From nobody Thu Jan 8 10:22:37 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of lists.libvirt.org designates 8.43.85.245 as permitted sender) client-ip=8.43.85.245; envelope-from=devel-bounces@lists.libvirt.org; helo=lists.libvirt.org; Received-SPF: pass (zohomail.com: domain of lists.libvirt.org designates 8.43.85.245 as permitted sender) client-ip=8.43.85.245; envelope-from=devel-bounces@lists.libvirt.org; helo=lists.libvirt.org; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of lists.libvirt.org designates 8.43.85.245 as permitted sender) smtp.mailfrom=devel-bounces@lists.libvirt.org; dmarc=pass(p=none dis=none) header.from=that.guru ARC-Seal: i=1; a=rsa-sha256; t=1766143646; cv=none; d=zohomail.com; s=zohoarc; b=UDz7PXFEYMOES3Dy12azSOG5PEbn3DCI2/9/ZWNcqowVuJqlcDt5/1nv+TzlOulKu6RPPMkOSYD7jFtPBFgtdO5AOro0U0pDgQ+Fom4qpRoLg/IkM/VxA9iKN8BaYV+EanBfa729N70Kaic69XHYi5HHillSo9QhWEkKkIY/wsI= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1766143646; h=Content-Transfer-Encoding:Cc:Cc:Date:Date:From:From:List-Subscribe:List-Post:List-Owner:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Subject:Subject:To:To:Message-Id:Reply-To; bh=fAxOx4Kw2cVcsqgzCgn74d+6XuvR2Uv10CMb9Ij27RY=; b=BtASGXLx1tiNmPAXubLr/rB9WexsSnUx4OQ5f3fLNFFI3+tFioSNmR5ppOq3swkVvBEUWJpPRn9fXRFqChzAC/tlBbntc9PbMhNFZLnLNmNPYFmYmbaLfQ66Ly7MZXuBXuGvQSyzdofrnfdLFepHyzq1183VdTT9KemkweMPOqM= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of lists.libvirt.org designates 8.43.85.245 as permitted sender) smtp.mailfrom=devel-bounces@lists.libvirt.org; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from lists.libvirt.org (lists.libvirt.org [8.43.85.245]) by mx.zohomail.com with SMTPS id 1766143646228185.86705951303418; Fri, 19 Dec 2025 03:27:26 -0800 (PST) Received: by lists.libvirt.org (Postfix, from userid 993) id 47A4E418A9; Fri, 19 Dec 2025 06:27:25 -0500 (EST) Received: from [172.19.199.83] (lists.libvirt.org [8.43.85.245]) by lists.libvirt.org (Postfix) with ESMTP id 1348C418E6; Fri, 19 Dec 2025 06:21:33 -0500 (EST) Received: by lists.libvirt.org (Postfix, from userid 993) id A83E941848; Thu, 18 Dec 2025 12:11:39 -0500 (EST) Received: from mail-108-mta18.mxroute.com (mail-108-mta18.mxroute.com [136.175.108.18]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (3072 bits) server-digest SHA256) (No client certificate requested) by lists.libvirt.org (Postfix) with ESMTPS id 43B5241837 for ; Thu, 18 Dec 2025 12:11:35 -0500 (EST) Received: from filter006.mxroute.com ([136.175.111.3] filter006.mxroute.com) (Authenticated sender: mN4UYu2MZsgR) by mail-108-mta18.mxroute.com (ZoneMTA) with ESMTPSA id 19b326d67f00004eea.001 for (version=TLSv1.3 cipher=TLS_AES_256_GCM_SHA384); Thu, 18 Dec 2025 17:06:29 +0000 X-Spam-Checker-Version: SpamAssassin 4.0.1 (2024-03-26) on lists.libvirt.org X-Spam-Level: X-Spam-Status: No, score=-5.3 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED,RCVD_IN_VALIDITY_RPBL_BLOCKED, RCVD_IN_VALIDITY_SAFE_BLOCKED,SPF_PASS autolearn=unavailable autolearn_force=no version=4.0.1 X-Greylist: delayed 301 seconds by postgrey-1.37 at lists.libvirt.org; Thu, 18 Dec 2025 12:11:35 EST X-Zone-Loop: 26252238dd7a85c11c2ffdb714c073ef2928d44d814f X-Originating-IP: [136.175.111.3] DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=that.guru; s=x; h=Content-Transfer-Encoding:MIME-Version:Date:Subject:Cc:To:From:Sender: Reply-To:Content-Type:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:In-Reply-To:References; bh=fAxOx4Kw2cVcsqgzCgn74d+6XuvR2Uv10CMb9Ij27RY=; b=cOmgVfkZddnQE0lBufmCKlnEZL wS0XY2AWuCqLXlarXP/2/ExvLgYPYMGFO1taxZ//9u8peD3kkGSl7EsouiQc6L2f4wDWYyE+89UpU H+VYHlWAWrSyxB6i5V8GBMoYO4p7iN9vVdjV1h42G3chRLCMDw94W8OkaFsIhKfoJ6n25Aahr3igW VHdD32yFYfEkod0Cgz7S9YGwaWTx7i80gafjfj+p3i35labpfQ5u1gcczKu6vqPL23TvZbDWgukR6 Q8CqKd/rj75e0e1AkO7/LwDOuQ4QW+eV4aMrnUpwOmuWXD8cbitt1NXv0FGK9Nf7LNWofw+MdZVO+ rM9S7bKw==; From: Stephen Finucane To: devel@lists.libvirt.org Subject: [PATCH] docs: Add note about auto-generated aliases Date: Thu, 18 Dec 2025 17:06:18 +0000 Message-ID: <20251218170620.359589-1-stephen@that.guru> MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable X-Authenticated-Id: stephen@that.guru X-MailFrom: stephen@that.guru X-Mailman-Rule-Hits: nonmember-moderation X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; loop; banned-address; header-match-devel.lists.libvirt.org-0; emergency; member-moderation Message-ID-Hash: CV2JVD5OQ5V24N4KCQ4SD5ZRBC3C4I5Y X-Message-ID-Hash: CV2JVD5OQ5V24N4KCQ4SD5ZRBC3C4I5Y X-Mailman-Approved-At: Fri, 19 Dec 2025 11:21:04 +0000 CC: Stephen Finucane X-Mailman-Version: 3.3.10 Precedence: list List-Id: Development discussions about the libvirt library & tools Archived-At: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: X-ZohoMail-DKIM: pass (identity @that.guru) X-ZM-MESSAGEID: 1766143647598158500 Content-Type: text/plain; charset="utf-8" We automatically generate an alias for virtually all devices if a user hasn't provided one [1]. Indicate this. Note that I have not listed all devices that support auto-generated aliases since that list would be liable to get stale rather quickly. [1] https://github.com/libvirt/libvirt/blob/v11.10.0/src/qemu/qemu_alias.c#= L692-L786 Signed-off-by: Stephen Finucane --- docs/formatdomain.rst | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/formatdomain.rst b/docs/formatdomain.rst index 1467fc7e10..5cb387dc82 100644 --- a/docs/formatdomain.rst +++ b/docs/formatdomain.rst @@ -2593,7 +2593,7 @@ guest domain. All devices occur as children of the ma= in ``devices`` element. =20 To help users identifying devices they care about, every device can have d= irect child ``alias`` element which then has ``name`` attribute where users can = store -identifier for the device. The identifier has to have "ua-" prefix and mus= t be +identifier for the device. The identifier has to have ``ua-`` prefix and m= ust be unique within the domain. Additionally, the identifier must consist only o= f the following characters: ``[a-zA-Z0-9_-]``. :since:`Since 3.9.0` =20 @@ -2609,6 +2609,9 @@ following characters: ``[a-zA-Z0-9_-]``. :since:`Sinc= e 3.9.0` ... =20 +If a user-specified alias is not provided, one will be automatically gener= ated +for most devices, based on attributes of the device such as its type. + =20 Hard drives, floppy disks, CDROMs ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ --=20 2.52.0