WINE the MS-Windows emulator.

An introduction.

 What is Wine?

Wine is an implementation of the Windows 3.x and Win32 APIs on top of X and Unix.

Think of Wine as a Windows compatibility layer for Linux. Wine provides both a development toolkit (Winelib) for porting Windows sources to Unix and a program loader, allowing unmodified Windows 3.1/95/NT binaries to run under Intel Unixes.

Wine works on most popular Intel Unixes, including Linux, FreeBSD, and Solaris.

Wine does not require Microsoft Windows, as it is a completely alternative implementation consisting of 100% Microsoft Free code, but it can optionally use native system DLLs if they are available.

Wine comes with complete sources, documentation and examples and is freely redistributable. (The licensing terms are similar to BSD.)

With Wine Windows applications can be installed and run on a Linux-system without the need to have a dos file-system installed.

Wine Features

 Binary Compatibility

• Support for Win16 and Win32 function calls
• 16 and 32 bit x86 code
• Optional use of external vendor DLLs
• Reverse-engineering design assures ``bug-for-bug'' compatibility

Graphics

• X11-based graphics display
• Remote display to any X terminal
• Supports full GDI and many new features of GDI32
• Partial DirectX support for games

Other Features

• Good support for sound, alternative input devices
• Modems, serial devices are supported
• Winsock TCP/IP networking

Wine API

• Designed for source compatibility with Win32 code
• Sample programs
• Automatically generated API documentation
• 32-bit resource compiler
• Partial Unicode support
• Internationalization -- Wine supports 16 languages
• Built-in debugger and configurable trace messages

Wine Status

• See the ANNOUNCE News about the latest release.
• See also the ChangeLog for the complete history, from 1993 to now.
• Wine is officially pre-alpha developers-only code, and is not yet suitable for general use. Nevertheless, many people find it useful in running a variety of Windows programs. Please see the application support database for success and failure reports with a variety of programs, as well as the bug list.

Places to go on the web and documents to read

You will find more info at the following web-sites

• At the WineHQ (WineHQ: http://www.winehq.com/).
• See also the About Wine  section at the HQ (http://www.winehq.com/about.html).
• And also the Wine Documentation at HQ (http://www.winehq.com/doc.html).

Where do you find the sources and/or binaries?

• Sources and binaries:  Download Wine 1 (http://www.winehq.com/download.html).
• Sources only:  Download Wine 2  (ftp://ftp.funet.fi/pub/Linux/BETA/Wine/development/).
• There are patches at Download Wine patches (http://www.winehq.com/patches980927/).

What is the version number?

v.980927 (October 6th 1998)

Is there an installation guide?

Yes, see the file README in the file Wine-980927.tar.gz .

Is there an FAQ/HOWTO document?

Yes, see the Wine FAQ (http://pw1.netcom.com/~dagar/winefaq.html).

 NOTICE: "The Wine FAQ" is Copyright (C) 1995-1997 by P. David Gardner, c/o Asgard Network Productions, 1107 Fair Oaks Ave., #175, South Pasadena CA 91030 USA.

Is there a man page?

Yes, the installation procedure will install one.

Where do I find more in depth information?

See again the the Wine FAQ.

On the HQ-site see the Wine references.

A newsgroup would be nice, is there one?

Yes, see: comp.emulators.ms-windows.wine

How do I know if a given windows application is already working? Remember this is development code!

See the Applications database  (http://www.winehq.com/Apps/query.cgi).

Down-to-earth and Hands-on information:

How to compile Wine:

In /usr/local/src/wine/wine-980927 (see the README ):

make clean; configure; make depend; make

make install

Wine Configuration for an Linux file system :

Minimal wine.conf file to be put in /usr/local/etc :
 
[Drive C]
;; C: is equivalent to /usr/local/wine
Path=/usr/local/wine
Type=hd
Filesystem=unix

[wine]
Windows=c:\windows
System=c:\windows\system
Path=c:\windows;c:\windows\system
Temp=c:\temp
 

 In /usr/local/wine :
 
/usr/local/wine/temp
/usr/local/wine/windows
/usr/local/wine/windows/system

How to run MS Word 6:

Use the following minimal install tree:

In /usr/local/wine:

total 3
drwxr-xr-x   3 user_login_name dos          1024 Oct 13 19:15 programs
drwxr-xr-x   2 user_login_name dos          1024 Oct 13 19:18 temp
drwxr-xr-x   3 user_login_name dos          1024 Oct 13 18:05 windows

wine/programs:
total 1
drwxr-xr-x   2 user_login_name dos          1024 Oct 13 19:18 winword

wine/programs/winword:
total 4170
-rwxr-xr-x   1 user_login_name dos       3483136 Jan 13  1994 winword.exe
-rwxr-xr-x   1 user_login_name dos        762880 Jan 13  1994 wwintl.dll

wine/temp:

wine/windows:
total 1
drwxr-xr-x   2 user_login_name dos          1024 Oct 13 19:18 system

wine/windows/system:
total 101
-rwxr-xr-x   1 user_login_name dos        102032 Feb  1  1994 sdm.dll

Remark: look out with the permissions of the temp directory.

How to configure wine to have a Windows-95 look:

You just add some stuff to to the wine.conf file. See the file .../documentation/win95look.

Where do you find the documentation in the distribution?

See .../documentation.

 Is there debugging info around?

Yes, see the Debugging notes.

Who are the authors?

Bob Amstadt, Dag Asheim, Martin Ayotte, Peter Bajusz, Ross Biro, Uwe Bonnes, Erik Bos, Fons Botman, John Brezak, Andrew Bulhak, John Burton, Niels de Carpentier, Jimen Ching, Huw D. M. Davies, Roman Dolejsi, Frans van Dorsselaer, Paul Falstad, David Faure, Claus Fischer, Olaf Flebbe, Peter Galbavy, Ramon Garcia, Matthew Ghio, Hans de Graaff, Charles M. Hannum, John Harvey, Cameron Heide, Jochen Hoenicke, Onno Hovers, Jeffrey Hsu, Miguel de Icaza, Jukka Iivonen, Lee Jaekil, Alexandre Julliard, Bang Jun-Young, Pavel Kankovsky, Jochen Karrer, Andreas Kirschbaum, Albrecht Kleine, Jon Konrath, Alex Korobka, Greg Kreider, Anand Kumria, Scott A. Laird, Andrew Lewycky, Martin von Loewis, Kenneth MacDonald, Peter MacDonald, William Magro, Juergen Marquardt, Ricardo Massaro, Marcus Meissner, Graham Menhennitt, David Metcalfe, Bruce Milner, Steffen Moeller, Andreas Mohr, Philippe De Muyter, Itai Nahshon, Michael Patra, Jim Peterson, Robert Pouliot, Keith Reynolds, Slaven Rezic, John Richardson, Johannes Ruscheinski, Thomas Sandford, Constantine Sapuntzakis , Pablo Saratxaga, Daniel Schepler, Ulrich Schmid, Bernd Schmidt, Yngvi Sigurjons son, Stephen Simmons, Rick Sladkey, William Smith, Dominik Strasser, Vadim Strizhevs ky, Erik Svendsen, Tristan Tarrant, Andrew Taylor, Duncan C Thomson, Goran Thyni, Jimmy Tirtawangsa, Jon Tombs, Linus Torvalds, Gregory Trubetskoy, Petri Tuomola, Michael Veksler, Sven Verdoolaege, Ronan Waide, Eric Warnke, Manfred Weichel, Morten Welinder, Jan Willamowius, Carl Williams, Karl Guenter Wuensch, Eric Youngdale, James Youngman, Mikolaj Zalewski, John Zero and many, many others.