2 .TH WINE 1 "September 1, 1995" "Version 9/1/95" "Windows Emulation"
4 wine \- run Windows 3.x programs under Linux
16 invokes the Linux Windows emulator.
19 currently runs a number of games and small applications (approximately
20 half of the applets and common games actually run), although the entire API
21 has not been implemented.
29 contained in the source distribution
35 will run under any Linux kernel more recent than 0.99.13, or
36 under recent releases of NetBSD and FreeBSD.
42 must be installed. (It is probably available from the same site
44 was, or the sources may be FTP'd from ftp.x.org).
48 run "./configure", which will detect your specific setup and create
49 the Makefiles. You can run "./configure --help" to see the available
50 configuration options. Then do "make depend; make" to build the
52 executable, and then "make install" to install it. By default,
54 is installed in /usr/local/bin; you can specify a different path with
55 the --prefix option when running
60 Change the depth to use for multiple-depth screens
63 Use a desktop window of the given geometry
66 Use the specified display
72 Enter the debugger before starting application
77 (one of En, Es, De, No, Fr, Fi, Da)
80 Create each top-level window as a properly managed X window
83 Set the application name
86 Use a private color map
89 Turn on synchronous display mode
95 Turn on message spying to the specified file
97 .I -debugmsg name[,name]
98 Turn debugging messages on or off - for instance,
99 .I -debugmsg +dll,+heap
100 will turn on DLL and heap debugging messages. The full list is:
101 all, accel, bitblt, bitmap, caret, catch, cdaudio, class, clipboard, clipping,
102 combo, comm, cursor, dc, dialog, dll, dosfs, driver, edit, enum, event, exec,
103 file, fixup, font, gdi, global, graphics, icon, int, key, keyboard, ldt,
104 listbox, local, malloc, mci, mcianim, mciwave, mdi, menu, menucalc, message,
105 metafile, midi, mmio, mmsys, mmtime, module, msg, nonclient, ole, palette,
106 profile, prop, reg, region, relay, resource, scroll, selector, selectors,
107 stress, syscolor, task, text, timer, toolhelp, utility, win, winsock.
110 Enables/disables built-in DLL's - starting wine with
112 is probably a good idea.
113 The full list of DLLs modifiable by this is:
114 KERNEL, USER, GDI, WIN87EM, SHELL, SOUND, KEYBOARD, WINSOCK, STRESS, MMSYSTEM,
115 SYSTEM, TOOLHELP, MOUSE, COMMDLG, OLE2, OLE2CONV, OLE2DISP, OLE2NLS, OLE2PROX,
116 OLECLI, OLESVR, COMPOBJ, STORAGE, WINPROCS, DDEML
119 Read only files may be opened in write mode
122 Starts wine in Enhanced mode
124 .SH PROGRAM/ARGUMENTS
125 The program name may be specified in DOS format (C:\\WINDOWS\\SOL.EXE) or in
126 Linux format (/msdos/windows/sol.exe). The program being executed may be
127 passed arguments by adding them on to the end of the command line invoking
129 (such as: wine "notepad C:\\TEMP\\README.TXT"). Note that
130 the program name and its arguments
132 be passed as a single parameter, which is usually accomplished by placing
133 them together in quotation marks. Multiple applications may be started
134 by placing all of them on the command line (such as: wine notepad clock).
135 .SH CONFIGURATION FILE
137 expects a configuration file (/usr/local/etc/wine.conf), which should
138 conform to the following rules (the format is just like a Windows .ini
139 file). The actual file name may be specified during the execution of
142 script. Alternatively, you may have a
144 file of this format in your home directory.
145 .SH CONFIGURATION FILE FORMAT
146 All entries are grouped in sections; a section begins with the line
150 and continues until the next section starts. Individual entries
151 consist of lines of the form
155 The value can be any text string, optionally included in single or
156 double quotes; it can also contain references to environment variables
159 Supported section names and entries are listed below.
163 This section is used to specify the root directory and type of each
165 drive, since most Windows applications require a DOS/MS-Windows based
166 disk drive & directory scheme. There is one such section for every
167 drive you want to configure.
169 .I format: Path = <rootdirectory>
173 If you mounted your dos partition as
175 and installed Microsoft Windows in
176 C:\\WINDOWS then you should specify
182 .I format: Type = <type>
186 Used to specify the drive type; supported types are floppy, hd, cdrom
189 .I format: Label = <label>
193 Used to specify the drive label; limited to 11 characters.
195 .I format: Serial = <serial>
199 Used to specify the drive serial number, as an 8-character hexadecimal
204 .I format: windows = <directory>
208 Used to specify a different Windows directory
210 .I format: system = <directory>
212 default: C:\\WINDOWS\\SYSTEM
214 Used to specify a different system directory
216 .I format: temp = <directory>
220 Used to specify a directory where Windows applications can store
223 .I format: path = <directories separated by semi-colons>
225 default: C:\\WINDOWS;C:\\WINDOWS\\SYSTEM
227 Used to specify the path which will be used to find executables and .DLL's.
229 .I format: symboltablefile = <filename>
233 Used to specify the path and file name of the symbol table used by the built-in
238 .I format: com[12345678] = <devicename>
242 Used to specify the devices which are used as com1 - com8.
246 .I format: lpt[12345678] = <devicename>
250 Used to specify the devices which are used as lpt1 - lpt8.
254 .I format: file = <filename or CON when logging to stdout>
258 Used to specify the file which will be used as
261 .I format: exclude = <message names separated by semicolons>
265 Used to specify which messages will be excluded from the logfile.
267 .I format: include = <message names separated by semicolons>
270 .br Used to specify which messages will be included in the logfile.
271 .SH SAMPLE CONFIGURATION FILE
294 system=c:\\windows\\system
298 path=c:\\windows;c:\\windows\\system;c:\\winapps\\word
300 symboltablefile=/usr/local/lib/wine.sym
318 Exclude=WM_TIMER;WM_SETCURSOR;WM_MOUSEMOVE;WM_NCHITTEST;
323 is available thanks to the work of Bob Amstadt, Dag Asheim,
324 Martin Ayotte, Ross Biro, Erik Bos, Fons Botman, John Brezak,
325 Andrew Bulhak, John Burton, Paul Falstad, Olaf Flebbe, Peter Galbavy,
326 Ramon Garcia, Hans de Graaf, Charles M. Hannum, Cameron Heide,
327 Jochen Hoenicke, Jeffrey Hsu, Miguel de Icaza, Alexandre Julliard,
328 Jon Konrath, Scott A. Laird, Martin von Loewis, Kenneth MacDonald,
329 Peter MacDonald, William Magro, Marcus Meissner, Graham Menhennitt,
330 David Metcalfe, Michael Patra, John Richardson, Johannes Ruscheinski,
331 Thomas Sandford, Constantine Sapuntzakis, Daniel Schepler,
332 Bernd Schmidt, Yngvi Sigurjonsson, Rick Sladkey, William Smith,
333 Erik Svendsen, Goran Thyni, Jimmy Tirtawangsa, Jon Tombs,
334 Linus Torvalds, Gregory Trubetskoy, Michael Veksler, Morten Welinder,
335 Jan Willamowius, Carl Williams, Karl Guenter Wuensch, Eric Youngdale,
338 This man page is maintained by Mike Phillips (msphil@facstaff.wm.edu), so
339 please send all corrections, comments, flames, etc., to him.
341 There are too many to count, much less list. Some bugs of note, however,
342 are that programs requiring VBRUNxxx.DLL are unreliable (with reports of
343 some working), OLE is not in place, the internal COMMDLG support is not yet
344 at 100% (although rapidly improving). Color support for other than 8bpp
345 (256 colors) is currently flaky.
347 A partial list of applications known to work with
349 include: sol, cruel, golf, clock, notepad, charmap, calc, and wzip11.
350 The following URLs point to different success/testing lists:
352 .I http://www.ifi.uio.no/~dash/wine/working-apps.html
354 .I http://dutifp.twi.tudelft.nl:8000/wine/
356 We would like to hear about what software does run under
358 and such reports may be posted to
359 .I comp.emulators.ms-windows.wine.
361 The most recent public version of
363 can be ftp'ed from tsx-11.mit.edu in the /pub/linux/ALPHA/Wine/development
364 directory. The releases are in the format 'Wine-yymmdd.tar.gz',
365 or 'Wine-yymmdd.diff.gz' for the diff's from the previous release.
369 .I /usr/local/bin/wine
372 .I /usr/local/etc/wine.conf
373 Main configuration file for wine.
376 Changes in Wine, since the beginning (most recent changes first)
379 Shell script to automatically generate Makefiles. Usually followed by
380 make to compile wine.
383 Subscribe to comp.emulators.ms-windows.wine