# gxemul -h
GXemul 0.4.3    Copyright (C) 2003-2006  Anders Gavare
Read the source code and/or documentation for other Copyright messages.

usage: gxemul [machine, other, and general options] [file [...]]
   or  gxemul [general options] @configfile

Machine selection options:
  -E t      try to emulate machine type t. (Use -H to get a list of types.)
  -e st     try to emulate machine subtype st. (Use this with -E.)

Other options:
  -C x      try to emulate a specific CPU. (Use -H to get a list of types.)
  -d fname  add fname as a disk image. You can add "xxx:" as a prefix
            where xxx is one or more of the following:
                b      specifies that this is the boot device
                c      CD-ROM
                d      DISK
                f      FLOPPY
                gH;S;  set geometry to H heads and S sectors-per-track
                i      IDE
                r      read-only (don't allow changes to the file)
                s      SCSI
                t      tape
                0-7    force a specific ID
  -G port   listen to gdb remote connections on this port
  -I hz     set the main cpu frequency to hz (not used by all combinations
            of machines and guest OSes)  -i        display each instruction as it is executed
  -J        disable dyntrans instruction combinations
  -j name   set the name of the kernel; for DECstation emulation, this passes
            the name to the bootloader, for example:
                -j netbsd     (NetBSD/pmax)      -j bsd      (OpenBSD/pmax)
                -j vmsprite   (Sprite/pmax)      -j vmunix   (Ultrix/RISC)
            For other emulation modes, if the boot disk is an ISO9660
            filesystem, -j sets the name of the kernel to load.
  -M m      emulate m MBs of physical RAM
  -N        display nr of instructions/second average, at regular intervals
  -n nr     set nr of CPUs (for SMP experiments)
  -O        force netboot (tftp instead of disk), even when a disk image is
            present (for DECstation, SGI, and ARC emulation)
  -o arg    set the boot argument, for DEC, ARC, or SGI emulation
            (default arg for DEC is -a, for ARC/SGI -aN)
  -p pc     add a breakpoint (remember to use the '0x' prefix for hex!)
  -Q        no built-in PROM emulation  (use this for running ROM images)
  -R        use random bootstrap cpu, instead of nr 0
  -r        register dumps before every instruction
  -S        initialize emulated RAM to random bytes, instead of zeroes
  -s f:name write statistics to file 'name', f is one or more of the following:
                v    virtual program counter
                p    physical equivalent of program counter
                i    internal ic->f representation of the program counter
            and optionally:
                d    disable statistics gathering at startup
                o    overwrite instead of append
  -t        show function trace tree
  -U        enable slow_serial_interrupts_hack_for_linux
  -X        use X11
  -x        open up new xterms for emulated serial ports (default is on when
            using configuration files or when X11 is used, off otherwise)
  -Y n      scale down framebuffer windows by n x n times
  -Z n      set nr of graphics cards, for emulating a dual-head or tripple-head
            environment (only for DECstation emulation)
  -z disp   add disp as an X11 display to use for framebuffers

General options:
  -c cmd    add cmd as a command to run before starting the simulation
  -D        skip the srandom call at startup
  -H        display a list of possible CPU and machine types
  -h        display this help message
  -K        force the debugger to be entered at the end of a simulation
  -q        quiet mode (don't print startup messages)
  -V        start up in the single-step debugger, paused
  -v        verbose debug messages

If you are selecting a machine type to emulate directly on the command line,
then you must specify one or more names of files that you wish to load into
memory. Supported formats are:   ELF a.out ecoff srec syms raw
where syms is the text produced by running 'nm' (or 'nm -S') on a binary.
To load a raw binary into memory, add "address:" in front of the filename,
or "address:skiplen:" or "address:skiplen:initialpc:".
Examples:
    0xbfc00000:rom.bin                    for a raw ROM image
    0xbfc00000:0x100:rom.bin              for an image with 0x100 bytes header
    0xbfc00000:0x100:0xbfc00884:rom.bin   start with pc=0xbfc00884