Re: [PATCH] docs: hooks: Document when shutoff-reason argument was introduced

From: Michal Privoznik <mprivozn(a)redhat.com&gt; Introduced in v10.5.0-rc1~52, qemu and lxc hook scripts are executed with additional argument: shutoff reason. But wording of our docs make it looks like it's been that way forever. Make it clear this is `recent` feature. Resolves: https://gitlab.com/libvirt/libvirt/-/issues/766 Signed-off-by: Michal Privoznik <mprivozn(a)redhat.com&gt; --- docs/hooks.rst | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/docs/hooks.rst b/docs/hooks.rst index 48128ba3d8..b363f51da1 100644 --- a/docs/hooks.rst +++ b/docs/hooks.rst @@ -211,7 +211,9 @@ operation. There is no specific operation to indicate a "restart" is occurring. /etc/libvirt/hooks/qemu guest_name stopped end - Then, after libvirt has released all resources, the hook is called again, - :since:`since 0.9.0`, to allow any additional resource cleanup: + :since:`since 0.9.0`, to allow any additional resource cleanup + (:since:`since 10.5.0` there's additional argument ``shutoff-reason`` passed + to the hook):

:: @@ -331,7 +333,9 @@ operation. There is no specific operation to indicate a "restart" is occurring. /etc/libvirt/hooks/lxc guest_name stopped end - Then, after libvirt has released all resources, the hook is called again, - :since:`since 0.9.0`, to allow any additional resource cleanup: + :since:`since 0.9.0`, to allow any additional resource cleanup + (:since:`since 10.5.0` there's additional argument ``shutoff-reason`` passed + to the hook):