NAME¶

boot-benchmark - Benchmark the time taken to boot the libguestfs appliance

SYNOPSIS¶

 ./run utils/boot-benchmark/boot-benchmark

DESCRIPTION¶

Benchmark the time taken to boot the libguestfs appliance.

It is essentially the same as doing:

 time guestfish -a /dev/null run

except that it warms up the caches and repeats the test many times, printing out the mean time and standard deviation.

This needs to be run on a quiet machine, so that other processes disturb the timing as little as possible. The program is completely safe to run at any time. It doesn't read or write any external files, and it doesn't require root.

You can run it from the build directory on the built copy of libguestfs like this:

 make
 ./run utils/boot-benchmark/boot-benchmark

If you omit "./run" then it is run on the installed copy of libguestfs.

OPTIONS¶

--help

Display brief help.

--append "OPTIONS"

Append "OPTIONS" to the kernel command line.

-m MB

--memsize MB

Set the appliance memory size in MB.

--smp N

Enable "N" virtual CPUs.

SEE ALSO¶

guestfs-performance(1), http://libguestfs.org/.

AUTHOR¶

Richard W.M. Jones http://people.redhat.com/~rjones/

COPYRIGHT¶

Copyright (C) 2016 Red Hat Inc.

LICENSE¶

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

BUGS¶

To get a list of bugs against libguestfs, use this link: https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools

To report a new bug against libguestfs, use this link: https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools

When reporting a bug, please supply:

• The version of libguestfs.
• Where you got libguestfs (eg. which Linux distro, compiled from source, etc)
• Describe the bug accurately and give a way to reproduce it.
• Run libguestfs-test-tool(1) and paste the complete, unedited output into the bug report.