1 <!-- *** Wine FAQ *** -->
2 <title>Wine FAQ
</title>
5 <qandadiv id=
"About-this-FAQ"><title>About this FAQ
</title>
7 <question id=
"Who-maintains-this-FAQ">
8 <para>Who maintains this FAQ ?
</para>
11 <para>Dave Gardner maintained it from
1995-
1998.
</para>
12 <para>Douglas Ridgway (ridgway@winehq.org) took it over in
1999.
</para>
13 <para>Andreas Mohr (amohr@codeweavers.com) converted it to FAQ-O-Matic in
2000.
</para>
14 <para>Dimitrie O. Paun, Keith Matthews and Tom Wickline (in alphabetical order) reorganized it in
2002.
</para>
15 <para>For suggestions/additions/complaints regarding this FAQ, please send an email to
16 <ulink url=
"mailto:wine-faq@winehq.org">wine-faq@winehq.org
</ulink></para>
20 <question id=
"What-is-the-copyright-on-the-FAQ-And">
21 <para>What is the copyright on the FAQ? And how may I use it?
</para>
24 <para>The original Wine FAQ, which this FAQ was based on, was copyright
© 1995-
1998 David Gardner.
</para>
25 <para>It may be reproduced and modified under the same terms as Wine itself.
</para>
29 <qandadiv id=
"General-Questions-about-Wine">
30 <title>General Questions about Wine
</title>
33 <question id=
"What-is-Wine-and-what-is-it-supposed-to">
34 <para>What is Wine and what is it supposed to do?
</para>
38 Wine is a program which allows the operation of DOS and MS
39 Windows programs (Windows
3.x and Win32 executables) on UNIX operating systems such as Linux.
40 It consists of a program loader, which loads and executes a Windows
41 binary, and a set of libraries that implements Windows API calls
42 using their UNIX or X11 equivalents. The libraries may also be used
43 for porting Win32 code into native UNIX executables, often
44 without many changes in the source. Wine is free software,
45 and its license (contained in the file LICENSE
46 in each distribution) is the LGPL.
52 <question id=
"Is-Wine-an-emulator">
53 <para>Does Wine emulate a full computer?
</para>
57 No, as the name says, Wine Is Not a (CPU) Emulator. Wine just
58 provides the Windows API. This means that you will need an
59 x86-compatible processor to run an x86 Windows application, for instance from Intel or AMD. The
60 advantage is that, unlike solutions that rely on CPU emulation, Wine
61 runs applications at full speed. Sometimes a program run under
62 Wine will be slower than when run on a copy of Microsoft Windows, but
63 this is more due to the fact that Microsoft have heavily optimized parts of their
64 code, whereas mostly Wine is not well optimized (yet). Occasionally, an app
65 may run faster under Wine than on Windows. Most apps run at roughly the same speed.
71 <question id=
"Are-here-any-alternatives-to-Wine">
72 <para>Are there any alternatives to Wine?
</para>
76 Yes, there are. You can use
<ulink url=
"http://www.vmware.com">VMWare
</ulink> to run a Windows installation inside a virtual machine,
77 or use
<ulink url=
"http://www.win4lin.com">Win4Lin
</ulink>
78 to run a specially adapted Windows version on Linux.
79 Both solutions cost money for both the software itself
80 and a Windows license.
83 Note that, like Wine, they can only use the hardware platform that
84 the target programs were originally compiled for (see below).
90 <question id=
"Difference-between-Wine-and-emulators">
91 <para>What is the difference between Wine and x86 hardware emulators?
</para>
95 There are two free x86 hardware emulators:
96 <ulink url=
"http://bochs.sourceforge.net">Bochs
</ulink>, and
97 <ulink url=
"http://savannah.nongnu.org/projects/plex86">Plex86
</ulink>.
101 Plex86 is the open-source free-software alternative for VMWare,
102 VirtualPC, and other IA-
32 on IA-
32 "Virtual PC products." It
103 can only run on the IA-
32 architecture.
107 Bochs is a highly portable open source IA-
32 (x86) PC emulator
108 written in C++, that runs on most popular platforms. It includes emulation
109 of the Intel x86 CPU, common I/O devices, and a custom BIOS. Currently,
110 Bochs can be compiled to emulate a
386,
486 or Pentium CPU. Bochs is capable
111 of running most Operating Systems inside the emulation including Linux,
112 Windows®
95, DOS, and recently Windows® NT
4.
116 Both are licensed under the GPL. Bochs is older than Plex86, seems to be
117 easier to install, but Plex86 will run faster because Plex86 uses a just in
118 time binary compiler.
121 The drawback of all emulators is that you need a version
122 of Windows in order to run Windows, and that they all have an
123 impact on performance. Wine also gives much better desktop integration - for
124 instance, programs use your standard window manager, system tray icons will
125 appear in your tray area (if you have one), and you can run programs direct from the
126 command line and the menus. The clipboard also works seamlessly.
133 <question id=
"Integrate-an-x86-emulator">
134 <para>When will Wine integrate an x86 CPU emulator so we can
135 run Windows applications on non-x86 machines?
</para>
139 The short answer is 'probably never'. Remember, Wine Is Not a
140 (CPU) Emulator. The long answer is that we probably don't want or
141 need to integrate one in the traditional sense.
144 Integrating a CPU emulator in Wine would be extremely hard,
145 due to the large number of Windows APIs and the complex
146 data types they exchange. It is not uncommon for a Windows API to
147 take three or more pointers to structures composed of many fields,
148 including pointers to other complex structures. For each of these
149 we would need a conversion routine to deal with the byte order and
150 alignment issues. Furthermore, Windows also contains many callback
151 mechanisms that constitute as many extra places where we would have
152 to handle these conversion issues. Wine already has to deal with
153 16 vs.
32 bit APIs and Ansi vs. Unicode APIs which both
154 introduce significant complexity. Adding support for a CPU emulator
155 inside Wine would introduce at least double that complexity and
156 only serve to slow down the development of Wine.
159 Fortunately another solution exists to run Windows applications
160 on non-x86 platforms: run both Wine and the application inside the
161 CPU emulator. As long as the emulator provides a standard Unix
162 environment, Wine should only need minimal modifications. What
163 performance you lose due to Wine running inside the emulator
164 rather than natively, you gain in complexity inside of Wine.
165 Furthermore, if the emulator is fast enough to run Windows
166 applications, Photoshop for instance, then it should be fast enough
167 to run that same Windows application plus Wine.
170 Two projects have started along those lines:
<ulink
171 url=
"http://fabrice.bellard.free.fr/qemu/">QEMU<
/>, an
172 open-source project, and
<ulink
173 url=
"http://www.transitives.com/tech_overview.htm">Dynamite<
/>,
174 a commercial CPU emulator environment from
175 <ulink url=
"http://www.transitives.com/">Transitives Technologies<
/>
176 which has been
<ulink
177 url=
"http://www.transgaming.com/news.php?newsid=37">paired
185 <question id=
"Why-would-anyone-want-Wine-Windows-suck">
186 <para>Why would anyone want Wine? Doesn't Windows suck?
</para>
190 First Wine is not about running Windows but about running Windows
194 So if all your computing needs are fulfilled by native Unix
195 applications, then you do not need Wine and should not be using
196 it. However, if you depend on one or more of the tens of
197 thousands of Windows applications, then Wine is the best way to
198 use it without giving up on Unix. Let's look at the alternatives
202 The most obvious alternative is to dual-boot. This is the solution
203 that provides the best compatibility. However it requires that you
204 acquire a Windows license and then dedicate a good chunk of your
205 hard-drive to Windows. But the worst is yet to come. Each time you
206 will want to use that application you will have to reboot to
207 Windows. This is especially significant if external factors dictate
208 when you must use this application (e.g. credit card to process,
209 email to retrieve from a Lotus Notes server). Then you will find
210 yourself forced to close all your Linux applications just to run
211 that one Windows application. You may quickly get tired of this, or
212 will find that such a situation is impossible to justify in a
213 business environment.
216 The next solution is to install virtual machine emulation software
217 such as VMWare, Win4Lin or Plex86. Then you can use windows
218 applications without suffering such a big disruption. But it still
219 requires that you acquire a Windows license and dedicate as much
220 disk space to Windows. Furthermore you will pay for the added
221 convenience: if using VMWare or Win4Lin you have to buy another
222 license, and more importantly you now have to dedicate a good chunk
223 of your computer's memory to the virtual machine. Performance will
224 take a significant hit too.
227 Using Wine lets you avoid all of that overhead: Windows license,
228 hard-drive space required by Windows, memory and performance hit
229 taken by emulated virtual machines. Now you can start your Windows
230 application straight from your regular desktop environment, place
231 that application's window side by side with native applications,
232 copy/paste from one to the other, and run it all at full speed.
235 It is also a pretty vital part of migrating a large organization,
236 you can't change a
5000 desktop setup overnight without a lot of risk.
242 <question id=
"Use-Windows-driver-with-Wine">
243 <para>Can I use Wine to make the Windows driver for my network card /
244 graphics card / scanner / etc. work on Unix?
</para>
248 The goal of Wine is to make it possible to run Windows applications
249 on Unix, not Windows drivers or VxDs.
252 Drivers and Windows applications belong to different worlds.
253 Applications run in user mode and use the APIs provided by
254 the kernel and the other user mode dlls. In contrast, drivers
255 are loaded in the Windows kernel, i.e. in ring
0 instead of ring
256 3, have to deal with specific memory management issues, and use
257 instructions not available to regular applications. This means
258 they would not be able to run in Wine since Wine runs entirely
259 in user mode. Rather you would have to modify the Linux kernel.
260 But in addition, drivers use a completely different API from
261 regular Windows applications. So the work performed on Wine would
262 not even be of any use for such a project. In other words, making
263 it possible to use Windows drivers or VxDs on Unix would be a
264 completely separate project.
267 However, if you want to reuse Windows drivers on a non-Microsoft
268 operating system we recommend that you have a look at
269 <ulink url=
"http://www.reactos.com/">ReactOS<
/>.
276 <question id=
"Which-one-of-the-different-Wine-packages">
277 <para>Which one of the different Wine packages out there is good for me?
</para>
281 Currently there is a broad selection of different Wine packages/versions:
286 <term><ulink url=
"http://www.winehq.org">Wine
</ulink></term>
289 This is the
"standard" distribution of Wine. Its license is
290 the LGPL, it can be downloaded for free. Both source code and binaries
291 are available in the download section of the site.
297 <term><ulink url=
"http://rewind.sourceforge.net">ReWind
</ulink></term>
300 This is a forked Wine tree that got created when Wine changed its
301 license from X11 to the more restrictive LGPL, in order to let
302 people continue to maintain an X11 licensed Wine version. Its
303 license is X11, it can be downloaded for free.
309 <term><ulink url=
"http://www.transgaming.com">TransGaming's WineX
</ulink></term>
312 This is TransGaming's Wine version specially suited for
313 games. It includes more mature Direct3D support than
314 WineHQ, although these days WineHQ has quite advanced
315 D3D support as well. Most of the code is under the AFPL
316 and can be downloaded for free.
319 However TransGaming also distributes binaries that contain
320 improved copy protection support (needed for many
321 games), support, and other enhancements. These packages are
322 only available in binary form to subscribed customers
323 ($
5/month, minimum three months).
329 <term><ulink url=
"http://wine.codeweavers.com">CodeWeavers' Wine preview
</ulink></term>
332 This is a special packaged version of the standard Wine tree
333 which has a nice setup for easy installation. License LGPL, free
334 download. It's pretty old now, and not recommended for general use.
340 <term><ulink url=
"http://www.codeweavers.com/products/crossover/">CodeWeavers' CrossOver Plugin
</ulink></term>
343 Special Wine installation to be used for running Windows
344 Netscape browser plugins such as e.g. QuickTime in Linux
345 browsers. Costs $
34.95.
346 Well worth it (very stable and useful packaging).
352 <term><ulink url=
"http://www.codeweavers.com/products/office/">CodeWeavers' CrossOver Office
</ulink></term>
355 Wine version with special packaging to make sure almost all
356 important Office type programs work pretty well. Costs $
54.95.
357 Seems to be well worth it so far according to some comments.
358 (note: you're supporting a company actively contributing to Wine
359 if you decide to buy either Plugin or Office.)
365 <term><ulink url=
"http://www.codeweavers.com/products/cxofficeserver/">CodeWeavers' CrossOver Office Server Edition
</ulink></term>
368 Allows you to run your favorite Windows productivity applications in
369 a distributed thin-client environment under Linux. Server Edition is
370 also a great addition to Solaris environments, since there built-in
371 support for Solaris desktops makes running Windows applications a
372 possibility on Sun workstations as well. For pricing just follow this link:
373 <ulink url=
"http://www.codeweavers.com/products/pricing.php">CrossOver Office Server Edition Pricing
</ulink>
383 <question id=
"Whats-the-history-of-Wine">
384 <para>What's the history of Wine?
</para>
388 The Wine project started in
1993 as a way to support running Windows
3.1
389 programs on Linux. Bob Amstadt was the original coordinator, but turned
390 it over fairly early on to Alexandre Julliard, who has run it ever
391 since. A
<ulink url=
"news:comp.emulators.ms-windows.wine">newsgroup
</ulink>
392 was created in July
1994. Over the years, ports for
393 other Unixes have been added, along with support for Win32 as Win32
394 applications became popular.
397 For more information, see
<ulink url=
"http://www.winehq.org/site/about">
398 http://www.winehq.org/site/about
</ulink>
404 <question id=
"What-is-the-current-version-of-Wine">
405 <para>What is the current version of Wine?
</para>
409 A new version of Wine is distributed about every month. You will be
410 able to keep up on all the latest releases by reading the newsgroup
411 <ulink url=
"news:comp.emulators.ms-windows.wine">
412 comp.emulators.ms-windows.wine
</ulink>, or by visiting the
413 <ulink url=
"http://www.winehq.org">Wine HQ homepage
</ulink>. When
414 downloading Wine from your FTP site of choice (see
415 <ulink url=
"http://www.winehq.org/download.shtml">the Download page
</ulink>
416 for some of these choices), you can make sure that you are getting
417 the latest version by watching the version numbers in the distribution
418 file name. For instance, the distribution released on August
13,
2003
419 was called Wine-
20030813.tar.gz. Patch files are also available. If
420 you are current to the previous version, you can download and apply
421 just the current patch file rather than the entire new distribution.
422 The patch file names follow the same conventions as the monthly
423 distribution.
<ulink url=
"http://www.winehq.org/site/cvs">
424 Read-only CVS
</ulink> access is also available.
430 <question id=
"What-is-the-current-Status-of-Wine">
431 <para>What is the current Status of Wine?
</para>
435 As of mid
2003, Wine consists of about
1.4 million lines of code,
436 written by more than
550 developers from dozens of countries around
437 the world. Wine is in active use by an estimated
100K people. Wine
438 implements more than
90% of the calls in popular Windows
439 specifications such as ECMA-
234 and Open32.
442 You may also want to look at the
443 <ulink url=
"http://www.winehq.org/site/status">
444 Status page
</ulink> for a global view on Wine's implementation progress.
450 <question id=
"When-will-Wine-be-finished">
451 <para>When will Wine be finished?
</para>
455 Large software projects are never finished, only released. In any
456 case Wine is chasing a moving target since every new release of
457 Windows contains new API calls or variations on the existing ones.
460 Because Wine is being developed by volunteers, it is difficult to
461 predict when it will be ready for general release. But due to the
462 much increased interest by companies in porting apps via Wine, Wine
463 development is constantly getting more and more active. Right now
464 we are working on releasing Wine
0.9 Real Soon Now(tm).
470 <question id=
"Who-is-responsible-for-Wine">
471 <para>Who is responsible for Wine?
</para>
475 Wine is available thanks to the work of many people. Please see the
476 <ulink url=
"http://source.winehq.org/source/AUTHORS">AUTHORS
</ulink>
477 file in the distribution for the complete list. Some companies that
478 are or have been involved with Wine development are CodeWeavers,
479 TransGaming, Corel, and Macadamian.
485 <question id=
"folks-who-contributed-money-or-equipment">
486 <para>Who are the folks and organizations who have contributed money or equipment to the Wine project?
</para>
490 People and organizations who have given generous contributions of
491 money, equipment, or licenses, include:
493 <itemizedlist spacing=
"compact">
495 <para>David L. Harper
</para>
498 <para>Bob Hepple
</para>
501 <para>Mark A. Horton
</para>
504 <para>Kevin P. Lawton
</para>
507 <para>The Syntropy Institute
</para>
510 <para>James Woulfe
</para>
514 VMWare Inc. (
<ulink url=
"http://www.vmware.com">
515 http://www.vmware.com
</ulink>)
520 Corel (
<ulink url=
"http://www.corel.com">
521 http://www.corel.com
</ulink>)
527 (
<ulink url=
"http://www.codeweavers.com/">http://www.codeweavers.com
</ulink>)
535 <question id=
"What-undocumented-APIs-are-not-understood">
536 <para>What undocumented APIs / interfaces are not understood? Would
537 seeing Microsoft source help?
542 The best would be if the Windows API was fully documented, so Wine
543 could be a perfect
"clean-room" implementation. Seeing the source
544 code might make it harder to prove that no copyright violations have
545 taken place. That said, the documentation is often bad, nonexistent,
546 and even misleading where it exists, so a fair amount of reverse
547 engineering has been necessary, particularly in the shell (Explorer)
548 interface. The biggest problem facing Wine though is simply lack of
549 manpower. At one point, over
5000 people were working on Windows
2000.
550 While Wine doesn't need to replicate all of Windows (we only cover the
551 parts needed to make Windows programs work), that's still nearly
10 times
552 more people working simply on one release than have
<emphasis>ever
</emphasis>
553 worked on Wine, in the history of the project.
559 <question id=
"Is-TransGamings-last-patch-included-in-Wine">
560 <para>Is TransGaming's latest patch included in the standard Wine release?
</para>
567 TransGaming makes money via a subscription service and the license
568 of their WineX tree is incompatible with the Wine license. Thus
569 WineX patches cannot be integrated into the Wine tree without
570 express permission by TransGaming. They have submitted some
571 of their work for integration into Wine, most notably DirectDraw
572 and some DirectSound work, and such work has been integrated into
573 the Wine tree. However it seems unlikely they will submit their
580 <question id=
"Will-there-be-a-Windows-version-of-Wine">
581 <para>Will there be a Windows version of Wine?
</para>
585 Some people are working on getting Wine code to compile on Windows
586 using one of the following projects as a basis:
588 <itemizedlist spacing=
"compact">
592 (
<ulink url=
"http:/www.cygwin.com/">http://www.cygwin.com
</ulink>)
598 (
<ulink url=
"http:/www.mingw.org/">http://www.mingw.org
</ulink>)
604 (
<ulink url=
"http://www.reactos.com/">http://www.reactos.com
</ulink>)
609 There's some progress, so a Wine version that's usable on Windows
610 might be available at some time.
613 Part of the rationale for these projects is to find out areas where
614 Wine portability is lacking. This is especially true of the
615 ReactOS project which is a reimplementation of the Windows kernel
616 and should thus be able to reuse most of Wine dlls.
619 Another reason for pursuing these projects is to be able to
620 replace a single Windows dll with its Wine counterpart. Besides
621 being a good test for the Wine dll, this lets us detect cases where
622 we made incorrect assumptions about how the dlls interact.
628 <qandadiv id=
"What-do-I-need-in-order-to-use-Wine">
629 <title>What do I need in order to use Wine?
</title>
631 <question id=
"Under-what-platforms-will-Wine-run">
633 Under what hardware platform(s) and operating system(s) will
639 Wine is being developed specifically to run on the
<emphasis>Intel
640 x86
</emphasis> class of CPUs under certain UNIXes that run on this
641 platform. Winelib however is capable of porting the Windows
642 applications
<emphasis>source code
</emphasis> to other platforms
646 Thus running Windows binaries on other platforms (e.g. Mac OS X on
647 PowerPC) using just Wine is
<emphasis>not
</emphasis> possible. You
648 would have to either run Wine in an emulated x86 environment or
649 take the Windows application source code and recompile it using
653 These are the platforms supported by Wine.
654 Winelib support for other platforms keeps evolving,
655 so it's not specifically listed here.
658 NetBSD, OpenBSD, UnixWare, and SCO OpenServer
5 worked at one time,
659 but Wine now requires kernel-level threads which are not currently
660 available (or understood by the Wine team) on those platforms.
663 The Wine development team hopes to attract the interest of other
664 commercial UNIX and UNIX clone vendors as well.
667 BeOS: porting efforts (BeWine) used to be pretty strong, but BeOS
668 has severe limitations in Unix call support. The demise of Be
669 further hampered the project though it might come back one day on
670 one of the open BeOS projects. In any case a functional port seems
671 unlikely to ever happen at this stage.
674 Mac OS X / Darwin: The
<ulink
675 url=
"http://darwine.sourceforge.net/project.html">Darwine<
/> is
676 currently working on porting Wine to the Darwin/x86 platform. Their
677 goal is to eventually make it possible to run x86 Windows
678 applications on Darwin/PPC and then Mac OS X by using Bochs.
681 FreeBSD: This port is well maintained and should work with
682 limitations in specific areas (mainly missing device/hardware
686 Linux/x86: Works, and as the most popular platform for both
687 developers and users, it is the best supported platform of all.
693 <question id=
"What-minimum-CPU-must-I-have">
695 What minimum CPU must I have in my computer to be able to run Wine
696 and MS Windows applications smoothly?
701 We need to differentiate between Wine and Winelib here.
704 Wine won't run on any x86 CPU less than an
80386 due to address
705 management limitations.
708 It is known to also work in the
80486 and upwards compatible CPUs.
709 The basic test is, if you can run X11 now, you should be able to run
710 Wine and MS Windows applications under it.
713 As always, the faster your CPU, the better. Having a math coprocessor
714 is unimportant. However, having a graphics accelerated video card
715 supported by X will help greatly.
718 Depending on your application you may find that faster speeds are
719 required for sensible use. We can't give specific advice on that due
720 to the vast range of applications out there. However the rule of
721 thumb is that if your application runs fine on Windows, it should
722 run fine on the same platform in Wine.
728 <question id=
"How-much-disk-space-will-Wine-take">
730 How much disk space will the Wine source code and binaries take on my
736 You need approximately
250 megabytes of free hard drive space to
737 store and compile the source code. Wine also needs about
18 megs in
738 your /tmp directory. And about
50 MB are needed to do a make install.
741 Binary packages, especially those not containing debug information,
742 have much lower disk space requirements, usually in the
20MB range.
748 <question id=
"What-other-software-do-I-need-to-compile">
750 What other software do I need to install, compile and run
756 Many development tools are needed in order to compile Wine.
757 A list of required packages for several distributions is included in
758 the README (
<ulink url=
"http://source.winehq.org/source/README">
759 http://source.winehq.org/source/README
</ulink>).
762 To run Wine, you will need the following:
765 <itemizedlist spacing=
"compact">
767 <para>The compiled Wine binary
</para>
770 <para>A properly configured wine.conf file (or ~/.winerc file)
</para>
773 <para>An installed and working X Window system
</para>
776 <para>Some Windows programs to test
</para>
782 <question id=
"How-much-RAM-do-I-need">
784 How much RAM do I need to have on my UNIX system to be able to run
785 Wine and MS Windows applications smoothly?
790 If you can run X smoothly on your UNIX system now, you should be
791 able to run Wine and MS Windows applications just fine too, depending
792 on how memory hungry the application is.
795 A Wine workstation will work with
16 megabytes of RAM and a
16
796 megabyte swap partition as long as you have a reasonable graphics
797 card. Most applications will run reasonably with
64/
64 Mb,
798 interactive games are likely to need more. You can run Wine with
8/
8,
799 but it is going to be unusably slow and very constraining on the
800 applications you can run. If you wish to be part of the development
801 team and program Wine itself, be aware that the debugger is rather
802 memory intensive. Some have suggested that
64 megabytes is the
803 minimum RAM needed for Wine development, although some are able to
804 work (albeit slowly) with
24 megabytes of physical RAM and lots of
811 <question id=
"How-long-does-Wine-take-to-build">
812 <para>How long does Wine take to build
</para>
816 Wine is getting to be quite large, and building from scratch takes a
817 lot of processing. As of September
2002, compile times were around
20
818 minutes on an Athlon
1200 with
640 Mb and
45-
50 minutes on a Cyrix
819 300 with
64 Mb. If you have a CVS copy, you may not need to rebuild
820 the whole thing every time you update.
825 <question id=
"I-have-a-Drivespaced-partition">
827 I have a Drivespaced, Doublespaced or Stackered DOS partition. Can
828 Wine run MS Windows binaries located in such a partition?
833 Yes, but only if the operating system supports mounting those types
834 of drives. There is a Linux file system driver called dmsdos that
835 will allow read/write access to Doublespaced and Drivespace
1.0
836 drives. More specifically, it supports mounting DOS
6.0 and
6.2
837 Doublespaced, DOS
6.22 Drivespaced, and Windows
95 Doublespaced
838 compressed partitions (read and write access works fine, but write
839 access is slow). It can be found at
840 <ulink url=
"ftp://metalab.unc.edu/pub/Linux/system/filesystems/dosfs/">
841 ftp://metalab.unc.edu/pub/Linux/system/filesystems/dosfs/
</ulink>
847 <question id=
"Do-I-need-to-have-a-DOS-partition">
848 <para>Do I need to have a DOS partition on my system to use Wine?
</para>
852 You do not need a licensed and installed copy of DOS or MS Windows to
853 install, configure and run Wine. However, Wine has to be able to
854 'see' an MS Windows binary (i.e. application) if it is to run it.
860 <question id=
"Does-MS-Windows-need-to-be-installed">
862 Does MS Windows need to be loaded into that partition in order to
863 run MS Windows programs under Wine?
868 Many folks have successfully installed and run programs
869 in their UNIX file system without having a DOS partition or MS
870 Windows. However, in many cases you need a directory and file
871 infrastructure that is similar to an existing Windows installation.
872 Some applications' installation programs want to distribute some of
873 the package's files into the /windows and /windows/system
874 directories in order to run, and unless these exist on your UNIX
875 file system, those programs will not install correctly and probably
876 will not run well, if at all. Most packages will set that up for you
877 as part of the install process.
880 If you have a DOS partition with MS Windows installed in it, make
881 sure that your UNIX system can 'see' this partition (check your
882 /etc/fstab file or mount the partition manually) so that Wine can
883 run the MS Windows binaries located in the DOS partition. To run
884 without a DOS partition, you need to set a UNIX path to be your
885 drive C, and make sure that the /windows and /windows/system
886 directories point to some place that actually exist.
889 Here's an example, copied from a machine which has no DOS partition
890 but successfully runs Wine:
898 System=c:\windows\system
900 Path=c:\windows;c:\windows\system;c:
903 In
<filename>/var/lib/wine/windows
</filename>, you will need to
904 install a
<filename>win.ini
</filename> config file that you might
905 find on a typical MS Windows
3.1 machine. The directory
906 <filename>/var/lib/wine/windows/system
</filename> should exist, but
907 doesn't need to contain anything. However, to use MS DLLs, you can
908 copy them into that directory. Note that this is a contravention of
909 the Windows licence unless Windows is properly installed on the
910 machine. If you have DOS/MS Windows installed on your system, you can
911 mount that partition at bootup by modifying the file
912 <filename>/etc/fstab
</filename> in your UNIX partition (assuming that
913 the UNIX kernel supports the DOS/MS Windows file system type).
916 If you edit this file by hand, it should contain something similar
920 /dev/hda1 /dosc msdos uid=
0,gid=
100,umask=
007 0 0
923 This will allow you to read and write to the DOS partition without
930 <question id=
"If-Wine-completely-replaces-MS-Windows">
932 If Wine completely replaces MS Windows, will it duplicate all of the
933 functions of MS Windows?
938 Wine's goal is to make it possible to run Windows applications on
939 Unix. To this end it will provide replacements for just those
940 DLLs and APIs that are needed by these Windows applications.
941 This means that Wine will not provide replacements for DLLs that
942 are not shipped with Windows or are always shipped with Windows
943 application (e.g. the Visual Basic run time). This also
944 means that implementing an API that no application ever uses is not
945 a priority. Similarly, until there are applications out there that
946 use the Win64 API, it will not be a priority. That being said,
947 we will certainly try to keep our options open and to improve our API
951 Also Wine is not an operating system, so that writing device
952 drivers is not part of Wine's goals. However if you are interested
953 in device drivers, the
<ulink url=
"http://www.kernel.org/">Linux
</ulink>,
954 <ulink url=
"http://www.freebsd.org/">FreeBSD
</ulink> and
955 <ulink url=
"http://www.reactos.com/">ReactOS
</ulink> kernel developers
956 would certainly appreciate your contribution.
959 Similarly Wine does not try to be a desktop environment so
960 providing applets such as a calculator, a file manager or even
961 window manager that look like Windows, are low priority or would
962 even best be done as a separate project. Such projects would also
963 to a large extant be redundant with other open-source projects.
964 Again, there are projects that would certainly appreciate your
965 contributions in this areas, such as the
966 <ulink url=
"http://www.gnome.org/">Gnome
</ulink> or
967 <ulink url=
"http://www.kde.org/">KDE
</ulink> desktop environments. You
968 will get the added benefit that your contribution will then be
969 usable by everyone, not just by Wine users.
975 <question id=
"Will-I-install-on-any-UNIX-file-system">
977 Will I be able to install MS Windows applications in any flavor of a
983 Wine is written to be file system independent, so MS Windows
984 applications will install and run under virtually any file system
985 supported by your brand of UNIX.
991 <question id=
"Will-Wine-run-only-under-X">
992 <para>Will Wine run only under X, or can it run in character mode?
</para>
996 Most of Wine's development effort is geared towards MS Windows' GUI,
997 but some limited support for character mode has appeared, by setting
998 <parameter>GraphicsDriver=ttydrv
</parameter> in wine.conf's
999 <parameter>[wine]
</parameter> section.
1002 Wine's infrastructure is already somewhat prepared for supporting
1003 other graphics drivers than x11drv, but no real
"alternative"
1004 graphics driver has been developed yet.
1010 <question id=
"Will-Wine-run-under-any-X-window-manager">
1011 <para>Will Wine run under any X window manager? Does it require a window manager at all?
</para>
1015 Wine is window manager independent, so the X window manager you
1016 choose to run has (almost) no bearing on your ability to run MS
1017 Windows programs under Wine. Wine uses standard X libraries, so no
1018 additional ones are needed. Wine has its own window management,
1019 which acts like MS Windows. It can be turned off to use the native
1020 window manager by modifying Managed or Desktop settings as described
1021 in
<command>man wine.conf
</command>.
1027 <question id=
"Will-32-bit-applications-run-under-Wine">
1028 <para>Will
32-bit Windows
95/
98 applications run under Wine?
</para>
1032 Yes,
32-bit programs are now about as well supported as
16-bit
1039 <qandadiv id=
"FAQ-Getting-Wine">
1040 <title>Getting Wine
</title>
1042 <question id=
"Where-can-I-get-Wine">
1043 <para>Where can I get Wine?
</para>
1047 Because of lags created by using mirror, word of the latest release
1048 may reach you before the release is actually available at the ftp
1049 sites listed here. The sources are available from the following
1055 <ulink url=
"http://sourceforge.net/project/showfiles.php?group_id=6241&package_id=77449">
1056 http://sourceforge.net/project/showfiles.php?group_id=
6241&package_id=
77449
1062 <ulink url=
"http://www.ibiblio.org/pub/Linux/ALPHA/wine/development/">
1063 http://www.ibiblio.org/pub/Linux/ALPHA/wine/development/
1069 <ulink url=
"ftp://ftp.infomagic.com/pub/mirrors/linux/sunsite/ALPHA/wine/development/">
1070 ftp://ftp.infomagic.com/pub/mirrors/linux/sunsite/ALPHA/wine/development/
1077 <ulink url=
"ftp://ftp.fu-berlin.de/unix/linux/mirrors/sunsite.unc.edu/ALPHA/wine/development/">
1078 ftp://ftp.fu-berlin.de/unix/linux/mirrors/sunsite.unc.edu/ALPHA/wine/development/
1085 <ulink url=
"ftp://orcus.progsoc.uts.edu.au/pub/Wine/development/">
1086 ftp://orcus.progsoc.uts.edu.au/pub/Wine/development/
1093 It should also be available from any other site that mirrors
1094 ibiblio.org, see
<ulink url=
"http://www.ibiblio.org/pub/Linux/MIRRORS.html">http://www.ibiblio.org/pub/Linux/MIRRORS.html<
/>. Some of
1095 these sites may archive previous versions of Wine as well as the
1096 current one. To determine which is the latest one, look at the
1097 distribution file name, which will take the form
1098 Wine-YYYYMMDD.tar.gz. Simply replace YYYYMMDD in the distribution
1099 file name with the numbers for year, month and date, respectively.
1100 The latest one is the one to get.
1103 Wine binary packages are available for several OS'es and
1105 <ulink url=
"http://www.winehq.org/site/download">
1106 the download page
</ulink> for the most recent list.
1112 <question id=
"Is-there-a-CVS-tree">
1113 <para>Is there a CVS tree?
</para>
1117 Current Wine sources are also available via anonymous client/server
1118 CVS. You will need CVS
1.9 or above. If you are coming from behind a
1119 firewall, you will either need a hole in the firewall for the CVS
1120 port (
2401) or use SOCKS.
1123 To login to the CVS tree, do
1126 export CVSROOT=:pserver:cvs@cvs.winehq.org/home/wine
1130 Use
"cvs" as the password (without the quotes). Note that
1131 <filename>/home/wine
</filename> is a path on the server, not on your
1132 machine. To check out the entire Wine source tree (which may be
1136 cvs -z
3 checkout wine
1139 or if you just want a subtree, or individual file, you can do that
1143 cvs -z
3 checkout wine/ANNOUNCE
1146 Be aware, though, that getting the entire Wine source tree via CVS
1147 is pretty slow, especially compared to getting Wine from an FTP
1148 mirror near you. For a CVS mirror list, see
1149 <ulink url=
"http://www.winehq.org/site/cvs#cvsservers">
1150 http://www.winehq.org/site/cvs#cvsservers
</ulink>
1153 Patch files are also available, so that you don't have to download,
1154 install, and configure the entire distribution each week if you are
1155 current to the previous release. Patch file release names follow the
1156 same numbering convention as do the general releases, and take the
1160 Wine-YYYYMMDD.diff.gz
1163 Patch files are available from the same sites that distribute the
1164 full release. To upgrade to a new release by using a patch file,
1165 first cd to the top-level directory of the release (the one
1166 containing the README file), then do a
"make clean", and patch the
1170 gunzip -c patch-file | patch -p1
1173 where patch-file is the name of the patch file something like
1174 Wine-YYYYMMDD.diff.gz. You can then re-run ./configure, and then run
1178 If you are mirroring the Wine distribution from the tsx-
11 site and
1179 wish to be listed here in this FAQ, please add it to the
1180 "things to go into the documentation" area.
1186 <question id=
"Can-I-get-Wine-using-cvsup">
1187 <para>Can I get Wine using cvsup?
</para>
1191 The CVS mirrors don't offer cvsup support yet, but the main server
1192 does. Use a
<filename>wine.sup
</filename> file of:
1195 *default host=cvs.winehq.org
1197 *default prefix=/cvs/wine
1198 *default release=wine
1201 # If your network link is a T1 or faster, comment out the following line.
1204 *default use-rel-suffix
1211 <qandadiv id=
"Installing-And-Configuring-Wine">
1212 <title>Installing and Configuring Wine
</title>
1214 <question id=
"How-do-I-compile-the-Wine-source-code">
1215 <para>How do I compile the Wine distribution source code?
</para>
1219 See the README (
<ulink url=
"http://source.winehq.org/source/README">http://source.winehq.org/source/README
</ulink>) for instructions.
1220 Additionally, you may want to set the
<parameter>TMPDIR
</parameter>
1221 environment variable
<command>TMPDIR=~/tmp
</command> or
1222 <command>TMPDIR=/tmp
</command> (if you are root).
1228 <question id=
"How-do-I-install-Windows-in-Wine">
1229 <para>How do I install Windows in Wine under Linux?
</para>
1233 Simple answer: you CAN'T. Windows demands direct access to the
1234 hardware and cannot get it with Wine and UNIX in the way
1237 Wine is supposed to be primarily used WITHOUT Windows. If you want
1238 to use a Windows installation, then use an existing installation
1239 alongside the UNIX installation (see the dual-boot HOWTO for your OS
1240 for more details). Or alternatively use the cabextract utility to
1241 extract Windows install archives to a directory that you want to use
1242 as Wine's Windows tree.
1248 <question id=
"How-do-I-configure-Wine-to-run-on-my-system">
1249 <para>How do I configure Wine to run on my system?
</para>
1253 Wine requires that you have a config file as
1254 <filename>~/.wine/config
</filename>. The format of this file is
1255 explained in the
<filename>wine.conf
</filename> man page. The file
1256 <filename>documentation/samples/config
</filename>
1257 (
<ulink url=
"http://source.winehq.org/source/documentation/samples/config">
1258 http://source.winehq.org/source/documentation/samples/config
</ulink>)
1259 contains a config file example. More explicit directions can be
1260 found in the
<filename>README
</filename> file
1261 (
<ulink url=
"http://source.winehq.org/source/README">
1262 http://source.winehq.org/source/README
</ulink>) that will be located in
1263 the base Wine directory after you gunzip and untar the distribution
1270 <question id=
"How-do-I-upgrade-configuration">
1271 <para>How do I upgrade Wine without losing my working configuration?
</para>
1275 Upgrading the wine installation does not affect the existing wine
1276 configuration. So after upgrading wine you still have the old (working )
1283 <question id=
"If-I-use-Windows-which-versions-OK">
1284 <para>If I want to use a Windows install, which versions are OK?
</para>
1288 Either use a classic no-windows install (Wine is getting better all
1289 the time) or use a Win9x install (Win95,
98,
98SE, ME). DON'T
1290 configure Wine to use an NT-based Windows install (NT, Win2K, WinXP, Win2K3).
1293 In general, most Windows installations contain vast quantities of garbage
1294 that can confuse Wine and make it less reliable. If you can, it's best to
1295 install the programs you want into Wine's fake windows drive.
1301 <question id=
"If-I-use-Windows-which-one-works-best">
1302 <para>If I use a Windows install with Wine, which one works best?
</para>
1309 I'd say Win98SE is the best version to use with Wine, as it's fairly
1310 widespread amongst developers and relatively old. Using Win2K files
1311 is
<emphasis>definitely
</emphasis> worse than a plain no-windows
1312 Wine install, and Win ME is said to be problematic, too (as probably
1313 no developer uses it). In short: all Win9x
<= W98SE are good.
1319 <question id=
"Installing-Visual-Basic-apps-wont-run">
1321 Installing applications generated by Visual Basic won't run. What
1327 Make sure you have all the VB run time libraries installed. You can
1328 get the latest version from the Microsoft web site.
1334 <question id=
"When-I-click-on-exe-file-nothing-happens">
1335 <para>When I click on *.exe file in my file Manager, nothing happens.
</para>
1339 The normal Wine releases don't have .exe extensions registered for
1340 Wine in KDE/Gnome yet. You have to open a terminal window instead
1341 (often an icon showing a
"black screen") and type something like:
1344 cd /my/windows/program/directory
1348 Or alternatively you could download the CodeWeavers Wine preview
1349 which includes .exe extension registration for KDE/Gnome and a nice
1356 <question id=
"bash-wine-Command-not-found-What-can-I-do">
1357 <para>bash says
"wine: Command not found" What can I do?
</para>
1361 Try to logout and login again into bash. That might fix it.
1364 If it doesn't, then make sure the wine binary is in your
1365 <parameter>PATH
</parameter>.
1371 find / -name
"wine" -type f -perm +
111
1374 to find the path where the wine binary is in. Then check whether
1375 <parameter>PATH
</parameter> includes it:
1381 If not, add that e.g. to
<filename>/etc/profile
</filename> by doing:
1384 export PATH=$PATH:/path/to/wine/binary
1390 If you used a package manager (
<command>rpm
</command> or
1391 <command>apt
</command>) - Verify your packages. The package
1392 <filename>winesetuptk.rpm
</filename> is only a front-end for
1393 making a meaningful config file, it DOES NOT install the wine
1397 For complete packages, use
<ulink url=
"http://rpmseek.com/rpm-pl/wine.html?hl=com&cx=0::">
1398 http://rpmseek.com/
</ulink> or the
<ulink url=
"http://www.winehq.org/site/download">
1399 Download
</ulink> section.
1405 <question id=
"How-do-I-remove-Wine-from-my-Computer">
1406 <para>How do I remove Wine from my Computer?
</para>
1410 It depends on how you installed. If you used an RPM, the right command is this:
1411 <command>rpm -e wine (as root)
</command>
1414 If you installed from source (the .tar.gz file), the right
1415 way to do it is to change to the root of the source tree (the directory with the configure script,
1416 readme etc) then run as root:
1417 <command>make uninstall
</command>
1423 <qandadiv id=
"About-running-Wine">
1424 <title>About running Wine
</title>
1426 <question id=
"How-do-I-run-an-MS-Windows-program">
1427 <para>How do I run an MS Windows program under Wine?
</para>
1431 When invoking Wine, you must specify the entire path to the
1432 executable, or by file name only. For example to run Windows'
1433 solitaire, type any of the following:
1438 <command>wine sol
</command> or
<command>wine sol.exe
</command>
1439 (using the search path to locate the file).
1444 <command>wine c:\\windows\\sol.exe
</command>
1445 (using a DOS file name).
1450 <command>wine /usr/windows/sol.exe
</command>
1451 (using a UNIX file name).
1456 <command>wine
"c:\windows\sol.exe"</command>
1457 (using quoted DOS file name).
1462 The path of the file will also be added to the path when a full name
1463 is supplied on the command line.
1470 <question id=
"Wine-cannot-find-MS-Windows-on-my-drive">
1472 I have installed and configured Wine, but Wine cannot find MS
1473 Windows on my drive. Where did I go wrong?
1478 If you have a DOS partition, first make sure that you have mounted
1479 it, either by putting the entry into
<filename>/etc/fstab
</filename>,
1480 or by manually mounting it.
1483 Remember too that unless your version of UNIX can see through it, or
1484 you are running a utility that can see through it, your DOS
1485 partition must not be located on a Drivespaced, Doublespaced or
1486 Stackered partition, as neither Linux, FreeBSD, NetBSD or Wine can
1487 natively 'see' files located in these compressed DOS partitions.
1490 Check your path statements in the
<filename>wine.conf
</filename>
1491 file. No capital letters may be used in paths, as they are
1492 automatically converted to lowercase.
1498 <question id=
"Parts-of-my-app-do-not-work-What-is-wrong">
1500 I was able to get various MS Windows programs to run, but parts of
1501 them do not work. What is wrong?
1506 Wine is not complete at this time, so some of each programs'
1507 features may not work. They will in time as more of the MS
1508 Windows API calls are included in Wine.
1514 <question id=
"Menus-do-not-work-how-can-I-exit">
1516 I have run various MS Windows programs, but since the program menus
1517 do not work, how can I exit these programs?
1522 Kill the xterm shell window that you called up to run your MS
1523 Windows program, and the X window that appeared with the program
1530 <question id=
"My-app-doesnt-work-what-can-i-do">
1532 My program doesn't work, what can I do?
1537 If you are a programmer and know C, then start debugging
1538 Wine and help us make it better! If you can't, then you will
1539 have to either convince a Wine developer to try and make your
1540 program work (there must be a downloadable version or demo for
1541 that), or hire somebody to do it for you. If this application
1542 is an internal corporate application, you may be able to hire a
1543 Wine developer to do consulting work for you on the matter.
1546 Alternatively, you may be able to get the app working by
1547 taking native DLLs from a Microsoft Windows install, and using
1548 them (set the dlls to native in the config file). Not all DLLs
1549 can be replaced that way - in particular DirectX cannot be, nor
1550 can some core system DLLs like user, ntdll, kernel32 etc
1556 <question id=
"Can-I-use-Wine-with-other-Linux-Distros">
1557 <para>Can I use Wine with SUSE, Peanut or other Linux Distro's?
</para>
1561 You can use Wine on any sufficiently recent Linux installation. The
1562 amount of work getting Wine up and running depends on whether there
1563 are proper packages available or a source compile has to be done.
1569 <question id=
"Does-Wine-work-with-AMD-Processors">
1570 <para>Does Wine work with AMD Processors?
</para>
1574 Yes, it does. Wine should work on any processor compatible with
1575 the Pentium or greater.
1581 <question id=
"Can-I-launch-Unix-app-from-Windows-app">
1582 <para> Can I launch a Unix program from a Windows program?
</para>
1586 Sure, Wine supports that. Just enter the unix program name wherever
1587 a program has something that it's supposed to execute, and it
1593 <question id=
"Error-with-installshield-6">
1595 I get
<quote>Error installing iKernel.exe: (
0x1400)
</quote>
1596 when running an InstallShield
6 installer.
1601 If you get the error
"Error installing iKernel.exe: (0x1400)" at any
1602 point, it's probably because there are leftover processes from a
1603 previous try. You can verify this with the command
1605 <para><prompt>$ <
/><command>ps augxw | grep wine
</command></para>
1607 If that command shows old copies of wine running your setup,
1608 you need to kill them before you can run the setup program.
1609 If there are no other Wine programs running, you can kill them
1610 all with the command
1612 <para><prompt>$ <
/><command>killall wine
</command></para>
1614 If you're also running Wine programs you care about, you'll
1615 have to kill off the old Setup instances one by one using
1616 kill and the individual PIDs (or perhaps Wine's spiffy Task Manager,
1617 which doesn't exist yet).
1620 You should repeat the
<command>ps
</command> to make sure the old
1621 Wine processes are gone.
1627 <qandadiv id=
"Getting-help">
1628 <title>Getting help
</title>
1630 <question id=
"Is-there-any-documentation-for-Wine">
1631 <para>Is there any documentation for Wine?
</para>
1635 Yes, see
<ulink url=
"http://www.winehq.org/site/documentation">
1636 http://www.winehq.org/site/documentation.
</ulink>
1642 <question id=
"I-have-written-some-documententation">
1644 I couldn't find the answer to my question in the documentation, but
1645 I've written a document explaining how to solve it. What should I do?
1650 Updates and additions to the Wine documentation directory should be
1651 sent to the wine-patches mailing list at
1652 <ulink url=
"http://www.winehq.org/site/forums">
1653 http://www.winehq.org/site/forums
</ulink>. Website and FAQ
1654 additions should be added to the appropriate Wine Knowledge base directory.
1660 <question id=
"Is-there-a-Usenet-newsgroup-for-Wine">
1661 <para>Is there a Usenet newsgroup for Wine?
</para>
1665 Yes, and it's called
1666 <ulink url=
"news:comp.emulators.ms-windows.wine">
1667 comp.emulators.ms-windows.wine
</ulink>. The newsgroup serves as a
1668 place for users and developers to discuss Wine, and for minor
1669 announcements for the general public. Major announcements will be
1670 cross posted to other appropriate newsgroups, such as the following:
1675 <ulink url=
"news:comp.os.linux.announce">
1676 comp.os.linux.announce
</ulink>
1681 <ulink url=
"news:ccomp.windows.x.announce">
1682 comp.windows.x.announce
</ulink>
1687 <ulink url=
"news:ccomp.emulators.announce">
1688 comp.emulators.announce
</ulink>
1693 If your Usenet site does not carry these newsgroups, please urge
1694 your ISP's sysadmin to add and/or uplink them.
1700 <question id=
"Is-there-a-World-Wide-Web-site-for-Wine">
1701 <para>Is there a World Wide Web site for Wine?
</para>
1705 Wine HQ (
<ulink url=
"http://www.winehq.org">http://www.winehq.org
</ulink>) is the official site.
1711 <question id=
"Is-there-an-IRC-channel-for-Wine">
1712 <para>Is there an IRC channel for Wine?
</para>
1716 Sure. It's channel
<filename>#WineHQ
</filename> on
1717 <filename>irc.freenode.net
</filename> see
1718 (
<ulink url=
"http://freenode.net">http://freenode.net
</ulink>).
1719 Usually several Wine developers hang out there just to help YOU ;-)
1725 <question id=
"I-think-I-found-a-bug-How-do-I-report-it">
1727 I think I've found a bug. How do I report this bug to the Wine
1733 Bug reports should be submitted to our online Bugzilla system
1734 (
<ulink url=
"http://bugs.winehq.org/">http://bugs.winehq.org/
</ulink>).
1735 You should include at least the following:
1740 The Wine version tested
1745 The Windows application name, including the version, and, if
1746 applicable, a URL the application can be downloaded from
1751 A brief description of the bug
1756 The relevant part(s) of the output of the Wine debugger
1761 A screenshot of the visual problem, if applicable
1766 For more information about reporting bugs please see the
1767 <ulink url=
"http://www.winehq.org/Docs/wine-user/bug-reporting.shtml">
1768 How to report a bug
</ulink> section of the Wine Users Guide.
1774 <qandadiv id=
"Helping-Wine-or-becoming-a-Wine-developer">
1775 <title>Helping Wine or becoming a Wine developer
</title>
1777 <question id=
"How-do-I-become-a-Wine-developer">
1778 <para>How do I become a Wine developer? What do I need to know?
</para>
1782 If you can program C, that's a good start. Download the sources via
1783 (
<ulink url=
"http://www.winehq.org/site/cvs">CVS,
</ulink>)
1784 subscribe to the mailing lists, look around the source, and
1785 pay attention to the comp.emulators.ms-windows.wine newsgroup
1786 and the mailing lists (
<ulink
1787 url=
"http://www.winehq.org/site/forums">http://www.winehq.org/site/forums
</ulink>).
1788 See if there's anything that you think you can fix or work
1789 on. You won't have much trouble finding areas that need work
1790 in Wine (grep for FIXMEs in the source).
1796 <question id=
"How-can-I-contribute-to-the-Wine-project">
1797 <para>How can I help contribute to the Wine project, and in what way(s)?
</para>
1801 You can contribute programming or documentation skills, or monetary
1802 or equipment donations, to aid the Wine developers in reaching their
1806 For a list of ideas of how you can help, please consult the
1807 <ulink url=
"http://www.winehq.org/site/contributing">
1808 Wine contrib page
</ulink>.
1814 <question id=
"I-want-to-help-beta-test-Wine">
1815 <para>I want to help beta test Wine. How can I do this?
</para>
1819 Wine still consists of some Alpha code at this time. However, anyone
1820 is welcome to download the latest version, and try it out at any
1827 <question id=
"I-wrote-some-code-I-would-like-to-submit">
1829 I have written some code that I would like to submit to the Wine
1830 project. How do I go about doing this?
1835 Submitting a patch for inclusion in Wine is pretty simple.
1836 Basically all you have to do is send the patch to the
1837 wine-patches mailing list
1838 (
<ulink url=
"http://www.winehq.org/mailman/listinfo/wine-patches">http://www.winehq.org/mailman/listinfo/wine-patches<
/>).
1839 Still there are a couple of recommendations about the patch format
1840 and all so it's best to read our page describing
<ulink
1841 url=
"http://www.winehq.org/site/sending_patches">how to submit
1842 patches<
/>. This will also give you more details about the whole
1843 process and in particular to what will happen to your patch once
1850 <qandadiv id=
"Developing-programs-using-Wine-WineLib">
1851 <title>Developing programs using Wine/WineLib
</title>
1853 <question id=
"Can-I-use-Wine-to-port-Win32-sources-to-Unix">
1854 <para>Can I use Wine to port my Win32 sources to Unix?
</para>
1858 That is the idea of Winelib. Right now you may still have some
1859 difficulties, but this is changing all the time. Read the
1860 <ulink url=
"http://www.winehq.org/Docs/winelib-user/">Winelib User's Guide
</ulink> for info.
1866 <question id=
"Will-MFC-work-with-Wine-What-do-I-need-to-do">
1867 <para>Will MFC work with Wine? What do I need to do?
</para>
1871 Wine is not implementing an MFC replacement nor does it intend to.
1872 However it is possible (with a lot of work) to compile the MFC from
1873 source and thus produce an
<filename>mfc42.dll.so
</filename> library.
1877 <ulink url=
"http://www.winehq.org/Docs/winelib-user/">Winelib User's Guide
</ulink> for how to do this.
1883 <question id=
"Are-there-commercial-apps-ported-using-Wine">
1885 Are there any commercial applications which have been ported
1891 Here are few examples of applications ported using Wine or Winelib:
1896 Corel's WordPerfect Office Suite
2000 was ported to Linux using
1902 Kylix, the Linux version of Delphi, was ported to Linux using
1903 Winelib. The IDE actually uses a combination of QT and Winelib
1904 which would not have been possible to achieve using only Wine.
1905 The generated applications however do not depend on Wine in
1911 MusicMatch Jukebox
5 has also been
1912 <ulink url=
"http://www.itworld.com/nl/lnx_desktop/01042001/">ported<
/>
1913 to Linux using Winelib. However more recent versions have not, and
1914 version
5 is no longer available.
1920 (
<ulink url=
"http://www.ability.com/linux/abilitylinux.php">http://www.ability.com/linux/abilitylinux.php
</ulink>)
1926 (
<ulink url=
"http://www7b.boulder.ibm.com/dl/swws/swwsgddb-p">http://www7b.boulder.ibm.com/dl/swws/swwsgddb-p
</ulink>)
1931 Many other important applications have already been ported. (we are
1932 speaking of several top
500 applications here)
1938 <question id=
"How-can-I-detect-Wine">
1939 <para>How can I detect Wine?
</para>
1943 You really shouldn't want to do this. If there's a quirk in Wine
1944 you need to work around, it's much better to fix it in Wine.
1952 <qandadiv id=
"Wine-HQ-issues">
1953 <title>Wine HQ issues
</title>
1955 <question id=
"Why-are-the-maillists-set-to-reply-to-author">
1957 Why are the mailing lists set to reply to author, not to mailing list?
1962 There are very valid reasons for doing so.
1968 <question id=
"How-to-unsubscribe-from-the-mailing-lists">
1969 <para>How to unsubscribe from the mailing lists?
</para>
1973 Please see:
<ulink url=
"http://www.winehq.org/site/forums">http://www.winehq.org/site/forums
</ulink>
1974 And select [(Un-)Subscribe]
1983 <!-- Keep this comment at the end of the file
1986 sgml-parent-document:("wine-devel.sgml" "book" "part" "chapter" "")