-----------------------------------------------------------      
                             The Wine FAQ                              
                                                                       
      Frequently asked questions about Wine.                           
      -----------------------------------------------------------      
                                                                       
      Questions                                                        
                                                                       
      Click on the question to see its answer.                         
                                                                       
          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://          
          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://                   
          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