/[gxemul]/trunk/man/gxemul.1
This is repository of my old source code which isn't updated any more. Go to git.rot13.org for current projects!
ViewVC logotype

Diff of /trunk/man/gxemul.1

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 32 by dpavlin, Mon Oct 8 16:20:58 2007 UTC revision 34 by dpavlin, Mon Oct 8 16:21:17 2007 UTC
# Line 1  Line 1 
1  .\" $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 $
2  .\"  .\"
3  .\" Copyright (C) 2004-2006  Anders Gavare.  All rights reserved.  .\" Copyright (C) 2004-2007  Anders Gavare.  All rights reserved.
4  .\"  .\"
5  .\" Redistribution and use in source and binary forms, with or without  .\" Redistribution and use in source and binary forms, with or without
6  .\" modification, are permitted provided that the following conditions are met:  .\" modification, are permitted provided that the following conditions are met:
# Line 29  Line 29 
29  .\" This is a minimal man page for GXemul. Process this file with  .\" This is a minimal man page for GXemul. Process this file with
30  .\"     groff -man -Tascii gxemul.1    or    nroff -man gxemul.1  .\"     groff -man -Tascii gxemul.1    or    nroff -man gxemul.1
31  .\"  .\"
32  .Dd NOVEMBER 2006  .Dd FEBRUARY 2007
33  .Dt GXEMUL 1  .Dt GXEMUL 1
34  .Os  .Os
35  .Sh NAME  .Sh NAME
# Line 56  real machine. Line 56  real machine.
56  .Pp  .Pp
57  Processors (ARM, MIPS, PowerPC, SuperH) are emulated using dynamic translation.  Processors (ARM, MIPS, PowerPC, SuperH) are emulated using dynamic translation.
58  However, unlike some other dynamically translating emulators, GXemul does  However, unlike some other dynamically translating emulators, GXemul does
59  not currently generate native code, only a "runnable intermediate  not need to generate native code, only a "runnable intermediate
60  representation", and will thus run on any host architecture, without the  representation", and will thus run on any host architecture, without the
61  need to implement per-architecture backends.  need to implement per-architecture backends.
62  .Pp  .Pp
# Line 89  from SGI. Use Line 89  from SGI. Use
89  .Fl H  .Fl H
90  to get a list of available emulation modes.  to get a list of available emulation modes.
91  .Pp  .Pp
92  There are two exceptions to the normal invocation usage mentioned above.  There are three exceptions to the normal invocation usage mentioned above.
93  The first is for DECstation emulation: if you have a bootable  .Pp
94  DECstation harddisk or CDROM image, then just supplying the diskimage via  1. For DECstation emulation, if you have a bootable DECstation harddisk or
95  the  CDROM image, then just supplying the diskimage via the
96  .Fl d  .Fl d
97  option is sufficient. (The filename of the kernel can then be  option is sufficient. The filename of the kernel can then be
98  skipped, as the emulator runs the bootblocks from the diskimage directly and  skipped, as the emulator runs the bootblocks from the diskimage directly and
99  doesn't need the kernel as a separate file.)  doesn't need the kernel as a separate file.
100  The second is if you supply an ISO9660 CDROM disk image. You may then use  .Pp
101  the  2. If you supply an ISO9660 CDROM disk image, then using the
102  .Fl j  .Fl j
103  option to indicate which file on the CDROM filesystem that should be  option to indicate a file on the CDROM filesystem to load is sufficient;
104  loaded into emulated memory.  no additional kernel filename needs to be supplied on the command line.
105    .Pp
106    3. For Dreamcast emulation, when booting e.g. a NetBSD/dreamcast CDROM
107    image, it is enough to supply the disk image (with the correct ISO
108    partition start offset). Bootblocks will be read directly from the CDROM
109    image, and there is no need to supply the name of an external kernel on
110    the command line.
111  .Pp  .Pp
112  Gzipped kernels are automatically unzipped, by calling the external gunzip  Gzipped kernels are automatically unzipped, by calling the external gunzip
113  program, both when specifying a gzipped file directly on the command line  program, both when specifying a gzipped file directly on the command line
# Line 158  Override the default geometry; use H hea Line 164  Override the default geometry; use H hea
164  (The number of cylinders is calculated automatically.)  (The number of cylinders is calculated automatically.)
165  .It i  .It i
166  IDE. (This is the default for most machine types.)  IDE. (This is the default for most machine types.)
167    .It oOFS;
168    Set the base offset for an ISO9660 filesystem on a disk image. The default
169    is 0. A suitable offset when booting from Dreamcast ISO9660 filesystem
170    images, which are offset by 11702 sectors, is 23965696.
171  .It r  .It r
172  Read-only (don't allow changes to be written to the file).  Read-only (don't allow changes to be written to the file).
173  .It s  .It s
# Line 304  Disabled at startup. Line 314  Disabled at startup.
314  Overwrite the file, instead of appending to it.  Overwrite the file, instead of appending to it.
315  .El  .El
316  .Pp  .Pp
317  .\" Statistics gathering can be enabled/disabled at runtime by using the  Statistics gathering can be enabled/disabled at runtime by using the
318  .\" "TODO" debugger command.  "statistics_enabled = yes" and "statistics_enabled = no" debugger
319  .\" .Pp  commands.
320    .Pp
321  When gathering instruction statistics using the  When gathering instruction statistics using the
322  .Fl s  .Fl s
323  option, instruction combinations are always disabled (i.e.  option, instruction combinations and native code generation
324  an implicit  are always disabled (i.e. implicit
325  .Fl J  .Fl J
326  is added to the command line).  and
327    .Fl B
328    flags are added to the command line).
329  .Pp  .Pp
330  If a value is missing (e.g. the end-of-page slot does not really have a  If a value is missing (e.g. the end-of-page slot does not really have a
331  known physical address), it is written out as just a dash ("-").  known physical address), it is written out as just a dash ("-").
332    .It Fl T
333    Halt if the emulated program attempts to access non-existing memory.
334  .It Fl t  .It Fl t
335  Show a trace tree of all function calls being made.  Show a trace tree of all function calls being made.
336  .It Fl U  .It Fl U
# Line 370  as an X11 display to use for framebuffer Line 385  as an X11 display to use for framebuffer
385  .\" .Pp  .\" .Pp
386  General options:  General options:
387  .Bl -tag -width Ds  .Bl -tag -width Ds
388    .It Fl b
389    Enable native code generation at runtime. This is not really implemented
390    yet. Don't use it unless you know what you are doing. It will most
391    likely not work.
392    .It Fl B
393    Disable native code generation at runtime. (This is the default in
394    GXemul 0.4.4; there are no implemented native code generation backends.)
395  .It Fl c Ar cmd  .It Fl c Ar cmd
396  Add  Add
397  .Ar cmd  .Ar cmd
# Line 393  emulation is not included in stable rele Line 415  emulation is not included in stable rele
415  yet.)  yet.)
416  .It Fl h  .It Fl h
417  Display a list of all available command line options.  Display a list of all available command line options.
418    .It Fl k Ar n
419    Set the size of the dyntrans cache (per emulated CPU) to
420    .Ar n
421    MB. The default size is 32 MB.
422  .It Fl K  .It Fl K
423  Force the single-step debugger to be entered at the end of a simulation.  Force the single-step debugger to be entered at the end of a simulation.
424  .It Fl q  .It Fl q
# Line 482  real-world processor. Line 508  real-world processor.
508  .Nm  .Nm
509  is in general not timing-accurate. Some emulation modes  is in general not timing-accurate. Some emulation modes
510  (DECstation, CATS, NetWinder, MobilePro (hpcmips), Malta (evbmips),  (DECstation, CATS, NetWinder, MobilePro (hpcmips), Malta (evbmips),
511  Cobalt, Algor, and Dreamcast) try to make the guest  Cobalt, Algor, Dreamcast, PICA-61, and IQ80321) try to make the guest
512  operating system's clock run at the same speed as the host clock.  operating system's clock run at the same speed as the host clock.
513  However, the number of instructions executed per clock tick can  However, the number of instructions executed per clock tick can
514  obviously vary, depending on the current CPU load on the host.  obviously vary, depending on the current CPU load on the host.
515  .Sh AUTHOR  .Sh AUTHOR
516  GXemul is Copyright (C) 2003-2006 Anders Gavare <anders@gavare.se>  GXemul is Copyright (C) 2003-2007 Anders Gavare <anders@gavare.se>
517  .Pp  .Pp
518  See http://gavare.se/gxemul/ for more information. For other Copyright  See http://gavare.se/gxemul/ for more information. For other Copyright
519  messages, see the corresponding parts of the source code and/or  messages, see the corresponding parts of the source code and/or
Legend:
Removed from v.32  
changed lines
  Added in v.34
  ViewVC Help
Powered by ViewVC 1.1.26