OS Manuals

/usr/bin/qemu-x86_64

QEMU user binaries (FIPS)

From qemu-fips-user 11.1.3-r0 (enterprise-packages), captured 2026-11-08 by running qemu-x86_64 --help (exit 0). permalink

usage: qemu-x86_64 [options] program [arguments...]
Linux CPU emulator (compiled for x86_64 emulation)

Options and associated environment variables:

Argument             Env-variable         Description
-h                                        print this help
-help
-g port              QEMU_GDB             wait gdb connection to 'port'
-L path              QEMU_LD_PREFIX       set the elf interpreter prefix to 'path'
-s size              QEMU_STACK_SIZE      set the stack size to 'size' bytes
-cpu model           QEMU_CPU             select CPU (-cpu help for list)
-E var=value         QEMU_SET_ENV         sets targets environment variable (see below)
-U var               QEMU_UNSET_ENV       unsets targets environment variable (see below)
-0 argv0             QEMU_ARGV0           forces target process argv[0] to be 'argv0'
-r uname             QEMU_UNAME           set qemu uname release string to 'uname'
-B address           QEMU_GUEST_BASE      set guest_base address to 'address'
-R size              QEMU_RESERVED_VA     reserve 'size' bytes for guest virtual address space
-t tsig hsig n[,...] QEMU_RTSIG_MAP       map target rt signals [tsig,tsig+n) to [hsig,hsig+n]
-d item[,...]        QEMU_LOG             enable logging of specified items (use '-d help' for a list of items)
-dfilter range[,...] QEMU_DFILTER         filter logging based on address range
-D logfile           QEMU_LOG_FILENAME    write logs to 'logfile' (default stderr)
-one-insn-per-tb     QEMU_ONE_INSN_PER_TB run with one guest instruction per emulated TB
-tb-size size        QEMU_TB_SIZE         TCG translation block cache size
-strace              QEMU_STRACE          log system calls
-seed                QEMU_RAND_SEED       Seed for pseudo-random number generator
-trace               QEMU_TRACE           [[enable=]<pattern>][,events=<file>][,file=<file>]
-version             QEMU_VERSION         display version information and exit
-perfmap             QEMU_PERFMAP         Generate a /tmp/perf-${pid}.map file for perf
-jitdump             QEMU_JITDUMP         Generate a jit-${pid}.dump file for perf

Defaults:
QEMU_LD_PREFIX  = /usr/gnemul/qemu-x86_64
QEMU_STACK_SIZE = 8388608 byte

You can use -E and -U options or the QEMU_SET_ENV and
QEMU_UNSET_ENV environment variables to set and unset
environment variables for the target process.
It is possible to provide several variables by separating them
by commas in getsubopt(3) style. Additionally it is possible to
provide the -E and -U options multiple times.
The following lines are equivalent:
    -E var1=val2 -E var2=val2 -U LD_PRELOAD -U LD_DEBUG
    -E var1=val2,var2=val2 -U LD_PRELOAD,LD_DEBUG
    QEMU_SET_ENV=var1=val2,var2=val2 QEMU_UNSET_ENV=LD_PRELOAD,LD_DEBUG
Note that if you provide several changes to a single variable
the last change will stay in effect.

See <https://qemu.org/contribute/report-a-bug> for how to report bugs.
More information on the QEMU project at <https://qemu.org>.
Options (24)
OptionDescriptionSource
-hprint this helphelp
-helphelp
-g portQEMU_GDB wait gdb connection to 'port'help
-L pathQEMU_LD_PREFIX set the elf interpreter prefix to 'path'help
-s sizeQEMU_STACK_SIZE set the stack size to 'size' byteshelp
-cpu modelQEMU_CPU select CPU (-cpu help for list)help
-E var=valueQEMU_SET_ENV sets targets environment variable (see below)help
-U varQEMU_UNSET_ENV unsets targets environment variable (see below)help
-0 argv0QEMU_ARGV0 forces target process argv[0] to be 'argv0'help
-r unameQEMU_UNAME set qemu uname release string to 'uname'help
-B addressQEMU_GUEST_BASE set guest_base address to 'address'help
-R sizeQEMU_RESERVED_VA reserve 'size' bytes for guest virtual address spacehelp
-t tsigmap target rt signals [tsig,tsig+n) to [hsig,hsig+n]help
-d itemQEMU_LOG enable logging of specified items (use '-d help' for a list of items)help
-dfilter rangefilter logging based on address rangehelp
-D logfileQEMU_LOG_FILENAME write logs to 'logfile' (default stderr)help
-one-insn-per-tbQEMU_ONE_INSN_PER_TB run with one guest instruction per emulated TBhelp
-tb-size sizeQEMU_TB_SIZE TCG translation block cache sizehelp
-straceQEMU_STRACE log system callshelp
-seedQEMU_RAND_SEED Seed for pseudo-random number generatorhelp
-traceQEMU_TRACE [[enable=]<pattern>][,events=<file>][,file=<file>]help
-versionQEMU_VERSION display version information and exithelp
-perfmapQEMU_PERFMAP Generate a /tmp/perf-${pid}.map file for perfhelp
-jitdumpQEMU_JITDUMP Generate a jit-${pid}.dump file for perfhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.