Initial revision
[gpxe.git] / contrib / bochs / bochsrc.txt
1 # You many now use double quotes around pathnames, in case
2 # your pathname includes spaces.
3
4 #=======================================================================
5 # CONFIG_INTERFACE
6 #
7 # The configuration interface is a series of menus or dialog boxes that
8 # allows you to change all the settings that control Bochs's behavior.
9 # There are two choices of configuration interface: a text mode version
10 # called "textconfig" and a graphical version called "wx".  The text
11 # mode version uses stdin/stdout and is always compiled in.  The graphical
12 # version is only available when you use "--with-wx" on the configure 
13 # command.  If you do not write a config_interface line, Bochs will 
14 # choose a default for you.
15 #
16 # NOTE: if you use the "wx" configuration interface, you must also use
17 # the "wx" display library.
18 #=======================================================================
19 #config_interface: textconfig
20 #config_interface: wx
21
22 #=======================================================================
23 # DISPLAY_LIBRARY
24 #
25 # The display library is the code that displays the Bochs VGA screen.  Bochs 
26 # has a selection of about 10 different display library implementations for 
27 # different platforms.  If you run configure with multiple --with-* options, 
28 # the display_library command lets you choose which one you want to run with.
29 # If you do not write a display_library line, Bochs will choose a default for
30 # you.
31 #
32 # The choices are: 
33 #   x              use X windows interface, cross platform
34 #   win32          use native win32 libraries
35 #   carbon         use Carbon library (for MacOS X)
36 #   beos           use native BeOS libraries
37 #   macintosh      use MacOS pre-10
38 #   amigaos        use native AmigaOS libraries
39 #   sdl            use SDL library, cross platform
40 #   svga           use SVGALIB library for Linux, allows graphics without X11
41 #   term           text only, uses curses/ncurses library, cross platform
42 #   rfb            provides an interface to AT&T's VNC viewer, cross platform
43 #   wx             use wxWindows library, cross platform
44 #   nogui          no display at all
45 #
46 # NOTE: if you use the "wx" configuration interface, you must also use
47 # the "wx" display library.
48 #=======================================================================
49 #display_library: amigaos
50 #display_library: beos
51 #display_library: carbon
52 #display_library: macintosh
53 #display_library: nogui
54 #display_library: rfb
55 #display_library: sdl
56 #display_library: term
57 #display_library: win32
58 #display_library: wx
59 #display_library: x
60
61 #=======================================================================
62 # ROMIMAGE:
63 # You now need to load a ROM BIOS into F0000-FFFFF.  I've wiped
64 # out most of the BIOS hooks, and replace them with real BIOS
65 # support.  Normally, you can use a precompiled BIOS in the bios/
66 # directory, named BIOS-bochs-latest. 
67 #=======================================================================
68 #romimage: bios/BIOS-bochs-970717a
69 #romimage: file=bios/BIOS-bochs-latest, address=0xf0000
70 romimage: file=$BXSHARE/BIOS-bochs-latest, address=0xf0000
71 #romimage: file=bios/BIOS-bochs-2-processors, address=0xf0000
72 #romimage: file=bios/BIOS-bochs-4-processors, address=0xf0000
73 #romimage: file=bios/rombios.bin, address=0xf0000
74
75 #=======================================================================
76 # MEGS
77 # set this to the default number of Megabytes of memory you want
78 # to emulate.  You may also pass the '-megs xyz' option to bochs
79 #
80 # The default is 32MB, most OS's won't need more than that. 
81 #=======================================================================
82 #megs: 256
83 #megs: 128
84 #megs: 64
85 megs: 32
86 #megs: 16
87 #megs: 8
88
89 #=======================================================================
90 # OPTROMIMAGE[1-4]:
91 # You may now load up to 4 optional ROM images. Be sure to use a 
92 # read-only area, typically between C8000 and EFFFF. These optional
93 # ROM images should not overwrite the rombios (located at
94 # F0000-FFFFF) and the videobios (located at C0000-C7FFF).
95 # Those ROM images will be initialized by the bios if they contain 
96 # the right signature (0x55AA).
97 # It can also be a convenient way to upload some arbitary code/data
98 # in the simulation, that can be retrieved by the boot loader
99 #=======================================================================
100 #optromimage1: file=optionalrom.bin, address=0xd0000
101 #optromimage2: file=optionalrom.bin, address=0xd1000
102 #optromimage3: file=optionalrom.bin, address=0xd2000
103 #optromimage4: file=optionalrom.bin, address=0xd3000
104 #optromimage1: file=../../src/bin/ne.zrom, address=0xd0000
105 optromimage1: file=../../src/bin/pnic.zrom, address=0xd0000
106
107 #=======================================================================
108 # VGAROMIMAGE
109 # You now need to load a VGA ROM BIOS into C0000.
110 #=======================================================================
111 #vgaromimage: bios/VGABIOS-lgpl-latest
112 #vgaromimage: bios/VGABIOS-elpin-2.40
113 vgaromimage: $BXSHARE/VGABIOS-elpin-2.40
114
115 #=======================================================================
116 # FLOPPYA:
117 # Point this to pathname of floppy image file or device
118 # This should be of a bootable floppy(image/device) if you're 
119 # booting from 'a'.
120 #
121 # You can set the initial status of the media to 'ejected' or 'inserted'.
122 #   floppya: 2_88=path, status=ejected             (2.88M 3.5" floppy)
123 #   floppya: 1_44=path, status=inserted            (1.44M 3.5" floppy)
124 #   floppya: 1_2=path, status=ejected              (1.2M  5.25" floppy)
125 #   floppya: 720k=path, status=inserted            (720K  3.5" floppy)
126 #   floppya: 360k=path, status=inserted            (360K  5.25" floppy)
127 #
128 # The path should be the name of a disk image file.  On unix, you can use
129 # a raw device name such as /dev/fd0 on Linux.  On WinNT and Win2k, use
130 # drive letters such as a: or b: as the path.  Raw floppy access is not
131 # supported on Windows 95 and 98.
132 #=======================================================================
133 floppya: 1_44=/dev/fd0, status=inserted
134 #floppya: file=../1.44, status=inserted
135 #floppya: 1_44=/dev/fd0H1440, status=inserted
136 #floppya: 1_2=../1_2, status=inserted
137 #floppya: 1_44=a:, status=inserted
138 #floppya: 1_44=a.img, status=inserted
139
140 #=======================================================================
141 # FLOPPYB:
142 # See FLOPPYA above for syntax
143 #=======================================================================
144 #floppyb: 1_44=b:, status=inserted
145 floppyb: 1_44=b.img, status=inserted
146
147 #=======================================================================
148 # ATA0, ATA1, ATA2, ATA3
149 # ATA controller for hard disks and cdroms
150 #
151 # ata[0-3]: enabled=[0|1], ioaddr1=addr, ioaddr2=addr, irq=number
152
153 # These options enables up to 4 ata channels. For each channel
154 # the two base io address and the irq must be specified.
155
156 # ata0 is enabled by default, with ioaddr1=0x1f0, ioaddr2=0x3f0, irq=14
157 #
158 # Examples:
159 #   ata0: enabled=1, ioaddr1=0x1f0, ioaddr2=0x3f0, irq=14
160 #   ata1: enabled=1, ioaddr1=0x170, ioaddr2=0x370, irq=15
161 #   ata2: enabled=1, ioaddr1=0x1e8, ioaddr2=0x3e8, irq=11
162 #   ata3: enabled=1, ioaddr1=0x168, ioaddr2=0x368, irq=9
163 #=======================================================================
164 ata0: enabled=1, ioaddr1=0x1f0, ioaddr2=0x3f0, irq=14
165 ata1: enabled=0, ioaddr1=0x170, ioaddr2=0x370, irq=15
166 ata2: enabled=0, ioaddr1=0x1e8, ioaddr2=0x3e8, irq=11
167 ata3: enabled=0, ioaddr1=0x168, ioaddr2=0x368, irq=9
168
169 #=======================================================================
170 # ATA[0-3]-MASTER, ATA[0-3]-SLAVE
171 #
172 # This defines the type and characteristics of all attached ata devices:
173 #   type=       type of attached device [disk|cdrom] 
174 #   path=       path of the image
175 #   cylinders=  only valid for disks
176 #   heads=      only valid for disks
177 #   spt=        only valid for disks
178 #   status=     only valid for cdroms [inserted|ejected]
179 #   biosdetect= type of biosdetection [none|auto], only for disks on ata0 [cmos]
180 #   translation=type of transation of the bios, only for disks [none|lba|large|rechs|auto]
181 #   model=      string returned by identify device command
182 #   
183 # Point this at a hard disk image file, cdrom iso file, or physical cdrom
184 # device.  To create a hard disk image, try running bximage.  It will help you
185 # choose the size and then suggest a line that works with it.
186 #
187 # In UNIX it may be possible to use a raw device as a Bochs hard disk, 
188 # but WE DON'T RECOMMEND IT.  In Windows there is no easy way.
189 #
190 # In windows, the drive letter + colon notation should be used for cdroms.
191 # Depending on versions of windows and drivers, you may only be able to 
192 # access the "first" cdrom in the system.  On MacOSX, use path="drive"
193 # to access the physical drive.
194 #
195 # The path, cylinders, heads, and spt are mandatory for type=disk
196 # The path is mandatory for type=cdrom
197 #
198 # Default values are:
199 #   biosdetect=auto, translation=auto, model="Generic 1234"
200 #
201 # The biosdetect option has currently no effect on the bios
202 #
203 # Examples:
204 #   ata0-master: type=disk, path=10M.sample, cylinders=306, heads=4, spt=17
205 #   ata0-slave:  type=disk, path=20M.sample, cylinders=615, heads=4, spt=17
206 #   ata1-master: type=disk, path=30M.sample, cylinders=615, heads=6, spt=17
207 #   ata1-slave:  type=disk, path=46M.sample, cylinders=940, heads=6, spt=17
208 #   ata2-master: type=disk, path=62M.sample, cylinders=940, heads=8, spt=17
209 #   ata2-slave:  type=disk, path=112M.sample, cylinders=900, heads=15, spt=17
210 #   ata3-master: type=disk, path=483M.sample, cylinders=1024, heads=15, spt=63
211 #   ata3-slave:  type=cdrom, path=iso.sample, status=inserted
212 #=======================================================================
213 #ata0-master: type=disk, path="30M.sample", cylinders=615, heads=6, spt=17
214 #ata0-slave: type=cdrom, path=D:, status=inserted
215 #ata0-slave: type=cdrom, path=/dev/cdrom, status=inserted
216 #ata0-slave: type=cdrom, path="drive", status=inserted
217
218 #=======================================================================
219 #
220 # The DISKC option is deprecated. Use ATA* options instead.
221 #
222 # DISKC: file=, cyl=, heads=, spt=
223 # Point this at a hard disk image file.  To create 
224 # a hard disk image, try running bximage.  It will help you choose the
225 # size and then suggest a diskc line that works with it.
226 #
227 # In UNIX it may be possible to use a raw device as a Bochs hard disk, 
228 # but WE DON'T RECOMMEND IT.  In Windows there is no easy way.
229 #
230 # Examples:
231 #   diskc: file=10M.sample, cyl=306, heads=4, spt=17
232 #   diskc: file=20M.sample, cyl=615, heads=4, spt=17
233 #   diskc: file=30M.sample, cyl=615, heads=6, spt=17
234 #   diskc: file=46M.sample, cyl=940, heads=6, spt=17
235 #   diskc: file=62M.sample, cyl=940, heads=8, spt=17
236 #   diskc: file=112M.sample, cyl=900, heads=15, spt=17
237 #   diskc: file=483M.sample, cyl=1024, heads=15, spt=63
238 #=======================================================================
239 #diskc: file="30M.sample", cyl=615, heads=6, spt=17
240
241 #=======================================================================
242 #
243 # The DISKD option is deprecated. Use ATA* options instead.
244 #
245 # DISKD:
246 # See DISKC above for syntax
247 #
248 # NOTE: diskd and cdromd must not be used together!
249 #=======================================================================
250 #diskd: file="diskd.img", cyl=615, heads=6, spt=17
251
252 #=======================================================================
253 #
254 # The CDROMD option is deprecated. Use ATA* options instead.
255 #
256 # CDROMD:
257 #
258 # cdromd: dev=/dev/cdrom, status=inserted
259 # cdromd: dev=/dev/cdrom, status=ejected
260 # cdromd: dev=e:, status=ejected
261 #
262 # In windows, the drive letter + colon notation should be used for cdroms.
263 # Depending on versions of windows and drivers, you may only be able to 
264 # access the "first" cdrom in the system.  On MacOSX, use path="drive"
265 # to access the physical drive.
266 #
267 # NOTE: diskd and cdromd must not be used together!
268 #=======================================================================
269 #cdromd: dev=D:, status=inserted
270 #cdromd: dev=/dev/cdrom, status=inserted
271 #cdromd: dev="drive", status=inserted
272
273 #=======================================================================
274 # NEWHARDDRIVESUPPORT: enabled=[0|1]
275 # As of cvs version on 5/17/2001, newharddrivesupport is on by default.
276 #=======================================================================
277 #newharddrivesupport: enabled=1
278
279 #=======================================================================
280 # BOOT:
281 # This defines your boot drive.  
282 # You can either boot from 'floppy', 'disk' or 'cdrom'
283 # legacy 'a' and 'c' are also supported
284 # Examples:
285 #   boot: floppy
286 #   boot: disk
287 #   boot: cdrom
288 #   boot: c
289 #   boot: a
290 #=======================================================================
291 #boot: floppy
292 #boot: disk
293
294 #=======================================================================
295 # FLOPPY_BOOTSIG_CHECK: disabled=[0|1]
296 # Enables or disables the 0xaa55 signature check on boot floppies
297 # Defaults to disabled=0
298 # Examples:
299 #   floppy_bootsig_check: disabled=0
300 #   floppy_bootsig_check: disabled=1
301 #=======================================================================
302 #floppy_bootsig_check: disabled=1
303 floppy_bootsig_check: disabled=0
304
305 #=======================================================================
306 # LOG:
307 # Give the path of the log file you'd like Bochs debug and misc. verbage
308 # to be written to.  If you really don't want it, make it /dev/null. :^(
309 #
310 # Examples:
311 #   log: ./bochs.out
312 #   log: /dev/tty
313 #=======================================================================
314 #log: /dev/null
315 log: bochsout.txt
316
317 #=======================================================================
318 # LOGPREFIX:
319 # This handles the format of the string prepended to each log line.
320 # You may use those special tokens :
321 #   %t : 11 decimal digits timer tick
322 #   %i : 8 hexadecimal digits of cpu0 current eip
323 #   %e : 1 character event type ('i'nfo, 'd'ebug, 'p'anic, 'e'rror)
324 #   %d : 5 characters string of the device, between brackets
325
326 # Default : %t%e%d
327 # Examples:
328 #   logprefix: %t-%e-@%i-%d
329 #   logprefix: %i%e%d
330 #=======================================================================
331 #logprefix: %t%e%d
332
333 #=======================================================================
334 # LOG CONTROLS
335 #
336 # Bochs now has four severity levels for event logging.
337 #   panic: cannot proceed.  If you choose to continue after a panic, 
338 #          don't be surprised if you get strange behavior or crashes.
339 #   error: something went wrong, but it is probably safe to continue the
340 #          simulation.
341 #   info: interesting or useful messages.
342 #   debug: messages useful only when debugging the code.  This may
343 #          spit out thousands per second.
344 #
345 # For events of each level, you can choose to crash, report, or ignore.
346 # TODO: allow choice based on the facility: e.g. crash on panics from
347 #       everything except the cdrom, and only report those.
348 #
349 # If you are experiencing many panics, it can be helpful to change
350 # the panic action to report instead of fatal.  However, be aware
351 # that anything executed after a panic is uncharted territory and can 
352 # cause bochs to become unstable.  The panic is a "graceful exit," so
353 # if you disable it you may get a spectacular disaster instead.
354 #=======================================================================
355 panic: action=ask
356 error: action=report
357 info: action=report
358 debug: action=ignore
359
360 #=======================================================================
361 # DEBUGGER_LOG:
362 # Give the path of the log file you'd like Bochs to log debugger output.
363 # If you really don't want it, make it /dev/null or '-'. :^(
364 #
365 # Examples:
366 #   debugger_log: ./debugger.out
367 #=======================================================================
368 #debugger_log: /dev/null
369 #debugger_log: debugger.out
370 debugger_log: -
371
372 #=======================================================================
373 # com1:
374 # This defines a serial (COM) port. You can specify a device to use as com1.
375 # This can be a real serial line, or a pty.  To use a pty (under X/Unix),
376 # create two windows (xterms, usually).  One of them will run bochs, and the
377 # other will act as com1. Find out the tty the com1 window using the `tty'
378 # command, and use that as the `dev' parameter.  Then do `sleep 1000000' in
379 # the com1 window to keep the shell from messing with things, and run bochs in
380 # the other window.  Serial I/O to com1 (port 0x3f8) will all go to the other
381 # window.
382 #=======================================================================
383 #com1: enabled=1, dev=/dev/ttyp9
384 #com1: enabled=1, dev=/tmp/serial.log
385
386
387 #=======================================================================
388 # PARPORT1:
389 # This defines a parallel (printer) port. When turned on and an output file is
390 # defined the emulated printer port sends characters printed by the guest OS
391 # into the output file. On some platforms a device filename can be used to
392 # send the data to the real parallel port (e.g. "/dev/lp0" on Linux, "lpt1" on
393 # win32 platforms).
394 #
395 # Examples:
396 #   parport1: enabled=1, file="parport.out"
397 #   parport1: enabled=1, file="/dev/lp0"
398 #   parport1: enabled=0
399 #=======================================================================
400 parport1: enabled=1, file="parport.out"
401
402 #=======================================================================
403 # SB16:
404 # This defines the SB16 sound emulation. It can have several of the
405 # following properties.
406 # All properties are in the format sb16: property=value
407 # midi: The filename is where the midi data is sent. This can be a
408 #       device or just a file if you want to record the midi data.
409 # midimode:
410 #      0=no data
411 #      1=output to device (system dependent. midi denotes the device driver)
412 #      2=SMF file output, including headers
413 #      3=output the midi data stream to the file (no midi headers and no
414 #        delta times, just command and data bytes)
415 # wave: This is the device/file where wave output is stored
416 # wavemode:
417 #      0=no data
418 #      1=output to device (system dependent. wave denotes the device driver)
419 #      2=VOC file output, incl. headers
420 #      3=output the raw wave stream to the file
421 # log:  The file to write the sb16 emulator messages to.
422 # loglevel:
423 #      0=no log
424 #      1=only midi program and bank changes
425 #      2=severe errors
426 #      3=all errors
427 #      4=all errors plus all port accesses
428 #      5=all errors and port accesses plus a lot of extra info
429 # dmatimer:
430 #      microseconds per second for a DMA cycle.  Make it smaller to fix
431 #      non-continous sound.  750000 is usually a good value.  This needs a
432 #      reasonably correct setting for IPS.
433 #
434 # For an example look at the next line:
435 #=======================================================================
436
437 #sb16: midimode=1, midi=/dev/midi00, wavemode=1, wave=/dev/dsp, loglevel=2, log=sb16.log, dmatimer=600000
438
439 #=======================================================================
440 # VGA_UPDATE_INTERVAL:
441 # Video memory is scanned for updates and screen updated every so many
442 # virtual seconds.  The default is 300000, about 3Hz.  This is generally
443 # plenty.  Keep in mind that you must tweak the 'ips:' directive
444 # to be as close to the number of emulated instructions-per-second
445 # your workstation can do, for this to be accurate.
446 #
447 # Examples:
448 #   vga_update_interval: 250000
449 #=======================================================================
450 vga_update_interval: 300000
451
452 # using for Winstone '98 tests
453 #vga_update_interval:  100000
454
455 #=======================================================================
456 # KEYBOARD_SERIAL_DELAY:
457 # Approximate time in microseconds that it takes one character to
458 # be transfered from the keyboard to controller over the serial path.
459 # Examples:
460 #   keyboard_serial_delay: 200
461 #=======================================================================
462 keyboard_serial_delay: 250
463
464 #=======================================================================
465 # KEYBOARD_PASTE_DELAY:
466 # Approximate time in microseconds between attempts to paste
467 # characters to the keyboard controller. This leaves time for the
468 # guest os to deal with the flow of characters.  The ideal setting
469 # depends on how your operating system processes characters.  The
470 # default of 100000 usec (.1 seconds) was chosen because it works 
471 # consistently in Windows.
472 #
473 # If your OS is losing characters during a paste, increase the paste
474 # delay until it stops losing characters.
475 #
476 # Examples:
477 #   keyboard_paste_delay: 100000
478 #=======================================================================
479 keyboard_paste_delay: 100000
480
481 #=======================================================================
482 # FLOPPY_COMMAND_DELAY:
483 # Time in microseconds to wait before completing some floppy commands
484 # such as read/write/seek/etc, which normally have a delay associated.
485 # I had this hardwired to 50,000 before.
486 #
487 # Examples:
488 #   floppy_command_delay: 50000
489 #=======================================================================
490 floppy_command_delay: 500
491
492 #=======================================================================
493 # IPS:
494 # Emulated Instructions Per Second.  This is the number of IPS that bochs
495 # is capable of running on your machine.  Read the note in config.h
496 # on how to find this.  Make sure to recompile after.
497 #
498 # IPS is used to calibrate many time-dependent events within the bochs 
499 # simulation.  For example, changing IPS affects the frequency of VGA
500 # updates, the duration of time before a key starts to autorepeat, and 
501 # the measurement of BogoMips and other benchmarks.
502 #
503 # Examples:
504 # Machine                                         Mips
505 # ________________________________________________________________
506 # 650Mhz Athlon K-7 with Linux 2.4.4/egcs-2.91.66 2 to 2.5 Mips
507 # 400Mhz Pentium II with Linux 2.0.36/egcs-1.0.3  1 to 1.8 Mips
508 # 166Mhz 64bit Sparc with Solaris 2.x             approx 0.75 Mips
509 # 200Mhz Pentium with Linux 2.x                   approx 0.5 Mips
510 #
511 #=======================================================================
512 ips: 1000000
513
514 #=======================================================================
515 # PIT:
516 # The PIT is the programmable interval timer.  It has an option that tries to
517 # keep the PIT in sync with real time.  This feature is still experimental,
518 # but it may be useful if you want to prevent Bochs from running too fast, for
519 # example a DOS video game.  Be aware that with the realtime pit option, your
520 # simulation will not be repeatable; this can a problem if you are debugging.
521 #=======================================================================
522 #pit: realtime=1
523
524 #=======================================================================
525 # mouse: Not used in any of the GUI specific modules, but the option
526 #        bx_options.mouse_enabled is set to this value.  The idea,
527 #        is that the GUI code should not generate mouse events when
528 #        not enabled.  The hardware emualation itself is not disabled
529 #        by this.  This is to facilitate deterministic runs of bochs.
530 #
531 # Examples:
532 #   mouse: enabled=1
533 #   mouse: enabled=0
534 #
535 # I wouldn't recommend enabling the mouse by default, unless you have a
536 # really good reason to do so.
537 #=======================================================================
538 mouse: enabled=0
539
540 #=======================================================================
541 # private_colormap: Request that the GUI create and use it's own
542 #                   non-shared colormap.  This colormap will be used
543 #                   when in the bochs window.  If not enabled, a
544 #                   shared colormap scheme may be used.  Not implemented
545 #                   on all GUI's.
546 #
547 # Examples:
548 #   private_colormap: enabled=1
549 #   private_colormap: enabled=0
550 #=======================================================================
551 private_colormap: enabled=0
552
553 #=======================================================================
554 # fullscreen: ONLY IMPLEMENTED ON AMIGA
555 #             Request that Bochs occupy the entire screen instead of a 
556 #             window.
557 #
558 # Examples:
559 #   fullscreen: enabled=0
560 #   fullscreen: enabled=1
561 #=======================================================================
562 fullscreen: enabled=0
563 screenmode: name="sample"
564
565 #=======================================================================
566 # ne2k: NE2000 compatible ethernet adapter
567 #
568 # Examples:
569 # ne2k: ioaddr=IOADDR, irq=IRQ, mac=MACADDR, ethmod=MODULE, ethdev=DEVICE, script=SCRIPT
570 #
571 # ioaddr, irq: You probably won't need to change ioaddr and irq, unless there
572 # are IRQ conflicts.
573 #
574 # mac: The MAC address MUST NOT match the address of any machine on the net.
575 # Also, the first byte must be an even number (bit 0 set means a multicast
576 # address), and you cannot use ff:ff:ff:ff:ff:ff because that's the broadcast
577 # address.  For the ethertap module, you must use fe:fd:00:00:00:01.  There may
578 # be other restrictions too.  To be safe, just use the b0:c4... address.
579 #
580 # ethdev: The ethdev value is the name of the network interface on your host
581 # platform.  On UNIX machines, you can get the name by running ifconfig.  On
582 # Windows machines, you must run niclist to get the name of the ethdev.
583 # Niclist source code is in misc/niclist.c and it is included in Windows 
584 # binary releases.
585 #
586 # script: The script value is optionnal, and is the name of a script that 
587 # is executed after bochs initialize the network interface. You can use 
588 # this script to configure this network interface, or enable masquerading.
589 # This is mainly useful for the tun/tap devices that only exist during
590 # Bochs execution. The network interface name is supplied to the script
591 # as first parameter
592 #=======================================================================
593 # ne2k: ioaddr=0x280, irq=9, mac=b0:c4:20:00:00:00, ethmod=fbsd, ethdev=xl0
594 # ne2k: ioaddr=0x280, irq=9, mac=b0:c4:20:00:00:00, ethmod=linux, ethdev=eth0
595 # ne2k: ioaddr=0x280, irq=9, mac=b0:c4:20:00:00:01, ethmod=win32, ethdev=MYCARD
596 # ne2k: ioaddr=0x280, irq=9, mac=fe:fd:00:00:00:01, ethmod=tap, ethdev=tap0
597 # ne2k: ioaddr=0x280, irq=9, mac=fe:fd:00:00:00:01, ethmod=tuntap, ethdev=tun0, script=./ifup.tun
598 # ne2k: ioaddr=0x280, irq=9, mac=fe:fd:00:00:00:01, ethmod=tuntap, ethdev=tun0
599
600 # Pseudo NIC adaptor.  The way bochs is structured at the moment means
601 # that you need to enable ne2k support in order to compile in any of
602 # the networking code.
603 pnic: ioaddr=0xdc00, irq=11, mac=fe:fd:00:00:00:01, ethmod=tuntap, ethdev=tun1, script=./ifup.tun
604
605 #=======================================================================
606 # KEYBOARD_MAPPING:
607 # This enables a remap of a physical localized keyboard to a 
608 # virtualized us keyboard, as the PC architecture expects.
609 # If enabled, the keymap file must be specified.
610
611 # Examples:
612 #   keyboard_mapping: enabled=1, map=gui/keymaps/x11-pc-de.map
613 #=======================================================================
614 keyboard_mapping: enabled=0, map=
615
616 #=======================================================================
617 # KEYBOARD_TYPE:
618 # Type of keyboard return by a "identify keyboard" command to the
619 # keyboard controler. It must be one of "xt", "at" or "mf".
620 # Defaults to "mf". It should be ok for almost everybody. A known
621 # exception is french macs, that do have a "at"-like keyboard.
622 #
623 # Examples:
624 #   keyboard_type: mf
625 #=======================================================================
626 #keyboard_type: mf
627
628 #=======================================================================
629 # USER_SHORTCUT:
630 # This defines the keyboard shortcut to be sent when you press the "user"
631 # button in the headerbar. The shortcut string can be a combination of
632 # these key names: "alt", "ctrl", "del", "esc", "f1", "f4", "tab", "win".
633 # Up to 3 keys can be pressed at a time.
634 #
635 # Example:
636 #   user_shortcut: keys=ctrlaltdel
637 #=======================================================================
638 user_shortcut: keys=ctrlaltdel
639
640 #=======================================================================
641 # other stuff
642 #=======================================================================
643 magic_break: enabled=1
644
645 #load32bitOSImage: os=nullkernel, path=../kernel.img, iolog=../vga_io.log
646 #load32bitOSImage: os=linux, path=../linux.img, iolog=../vga_io.log, initrd=../initrd.img
647 i440fxsupport: enabled=1
648 #time0: 938581955
649
650 #=======================================================================
651 # for Macintosh, use the style of pathnames in the following
652 # examples.
653 #
654 # vgaromimage: :bios:VGABIOS-elpin-2.20
655 # romimage: file=:bios:BIOS-bochs-981222a, address=0xf0000
656 # floppya: 1_44=[fd:], status=inserted
657 #=======================================================================
658