diff --git a/docs/tracing.txt b/docs/tracing.txt index ea29f2c..ca5022a 100644 --- a/docs/tracing.txt +++ b/docs/tracing.txt @@ -9,7 +9,7 @@ for debugging, profiling, and observing execution. 1. Build with the 'simple' trace backend: - ./configure --trace-backend=simple + ./configure --enable-trace-backend=simple make 2. Create a file with the events you want to trace: @@ -19,11 +19,19 @@ for debugging, profiling, and observing execution. 3. Run the virtual machine to produce a trace file: - qemu -trace events=/tmp/events ... # your normal QEMU invocation + qemu-system-i386 -trace events=/tmp/events ... # your normal QEMU invocation + + For example: + + qemu-system-i386 -trace events=/tmp/events -hda ./linux-0.2.img -kernel ./vmlinuz-2.6.35-22-generic -append "root=/dev/sda" -initrd ./initrd.img-2.6.35-22-generic + + where linux-0.2.img is the "dd" image containing the root filesystem, vmlinuz-* is the kernel file, and initrd-* is the initrd file. 4. Pretty-print the binary trace file: - ./simpletrace.py trace-events trace-* + ./scripts/simpletrace.py trace-events trace-1958 + + where trace-1958 is one of the local files produced from earlier tracing in Step 3. == Trace events ==