Wine FAQ

Intro, intermediate and advanced HOWTOs and discussion.
Post Reply
User avatar
weazy
Ex-Admin
Posts: 1688
Joined: Sun Jul 07, 2002 10:02 am
Location: any given
Contact:

Wine FAQ

Post by weazy » Fri May 30, 2003 5:22 pm

The Wine FAQ

Contents:

About Wine

1. What is Wine?
2. What's UNIX? What's Linux? What's FreeBSD? What's GNU?
3. Is Wine an emulator?
4. What's the history of Wine?
5. Why would anyone want Wine? Doesn't Windows suck?
6. What is Wine, and what is it supposed to do?
7. What is the current version of Wine?
8. When will Wine be finished?
9. What undocumented APIs / interfaces are not understood?
Would seeing Microsoft source help?

Getting Wine

10. Do I need Unix first? Where can I get Linux?
11. Can I get Wine on CD?

Common troubles with configuring Wine

12. This RPM requires libncurses.so.5, but the latest
ncurses I can find is libncurses.so.4?
13. Why does it keep saying that Xpm is not installed?
14. What is this kernel/kernel32 mismatch warning?
15. I'm getting a X_OpenFont crash when starting Wine!
16. All my Wine windows stick on top and/or on all my
desktops!
17. Wine looks like Windows 3.1, but I run Windows 95
applications?
18. I compiled Wine from source, but it can't find the .so
files, like libavifil32.so!
19. Wine won't start on my new glibc2.1.3-based
distribution (RedHat 6.2, Mandrake 7.0, etc)!

Common troubles with running programs with Wine

20. I'm getting a relocation records stripped message,
what's this?
21. I can't start programs in paths with spaces in them!
22. I tried to run a setup application, but it complains
that it can't create start menu entries, what can I do?
23. My application wants me to change disks/CD-ROMs, but I
can't unmount it while it is running, what can I do?

Getting Help

24. Is there any documentation for Wine?
25. I couldn't find the answer to my question in the
documentation, but I've written a document explaining
how to solve it. What should I do?

Developing programs using Wine


26. Can I use Wine to port my Win32 sources to Unix?
27. Will MFC work with Wine? What do I need to do?
28. Are there any commercial applications which have been
ported using Wine?
29. How can I detect Wine?

Becoming a Wine developer

30. How do I become a Wine developer? What do I need to
know?

About this FAQ

31. How recent is this FAQ? Where can I get the latest
version?
32. Who maintains this FAQ? What's its history? How do I
submit additions?
33. What's the copyright on this FAQ? How may I use it?

Capabilities

34. Which programs does Wine currently run?
35. Are there programs which Wine will never be able to
run?
36. Can I use Wine to access my Winmodem?
37. Will MS Windows programs typically run faster or slower
under UNIX and Wine than they do under DOS and MS
Windows? Will certain kinds of programs run slower or
faster?
38. Are there any advantages or disadvantages to running MS
Windows applications under Wine that I should be aware
of?
39. Will Wine support MS Windows networked applications
that use winsock.dll?
40. I'm a software developer who wants to use UNIX to
develop programs rather than DOS, but I need to write
DOS and MS Windows programs as well. Will I be able to
run my favorite DOS and/or MS Windows compilers under
Wine?

What You Need to Run Wine

41. Under what hardware platform(s) and operating system(s)
will Wine run?
42. What minimum CPU must I have in my computer to be able
to run Wine and MS Windows applications smoothly?
43. How much disk space will the Wine source code and
binaries take on my hard drive? What other software do
I need to have installed to compile and run Wine?
44. How much RAM do I need to have on my UNIX system to be
able to run Wine and MS Windows applications smoothly?
45. I have a Drivespaced, Doublespaced or Stackered DOS
partition. Can Wine run MS Windows binaries located in
such a partition?
46. Do I need to have a DOS partition on my system to use
Wine? Does MS Windows need to be loaded into that
partition in order to run MS Windows programs under
Wine?
47. If Wine completely replaces MS Windows, will it
duplicate all of the functions of MS Windows?
48. Will I be able to install MS Windows applications in
any flavor of a UNIX filesystem?
49. Will Wine run only under X, or can it run in character
mode?
50. Will Wine run under any X window manager? Does it
require a window manager at all?
51. Will 32-bit Windows 95/98 applications run under Wine?
52. What about NT specific programs, which use NT-only
features?

How to Find, Install, Configure and Run Wine

53. Where can I get Wine?
54. If I do not have an Internet account, how can I get
Wine?
55. How do I install Wine on my hard drive?
56. How do I compile the Wine distribution source code?
57. How do I configure Wine to run on my system?
58. How do I run an MS Windows program under Wine?
59. I have installed and configured Wine, but Wine cannot
find MS Windows on my drive. Where did I go wrong?
60. I'm running a DirectX game, but the graphics is slow,
how can I speed it up?
61. I think I've found a bug. How do I report this bug to
the Wine programming team?
62. I was able to get various MS Windows programs to run,
but parts of them do not work. What is wrong?
63. I have run various MS Windows programs, but since the
program menus do not work, how can I exit these
programs?
64. How do I remove Wine from my computer?

How to Get Help with Wine

65. Is there a Usenet newsgroup for Wine?
66. Is there a World Wide Web site for Wine?

How You Can Help with the Wine Project

67. How can I help contribute to the Wine project, and in
what way(s)?
68. I want to help beta test Wine. How can I do this?
69. I have written some code that I would like to submit to
the Wine project. How do I go about doing this?

Who's Responsible for Wine?

70. Who is responsible for writing and maintaining the Wine
source code?
71. Who are the folks and organizations who have
contributed money or equipment to the Wine project?

Questions and Answers

About Wine

1. What is Wine?

Wine is Windows on UNIX.

2. What's UNIX? What's Linux? What's FreeBSD? What's GNU?

UNIX refers to a number of OSes based on the OS started
at Bell Labs in the 70's. GNU is a longstanding project
to create a free Unix. Linux and FreeBSD are free
Unixes, building on the GNU project. Some distributors,
such as Debian, refer to the result as GNU/Linux in
recognition of the GNU heritage.



3. Is Wine an emulator?

Unfortunately, no. Wine provides low-level binary
compatibility, but currently only for OSes running on
Intel-compatible chips.



4. What's the history of Wine?

As far as I remember it was a discussion in
comp.os.linux about Windows emulation. The first real
code came from Eric Youngdale (at this point he was
toying around with object formats, i.e. he was writing
the ELF infrastructure for Linux and applied this
knowledge to write a simple loader for Windows
binaries). Then Bob Amstadt got the actual project
running (with TK widgets). -- Joerg

Also see http://www.winehq.com/about.html.



5. Why would anyone want Wine? Doesn't Windows suck?

Not everyone thinks so. And for those that don't,
Windows programs would suck less when run on a more
stable and flexible UNIX platform.



6. What is Wine, and what is it supposed to do?

Wine is a program which allows the operation of DOS and
MS Windows programs (Windows 3.x and Win32 executables)
on UNIX. It consists of a program loader, which loads
and executes a Windows binary, and a library that
implements Windows API calls using their UNIX or X11
equivalents. The library may also be used for porting
Win32 code into native UNIX executables.

Wine is free software, and its license (contained in
the file LICENSE in each distribution) is BSD style.
Basically, this means that you can do anything with
Wine except claim that you wrote it.



7. What is the current version of Wine?

A new version of Wine is distributed about every three
weeks. You will be able to keep up on all the latest
releases by reading the newsgroup

comp.emulators.ms-windows.wine

where new release announcements are made. You can also
subscribe to the wine-announce mailing list to be
notified of new releases via email.

When downloading Wine from your FTP site of choice (see
http://www.winehq.com/download.html for some of these
choices), you can make sure that you are getting the
latest version by watching the version numbers in the
distribution filename.

For instance, the distribution released on June 20,
1994 was called Wine-940620.tar.gz.

Patch files are also available. If you are current to
the previous version, you can download and apply just
the current patch file rather than the entire new
distribution. The patch filenames follow the same
conventions as the monthly distribution.

Read-only CVS access is also available. See http://
http://www.winehq.com/dev.html



8. When will Wine be finished?

Large software projects are never finished, only
released.

Because Wine is being developed by volunteers, it is
difficult to predict when it will be ready for general
release. Between 90-98% of the functions used by MS
Windows applets, and 80-90% of the functions used by
major programs, have been at least partially
implemented at this time. However, the remaining 10%
will likely take another 90% of the time, not including
debugging.



9. What undocumented APIs / interfaces are not understood?
Would seeing Microsoft source help?

The best would be if the Windows API would be fully
documented, so Wine could be a perfect "clean-room"
implementation. Seeing the source code might make it
harder to prove that no copyright violations have taken
place. That said, the documentation is often bad,
nonexistent, and even misleading where it exists, so a
fair amount of reverse engineering have been necessary,
particularly in the shell (Explorer) interface.

Getting Wine



10. Do I need Unix first? Where can I get Linux?

The short answer is yes: Wine is not an OS, it runs on
top of your OS. A project named Generic Windows, a
prepacked setup of FreeBSD+XFree86+Wine, has been
proposed, but its domain name, genericwindows.com,
seems to have disappeared from the Web.



11. Can I get Wine on CD?

You can get the source on any CD which mirrors a Wine
site, such as the Metalab CD's marketed by Walnut Creek
CDROM. Be warned that these might be slightly out of
date by the time you get them.

Common troubles with configuring Wine



12. This RPM requires libncurses.so.5, but the latest
ncurses I can find is libncurses.so.4?

RedHat has pulled a bad versioning trick; ncurses 5 is
still installed as libncurses.so.4 in order to avoid
having to recompile the rest of the distribution. If
you must use a RPM rather than compile from source,
make a symlink, like
cd /usr/lib
ln -s libncurses.so.4 libncurses.so.5



13. Why does it keep saying that Xpm is not installed?

You need the Xpm development headers. On RedHat and
SuSE, this is the xpm-devel package. On Debian, this is
the xpm4g-dev package. Remember to rm config.cache (or
make distclean) before trying again.



14. What is this kernel/kernel32 mismatch warning?

An error in the configuration file, which unfortunately
many RPM creators have overlooked. If you run win32
applications and have win95/winNT installed with this
error, Wine will crash on startup. The wine.conf should
contain something like this (but you may ignore the
DllPairs section if it doesn't exist, as it was
obsoleted a while ago):
[DllPairs]
krnl386 = kernel32
[DllOverrides]
kernel32, gdi32, user32 = builtin
krnl386, gdi, user = builtin



15. I'm getting a X_OpenFont crash when starting Wine!

Make sure you have run mkfontdir in all your X font
directories to make sure X has a current list of
available fonts. Also, some Windows fonts do not work
properly in X. When Wine starts, it queries the X
server for the metrics of every font on the system, and
for some fonts this may fail. Run wine -debugmsg +font
-sync to see what fonts it was querying the X server
about, then remove the offending font.



16. All my Wine windows stick on top and/or on all my
desktops!

Have you tried the -managed or -desktop command line
options? See the man page for details.



17. Wine looks like Windows 3.1, but I run Windows 95
applications?

The visual look and the API are completely different
and independent things, think of the look as a theme,
it does not change what the applications think they are
running on. That said, to change the look, set the
WineLook option under [Tweak.Layout] in your wine.conf.



18. I compiled Wine from source, but it can't find the .so
files, like libavifil32.so!

When compiling from source, the libraries go into /usr/
local/lib by default. Most Linux distributions aren't
set up to look there by default, you have to add /usr/
local/lib to /etc/ld.so.conf (and then rerun ldconfig)
yourself (or let tools/wineinstall do it for you).



19. Wine won't start on my new glibc2.1.3-based
distribution (RedHat 6.2, Mandrake 7.0, etc)!

There are severe bugs in stock glibc2.1.3. For towupper
crashes, or errors about MENU_CopySysPopup and USER,
you can work around the problem by defining the
environment variable LC_ALL, i.e. export LC_ALL=en (in
bash) or setenv LC_ALL en (in tcsh).

Common troubles with running programs with Wine



20. I'm getting a relocation records stripped message,
what's this?

It means that a Win32 application tried to start
another executable, but this new executable wanted
itself loaded at an address typically already occupied
by the old executable, and did not have the relocation
records necessary for it to be loaded anywhere else
(recent versions of MSVC++ removes (strips) this
information by default). Sometimes you can get the
application up anyway by just manually starting the
other executable it was trying to run (this applies to
Lotus Notes, for example).

The root of this problem is that Win32 keeps separate
address spaces for each Win32 process, so that two
executables will never clash under Windows. However,
there is a lot of work left before Wine can do the
same, mostly having to do with how these applications
are going to communicate with each other once they are
separated.



21. I can't start programs in paths with spaces in them!

Did you do something like wine /c/Program Files/foo/
bar.exe? The shell sees unescaped spaces as argument
separators, for obvious reasons. To tell it that it's
all one argument, you must quote it. Examples:
wine /c/Program\ Files/foo/bar.exe
wine "/c/Program Files/foo/bar.exe"

But the best and simplest idea is always to cd into the
program's directory first and then just run wine
bar.exe. Many applications depend on the current
directory being the program directory, and they might
not work otherwise.



22. I tried to run a setup application, but it complains
that it can't create start menu entries, what can I do?

If you're running without a real Windows installation,
first you need to install the necessary registry
entries, if you haven't already done so. See
documentation/no-windows for more information. Next,
you need to create directories for the paths in the
registry. If your Drive C path is /c, you would type
something like
mkdir "/c/windows/Start Menu"
mkdir "/c/windows/Start Menu/Programs"

to prepare the start menus, and after this the install
should succeed. (The newest version of tools/
wineinstall should do all this for you.)



23. My application wants me to change disks/CD-ROMs, but I
can't unmount it while it is running, what can I do?

Use the Supermount kernel patch, and mount your
removable media using the Supermount filesystem (read
its README file). Supermount implements DOS/
Windows-like behaviour (it allows you to change media
(as long as no files are open) without unmounting).

(Mandrake kernels are known to include this patch by
default.)

Getting Help



24. Is there any documentation for Wine?

Yes, a bit. Look in the documentation/ directory of the
source distribution. Also see the WineHQ website and
the draft version of the Wine-HOWTO.



25. I couldn't find the answer to my question in the
documentation, but I've written a document explaining
how to solve it. What should I do?

Updates and additions to the Wine documentation
directory should be sent to the wine-patches mailing
list. Website and FAQ additions should be sent to
webmaster@winehq.com.

Developing programs using Wine



26. Can I use Wine to port my Win32 sources to Unix?

That is the idea of Winelib. Right now you may have
some difficulties, but this should change soon.



27. Will MFC work with Wine? What do I need to do?

Work is underway to support this.



28. Are there any commercial applications which have been
ported using Wine?

At this time, Corel's WordPerfect Office Suite and
Deneba's Canvas 7 are known to use Winelib.



29. How can I detect Wine?

You shouldn't need to. If there's a quirk in Wine you
need to work around, it's better to fix it in Wine.

Becoming a Wine developer



30. How do I become a Wine developer? What do I need to
know?

If you can program C, that's a good start. Download the
sources via CVS, subscribe to the mailing lists, look
around the source, and pay attention to the
comp.emulators.ms-windows.wine newsgroup and the
mailing lists. See if there's anything that you think
you can fix or work on. You won't have much trouble
finding areas that need work in Wine (grep for FIXMEs
in the source).

About this FAQ



31. How recent is this FAQ? Where can I get the latest
version?

This document was last edited Tue Mar 06 01:33:11 EST
2001. It is available from http://www.winehq.com/
faq.html.



32. Who maintains this FAQ? What's its history? How do I
submit additions?

Dave Gardner maintained it from 1995-1998. Douglas
Ridgway <ridgway@winehq.com>, the current maintainer,
took it over in 1999. Proposed new questions should be
sent to him.



33. What's the copyright on this FAQ? How may I use it?

The original Wine FAQ, which this FAQ was based on, was
copyright © 1995-1998 David Gardner. It may be
reproduced and modified under the same terms as Wine
itself.

Capabilities



34. Which programs does Wine currently run?

Please see the Apps database.



35. Are there programs which Wine will never be able to
run?

Wine is designed to allow applications to run, and
implements an application programming interface. It is
not designed to interface directly with hardware, which
is the responsibility of the underlying operating
system. Wine does not in general allow using Windows
drivers under Unix. That said, Wine has been used to
support parallel devices, such as parallel port
scanners for which no Unix driver is available.



36. Can I use Wine to access my Winmodem?

No. These are usually cheap DAC/ADC boards that comes
with software that consumes some of the processing
power of your main CPU instead of letting the hardware
do its own job of decoding/encoding the acoustic
signals that carries data over the phone line. The
software drivers use VxDs to access the hardware, which
brings us to the previous question, above.

See http://www.linmodems.org/ instead.



37. Will MS Windows programs typically run faster or slower
under UNIX and Wine than they do under DOS and MS
Windows? Will certain kinds of programs run slower or
faster?

When work on Wine is completed, programs should
typically run at about the same speed under Wine as
they do under DOS and MS Windows. Currently, there are
debugging features built into each release, and this
slows down the execution of programs. However, these
debugging features will be removed for any
post-development releases.



38. Are there any advantages or disadvantages to running MS
Windows applications under Wine that I should be aware
of?

As with OS/2, you will be running MS Windows programs
under a protected mode operating system, which brings
certain advantages (and some disadvantages).

For instance, there will be crash protection. That is,
each MS Windows application running under Wine will be
running in its own X window and its own portion of
reserved memory. If one MS Windows application crashes,
it will not crash the other MS Windows or UNIX
applications that you may have running at the same
time.

However, be aware that some applications are broken and
they access memory that they haven't properly (or at
all) allocated. Under OS/2 or Wine, they will crash.
Under MS Windows, they may work for a period of time,
but then eventually you will have to reboot the
machine.

Also, MS Windows programs should run at about the same
speed under Wine as they do under MS Windows.

When Wine is finished, you will be able to run your
favorite MS Windows applications in a UNIX environment.
However, be aware that any application written for MS
Windows will run much less efficiently than its native
UNIX cousin. For Linux, there is a database of such
applications at the Linux Apps Page.



39. Will Wine support MS Windows networked applications
that use winsock.dll?

Yes, Wine does support such applications, more so the
16-bit than the 32-bit version of winsock. Working
applications include Agent (a Usenet newsreader), mIRC,
ws-FTP and Internet Explorer.



40. I'm a software developer who wants to use UNIX to
develop programs rather than DOS, but I need to write
DOS and MS Windows programs as well. Will I be able to
run my favorite DOS and/or MS Windows compilers under
Wine?

Wine now supports DOS applications natively, which
means that you might be able to run command-line
utilities. Some have reported success in running (to
varying degrees of success) various C++ compilers, and
the Borland Dephi and Turbo Pascal for Windows
compilers. Others have reported success in running the
Borland C++ 5.0 command line compiler (bcc) as well as
some of the debugging tools in the MS SDK, but these
compilers' IDEs generally do not run yet.

What You Need to Run Wine



41. Under what hardware platform(s) and operating system(s)
will Wine run?

Wine is being developed specifically to run on the
Intel x86 class of CPUs under certain UNIXes that run
on the x86 platform. UNIXes currently being tested for
Wine compatibility include Linux, FreeBSD, and Solaris
x86. NetBSD, OpenBSD, Unixware, and SCO OpenServer 5
worked at one time, but Wine now requires kernel-level
threads which are not currently available (or
understood by the Wine team) in those platforms. The
Wine development team hopes to attract the interest of
other commercial UNIX and UNIX clone vendors as well.

There are side efforts underway to port Wine to the
Alpha, OS/2, and BeOS platforms. You can find out more
information about the OS/2 port at http://
http://www.winehq.com/wine/documentation/wine_os2



42. What minimum CPU must I have in my computer to be able
to run Wine and MS Windows applications smoothly?

Wine won't run on any x86 CPU less than an 80386. It is
known to also work in the 80486 and Pentium CPUs.
Beyond that, the basic test is, if you can run X11 now,
you should be able to run Wine and MS Windows
applications under it. As always, the faster your CPU,
the better. Having a math coprocessor is unimportant.
However, having a graphics accelerated video card
supported by X will help greatly.



43. How much disk space will the Wine source code and
binaries take on my hard drive? What other software do
I need to have installed to compile and run Wine?

You need approximately 220 megabytes of free hard drive
space to store and compile the source code. Wine also
needs about 18 megs in your /tmp directory.

Many development tools need to be installed in order to
compile Wine. A list of required packages for several
distributions is included in the README.

To run Wine, you will need the following:
+ The compiled Wine binary
+ A properly configured wine.conf file (or ~/.winerc
file)
+ An installed and working X Window system
+ Some MS Windows programs to test



44. How much RAM do I need to have on my UNIX system to be
able to run Wine and MS Windows applications smoothly?

If you can run X smoothly on your UNIX system now, you
should be able to run Wine and MS Windows applications
just fine too. A typical Wine workstation should
realistically have at least 16 megabytes of RAM and a
16 megabyte swap partition. More is better, of course.
You can run Wine with 8/8, but it is not recommended.
If you wish to be part of the development team and
program Wine itself, be aware that the new debugger is
rather memory intensive. Some have suggested that 64
megabytes is the minimum RAM needed for Wine
development, although some are able to work (albeit
slowly) with 24 megabytes of physical RAM and lots of
swap space.



45. I have a Drivespaced, Doublespaced or Stackered DOS
partition. Can Wine run MS Windows binaries located in
such a partition?

Yes, but only if the operating system supports mounting
those types of drives.

There is a Linux filesystem driver called dmsdos that
will allow read/write access through Doublespaced and
Drivespace 1.0 drives. More specifically, it supports
mounting DOS 6.0 and 6.2 Doublespaced, DOS 6.22
Drivespaced, and Windows 95 Doublespaced compressed
partitions (read and write access works fine, but write
access is slow). It can be found at ftp://
metalab.unc.edu/pub/Linux/system/filesystems/dosfs/.



46. Do I need to have a DOS partition on my system to use
Wine? Does MS Windows need to be loaded into that
partition in order to run MS Windows programs under
Wine?

Unlike Wabi, you do not need a licensed and installed
copy of DOS or MS Windows to install, configure and run
Wine. However, Wine has to be able to 'see' an MS
Windows binary if it is to run it.

Some folks have successfully installed and run some
small programs in their UNIX filesystem without having
a DOS partition or MS Windows. However, not all
programs will work this way yet. Some applications'
installation programs want to distribute some of the
package's files into the /windows and /windows/system
directories in order to run, and unless these exist on
your UNIX filesystem, those programs will not install
correctly and probably will not run well, if at all.

If you have a DOS partition with MS Windows installed
in it, make sure that your UNIX system can 'see' this
partition (check your /etc/fstab file or mount the
partition manually) so that Wine can run the MS Windows
binaries located in the DOS partition.

When it is finished, Wine will not require that you
have a DOS partition on your system at all, meaning
that you will not need to have MS Windows installed
either. Wine programmers will provide an application
setup program to allow you to install your MS Windows
programs straight from your distribution diskettes or
CDs onto your UNIX filesystem, or from within your UNIX
filesystem if you ftp an MS Windows program over the
Internet.

To run without a DOS partition, you need to set a UNIX
path to be your drive C, and make sure that the /
windows and /windows/system directories point to some
place that actually exist. Here's an example, copied
from a machine which has no DOS partition but
successfully runs Wine
[Drive C]
Path=/var/lib/wine
Type=hd
Label=MS-DOS
Filesystem=win95

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

In /var/lib/wine/windows, you will need to install a
win.ini config file that you might find on a typical MS
Windows 3.1 machine. The directory /var/lib/wine/
windows/system should exist, but doesn't need to
contain anything. However, to use MS DLLs, you can copy
them into that directory.

If you have DOS/MS Windows installed on your system,
you can mount that partition at bootup by modifying the
file /etc/fstab in your UNIX partition. If you edit
this file by hand, it should contain something similar
to the following
/dev/hda1 /dosc msdos uid=0,gid=100,umask=007 0 0

This will allow you to read and write to the DOS
partition without being root.



47. If Wine completely replaces MS Windows, will it
duplicate all of the functions of MS Windows?

Most of them, yes. However, some applications and
applets that come with MS Windows, such as File Manager
and Calculator, can be considered by some to be
redundant, since 32-bit UNIX programs that duplicate
these applets' functions already exist.



48. Will I be able to install MS Windows applications in
any flavor of a UNIX filesystem?

Wine is written to be filesystem independent, so MS
Windows applications will install and run under any
filesystem supported by your brand of UNIX.



49. Will Wine run only under X, or can it run in character
mode?

Most of Wine's development effort is geared against MS
Windows' GUI, but some limited support for character
mode has appeared, by setting GraphicsDriver=ttydrv in
wine.conf's [wine] section.



50. Will Wine run under any X window manager? Does it
require a window manager at all?

Wine is window manager independent, so the X window
manager you choose to run has no bearing on your
ability to run MS Windows programs under Wine. Wine
uses standard X libraries, so no additional ones are
needed. Wine has its own window management, which acts
like MS Windows. It can be turned off to use the native
window manager with the -managed command-line switch.



51. Will 32-bit Windows 95/98 applications run under Wine?

Yes, 32-bit programs are now about as well supported as
16-bit programs.



52. What about NT specific programs, which use NT-only
features?

These are only poorly supported.

How to Find, Install, Configure and Run Wine



53. Where can I get Wine?

Because of lags created by using mirror, word of this
newest release may reach you before the release is
actually available at the ftp sites listed here. The
sources are available from the following locations:
+ ftp://metalab.unc.edu/pub/Linux/ALPHA/wine/
development/
+ ftp://tsx-11.mit.edu/pub/linux/ALPHA/Wine/
development/
+ ftp://ftp.infomagic.com/pub/mirrors/linux/sunsite/
ALPHA/wine/development/
+ ftp://ftp.progsoc.uts.edu.au/pub/Wine/development/

It should also be available from any site that mirrors
tsx-11 or metalab (formerly sunsite).

Some of these ftp sites may archive previous versions
of Wine as well as the current one. To determine which
is the latest one, look at the distribution filename,
which will take the form Wine-YYMMDD.tar.gz. Simply
replace YYMMDD in the distribution filename with the
numbers for year, month and date, respectively. The
latest one is the one to get.

Wine binary packages are available for several OS'es
and distributions. See http://www.winehq.com/
download.html for the most recent list.

Current Wine sources are also available via anonymous
client/server CVS. You will need CVS 1.9 or above. If
you are coming from behind a firewall, you will either
need a hole in the firewall for the CVS port (2401) or
use SOCKS. To login to the CVS tree, do
export CVSROOT=:pserver:cvs@cvs.winehq.com:/home/wine
cvs login

Use "cvs" as the password (without the quotes). Note
that /home/wine is a path on the server, not on your
machine.

To check out the entire Wine source tree (which may be
slow), use
cvs -z 3 checkout wine

or if you just want a subtree, or individual file, you
can do that too with
cvs -z 3 checkout wine/ANNOUNCE

Be aware, though, that getting the entire Wine source
tree via CVS is pretty slow, especially compared to
getting Wine from an FTP mirror near you.

Patch files are also available, so that you don't have
to download, install and configure the entire
distribution each week if you are current to the
previous release. Patch file release names follow the
same numbering convention as do the general releases,
and take the form

Wine-YYMMDD.diff.gz

Patch files are available from the same sites that
distribute the full release. To upgrade to a new
release by using a patch file, first cd to the
top-level directory of the release (the one containing
the README file), then do a "make clean", and patch the
release with
gunzip -c patch-file | patch -p1

where patch-file is the name of the patch file
something like Wine-YYMMDD.diff.gz. You can then re-run
./configure, and then run make depend && make.

If you are mirroring the Wine distribution from the
tsx-11 site and wish to be listed here in this FAQ,
please send email to the FAQ author/maintainer at
webmaster@winehq.com



54. If I do not have an Internet account, how can I get
Wine?

Some CD-ROM archives of Internet sites, notably those
from Walnut Creek that archive ftp.cdrom.com and
metalab.unc.edu, may include some versions of Wine on
their CD releases. However, the age of these
distributions should always be questioned, as the
'snapshot' of the ftp site may have been taken anywhere
from 1-4 months (or more) prior to the CD's pressing
date.

Your best bet to get the very latest distribution of
Wine, if you do not have your own Internet account, is
to find a friend who does have an Internet account, and
have him/her ftp the necessary file(s) for you.
Unfortunately, since the Wine source no longer fits on
a 1.44 MB floppy, you'll have to figure out some way to
transfer the file to your computer.

If you have an email account on a BBS that can reach
the Internet through a gateway, you may be able to use
'email ftp' to get the Wine release sent to you; check
with your BBS system operator for details.



55. How do I install Wine on my hard drive?

Just un-gzip and un-tar the file, and follow the
instructions contained in the README file that will be
located in the base Wine directory.



56. How do I compile the Wine distribution source code?

See the README for instructions. Additionally, you may
want to set the TMPDIR environment variable TMPDIR=~/
tmp or TMPDIR=/tmp (if you are root)



57. How do I configure Wine to run on my system?

Wine requires that you have a file called usr/local/etc
/wine.conf (you can supply a different filename when
configuring wine) or a file called .winerc in your home
directory. The format of this file is explained in the
wine.conf man page . The file wine.ini contains a
config file example. More explicit directions can be
found in the README file that will be located in the
base Wine directory after you ungzip and untar the
distribution file.



58. How do I run an MS Windows program under Wine?

When invoking Wine, you must specify the entire path to
the executable, or by filename only.

For example to run Windows' solitaire, type any of the
following:
+ wine sol or wine sol.exe (using the search path to
locate the file)
+ wine c:\\windows\\sol.exe (using a DOS filename)
+ wine /usr/windows/sol.exe (using a UNIX filename)

The path of the file will also be added to the path
when a full name is supplied on the command line.



59. I have installed and configured Wine, but Wine cannot
find MS Windows on my drive. Where did I go wrong?

If you have a DOS partition, first make sure that you
have mounted it, either by putting the entry into [tt /
etc/fstab], or by manually mounting it. Remember too
that unless your version of UNIX can see through it, or
you are running a utility that can see through it, your
DOS partition must not be located on a Drivespaced,
Doublespaced or Stackered partition, as neither Linux,
FreeBSD, NetBSD or Wine can natively 'see' files
located in these compressed DOS partitions.

Check your path statements in the wine.conf file. No
capital letters may be used in paths, as they are
automatically converted to lowercase.



60. I'm running a DirectX game, but the graphics is slow,
how can I speed it up?

If you're using XFree86, you can take advantage of DGA.
You must have rw access to /dev/mem to do this. On many
distributions, you can add yourself to the kmem group.
Otherwise, you have to change /dev/mem permissions, or
even play as root.



61. I think I've found a bug. How do I report this bug to
the Wine programming team?

Bug reports should be posted to the newsgroup
comp.emulators.ms-windows.wine. See documentation/
bugreports for a list of what to include. This means at
least the following:
+ The Wine version tested
+ The MS Windows program name and, if possible, the
version number of the software tested
+ A brief description of the bug
+ The relevant part(s) of the output of the Wine
debugger



62. I was able to get various MS Windows programs to run,
but parts of them do not work. What is wrong?

Wine is not complete at this time, so some of each
programs' features may not work. They will in time as
more of the MS Windows API calls are included in Wine.



63. I have run various MS Windows programs, but since the
program menus do not work, how can I exit these
programs?

Kill the xterm shell window that you called up to run
your MS Windows program, and the X window that appeared
with the program will be killed too.



64. How do I remove Wine from my computer?

All you have to do is to type
rm -fR \[/path/\]Wine*

Make sure that you specify the exact path when using
the powerful 'rm -fR' command. If you are afraid that
you might delete something important, or might
otherwise delete other files within your filesystem, cd
into each Wine subdirectory singly and delete the files
found there manually, one file or directory at a time.
Neither the Wine developers and programmers, nor the
Wine FAQ author/maintainer, can be held responsible for
your deleting any files in your own filesystem.

How to Get Help with Wine



65. Is there a Usenet newsgroup for Wine?

Yes, and it's called comp.emulators.ms-windows.wine.
The newsgroup serves as a place for developers to
discuss Wine, and for minor announcements for the
general public. Major announcements will be crossposted
to other appropriate newsgroups, such as the following
comp.os.linux.announce comp.windows.x.announce
comp.emulators.announce If your Usenet site does not
carry these newsgroups, please urge your ISP's sysadmin
and/or uplink to add them.



66. Is there a World Wide Web site for Wine?

Here are a few
+ WineHQ The official site.
+ http://www.qbc.clic.net/~krynos/wine_en.html

If you are installing or maintain a WWW page pertaining
to Wine that you feel would be useful for others to
read, please inform the FAQ author/maintainer at
webmaster@winehq.com.

How You Can Help with the Wine Project



67. How can I help contribute to the Wine project, and in
what way(s)?

You can contribute programming skills, or monetary or
equipment donations, to aid the Wine developers in
reaching their goals. To find out who, what, where,
when and why, please post your desire to contribute to
the newsgroup comp.emulators.ms-windows.wine



68. I want to help beta test Wine. How can I do this?

Beta testers are currently not needed, as Wine is still
Alpha code at this time. However, anyone is welcome to
download the latest version and try it out at any time.



69. I have written some code that I would like to submit to
the Wine project. How do I go about doing this?

Patches are greatly appreciated and should be submitted
to the wine-patches mailing list. Also see this page
for a description of what happens to submitted patches.

Who's Responsible for Wine?



70. Who is responsible for writing and maintaining the Wine
source code?

Wine is available thanks to the work of many people.
Please see the file AUTHORS in the distribution for the
complete list.



71. Who are the folks and organizations who have
contributed money or equipment to the Wine project?

People and organizations who have given generous
contributions of money, equipment, or licenses, include
+ David L. Harper
+ Bob Hepple
+ Mark A. Horton
+ Kevin P. Lawton
+ the Syntropy Institute
+ James Woulfe
+ vmWare Inc.
+ Corel
--The Devil is in the Details--

Post Reply