libguestfs-boot-benchmark man page

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


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


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:

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

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



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



Richard W.M. Jones


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.


To get a list of bugs against libguestfs, use this link:

To report a new bug against libguestfs, use this link:

When reporting a bug, please supply:


2018-05-21 libguestfs-1.39.5 Virtualization Support