From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43)
	id 1J2HHZ-00071T-EN
	for qemu-devel@nongnu.org; Tue, 11 Dec 2007 21:25:09 -0500
Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43)
	id 1J2HHX-00070J-PA
	for qemu-devel@nongnu.org; Tue, 11 Dec 2007 21:25:08 -0500
Received: from [199.232.76.173] (helo=monty-python.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43) id 1J2HHX-000708-H9
	for qemu-devel@nongnu.org; Tue, 11 Dec 2007 21:25:07 -0500
Received: from owa.c2.net ([207.235.78.2] helo=email.c2.net)
	by monty-python.gnu.org with esmtp (Exim 4.60)
	(envelope-from <thayne@c2.net>) id 1J2HHX-0000EZ-FC
	for qemu-devel@nongnu.org; Tue, 11 Dec 2007 21:25:07 -0500
From: Thayne Harbaugh <thayne@c2.net>
Content-Type: multipart/mixed; boundary="=-ZxF3wAGsL7MrsVPEA7tM"
Date: Tue, 11 Dec 2007 19:16:25 -0700
Message-Id: <1197425785.2947.101.camel@phantasm.home.enterpriseandprosperity.com>
Mime-Version: 1.0
Subject: [Qemu-devel] [PATCH] QEMU_STRACE documentation
Reply-To: thayne@c2.net, qemu-devel@nongnu.org
List-Id: qemu-devel.nongnu.org
List-Unsubscribe: <http://lists.nongnu.org/mailman/listinfo/qemu-devel>,
	<mailto:qemu-devel-request@nongnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/pipermail/qemu-devel>
List-Post: <mailto:qemu-devel@nongnu.org>
List-Help: <mailto:qemu-devel-request@nongnu.org?subject=help>
List-Subscribe: <http://lists.nongnu.org/mailman/listinfo/qemu-devel>,
	<mailto:qemu-devel-request@nongnu.org?subject=subscribe>
To: qemu-devel@nongnu.org


--=-ZxF3wAGsL7MrsVPEA7tM
Content-Type: text/plain
Content-Transfer-Encoding: 7bit

This patch adds documentation for the QEMU_STRACE environment setting.


--=-ZxF3wAGsL7MrsVPEA7tM
Content-Disposition: attachment; filename=08_strace_doc.patch
Content-Type: text/x-patch; name=08_strace_doc.patch; charset=UTF-8
Content-Transfer-Encoding: 7bit

Index: qemu/qemu-doc.texi
===================================================================
--- qemu.orig/qemu-doc.texi	2007-12-11 19:00:53.000000000 -0700
+++ qemu/qemu-doc.texi	2007-12-11 19:16:28.000000000 -0700
@@ -2437,6 +2437,17 @@
 Act as if the host page size was 'pagesize' bytes
 @end table
 
+Environment variables:
+
+@table @env
+@item QEMU_STRACE
+Print system calls and arguments similar to the 'strace' program
+(NOTE: the actual 'strace' program will not work because the user
+space emulator hasn't implemented ptrace).  At the moment this is
+incomplete.  All system calls that don't have a specific argument
+format are printed with information for six arguments.  Many
+flag-style arguments don't have decoders and will show up as numbers.
+
 @node Other binaries
 @subsection Other binaries
 
Index: qemu/linux-user/main.c
===================================================================
--- qemu.orig/linux-user/main.c	2007-12-11 19:02:01.000000000 -0700
+++ qemu/linux-user/main.c	2007-12-11 19:14:57.000000000 -0700
@@ -1943,7 +1943,12 @@
            "debug options:\n"
            "-d options   activate log (logfile=%s)\n"
            "-p pagesize  set the host page size to 'pagesize'\n"
-           "-strace      log system calls\n",
+           "-strace      log system calls\n"
+           "\n"
+           "environment variables:\n"
+           "QEMU_STRACE       Print system calls and arguments similar to the\n"
+           "                  'strace' program.  Enable by setting to any value.\n"
+           ,
            TARGET_ARCH,
            interp_prefix,
            x86_stack_size,

--=-ZxF3wAGsL7MrsVPEA7tM--