ShuriZma
/
xemu
mirror of https://github.com/xemu-project/xemu.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

qga/qapi-schema: Tweak documentation of fsfreeze commands 

"Returns:" sections of guest-fsfreeze-freeze and
guest-fsfreeze-freeze-list describe both command behavior and success
response.  Move behavior out, so "Returns:" is only about success
response.

Signed-off-by: Markus Armbruster <armbru@redhat.com>
Message-ID: <20240227113921.236097-12-armbru@redhat.com>
This commit is contained in:
Markus Armbruster 2024-02-27 12:39:19 +01:00
parent 6a90cc82b5
commit e22955e7f6
1 changed files with 9 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
qga/qapi-schema.json
View File

@ -437,15 +437,16 @@
# command succeeded, you may call @guest-fsfreeze-thaw later to # command succeeded, you may call @guest-fsfreeze-thaw later to
# unfreeze. # unfreeze.
# #
# On error, all filesystems will be thawed. If no filesystems are
# frozen as a result of this call, then @guest-fsfreeze-status will
# remain "thawed" and calling @guest-fsfreeze-thaw is not necessary.
#
# Returns: Number of file systems currently frozen.
#
# Note: On Windows, the command is implemented with the help of a # Note: On Windows, the command is implemented with the help of a
# Volume Shadow-copy Service DLL helper. The frozen state is # Volume Shadow-copy Service DLL helper. The frozen state is
# limited for up to 10 seconds by VSS. # limited for up to 10 seconds by VSS.
# #
# Returns: Number of file systems currently frozen. On error, all
# filesystems will be thawed. If no filesystems are frozen as a
# result of this call, then @guest-fsfreeze-status will remain
# "thawed" and calling @guest-fsfreeze-thaw is not necessary.
#
# Since: 0.15.0 # Since: 0.15.0
## ##
{ 'command': 'guest-fsfreeze-freeze', { 'command': 'guest-fsfreeze-freeze',
@ -457,12 +458,13 @@
# Sync and freeze specified guest filesystems. See also # Sync and freeze specified guest filesystems. See also
# @guest-fsfreeze-freeze. # @guest-fsfreeze-freeze.
# #
# On error, all filesystems will be thawed.
#
# @mountpoints: an array of mountpoints of filesystems to be frozen. # @mountpoints: an array of mountpoints of filesystems to be frozen.
# If omitted, every mounted filesystem is frozen. Invalid mount # If omitted, every mounted filesystem is frozen. Invalid mount
# points are ignored. # points are ignored.
# #
# Returns: Number of file systems currently frozen. On error, all # Returns: Number of file systems currently frozen.
# filesystems will be thawed.
# #
# Since: 2.2 # Since: 2.2
## ##