- update sector count before calling write completion function (SF patch #2144692)
[bochs-mirror.git] / doc / man / bochs.1
blob4e516f9bec0c99a8db173573fe592f276350f3ca
1 .\"Document Author:  Timothy R. Butler   -   tbutler@uninetsolutions.com"
2 .TH bochs 1 "29 Dec 2005" "bochs @version@" "The Bochs Project"
3 .\"SKIP_SECTION"
4 .SH NAME
5 bochs \- Portable x86 Emulator.
6 .\"SKIP_SECTION"
7 .SH SYNOPSIS
8 .B bochs
9 .RI \|[ bochs_options \|]
10 .RI \|[ bochsrc_options \|]
11 .\"SKIP_SECTION"
12 .SH DESCRIPTION
13 .LP
14 Bochs is a portable Intel Architecture  32 (x86) emulator
15 that runs on most popular  operating systems. Inside  the
16 emulator,  it  can  run  many operating systems including
17 Linux and Microsoft(R) Windows(R).
18 .\".\"DONT_SPLIT"
19 .SH OPTIONS
20 .LP
21 When you run bochs without one of the following options, it
22 will search for a configuration file called .bochsrc in
23 the current directory and your home directory and display
24 the start menu.
25 .TP
26 .BI \-q
27 With this option the start menu will be skipped after loading
28 the configuration file.
29 .TP
30 .BI \-f\ configfile
31 This option specifies the name of the configuration file.
32 .TP
33 .BI \-qf\ configfile
34 When you run bochs with this option, it will skip the start
35 menu and use the specified configuration file.
36 .TP
37 .BI \-n
38 With this option bochs doesn't load a configuration file.
39 In that case the setup for the emulation must be done with
40 bochsrc options on the command line or in the start menu.
41 .TP
42 .BI \-h,\ --help
43 Print a summary of the command line options for bochs and exit.
44 .LP
45 You can override the settings from the configuration file
46 with command line arguments, using the  same  syntax  as the
47 bochsrc file. If you have  any spaces in your command line
48 arguments, they should be enclosed  in  single quotes.
49 For information on Bochs command line and configuration
50 file arguments, see the man page
51 .B bochsrc(5).
53 Example:
54   bochs -q 'boot:a' 'floppya: 1_44=a.img, status=inserted'
56 .\"SKIP_SECTION"
57 .SH LICENSE
58 This program  is distributed  under the terms of the  GNU
59 Lesser General Public License as published  by  the  Free
60 Software  Foundation.  See  the  COPYING file located  in
61 /usr/local/share/doc/bochs/ for details on the license and
62 the lack of warranty.
63 .\"SKIP_SECTION"
64 .SH AVAILABILITY
65 The latest version of this program can be found at:
66         http://bochs.sourceforge.net/getcurrent.html
67 .\"SKIP_SECTION"
68 .SH SEE ALSO
69 bochsrc(5), bochs-dlx(1), bximage(1), bxcommit(1)
70 .PP
71 .nf
72 The Bochs IA-32 Emulator site on the World Wide Web:
73         http://bochs.sourceforge.net
75 Online Bochs Documentation
76         http://bochs.sourceforge.net/doc/docbook
77 .fi
78 .\"SKIP_SECTION"
79 .SH AUTHORS
80 The   Bochs  emulator  was   created   by  Kevin   Lawton
81 (kevin@mandrakesoft.com),  and  is  currently  maintained
82 by the  members of  the  Bochs x86 Emulator Project.  You
83 can see a current roster of members at:
85         http://bochs.sourceforge.net/getinvolved.html
86 .\"SKIP_SECTION"
87 .SH BUGS
88 Please  report all  bugs to the bug tracker  on  our  web
89 site. Just go to http://bochs.sourceforge.net, and click
90 "Bug Reports" on the sidebar under "Feedback".
91 .PP
92 Provide a detailed description of the bug, the version of
93 the program you are running, the operating system you are
94 running the program on  and  the  operating   system  you
95 are running in the emulator.