MAN page from RedHat Other Wine-971130-1.i386.rpm

WINE

Section: Windows Emulation (1)
Updated: September 1, 1995
Index

NAME

wine - run Windows programs under Unix

SYNOPSIS

wine[options]program_name[program_name...]

DESCRIPTION

wineinvokes the Windows emulator.

wine currently runs a number of games and small applications (approximatelyhalf of the applets and common games actually run), although the entire APIhas not been implemented.

See the files README,ChangeLog, configure, and theMakefilecontained in the source distributionto compilewine.

REQUIREMENTS

At present, winewill run under any Linux kernel more recent than 0.99.13, orunder recent releases of NetBSD/i386, FreeBSD and OpenBSD/i386.

Xmust be installed.

libXpmmust be installed. (It is probably available from the same site winewas, or the sources may be FTP'd from ftp.x.org).

INSTALLATION

To install Wine,run "./configure", which will detect your specific setup and createthe Makefiles. You can run "./configure --help" to see the availableconfiguration options. Then do "make depend; make" to build thewineexecutable, and then "make install" to install it. By default,wineis installed in /usr/local/bin; you can specify a different path withthe --prefix option when runningconfigure.

OPTIONS

-backingstore: Turn on backing store
-debug: Enter the debugger before starting application
-debugmsg name[,name]: Turn debugging messages on or off - for instance, -debugmsg +dll,+heapwill turn on DLL and heap debugging messages. The full list is: all, accel,atom, bitblt, bitmap, caret, cdaudio, class, clipboard, clipping, combo,comm, commdlg, crtdll, cursor, dc, dde, dialog, dll, dosfs, driver, edit,env, event, exec, file, fixup, font, gdi, global, graphics, heap, hook,icon, int, key, keyboard, ldt, listbox, local, mci, mcianim, mciwave, mdi,menu, message, metafile, midi, mmio, mmsys, mmtime, module, msg, nonclient,ole, palette, profile, prop, reg, region, relay, resource, scroll, selector,sem, sendmsg, shm, stress, string, syscolor, task, text, timer, toolhelp,ver, vxd, win, win32, winsock.
-depth n: Change the depth to use for multiple-depth screens
-desktop geom: Use a desktop window of the given geometry
-display name: Use the specified display
-dll name: Enables/disables built-in DLL's - starting wine with-dll -commdlgis 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
-failreadonly: Read only files may not be opened in write mode (the default is toallow opening read-only files for writing, because most Windowsprograms always request read-write access, even on CD-ROM drives...).
-fixedmap: Use a "standard" color map.
-iconic: Start as an icon
-language xx: Set the language toxx(one of En, Es, De, No, Fr, Fi, Da, Cz, Eo, It, Ko, Hu, Pl, Po)
-managed: Create each top-level window as a properly managed X window
-mode modename: Determines the mode in whichwineis started. Possible mode names arestandardandenhanced.Enhanced mode is the default (when no -mode option is specified).
-name name: Set the application name
-privatemap: Use a private color map
-synchronous: Turn on synchronous display mode
-winver version: Specify which Windows version WINE should imitate.Possible arguments are: win31, win95 and nt351.

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 invokingwine(such as: wine "notepad C:\TEMP\README.TXT"). Note thatthe program name and its arguments mustbe passed as a single parameter, which is usually accomplished by placingthem together in quotation marks. Multiple applications may be startedby placing all of them on the command line (such as: wine notepad clock).

CONFIGURATION FILE

wineexpects a configuration file (/usr/local/etc/wine.conf), which shouldconform to the following rules (the format is just like a Windows .inifile). The actual file name may be specified during the execution oftheconfigurescript. Alternatively, you may have a .winercfile of this format in your home directory.

CONFIGURATION FILE FORMAT

All entries are grouped in sections; a section begins with the line
[section name]
and continues until the next section starts. Individual entriesconsist of lines of the form
entry=value
The value can be any text string, optionally included in single ordouble quotes; it can also contain references to environment variablessurrounded by${}.Supported section names and entries are listed below.

[Drive X]
This section is used to specify the root directory and type of eachDOSdrive, since most Windows applications require a DOS/MS-Windows based disk drive & directory scheme. There is one such section for everydrive you want to configure.

format: Path = <rootdirectory>
default: none
If you mounted your dos partition as /dosand installed Microsoft Windows in C:\WINDOWS then you should specify Path=/dosin the[Drive C]section.

format: Type = <type>
default: hd
Used to specify the drive type; supported types are floppy, hd, cdromand network.

format: Label = <label>
default: 'Drive X'
Used to specify the drive label; limited to 11 characters.

format: Serial = <serial>
default: 12345678
Used to specify the drive serial number, as an 8-character hexadecimalnumber.

format: Filesystem = <fstype>
default: unix
Used to specify the type of the filesystem on which the drive resides;supported types are msdos (or fat), win95 (or vfat), unix. If thedrive spans several different filesystems, say unix.

[wine]
format: windows = <directory>
default: C:\WINDOWS
Used to specify a different Windows directory

format: system = <directory>
default: C:\WINDOWS\SYSTEM
Used to specify a different system directory

format: temp = <directory>
default: C:\TEMP
Used to specify a directory where Windows applications can store temporary files.

format: path = <directories separated by semi-colons>
default: C:\WINDOWS;C:\WINDOWS\SYSTEM
Used to specify the path which will be used to find executables and .DLL's.

format: symboltablefile = <filename>
default: wine.sym
Used to specify the path and file name of the symbol table used by the built-indebugger.

[serialports]
format: com[12345678] = <devicename>
default: none
Used to specify the devices which are used as com1 - com8.

[parallelports]
format: lpt[12345678] = <devicename>
default: none
Used to specify the devices which are used as lpt1 - lpt8.

[spy]
format: file = <filename or CON when logging to stdout>
default: none
Used to specify the file which will be used aslogfile.

format: exclude = <message names separated by semicolons>
default: none
Used to specify which messages will be excluded from the logfile.

format: include = <message names separated by semicolons>
default: none

SAMPLE CONFIGURATION FILE

[Drive A]
Path=/mnt/fd0
Type=floppy

[Drive C]
Path=/dos
Type=hd
Label=DOS disk

[Drive D]
Path=${HOME}/Wine

[wine]
windows=c:\windows
system=c:\windows\system
temp=c:\temp
path=c:\windows;c:\windows\system;c:\winapps\word
symboltablefile=/usr/local/lib/wine.sym

[serialports]
com1=/dev/cua1
com2=/dev/cua1

[parallelports]
lpt1=/dev/lp0

[spy]
;File=CON
;File=spy.log
Exclude=WM_TIMER;WM_SETCURSOR;WM_MOUSEMOVE;WM_NCHITTEST;
Include=WM_COMMAND;

AUTHORS

Wineis available thanks to the work of Bob Amstadt, Dag Asheim,Martin Ayotte, Ross Biro, Erik Bos, Fons Botman, John Brezak,Andrew Bulhak, John Burton, Paul Falstad, Olaf Flebbe, Peter Galbavy,Ramon Garcia, Hans de Graaf, Charles M. Hannum, Cameron Heide,Jochen Hoenicke, Jeffrey Hsu, Miguel de Icaza, Alexandre Julliard,Jon Konrath, Scott A. Laird, Martin von Loewis, Kenneth MacDonald,Peter MacDonald, William Magro, Marcus Meissner, Graham Menhennitt,David Metcalfe, Michael Patra, John Richardson, Johannes Ruscheinski,Thomas Sandford, Constantine Sapuntzakis, Daniel Schepler,Bernd Schmidt, Yngvi Sigurjonsson, Rick Sladkey, William Smith,Erik Svendsen, Goran Thyni, Jimmy Tirtawangsa, Jon Tombs,Linus Torvalds, Gregory Trubetskoy, Michael Veksler, Morten Welinder,Jan Willamowius, Carl Williams, Karl Guenter Wuensch, Eric Youngdale,and James Youngman.

This man page is maintained by Mike Phillips (msphilAATTfacstaff.wm.edu), so please send all corrections, comments, flames, etc., to him.

BUGS

There are too many to count, much less list. Some bugs of note, however,are that programs requiring VBRUNxxx.DLL are unreliable (with reports ofsome working), OLE is not in place, the internal COMMDLG support is not yetat 100% (although rapidly improving). Color support for other than 8bpp(256 colors) is currently flaky.

A partial list of applications known to work with wineinclude: sol, cruel, golf, clock, notepad, charmap, calc, and wzip11.The following URLs point to different success/testing lists:
http://www.ifi.uio.no/~dash/wine/working-apps.html
http://dutifp.twi.tudelft.nl:8000/wine/

We would like to hear about what software does run under Wine,and such reports may be posted to comp.emulators.ms-windows.wine.

AVAILABILITY

The most recent public version of winecan be ftp'ed from tsx-11.mit.edu in the /pub/linux/ALPHA/Wine/development directory. The releases are in the format 'Wine-yymmdd.tar.gz', or 'Wine-yymmdd.diff.gz' for the diff's from the previous release.

FILES

/usr/local/bin/wine: The invoker program.
/usr/local/etc/wine.conf: Main configuration file for wine.
ChangeLog: Changes in Wine, since the beginning (most recent changes first)
configure: Shell script to automatically generate Makefiles. Usually followed bymake to compile wine.
Wine newsgroup: Subscribe to comp.emulators.ms-windows.wine

This document was created byman2html,using the manual pages.