.TH EMU 1E.SH NAMEemu \- Inferno emulator (hosted Inferno).SH SYNOPSIS.B emu[.BI \-g " Xsize x Ysize"][.BI \-c n][.BI -d " daemon"].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,otherwise known as `hosted Inferno'.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 \-d " daemon"Run .I emuas a server, invoking.I daemoninstead of.BR /dis/emuinit.dis ,and disablinginput from.B cons(see.IR cons (3))..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.I channelfor the display, if possible.See.IR image (6)for the full range of channel descriptors.For example,.B k8gives 8 bit greyscale, and.B x8r8g8b8gives 24 bit colour on a PC.The set of channels supported is platform-dependent..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..PP.I Emusets several Inferno environment variables:.TF emuwdirxxx.PD.TP.B cputypehost processor architecture:.B 386(for any x86),.BR arm ,.BR mips ,.B power(any Power or PowerPC),.BR sparc ,and.BR spim(little-endian MIPS)..TP.B emuargsarguments with which.I emuwas invoked.TP.B emuhosthost operating system type, such as:.BR FreeBSD ,.BR Irix ,.BR Linux ,.BR MacOSX ,.BR NetBSD ,.BR Nt(used for Windows generally),.BR OpenBSD ,.BR Plan9 ,.B Solarisand.BR Unixware ..TP.B emurootname of directory in host file system that acts as Inferno's root directory.TP.B emuwdirname in host file system of directory where.I emuwas invoked.PD.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)