--- trunk/man/gxemul.1 2007/10/08 16:18:06 5 +++ trunk/man/gxemul.1 2007/10/08 16:18:11 6 @@ -1,4 +1,4 @@ -.\" $Id: gxemul.1,v 1.14 2005/04/16 02:38:21 debug Exp $ +.\" $Id: gxemul.1,v 1.21 2005/06/03 23:14:52 debug Exp $ .\" .\" Copyright (C) 2004-2005 Anders Gavare. All rights reserved. .\" @@ -29,7 +29,7 @@ .\" This is a minimal man page for GXemul. Process this file with .\" groff -man -Tascii gxemul.1 or nroff -man gxemul.1 .\" -.Dd APRIL 2005 +.Dd JUNE 2005 .Dt GXEMUL 1 .Os .Sh NAME @@ -51,7 +51,7 @@ to run binary code for (among others) MIPS-based machines. Several emulation modes are available. For some emulation modes, processors and surrounding hardware components are emulated well enough to let -unmodified operating systems (eg NetBSD) run as if they were running on a +unmodified operating systems (eg. NetBSD) run as if they were running on a real machine. .Pp There are three ways to invoke the emulator. When emulating a @@ -78,14 +78,19 @@ .Fl H to get a list of available emulation modes. .Pp -(There is an exception to the normal invocation usage mentioned above; -if you want to use the DECstation emulation mode, and have a bootable +There are two exceptions to the normal invocation usage mentioned above. +The first is for DECstation emulation: if you have a bootable DECstation harddisk or CDROM image, then just supplying the diskimage via the .Fl d -option is sufficient. The filename of the kernel can then be +option is sufficient. (The filename of the kernel can then be skipped, as the emulator runs the bootblocks from the diskimage directly and doesn't need the kernel as a separate file.) +The second is if you supply an ISO9660 CDROM disk image. You may then use +the +.Fl j +option to indicate which file on the CDROM filesystem that should be +loaded into emulated memory. .Pp Machine selection options: .Bl -tag -width Ds @@ -108,7 +113,7 @@ .It Fl B Disable dynamic binary translation completely. By default, bintrans will be turned on if the host architecture supports it. -However, in this release (0.3.1), there is no new bintrans system. +However, in this release (0.3.X), there is no new bintrans system. If you want to enable binary translation, use .Fl "b". .It Fl b @@ -126,7 +131,7 @@ as a disk image. By adding one or more modifier characters and then a colon (":") as a prefix to .Ar "name", -you can modify the disk image's behaviour. Available modifiers are: +you can modify the way the disk image is treated. Available modifiers are: .Bl -tag -width Ds .It b Specifies that this is a boot device. @@ -136,6 +141,9 @@ DISK (this is the default). .It f FLOPPY. +.It gH;S; +Override the default geometry; use H heads and S sectors-per-track. +(The number of cylinders is calculated automatically.) .It i IDE. .It r @@ -145,12 +153,20 @@ .It t Tape. .It 0-7 -Force a specific SCSI ID number. +Force a specific ID number. .El .Pp -Filenames ending with ".iso" are assumed to be CDROM images. Files with a -size of exactly 1.44 MB are assumed to be floppy images. All others -are assumed to be disks. +Unless otherwise specified, filenames ending with ".iso" are assumed to be +CDROM images. Most others are assumed to be disks. Depending on which +machine is being emulated, the default for disks can be either SCSI or +IDE. Some disk images that are very small are assumed to be floppy disks. +(If you are not happy with the way a disk image is detected, then you need +to use explicit prefixes to force a specific type.) +.Pp +For floppies, the gH;S; prefix is ignored. Instead, the number of +heads and cylinders are assumed to be 2 and 80, respectively, and the +number of sectors per track is calculated automatically. (This works for +720KB, 1.2MB, 1.44MB, and 2.88MB floppies.) .It Fl I Ar x Emulate clock interrupts at .Ar x @@ -164,8 +180,10 @@ .It Fl j Ar n Set the name of the kernel to .Ar "n". -Useful names are "bsd" for OpenBSD/pmax, or "vmunix" for Ultrix. -("netbsd" is usually the default value.) +When booting from an ISO9660 filesystem, the kernel will try to boot from +this file. (In some emulation modes, eg. DECstation, this name is passed +along to the boot program. Useful names are "bsd" for OpenBSD/pmax, +or "vmunix" for Ultrix.) .It Fl M Ar m Emulate .Ar m @@ -186,9 +204,9 @@ Set the boot argument (for DEC, ARC, or SGI emulation). Default .Ar arg -for DEC is '-a', for ARC '-aN'. +for DEC is "-a", for ARC "-aN". .It Fl p Ar pc -Add a breakpoint (remember to use the '0x' prefix for hex). +Add a breakpoint. (Remember to use the "0x" prefix for hex.) .It Fl Q Disable the built-in PROM emulation. This is useful for running raw ROM images from real machines. @@ -242,12 +260,13 @@ General options: .Bl -tag -width Ds .It Fl D -Guarantee fully deterministic behaviour. Normally, the emulator calls +Guarantee fully deterministic behavior. Normally, the emulator calls srandom() with a seed based on the current time at startup. When the .Fl D option is used, the srandom() call is skipped, which should cause two -subsequent invokations of the emulator to be identical, if all other -settings are identical. (If this option is used, then +subsequent invocations of the emulator to be identical, if all other +settings are identical and no user input is taking place. (If this option +is used, then .Fl I must also be used.) .It Fl H @@ -313,8 +332,7 @@ .Nm source distribution, some are indirectly mentioned in the TODO file. .Pp -There is no new bintrans system in this release (0.3.1), so you will -need to add +There is no new bintrans system in this release, so you will need to add .Fl b to select the old bintrans system, if you want speed. .Pp @@ -322,6 +340,9 @@ does not simulate individual pipe-line stages or penalties caused by branch-prediction misses, so it cannot be used for accurate performance measurement. +.Pp +.Nm +is not timing-accurate. .Sh AUTHOR Anders Gavare .Pp