2 .TH WINE 1 "July 8, 1998" "Version 980628" "Windows Emulator"
4 wine \- run Windows programs under Unix
16 invokes the Windows emulator.
19 currently runs a growing list of applications written for both Win3.1 and
20 Win95. Older, simpler applications work better than newer, more complex
21 ones. A large percentage of the API has been implemented, although there
22 are still several major pieces of work left to do.
26 will run under any Linux kernel more recent than 0.99.13, or
27 under recent releases of NetBSD/i386, FreeBSD and OpenBSD/i386.
29 The current support for multithreaded applications relies on the
31 system call, which is currently available only on Linux systems running
35 must be installed. To use Wine's support for multithreaded applications,
36 your X libraries must be reetrant. If you have libc6 (glibc2), or you
37 compiled the libraries yourself, they were probably compiled with the
38 reetrant option enabled.
41 must be installed. If you're using Red Hat, the name of the package is
42 XFree86-devel. The sources may be FTP'd from ftp.Xfree86.org or its
46 2.7.x or later is required to build
48 Versions earlier than 2.7.2.3 may have problems when certain files are
49 compiled with optimization.
53 run "./configure" in the top-level directory of the source, which will
54 detect your specific setup and create the Makefiles. You can run
55 "./configure --help" to see the available configuration options. Then do
56 "make depend; make" to build the
58 executable, and then "make install" to install it. By default,
60 is installed in /usr/local/bin; you can specify a different path with
61 the --prefix option when running
64 For more information, see the
66 file contained in the source distribution.
73 Enter the debugger before starting application
75 .I -debugmsg [xxx]#name[,[xxx1]#name1]
76 Turn debugging messages on or off.
79 xxx is optional and can be one of the following:
85 If xxx is not specified, all debugging messages for the specified
86 channel are turned on. # is required and can be either + or -. Note that
87 there is not a space after the comma between names.
91 .I -debugmsg warn+dll,+heap
92 will turn on DLL warning messages and all heap messages.
94 .I -debugmsg fixme-all,warn+cursor,+relay
95 will turn off all FIXME messages, turn on cursor warning messages, and turn
96 on all relay messages (API calls).
98 The full list of names is: all, accel, advapi, aspi, atom, bitblt, bitmap,
99 caret, cd, cdaudio, class, clipboard, clipping, combo, comm, commctrl,
100 commdlg, console, crtdll, cursor, dc, dde, ddeml, ddraw, debug, dialog,
101 dinput, dll, dosfs, driver, dsound, edit, event, exec, file, fixup, font,
102 gdi, global, graphics, header, heap, hook, icon, imagelist, int, int21,
103 int31, key, keyboard, ldt, listbox, local, mci, mcianim, mciwave, mdi, menu,
104 message, metafile, midi, mmaux, mmio, mmsys, mmtime, module, mpr, msg,
105 nonclient, ntdll, ole, palette, print, process, profile, prop, reg, region,
106 relay, resource, scroll, security, segment, selector, sem, sendmsg, shell,
107 shm, snoop, sound, stress, string, syscolor, task, text, thread, thunk, timer,
108 toolhelp, tweak, uitools, updown, ver, virtual, vxd, win, win16drv, win32,
109 wing, winsock, wnet, x11, x11drv.
111 For more information on debugging messages, see the file
112 .I documentation/debug-msgs
113 in the source distribution.
117 Change the depth to use for multiple-depth screens
120 Use a desktop window of the given geometry
123 Use the specified display
126 Enables/disables built-in DLL's - starting wine with
128 is probably a good idea.
129 The full list of DLLs modifiable by this is:
130 WIN87EM, SHELL, SOUND, KEYBOARD, WINSOCK, STRESS, MMSYSTEM, SYSTEM, TOOLHELP,
131 MOUSE, COMMDLG, OLE2, OLE2CONV, OLE2DISP, OLE2NLS, OLE2PROX, OLECLI, OLESVR,
132 COMPOBJ, STORAGE, WINPROCS, DDEML, ADVAPI32, COMCTL32, COMDLG32, CRTDLL,
133 GDI32, LZ32, MPR, NTDLL, OLE32, SHELL32, USER32, VER, VERSION, W32SYS, WINMM,
137 Read only files may not be opened in write mode (the default is to
138 allow opening read-only files for writing, because most Windows
139 programs always request read-write access, even on CD-ROM drives...).
142 Use a "standard" color map.
150 (one of En, Es, De, No, Fr, Fi, Da, Cz, Eo, It, Ko, Hu, Pl, Po, Sw, Ca)
153 Create each top-level window as a properly managed X window
156 Determines the mode in which
158 is started. Possible mode names are
162 Enhanced mode is the default (when no -mode option is specified).
165 Set the application name
168 Use a private color map
171 Turn on synchronous display mode
174 Specify which Windows version WINE should imitate.
175 Possible arguments are: win31, win95, nt351, and nt40.
177 .SH PROGRAM/ARGUMENTS
178 The program name may be specified in DOS format (C:\\WINDOWS\\SOL.EXE) or in
179 Unix format (/msdos/windows/sol.exe). The program being executed may be
180 passed arguments by adding them on to the end of the command line invoking
182 (such as: wine "notepad C:\\TEMP\\README.TXT"). Note that
183 the program name and its arguments
185 be passed as a single parameter, which is usually accomplished by placing
186 them together in quotation marks. Multiple applications may be started
187 by placing all of them on the command line (such as: wine notepad clock).
188 .SH CONFIGURATION FILE
190 expects a configuration file (/usr/local/etc/wine.conf), which should
191 conform to the following rules (the format is just like a Windows .ini
192 file). The actual file name may be specified during the execution of
195 script. Alternatively, you may have a
197 file of this format in your home directory or have the environment variable
199 pointing to a configuration file.
200 .SH CONFIGURATION FILE FORMAT
201 All entries are grouped in sections; a section begins with the line
205 and continues until the next section starts. Individual entries
206 consist of lines of the form
210 The value can be any text string, optionally included in single or
211 double quotes; it can also contain references to environment variables
214 Supported section names and entries are listed below.
218 This section is used to specify the root directory and type of each
220 drive, since most Windows applications require a DOS/MS-Windows based
221 disk drive & directory scheme. There is one such section for every
222 drive you want to configure.
224 .I format: Path = <rootdirectory>
228 If you mounted your dos partition as
230 and installed Microsoft Windows in
231 C:\\WINDOWS then you should specify
237 .I format: Type = <type>
241 Used to specify the drive type; supported types are floppy, hd, cdrom
244 .I format: Label = <label>
248 Used to specify the drive label; limited to 11 characters.
250 .I format: Serial = <serial>
254 Used to specify the drive serial number, as an 8-character hexadecimal
257 .I format: Filesystem = <fstype>
261 Used to specify the type of the filesystem on which the drive resides;
262 supported types are msdos (or fat), win95 (or vfat), unix. If the
263 drive spans several different filesystems, say unix.
267 .I format: windows = <directory>
271 Used to specify a different Windows directory
273 .I format: system = <directory>
275 default: C:\\WINDOWS\\SYSTEM
277 Used to specify a different system directory
279 .I format: temp = <directory>
283 Used to specify a directory where Windows applications can store
286 .I format: path = <directories separated by semi-colons>
288 default: C:\\WINDOWS;C:\\WINDOWS\\SYSTEM
290 Used to specify the path which will be used to find executables and .DLL's.
292 .I format: symboltablefile = <filename>
296 Used to specify the path and file name of the symbol table used by the built-in
301 .I format: com[12345678] = <devicename>
305 Used to specify the devices which are used as com1 - com8.
309 .I format: lpt[12345678] = <devicename>
313 Used to specify the devices which are used as lpt1 - lpt8.
317 .I format: file = <filename or CON when logging to stdout>
321 Used to specify the file which will be used as
324 .I format: exclude = <message names separated by semicolons>
328 Used to specify which messages will be excluded from the logfile.
330 .I format: include = <message names separated by semicolons>
333 .br Used to specify which messages will be included in the logfile.
337 .I format: Win95Look=<true|false>
341 Use Win95-like window displays or Win3.1-like window displays.
342 .SH SAMPLE CONFIGURATION FILE
365 system=c:\\windows\\system
369 path=c:\\windows;c:\\windows\\system;c:\\winapps\\word
371 symboltablefile=/usr/local/lib/wine.sym
389 Exclude=WM_TIMER;WM_SETCURSOR;WM_MOUSEMOVE;WM_NCHITTEST;
398 is available thanks to the work of many developers. For a listing
399 of the authors, please see the file
401 in the top-level directory of the source distribution.
403 There are too many to count, much less list. Some bugs of note, however,
404 are that programs requiring VBRUNxxx.DLL are unreliable (with reports of
405 some working), OLE is not in place, the internal COMMDLG support is not yet
406 at 100% (although rapidly improving). Color support for other than 8bpp
407 (256 colors) is currently flaky.
409 A status report on many appplications is available from
410 .I http://www.winehq.com/apps.cgi.
411 Users can add, modify, and delete entries on this list.
413 Bug reports and successes may be posted to
414 .I comp.emulators.ms-windows.wine.
416 The most recent public version of
418 can be ftp'ed from sunsite.unc.edu or tsx-11.mit.edu in the /pub/linux/ALPHA/Wine/development
419 directory. The releases are in the format 'Wine-yymmdd.tar.gz',
420 or 'Wine-yymmdd.diff.gz' for the diff's from the previous release.
425 .I http://www.winehq.com.
426 This website contains a great deal of information about
428 as well as a collection of unofficial patches against the current release.
433 .I comp.emulators.ms-windows.wine.
434 All discussions about the project take place in this forum.
438 .I /usr/local/bin/wine
441 .I /usr/local/etc/wine.conf
442 Global configuration file for wine.
444 .I /usr/local/lib/wine.sym
445 Global symbol table (used in debugger)
448 User-specific configuration file