From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from firstgate.proxmox.com (firstgate.proxmox.com [IPv6:2a01:7e0:0:424::9]) by lore.proxmox.com (Postfix) with ESMTPS id 4159F1FF141 for ; Fri, 27 Feb 2026 13:06:36 +0100 (CET) Received: from firstgate.proxmox.com (localhost [127.0.0.1]) by firstgate.proxmox.com (Proxmox) with ESMTP id BBC50FA3A; Fri, 27 Feb 2026 13:07:33 +0100 (CET) From: Dominik Csapak To: pve-devel@lists.proxmox.com Subject: [PATCH docs v3 1/1] examples: add new hookscript phase to example hookscript Date: Fri, 27 Feb 2026 13:06:54 +0100 Message-ID: <20260227120728.2152303-5-d.csapak@proxmox.com> X-Mailer: git-send-email 2.47.3 In-Reply-To: <20260227120728.2152303-1-d.csapak@proxmox.com> References: <20260227120728.2152303-1-d.csapak@proxmox.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-SPAM-LEVEL: Spam detection results: 0 AWL 0.034 Adjusted score from AWL reputation of From: address BAYES_00 -1.9 Bayes spam probability is 0 to 1% DMARC_MISSING 0.1 Missing DMARC policy KAM_DMARC_STATUS 0.01 Test Rule for DKIM or SPF Failure with Strict Alignment SPF_HELO_NONE 0.001 SPF: HELO does not publish an SPF Record SPF_PASS -0.001 SPF: sender matches SPF record Message-ID-Hash: GJQ6RGSSEDU3O7AHWH5BGMF2MURF5VHP X-Message-ID-Hash: GJQ6RGSSEDU3O7AHWH5BGMF2MURF5VHP X-MailFrom: d.csapak@proxmox.com X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; loop; banned-address; emergency; member-moderation; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header X-Mailman-Version: 3.3.10 Precedence: list List-Id: Proxmox VE development discussion List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: qemu-server has a new phase 'post-pci-prepare' that is called for vms with pci passthrough for each device prepared. add that to the example hookscript and explain when it's called and it's parameters with a comment. Signed-off-by: Dominik Csapak --- examples/guest-example-hookscript.pl | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/examples/guest-example-hookscript.pl b/examples/guest-example-hookscript.pl index 1cce2e3..da14fd1 100755 --- a/examples/guest-example-hookscript.pl +++ b/examples/guest-example-hookscript.pl @@ -38,6 +38,31 @@ if ($phase eq 'pre-start') { print "$vmid started successfully.\n"; +} elsif ($phase eq 'post-pci-prepare') { + + # Only called for virtual machines, not containers. + # + # This phase will be called for each pci device that is passed through, + # after it was prepared by the PVE stack. In other words when either + # * the mdev/vGPU was created + # * the driver was changed to vfio-pci and the device was reset + # + # This phase has 3 additional parameters given via the environment + + # the id from the config, e.g. 'hostpci0' + my $hostpci_x = $ENV{PVE_HOOK_ID}; + + # the pciid of the passed through device or the underlying device in case of an mdev/vGPU + # e.g. '0000:01:00.0' + my $pciid = $ENV{PVE_HOOK_PCIID}; + + # the uuid of the mediated device if it was one, + # e.g. '00000001-0000-0000-0000-000000008006' + my $mdev_uuid = $ENV{PVE_HOOK_MDEV_UUID}; + + print "Prepared PCI device for $hostpci_x with pciid: $pciid.\n"; + print "It is a mediated device with UUID: $mdev_uuid\n" if $mdev_uuid; + } elsif ($phase eq 'pre-stop') { # Third phase 'pre-stop' will be executed before stopping the guest -- 2.47.3