.\" -*- nroff -*- .TH WINE 1 "June 22, 1998" "Version 980614" "Windows Emulator" .SH NAME wine \- run Windows programs under Unix .SH SYNOPSIS .B wine [ .I options ] .I program_name [ .I program_name... ] .SH DESCRIPTION .B wine invokes the Windows emulator. .PP .B wine currently runs a growing list of applications written for both Win3.1 and Win95. Older, simpler applications work better than newer, more complex ones. A large percentage of the API has been implemented, although there are still several major pieces of work left to do. .SH REQUIREMENTS At present, .B wine will run under any Linux kernel more recent than 0.99.13, or under recent releases of NetBSD/i386, FreeBSD and OpenBSD/i386. .PP The current support for multithreaded applications relies on the .B clone(2) system call, which is currently available only on Linux systems running libc6 (glibc2). .PP .B X must be installed. To use Wine's support for multithreaded applications, your X libraries must be reetrant. If you have libc6 (glibc2), or you compiled the libraries yourself, they were probably compiled with the reetrant option enabled. .PP .B libXpm must be installed. It is probably available from the same site .B wine was, or the sources may be FTP'd from ftp.x.org. Usually it's in a package named something like XFree86-devel. .SH INSTALLATION To install .B Wine, run "./configure" in the top-level directory of the source, which will detect your specific setup and create the Makefiles. You can run "./configure --help" to see the available configuration options. Then do "make depend; make" to build the .B wine executable, and then "make install" to install it. By default, .B wine is installed in /usr/local/bin; you can specify a different path with the --prefix option when running .B configure. .PP For more information, see the .B README file contained in the source distribution .SH OPTIONS .TP .I -backingstore Turn on backing store .TP .I -debug Enter the debugger before starting application .TP .I -debugmsg [xxx]#name[,[xxx1]#name1] Turn debugging messages on or off. .RS +7 .PP xxx can be one of the following: err, warn, fixme, or trace, and # can be either + or -. Note that there is not a space between names. .PP For instance: .PP .I -debugmsg warn+dll,+heap will turn on DLL and heap warning messages. .br .I -debugmsg fixme-all,warn+cursor,+relay will turn off all FIXME messages, turn on cursor warning messages, and turn on all relay messages (API calls). .PP The full list of names is: all, accel, advapi, aspi, atom, bitblt, bitmap, caret, cd, cdaudio, class, clipboard, clipping, combo, comm, commctrl, commdlg, console, crtdll, cursor, dc, dde, ddeml, ddraw, debug, dialog, dinput, dll, dosfs, driver, dsound, edit, event, exec, file, fixup, font, gdi, global, graphics, header, heap, hook, icon, imagelist, int, int21, int31, key, keyboard, ldt, listbox, local, mci, mcianim, mciwave, mdi, menu, message, metafile, midi, mmaux, mmio, mmsys, mmtime, module, mpr, msg, nonclient, ntdll, ole, palette, print, process, profile, prop, reg, region, relay, resource, scroll, security, segment, selector, sem, sendmsg, shell, shm, snoop, sound, stress, string, syscolor, task, text, thread, thunk, timer, toolhelp, tweak, uitools, updown, ver, virtual, vxd, win, win16drv, win32, wing, winsock, wnet, x11, x11drv. .PP For more information on debugging messages, see the file .I documentation/debug-msgs in the source distribution. .RE .TP .I -depth n Change the depth to use for multiple-depth screens .TP .I -desktop geom Use a desktop window of the given geometry .TP .I -display name Use the specified display .TP .I -dll name Enables/disables built-in DLL's - starting wine with .I -dll -commdlg is probably a good idea. The full list of DLLs modifiable by this is: WIN87EM, SHELL, SOUND, KEYBOARD, WINSOCK, STRESS, MMSYSTEM, SYSTEM, TOOLHELP, MOUSE, COMMDLG, OLE2, OLE2CONV, OLE2DISP, OLE2NLS, OLE2PROX, OLECLI, OLESVR, COMPOBJ, STORAGE, WINPROCS, DDEML, ADVAPI32, COMCTL32, COMDLG32, CRTDLL, GDI32, LZ32, MPR, NTDLL, OLE32, SHELL32, USER32, VER, VERSION, W32SYS, WINMM, WINSPOOL, WSOCK32 .TP .I -failreadonly Read only files may not be opened in write mode (the default is to allow opening read-only files for writing, because most Windows programs always request read-write access, even on CD-ROM drives...). .TP .I -fixedmap Use a "standard" color map. .TP .I -iconic Start as an icon .TP .I -language xx Set the language to .I xx (one of En, Es, De, No, Fr, Fi, Da, Cz, Eo, It, Ko, Hu, Pl, Po, Sw, Ca) .TP .I -managed Create each top-level window as a properly managed X window .TP .I -mode modename Determines the mode in which .B wine is started. Possible mode names are .I standard and .I enhanced. Enhanced mode is the default (when no -mode option is specified). .TP .I -name name Set the application name .TP .I -privatemap Use a private color map .TP .I -synchronous Turn on synchronous display mode .TP .I -winver version Specify which Windows version WINE should imitate. Possible arguments are: win31, win95, nt351, and nt40. .PD 1 .SH PROGRAM/ARGUMENTS The program name may be specified in DOS format (C:\\WINDOWS\\SOL.EXE) or in Linux format (/msdos/windows/sol.exe). The program being executed may be passed arguments by adding them on to the end of the command line invoking .B wine (such as: wine "notepad C:\\TEMP\\README.TXT"). Note that the program name and its arguments .I must be passed as a single parameter, which is usually accomplished by placing them together in quotation marks. Multiple applications may be started by placing all of them on the command line (such as: wine notepad clock). .SH CONFIGURATION FILE .B wine expects a configuration file (/usr/local/etc/wine.conf), which should conform to the following rules (the format is just like a Windows .ini file). The actual file name may be specified during the execution of the .B configure script. Alternatively, you may have a .I .winerc file of this format in your home directory or the environment variable .B WINE_INI pointing to a configuration file. .SH CONFIGURATION FILE FORMAT All entries are grouped in sections; a section begins with the line .br .I [section name] .br and continues until the next section starts. Individual entries consist of lines of the form .br .I entry=value .br The value can be any text string, optionally included in single or double quotes; it can also contain references to environment variables surrounded by .I ${}. Supported section names and entries are listed below. .PP .B [Drive X] .br This section is used to specify the root directory and type of each .B DOS drive, since most Windows applications require a DOS/MS-Windows based disk drive & directory scheme. There is one such section for every drive you want to configure. .PP .I format: Path = .br default: none .br If you mounted your dos partition as .I /dos and installed Microsoft Windows in C:\\WINDOWS then you should specify .I Path=/dos in the .I [Drive C] section. .PP .I format: Type = .br default: hd .br Used to specify the drive type; supported types are floppy, hd, cdrom and network. .PP .I format: Label =