--- trunk/man/gxemul.1 2007/10/08 16:21:06 33 +++ trunk/man/gxemul.1 2007/10/08 16:21:17 34 @@ -1,6 +1,6 @@ -.\" $Id: gxemul.1,v 1.76 2006/11/04 06:40:20 debug Exp $ +.\" $Id: gxemul.1,v 1.85 2007/02/05 16:49:21 debug Exp $ .\" -.\" Copyright (C) 2004-2006 Anders Gavare. All rights reserved. +.\" Copyright (C) 2004-2007 Anders Gavare. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions are met: @@ -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 NOVEMBER 2006 +.Dd FEBRUARY 2007 .Dt GXEMUL 1 .Os .Sh NAME @@ -56,7 +56,7 @@ .Pp Processors (ARM, MIPS, PowerPC, SuperH) are emulated using dynamic translation. However, unlike some other dynamically translating emulators, GXemul does -not currently generate native code, only a "runnable intermediate +not need to generate native code, only a "runnable intermediate representation", and will thus run on any host architecture, without the need to implement per-architecture backends. .Pp @@ -89,19 +89,25 @@ .Fl H to get a list of available emulation modes. .Pp -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 +There are three exceptions to the normal invocation usage mentioned above. +.Pp +1. 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 +doesn't need the kernel as a separate file. +.Pp +2. If you supply an ISO9660 CDROM disk image, then using the .Fl j -option to indicate which file on the CDROM filesystem that should be -loaded into emulated memory. +option to indicate a file on the CDROM filesystem to load is sufficient; +no additional kernel filename needs to be supplied on the command line. +.Pp +3. For Dreamcast emulation, when booting e.g. a NetBSD/dreamcast CDROM +image, it is enough to supply the disk image (with the correct ISO +partition start offset). Bootblocks will be read directly from the CDROM +image, and there is no need to supply the name of an external kernel on +the command line. .Pp Gzipped kernels are automatically unzipped, by calling the external gunzip program, both when specifying a gzipped file directly on the command line @@ -158,6 +164,10 @@ (The number of cylinders is calculated automatically.) .It i IDE. (This is the default for most machine types.) +.It oOFS; +Set the base offset for an ISO9660 filesystem on a disk image. The default +is 0. A suitable offset when booting from Dreamcast ISO9660 filesystem +images, which are offset by 11702 sectors, is 23965696. .It r Read-only (don't allow changes to be written to the file). .It s @@ -304,18 +314,23 @@ Overwrite the file, instead of appending to it. .El .Pp -.\" Statistics gathering can be enabled/disabled at runtime by using the -.\" "TODO" debugger command. -.\" .Pp +Statistics gathering can be enabled/disabled at runtime by using the +"statistics_enabled = yes" and "statistics_enabled = no" debugger +commands. +.Pp When gathering instruction statistics using the .Fl s -option, instruction combinations are always disabled (i.e. -an implicit +option, instruction combinations and native code generation +are always disabled (i.e. implicit .Fl J -is added to the command line). +and +.Fl B +flags are added to the command line). .Pp If a value is missing (e.g. the end-of-page slot does not really have a known physical address), it is written out as just a dash ("-"). +.It Fl T +Halt if the emulated program attempts to access non-existing memory. .It Fl t Show a trace tree of all function calls being made. .It Fl U @@ -370,6 +385,13 @@ .\" .Pp General options: .Bl -tag -width Ds +.It Fl b +Enable native code generation at runtime. This is not really implemented +yet. Don't use it unless you know what you are doing. It will most +likely not work. +.It Fl B +Disable native code generation at runtime. (This is the default in +GXemul 0.4.4; there are no implemented native code generation backends.) .It Fl c Ar cmd Add .Ar cmd @@ -393,6 +415,10 @@ yet.) .It Fl h Display a list of all available command line options. +.It Fl k Ar n +Set the size of the dyntrans cache (per emulated CPU) to +.Ar n +MB. The default size is 32 MB. .It Fl K Force the single-step debugger to be entered at the end of a simulation. .It Fl q @@ -482,12 +508,12 @@ .Nm is in general not timing-accurate. Some emulation modes (DECstation, CATS, NetWinder, MobilePro (hpcmips), Malta (evbmips), -Cobalt, Algor, and Dreamcast) try to make the guest +Cobalt, Algor, Dreamcast, PICA-61, and IQ80321) try to make the guest operating system's clock run at the same speed as the host clock. However, the number of instructions executed per clock tick can obviously vary, depending on the current CPU load on the host. .Sh AUTHOR -GXemul is Copyright (C) 2003-2006 Anders Gavare +GXemul is Copyright (C) 2003-2007 Anders Gavare .Pp See http://gavare.se/gxemul/ for more information. For other Copyright messages, see the corresponding parts of the source code and/or