From nobody Tue May 7 06:26:48 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) client-ip=170.10.133.124; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-124.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1622808661; cv=none; d=zohomail.com; s=zohoarc; b=ddG+OJJXKNFjSkHZ2MkSB/Du12644u/fF3yrp0Ort6tqcdfgaBGE98nwpGkQl1b5O6ueAALPmn8m5N/B5qxyQJdRXBxhFKTH33qFd/qhMn8PvZHXwRdRTxsA/s6q5R9N9ErAGseb/awgdXUYdRa5GyeYwYsUlSFsUKsmeFu3Dys= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1622808661; h=Content-Type:Content-Transfer-Encoding:Date:From:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:To; bh=BHEchgNj/yHzWiy/iJuriZggWkDQxs9yxgZuj9Lq6nM=; b=JOItJzhvvTYDF7/ftccriqq4bVjJnc1E/EW1Jg7XAEXdNNvFcjJ7RnN4yyM5UhjA6lttT4P6jytoj/KVintuQkWaX/P2CmArt1yh0vkpM/GQfaI3951n6jo6viPzlP4IvLPtdLCX+bzCgrTWmUkNKMOp3A4sShHmwtoLSzRQexA= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by mx.zohomail.com with SMTPS id 1622808661397137.87957033702025; Fri, 4 Jun 2021 05:11:01 -0700 (PDT) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-316-sQl7nxlWO1impvwUsd0zEA-1; Fri, 04 Jun 2021 08:10:58 -0400 Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.phx2.redhat.com [10.5.11.13]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 7A93E6D246; Fri, 4 Jun 2021 12:10:53 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.20]) by smtp.corp.redhat.com (Postfix) with ESMTPS id DE9ED687C3; Fri, 4 Jun 2021 12:10:52 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id 4C8A31800BB8; Fri, 4 Jun 2021 12:10:51 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.phx2.redhat.com [10.5.11.22]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id 154C8jsT020926 for ; Fri, 4 Jun 2021 08:08:45 -0400 Received: by smtp.corp.redhat.com (Postfix) id BA9CF10023B5; Fri, 4 Jun 2021 12:08:45 +0000 (UTC) Received: from speedmetal.lan (unknown [10.40.208.29]) by smtp.corp.redhat.com (Postfix) with ESMTP id 22F5610013D7 for ; Fri, 4 Jun 2021 12:08:41 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1622808660; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=BHEchgNj/yHzWiy/iJuriZggWkDQxs9yxgZuj9Lq6nM=; b=AVbRbHhv1sVPRWtlJoKVMX34pHbrh2QBUbCKyuY/ueJoxfHF9ee+CfWy8CAzyIF8R+bk8t 0FGj5w6UfBZZn7DtJY4xgnXQvwLtsyy6KKCpFWd+znbi8qofUlInhSbf4Pa2HQ6XdM/hxH z3+81ZVQjJMThog1g31E0r/QR3ZNWYc= X-MC-Unique: sQl7nxlWO1impvwUsd0zEA-1 From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH] docs: formatdomain: Document disk serial truncation status quo Date: Fri, 4 Jun 2021 14:08:40 +0200 Message-Id: <31fe9e1a1ddc3da0abe7f63d544a3420cf953b74.1622808520.git.pkrempa@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.84 on 10.5.11.22 X-loop: libvir-list@redhat.com X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.13 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=libvir-list-bounces@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) Content-Type: text/plain; charset="utf-8" Disk serials are truncated arbitrarily and silently by qemu depending on the device type and how they are configured. Since changing the current state would lead to more regressions than we have now, document that the truncation is arbitrary. Signed-off-by: Peter Krempa Reviewed-by: Michal Privoznik --- docs/formatdomain.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index aa7bb8da14..3ee537da14 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -3146,6 +3146,16 @@ paravirtualized driver is specified via the ``disk``= element. may look like ``WD-WMAP9A966149``. Not supported for scsi-block devices, that is those using disk ``type`` 'block' using ``device`` 'lun' on ``bus`` 'scsi'. :since:`Since 0.7.1` + + Note that depending on hypervisor and device type the serial number may= be + truncated silently. IDE/SATA devices are commonly limited to 20 charact= ers. + SCSI devices depending on hypervisor version are limited to 20, 36 or 2= 47 + characters. + + Hypervisors may also start rejecting overly long serials instead of + truncating them in the future so it's advised to avoid the implicit + truncation by testing the desired serial length range with the desired = device + and hypervisor combination. ``wwn`` If present, this element specifies the WWN (World Wide Name) of a virtu= al hard disk or CD-ROM drive. It must be composed of 16 hexadecimal digits. --=20 2.31.1