[Qemu-devel] [PATCH v2 1/1] doc: document chardev option 'append'

[Denis V. Lunev]

    commit 31e38a22a0c5a25646f966f001e1f5513d5a186d
    Author: Olga Krishtal <address@hidden>
    Date:   Fri Dec 4 09:42:04 2015 +0300

        qemu-char: append opt to stop truncation of serial file

has added the option to the runtime but does not added it to -help
output. This blocks libvirt from using it.

Signed-off-by: Denis V. Lunev <address@hidden>
CC: Dmitry Mishin <address@hidden>
CC: Eric Blake <address@hidden>
CC: Markus Armbruster <address@hidden>
CC: Paolo Bonzini <address@hidden>
---
Changes from v1:
- fixed default value to 'off'

 qemu-options.hx | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/qemu-options.hx b/qemu-options.hx
index 49afe6c..f706e4a 100644
--- a/qemu-options.hx
+++ b/qemu-options.hx
@@ -2044,7 +2044,7 @@ DEF("chardev", HAS_ARG, QEMU_OPTION_chardev,
     "-chardev 
vc,id=id[[,width=width][,height=height]][[,cols=cols][,rows=rows]]\n"
     "         [,mux=on|off]\n"
     "-chardev ringbuf,id=id[,size=size]\n"
-    "-chardev file,id=id,path=path[,mux=on|off]\n"
+    "-chardev file,id=id,path=path[,mux=on|off][,append=on|off]\n"
     "-chardev pipe,id=id,path=path[,mux=on|off]\n"
 #ifdef _WIN32
     "-chardev console,id=id[,mux=on|off]\n"
@@ -2199,7 +2199,7 @@ console with the given dimensions.
 Create a ring buffer with fixed size @option{size}.
 @var{size} must be a power of two, and defaults to @code{64K}).
 
address@hidden -chardev file ,address@hidden ,address@hidden
address@hidden -chardev file ,address@hidden ,address@hidden 
[,address@hidden|off}]
 
 Log all traffic received from the guest to a file.
 
@@ -2207,6 +2207,9 @@ Log all traffic received from the guest to a file.
 created if it does not already exist, and overwritten if it does. @option{path}
 is required.
 
address@hidden specifies that QEMU must truncate the file on open.
address@hidden is optional, default value is off.
+
 @item -chardev pipe ,address@hidden ,address@hidden
 
 Create a two-way connection to the guest. The behaviour differs slightly 
between
-- 
2.5.0