.TH EMU 1E.SH NAMEemu \- Inferno emulator.SH SYNOPSIS.B emu[.BI \-g Xsize x Ysize][.BR \-c [0-9]][.BI -d " daemon"][.BR \-m [0-9]].RB [ \-s ][.BI \-p pool = maxsize][.BI \-f font][.BI \-r rootpath].RB [ \-7 ][.RB \-C channel][.RB \-S][.B -v][.I cmd.RI [ " arg ... " ]].SH DESCRIPTION.I Emuprovides the Inferno emulation environment.The emulator runs as an application under themachine's native operating system, andprovides system services and a Dis virtual machine for Inferno applications..PP.I Emustarts an Inferno initialisation program.BR /dis/emuinit.dis ,whose path name is interpreted in theInferno file name space,not inthe native operating system's name space.It in turn invokes the shell.BR /dis/sh.disby default or the optional.I cmdand its arguments.If the.B \-doption is specified,.I emuinstead invokes.BR daemon ,turning the.I emuinstance into an Inferno service process on the network,running the given.I daemonservice or services..PPThe emulator supports the following options:.TP.BI \-c nUnless specified otherwise by the module (see.B wm/rtin.IR wm-misc (1)),.I emuuses an interpreter to execute Dis instructions.Setting.I nto 1 (the default value is 0)makes the default behaviourto compile Disinto native instructions when a module is loaded,resulting in faster execution but larger run-time size.Setting.I nto values larger than 1 enables increasingly detailed traces of the compiler..TP.BI \-dRun .I emuas a server..TP.BI \-g Xsize x YsizeDefine screen width and height in pixels.The default values are 640x480 and the minimum values are 64x48.Values smaller than the minimum or greater than theavailable display size are ignored..TP.BI \-f fontSpecify the default font for the.B tkmodule.The path is interpreted in the Inferno name space.If unspecified, the.B fontvariable has value.BR /fonts/lucm/unicode.9.font ..TP.BI \-r rootpathSpecify the host system directory that.I emuwill serve as its root.The default value is.B /usr/infernoon most systems, but.BR \einfernoon Windows..TP.B \-sSpecify how the emulator deals with traps reported by the operating system.By default, they suspend execution of the offending thread within the virtual machineabstraction.The.B \-soption causes.I emuitself to trap, permitting debugging of thebroken host operating system process that results when a trap occurs.(This is intended to allow debugging of.IR emu ,not Inferno applications.).TP.BI \-p pool = maxsizeSpecify the maximum size in bytes of the named memory allocation pool.The poolsare:.RS.TP \w'imagexxx'u.B mainthe general malloc arena.TP.B heapthe Dis virtual machine heap.TP.B imageimage storage for the display.RE.TP.B \-7When host graphics is provided by X11, request a 7-bit colour map;use this option only if X11 refused to allow.I emuto configure the normal (default) 8-bit Inferno colour map..TP.B \-C channelUse the given channel for the display if possible. For example, k8 gives8 bit greyscale. See .IR image (6)for the full range of channel descriptors..TP.B \-SForce stylus input behaviour for Tk mouse events:motion events are received only when a button is down(just as a stylus produces no events until it touches the screen).This option only affects the behaviour of Tk mouse events, it does notaffect the behaviour of.B /dev/pointeras described in .IR cons (3)..TP.B \-vPrint version data: edition and revision date..PPOptions may also be set in the host operating system's environment variable.BR EMU ;they are overridden by options supplied on the command line..PP.I Emufinds the host system directory that will serve as its Inferno root directoryas the last value found as follows:it is the value built-in to the executable, by default; orthe value of the host system's environment variable.BR INFERNO ;or the value of the environment variable.BR ROOT ;or the value of a.B -roption in the environment variable.BR EMU ;or the.I rootpathset by a.B -roption to the.I emucommand itself..SH EXAMPLETo start.B wm/logondirectly:.IP.EXEMU='-g800x600 -c1'emu /dis/wm/wm.dis wm/logon -u inferno.EE.SH FILES.TF /dis/emuinit.dis.TP.B /dis/emuinit.disThe default initialisation program..TP.B /dis/sh.disThe default Inferno shell..SH SOURCE.B /emu.SH "SEE ALSO".IR limbo (1),.IR wm-misc (1)