[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Qemu-devel] [PULL v2 6/8] qga: improve fsfreeze documentations
From: |
Michael Roth |
Subject: |
[Qemu-devel] [PULL v2 6/8] qga: improve fsfreeze documentations |
Date: |
Thu, 27 Apr 2017 00:46:34 -0500 |
From: Marc-André Lureau <address@hidden>
Some users find the fsfreeze behaviour confusing. Add some notes about
invalid mount points and Windows usage.
Related to:
https://bugzilla.redhat.com/show_bug.cgi?id=1436976
Signed-off-by: Marc-André Lureau <address@hidden>
Reviewed-by: Vinzenz Feenstra <address@hidden>
Signed-off-by: Michael Roth <address@hidden>
---
qga/qapi-schema.json | 12 ++++++++++--
1 file changed, 10 insertions(+), 2 deletions(-)
diff --git a/qga/qapi-schema.json b/qga/qapi-schema.json
index 6307ae2..0f4cba5 100644
--- a/qga/qapi-schema.json
+++ b/qga/qapi-schema.json
@@ -426,7 +426,13 @@
##
# @guest-fsfreeze-freeze:
#
-# Sync and freeze all freezable, local guest filesystems
+# Sync and freeze all freezable, local guest filesystems. If this
+# command succeeded, you may call @guest-fsfreeze-thaw later to
+# unfreeze.
+#
+# Note: On Windows, the command is implemented with the help of a
+# Volume Shadow-copy Service DLL helper. The frozen state is limited
+# for up to 10 seconds by VSS.
#
# Returns: Number of file systems currently frozen. On error, all filesystems
# will be thawed.
@@ -439,10 +445,12 @@
##
# @guest-fsfreeze-freeze-list:
#
-# Sync and freeze specified guest filesystems
+# Sync and freeze specified guest filesystems.
+# See also @guest-fsfreeze-freeze.
#
# @mountpoints: an array of mountpoints of filesystems to be frozen.
# If omitted, every mounted filesystem is frozen.
+# Invalid mount points are ignored.
#
# Returns: Number of file systems currently frozen. On error, all filesystems
# will be thawed.
--
2.7.4
- [Qemu-devel] [PULL v2 0/8] qemu-ga patch queue, Michael Roth, 2017/04/27
- [Qemu-devel] [PULL v2 2/8] qga-win: Enable 'can-offline' field in 'guest-get-vcpus' reply, Michael Roth, 2017/04/27
- [Qemu-devel] [PULL v2 3/8] qga-win: Fix a bug where qemu-ga service is stuck during stop operation, Michael Roth, 2017/04/27
- [Qemu-devel] [PULL v2 7/8] qga: Add 'guest-get-users' command, Michael Roth, 2017/04/27
- [Qemu-devel] [PULL v2 6/8] qga: improve fsfreeze documentations,
Michael Roth <=
- [Qemu-devel] [PULL v2 4/8] qga-win: Fix Event Viewer errors caused by qemu-ga, Michael Roth, 2017/04/27
- [Qemu-devel] [PULL v2 5/8] qga: Add 'guest-get-host-name' command, Michael Roth, 2017/04/27
- [Qemu-devel] [PULL v2 1/8] qemu-ga: Make QGA VSS provider service run only when needed, Michael Roth, 2017/04/27
- [Qemu-devel] [PULL v2 8/8] qga: Add `guest-get-timezone` command, Michael Roth, 2017/04/27
- Re: [Qemu-devel] [PULL v2 0/8] qemu-ga patch queue, Stefan Hajnoczi, 2017/04/28