|
 |
e76f14 |
From 72a5b6bd7893c5c955a8c4e1957ac9453c71c285 Mon Sep 17 00:00:00 2001
|
|
|
e76f14 |
From: "Richard W.M. Jones" <rjones@redhat.com>
|
|
|
e76f14 |
Date: Fri, 1 Apr 2016 17:46:53 +0100
|
|
|
e76f14 |
Subject: [PATCH] docs: Link to boot-analysis program from
|
|
|
e76f14 |
guestfs-performance(1).
|
|
|
e76f14 |
|
|
|
e76f14 |
(cherry picked from commit 2e04be377a71e9e76d7c8483889a717e9d4f8ec9)
|
|
|
e76f14 |
---
|
|
|
e76f14 |
docs/guestfs-performance.pod | 22 +++++++++++++++++++---
|
|
|
e76f14 |
1 file changed, 19 insertions(+), 3 deletions(-)
|
|
|
e76f14 |
|
|
|
e76f14 |
diff --git a/docs/guestfs-performance.pod b/docs/guestfs-performance.pod
|
|
|
e76f14 |
index 2a7a4a4..4ba6faf 100644
|
|
|
e76f14 |
--- a/docs/guestfs-performance.pod
|
|
|
e76f14 |
+++ b/docs/guestfs-performance.pod
|
|
|
e76f14 |
@@ -429,7 +429,23 @@ example).
|
|
|
e76f14 |
In Xen, dom0 is a virtual machine, and so hardware virtualization is
|
|
|
e76f14 |
not available.
|
|
|
e76f14 |
|
|
|
e76f14 |
-=head1 DETAILED TIMINGS USING TS
|
|
|
e76f14 |
+=head1 DETAILED ANALYSIS
|
|
|
e76f14 |
+
|
|
|
e76f14 |
+=head2 Boot analysis
|
|
|
e76f14 |
+
|
|
|
e76f14 |
+In the libguestfs source directory, in F<tests/qemu> is a program
|
|
|
e76f14 |
+called C<boot-analysis>. This program is able to produce a very
|
|
|
e76f14 |
+detailed breakdown of the boot steps (eg. qemu, BIOS, kernel,
|
|
|
e76f14 |
+libguestfs init script), and can measure how long it takes to perform
|
|
|
e76f14 |
+each step.
|
|
|
e76f14 |
+
|
|
|
e76f14 |
+To run this program, do:
|
|
|
e76f14 |
+
|
|
|
e76f14 |
+ make
|
|
|
e76f14 |
+ make -C tests/qemu boot-analysis
|
|
|
e76f14 |
+ ./run ./tests/qemu/boot-analysis
|
|
|
e76f14 |
+
|
|
|
e76f14 |
+=head2 Detailed timings using ts
|
|
|
e76f14 |
|
|
|
e76f14 |
Use the L<ts(1)> command (from moreutils) to show detailed
|
|
|
e76f14 |
timings:
|
|
|
e76f14 |
@@ -450,7 +466,7 @@ timings:
|
|
|
e76f14 |
|
|
|
e76f14 |
The timestamps are seconds (incrementally since the previous line).
|
|
|
e76f14 |
|
|
|
e76f14 |
-=head1 DETAILED TIMINGS USING SYSTEMTAP
|
|
|
e76f14 |
+=head2 Detailed timings using SystemTap
|
|
|
e76f14 |
|
|
|
e76f14 |
You can use SystemTap (L<stap(1)>) to get detailed timings from
|
|
|
e76f14 |
libguestfs programs.
|
|
|
e76f14 |
@@ -516,7 +532,7 @@ example:
|
|
|
e76f14 |
You will need to consult, and even modify, the source to libguestfs to
|
|
|
e76f14 |
fully understand the output.
|
|
|
e76f14 |
|
|
|
e76f14 |
-=head1 DETAILED DEBUGGING USING GDB
|
|
|
e76f14 |
+=head2 Detailed debugging using gdb
|
|
|
e76f14 |
|
|
|
e76f14 |
You can attach to the appliance BIOS/kernel using gdb. If you know
|
|
|
e76f14 |
what you're doing, this can be a useful way to diagnose boot
|
|
|
e76f14 |
--
|
|
|
aa0300 |
2.7.4
|
|
|
e76f14 |
|