From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([2001:4830:134:3::10]:55648) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aBJZG-0005wV-GF for qemu-devel@nongnu.org; Tue, 22 Dec 2015 04:49:23 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aBJZB-0002A1-QZ for qemu-devel@nongnu.org; Tue, 22 Dec 2015 04:49:18 -0500 Received: from mailhub.sw.ru ([195.214.232.25]:21083 helo=relay.sw.ru) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aBJZB-00029v-EV for qemu-devel@nongnu.org; Tue, 22 Dec 2015 04:49:13 -0500 From: "Denis V. Lunev" Date: Tue, 22 Dec 2015 12:49:09 +0300 Message-Id: <1450777749-14022-1-git-send-email-den@openvz.org> Subject: [Qemu-devel] [PATCH v2 1/1] doc: document chardev option 'append' List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Dmitry Mishin , qemu-devel@nongnu.org, Markus Armbruster , Paolo Bonzini , "Denis V. Lunev" commit 31e38a22a0c5a25646f966f001e1f5513d5a186d Author: Olga Krishtal 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 CC: Dmitry Mishin CC: Eric Blake CC: Markus Armbruster CC: Paolo Bonzini --- 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}). -@item -chardev file ,id=@var{id} ,path=@var{path} +@item -chardev file ,id=@var{id} ,path=@var{path} [,append=@var{on|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. +@option{append} specifies that QEMU must truncate the file on open. +@option{append} is optional, default value is off. + @item -chardev pipe ,id=@var{id} ,path=@var{path} Create a two-way connection to the guest. The behaviour differs slightly between -- 2.5.0