With the current wording, users might think that the -F option is not
required as long as the script is placed in the default path. Be clear
that the option is always required. Also includes some minor language
improvements in the rest of the comment.

Signed-off-by: Fiona Ebner <f.ebner@proxmox.com>
---
 scripts/qemu-guest-agent/fsfreeze-hook | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/scripts/qemu-guest-agent/fsfreeze-hook b/scripts/qemu-guest-agent/fsfreeze-hook
index c1feb6f5ce..5b915af017 100755
--- a/scripts/qemu-guest-agent/fsfreeze-hook
+++ b/scripts/qemu-guest-agent/fsfreeze-hook
@@ -1,11 +1,12 @@
 #!/bin/sh
 
-# This script is executed when a guest agent receives fsfreeze-freeze and
-# fsfreeze-thaw command, if it is specified in --fsfreeze-hook (-F)
-# option of qemu-ga or placed in default path (/etc/qemu/fsfreeze-hook).
-# When the agent receives fsfreeze-freeze request, this script is issued with
-# "freeze" argument before the filesystem is frozen. And for fsfreeze-thaw
-# request, it is issued with "thaw" argument after filesystem is thawed.
+# This script is executed when the guest agent receives fsfreeze-freeze and
+# fsfreeze-thaw commands, provided that the --fsfreeze-hook (-F) option of
+# qemu-ga is specified and the script is placed in /etc/qemu/fsfreeze-hook or in
+# the path specified together with -F. When the agent receives fsfreeze-freeze
+# requests, this script is called with "freeze" as its argument before the
+# filesystem is frozen. And for fsfreeze-thaw requests, it is called with "thaw"
+# as its argument after the filesystem is thawed.
 
 LOGFILE=/var/log/qga-fsfreeze-hook.log
 FSFREEZE_D=$(dirname -- "$0")/fsfreeze-hook.d
-- 
2.47.2

Reviewed-by: Kostiantyn Kostiuk <kkostiuk@redhat.com>

Best Regards,
Kostiantyn Kostiuk.


On Tue, Sep 16, 2025 at 3:22 PM Fiona Ebner <f.ebner@proxmox.com> wrote:

> With the current wording, users might think that the -F option is not
> required as long as the script is placed in the default path. Be clear
> that the option is always required. Also includes some minor language
> improvements in the rest of the comment.
>
> Signed-off-by: Fiona Ebner <f.ebner@proxmox.com>
> ---
>  scripts/qemu-guest-agent/fsfreeze-hook | 13 +++++++------
>  1 file changed, 7 insertions(+), 6 deletions(-)
>
> diff --git a/scripts/qemu-guest-agent/fsfreeze-hook
> b/scripts/qemu-guest-agent/fsfreeze-hook
> index c1feb6f5ce..5b915af017 100755
> --- a/scripts/qemu-guest-agent/fsfreeze-hook
> +++ b/scripts/qemu-guest-agent/fsfreeze-hook
> @@ -1,11 +1,12 @@
>  #!/bin/sh
>
> -# This script is executed when a guest agent receives fsfreeze-freeze and
> -# fsfreeze-thaw command, if it is specified in --fsfreeze-hook (-F)
> -# option of qemu-ga or placed in default path (/etc/qemu/fsfreeze-hook).
> -# When the agent receives fsfreeze-freeze request, this script is issued
> with
> -# "freeze" argument before the filesystem is frozen. And for fsfreeze-thaw
> -# request, it is issued with "thaw" argument after filesystem is thawed.
> +# This script is executed when the guest agent receives fsfreeze-freeze
> and
> +# fsfreeze-thaw commands, provided that the --fsfreeze-hook (-F) option of
> +# qemu-ga is specified and the script is placed in
> /etc/qemu/fsfreeze-hook or in
> +# the path specified together with -F. When the agent receives
> fsfreeze-freeze
> +# requests, this script is called with "freeze" as its argument before the
> +# filesystem is frozen. And for fsfreeze-thaw requests, it is called with
> "thaw"
> +# as its argument after the filesystem is thawed.
>
>  LOGFILE=/var/log/qga-fsfreeze-hook.log
>  FSFREEZE_D=$(dirname -- "$0")/fsfreeze-hook.d
> --
> 2.47.2
>
>
>
>