[Top] [Prev] [Next]

emu

emu - Inferno emulator

Synopsis

emu [Options... ]

Description

 The emu command provides the Inferno emulation environment. The emulator runs as an application under the machine's native operating system, which provides system services.

The emu command starts an Inferno shell (default /dis/sh.dis), whose path name is interpreted in the Inferno file name space, not in the native operating system's name space.

Options

Options may be set from the environment variable EMU but are overridden by options supplied on the command line
-c[0-9]

 The -c option determines the manner in which the emulator will process Dis programs.

 0

(default)

Unless specified otherwise by the module, emu uses an interpreter to execute Dis instructions on the native machine.

 1

 Setting the option argument to non-zero changes the default behavior to compile Dis into native instructions when a module is loaded (just-in-time compilation). This results in faster execution but larger run-time size.

 2-9

 Setting the option argument to larger values engages compiler trace facilities.

-gXxY

Define screen width and height in pixels. The default values are 640 and 480 respectively. Values smaller than the defaults are ignored.

-ffontpath

Specify the default font for the tk module. The path is interpreted in the Inferno name space. If unspecified, the font variable has value <inferno_root>/fonts/lucm/unicode.9.font.

(See Notes section below for value of <inferno_root>.)

-rrootdir

 Specify directory that emu will serve as its root instead of <inferno_root>. See Notes below for default values.

-s

 This option specifies how the emulator deals with traps reported by the operating system. By default, traps suspend execution of the offending thread. When the -s option is set, emu makes no arrangements to catch traps and, if they occur, the emu process responds accordingly (e.g., terminates with core file). This facilitates debugging of the broken process via tools in the host environment.

-ppoolname =maxsize

Specify the maximum size (in bytes) of the named memory allocation pool. The pools are:

 main

 the general malloc arena

 heap

 the Dis virtual machine heap

 image

 image storage for the display

-m[012]

 Garbage collector mark-and-sweep trace parameter.

-7

 Restrict emu to 7-bit (128 element) color map. The default is 256 elements. Useful for X-terminals with few color maps.

Files
/dis/sh.dis

 The default Inferno shell.

See Also

 limbo, and sh

Notes

Default value of <inferno_root> is /usr/inferno on Unix-hosted systems and \users\inferno on Windows-hosted systems.


[Top] [Prev] [Next]

infernosupport@lucent.com
Copyright © 1996,Lucent Technologies, Inc. All rights reserved.