From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([2001:4830:134:3::10]:43996) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aFkGH-00084o-Ri for qemu-devel@nongnu.org; Sun, 03 Jan 2016 10:08:02 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aFkGE-0005JL-La for qemu-devel@nongnu.org; Sun, 03 Jan 2016 10:08:01 -0500 Received: from mailhub.sw.ru ([195.214.232.25]:15836 helo=relay.sw.ru) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aFkGE-0005J2-8y for qemu-devel@nongnu.org; Sun, 03 Jan 2016 10:07:58 -0500 From: "Denis V. Lunev" Date: Sun, 3 Jan 2016 18:07:46 +0300 Message-Id: <1451833666-10564-1-git-send-email-den@openvz.org> Subject: [Qemu-devel] [PATCH v3 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. Signed-off-by: Denis V. Lunev Reviewed-by: Daniel P. Berrange CC: Dmitry Mishin CC: Eric Blake CC: Markus Armbruster CC: Paolo Bonzini --- Changes from v2: - removed comment about libvirt in the description - rephrased the description by the suggestions from Eric 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 215d00d..3544788 100644 --- a/qemu-options.hx +++ b/qemu-options.hx @@ -2099,7 +2099,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" @@ -2254,7 +2254,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. @@ -2262,6 +2262,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 should append to the file. The file is +truncated if the option is omitted or is specified as off. + @item -chardev pipe ,id=@var{id} ,path=@var{path} Create a two-way connection to the guest. The behaviour differs slightly between -- 2.1.4