Re: [RFC PATCH v3 3/3] docs: provide description for pci hotplug option

["Teddy Astie" <teddy.astie@xxxxxxxxxx>]

Le 10/04/2026 à 17:06, Thierry Escande a écrit :
> This patch adds description for the 'hotplug' PCI option, allowing
> devices to be attached to the guest using the legacy QMP hotplug
> mechanism or by passing them to the Qemu command line using '-device'.
>
> Signed-off-by: Thierry Escande <thierry.escande@xxxxxxxxxx>
> ---
> v2: no change
> v3: no change
> ---
>   docs/man/xl-pci-configuration.5.pod | 17 +++++++++++++++++
>   docs/man/xl.cfg.5.pod.in            |  6 ++++++
>   2 files changed, 23 insertions(+)
>
> diff --git a/docs/man/xl-pci-configuration.5.pod 
> b/docs/man/xl-pci-configuration.5.pod
> index 0691f06ad3..8b664173cb 100644
> --- a/docs/man/xl-pci-configuration.5.pod
> +++ b/docs/man/xl-pci-configuration.5.pod
> @@ -166,6 +166,23 @@ dom0 without confirmation.  Please use with care.
>
>   =back
>
> +=item B<hotplug>=I<BOOLEAN>
> +
> +=over 4
> +
> +=item Description
> +
> +Tells L<xl(1)> to use QMP hotplug mechanism to attach assignable device to
> +the guest, or to pass it via Qemu command line using
> +'B<-device xen-pci-passthrough,...>'. The default is to use the legacy QMP
> +mechanism.
> +
> +=item Default Value
> +
> +1
> +
> +=back
> +
>   =item B<power_mgmt>=I<BOOLEAN>
>
>   =over 4
> diff --git a/docs/man/xl.cfg.5.pod.in b/docs/man/xl.cfg.5.pod.in
> index 3aac0bc4fb..181aaffa0f 100644
> --- a/docs/man/xl.cfg.5.pod.in
> +++ b/docs/man/xl.cfg.5.pod.in
> @@ -1230,6 +1230,12 @@ B<(HVM only)> Changes the default value of 
> B<power_mgmt> for all PCI
>   devices passed through to this VM. See B<power_mgmt>
>   above.
>
> +=item B<pci_hotplug=BOOLEAN>
> +
> +B<(HVM only)> Changes the default value of B<hotplug> for all PCI
> +devices passed through to this VM. See L<xl-pci-configuration(5)> for
> +more details.
> +
>   =item B<gfx_passthru=BOOLEAN|"STRING">
>
>   Enable graphics device PCI passthrough. This option makes an assigned

Reviewed-by: Teddy Astie <teddy.astie@xxxxxxxxxx>


--
Teddy Astie | Vates XCP-ng Developer

XCP-ng & Xen Orchestra - Vates solutions

web: https://vates.tech