Go to the first, previous, next, last section, table of contents.

3 Invoking the emulators

The names of the available emulators are:

You can run each of them by simply typing the name from a shell or by configuring your window manager for example to use them to open disk images.

If you want to look at the log output, or use the monitor in a port which does not have a dedicated monitor UI yet (such as the XAW port), you should always run them from a terminal window such as xterm or rxvt. For example, you could do 

xterm -e x64

3.1 Command-line options used during initialization

There are several options you can specify on the command line. Some of them are used to specify emulation settings and will be described in detail later (see section 6 Settings and resources for a complete list). The remaining options are used only to give usage information or to initialize the emulator in some way:

-help
-?
List all the available command-line options and their meaning.
-default
Set default resources (see section 6 Settings and resources). This will override all the settings specified before, but not the settings specified afterwards on the command line.
-config <filename>
Specify config file
-logfile <name>
Specify log file name
-verbose
Enable verbose log output.
-keybuf <string>
Put the specified string into the keyboard buffer.
-console
Console mode (for music playback)
-chdir <directory>
Change the working directory.
-autostart IMAGE
Autostart `IMAGE' (see section 3.2 Autostarting programs from the command-line).
-autoload <name>
Attach and autoload tape/disk image <name>
-basicload
On autostart, load to BASIC start (without ',1')
+basicload
On autostart, load with ',1'
-autostartwithcolon
On autostart, use the 'RUN' command with a colon, i.e., 'RUN:'
+autostartwithcolon
On autostart, do not use the 'RUN' command with a colon; i.e., 'RUN'
-autostart-handle-tde
+autostart-handle-tde
Handle/Do not handle True Drive Emulation on autostart
+autostart-warp
Enable/Disable warp mode during autostart
-autostartprgmode
Set autostart mode for PRG files
-autostartprgdiskimage
Set disk image for autostart of PRG files
-autostart-delay-random
+autostart-delay-random
Enable/Disable random delay on autostart
-autostart-delay <value>
Set initial autostart delay (0: use default)
-1 NAME
Attach `NAME' as a tape image file.
-8 NAME
-9 NAME
-10 NAME
-11 NAME
Attach `NAME' as a disk image to device 8, 9, 10 or 11.
-attach8ro
-attach9ro
-attach10ro
-attach11ro
Attach disk image for drive #8-11 read only
-attach8rw
-attach9rw
-attach10rw
-attach11rw
Attach disk image for drive #8-11 read write (if possible)

3.2 Autostarting programs from the command-line

It is possible to let the emulator autostart a disk or tape image file, by simply specifying its name as the last argument on the command line, for example 

x64 lovelygame.x64.gz

will start the C64 emulator, attaching `lovelygame.x64.gz' as a disk image and running the first program on it. You can also specify the name of the program on the fisk image by appending a colon (`:') the name itself to the argument; for example 

x64 "lovelygame.x64.gz:run me"

will run the program named `run me' on `lovelygame.x64.gz' instead of the first one.

Using the command-line option -autostart is equivalent; so the same result can be obtained with 

x64 -autostart "lovelygame.x64.gz:run me"

If you specify a raw CBM or P00 file, the emulator will setup the file system based drive emulation so that it is enabled and accesses the directory containing the file first. This is a very convenient way to start multi-file programs stored in file system directories and not requiring "true" drive emulation.

See section 5.5 Using disk and tape images. for more information about images and autostart.

Go to the first, previous, next, last section, table of contents.