home *** CD-ROM | disk | FTP | other *** search
/ ftp.pasteur.org/FAQ/ / ftp-pasteur-org-FAQ.zip / FAQ / windows-emulation / wine-faq
Encoding:
Internet Message Format  |  1998-11-30  |  36.0 KB
  1. Path: senator-bedfellow.mit.edu!bloom-beacon.mit.edu!cambridge-news.cygnus.com!cygnus.com!news.sgi.com!nntprelay.mathworks.com!ix.netcom.com!dagar
  2. From: dagar@net1.dagar.com ()
  3. Newsgroups: comp.emulators.ms-windows.wine,comp.windows.x.i386unix,comp.os.linux.answers,comp.answers,news.answers
  4. Subject: WINE (WINdows Emulator) Frequently Asked Questions
  5. Followup-To: comp.emulators.ms-windows.wine
  6. Date: 27 Nov 1998 17:30:52 GMT
  7. Organization: ICGNetcom
  8. Lines: 876
  9. Approved: linux-answers@news.ornl.gov,news-answers-request@MIT.EDU
  10. Message-ID: <73mnkc$gkl@dfw-ixnews5.ix.netcom.com>
  11. NNTP-Posting-Host: pas-ca32-22.ix.netcom.com
  12. X-NETCOM-Date: Fri Nov 27 11:30:52 AM CST 1998
  13. Summary: This posting contains a list of Frequently Asked Questions 
  14.          (and their answers) about Wine, a program that allows UNIX
  15.          workstation users to run MS Windows binaries. This should be 
  16.          read by anyone wishing to know more about the ongoing development 
  17.          of this programming project.
  18. X-Newsreader: TIN [version 1.2 PL2]
  19. Xref: senator-bedfellow.mit.edu comp.emulators.ms-windows.wine:19958 comp.windows.x.i386unix:30226 comp.os.linux.answers:4280 comp.answers:34063 news.answers:145589
  20.  
  21. Archive-name: windows-emulation/wine-faq
  22. Posting-Frequency: monthly
  23. Last-modified: 1998/11/15
  24. Version: 19981127
  25. URL: http://http://pw1.netcom.com/~dagar/winefaq.html
  26. Copyright: (C) 1995-1998 P. David Gardner
  27. Maintainer: Dave Gardner <dagar@ix.netcom.com>
  28.  
  29.                      The Wine (Windows Emulator) FAQ
  30.  
  31.                                Contents
  32.  
  33. What's New
  34.  
  35. General Information
  36.  
  37. Section 1: An Overview of the Wine Project
  38.       1.1: What is Wine, and what is it supposed to do? 
  39.       1.2: What is the current version of Wine? 
  40.       1.3: When will Wine be ready for general distribution? 
  41.  
  42. Section 2: What Programs Can Wine Run? 
  43.       2.1: Which MS Windows programs does Wine currently run? 
  44.       2.2: Which MS Windows programs do you expect Wine never to be 
  45.            able to run at all, and for what reason(s)? 
  46.       2.3: Will MS Windows programs typically run faster or slower under
  47.            UNIX and Wine than they do under DOS and MS Windows? Will 
  48.            certain kinds of programs run slower or faster? 
  49.       2.4: Are there any advantages or disadvantages to running MS Windows
  50.            applications under Wine that I should be aware of? 
  51.       2.5: Will Wine support MS Windows networked applications that use
  52.            winsock.dll? 
  53.       2.6: I'm a software developer who wants to use UNIX to develop
  54.            programs rather than DOS, but I need to write DOS and MS 
  55.            Windows programs as well. Will I be able to run my favorite 
  56.            DOS and/or MS Windows compilers under Wine? 
  57.  
  58. Section 3: What You Need to Use Wine
  59.  
  60.       3.1: Under what hardware platform(s) and operating system(s) will
  61.            Wine run? 
  62.       3.2: What minimum CPU must I have in my computer to be able to run
  63.            Wine and MS Windows applications smoothly? 
  64.       3.3: How much disk space will the Wine source code and binaries 
  65.            take on my hard drive? What other software do I need to have 
  66.            installed to compile and run Wine? 
  67.       3.4: How much RAM do I need to have on my UNIX system to be able to
  68.            run Wine and MS Windows applications smoothly? 
  69.       3.5: I have a Drivespaced, Doublespaced or Stackered DOS partition.
  70.            Can Wine run MS Windows binaries located in such a partition? 
  71.       3.6: Do I need to have a DOS partition on my system to use Wine?
  72.            Does MS Windows need to be loaded into that partition in order 
  73.            to run MS Windows programs under Wine? 
  74.       3.7: If Wine completely replaces MS Windows, will it duplicate all
  75.            of the functions of MS Windows? 
  76.       3.8: Will I be able to install MS Windows applications in any flavor
  77.            of a UNIX filesystem? 
  78.       3.9: Will Wine run only under X, or can it run in character mode? 
  79.      3.10: Will Wine run under any X window manager? 
  80.      3.11: Will 32-bit Windows 95 or Win NT applications run under Wine? 
  81.  
  82. Section 4: How to Find, Install, Configure and Run Wine
  83.  
  84.       4.1: Where can I get Wine? 
  85.       4.2: If I do not have an Internet account, how can I get Wine? 
  86.       4.3: How do I install Wine on my hard drive? 
  87.       4.4: How do I compile the Wine distribution source code? 
  88.       4.5: How do I configure Wine to run on my system? 
  89.       4.6: How do I run an MS Windows program under Wine? 
  90.       4.7: I have installed and configured Wine, but Wine cannot find MS
  91.            Windows on my drive. Where did I go wrong? 
  92.       4.8: I think I've found a bug. How do I report this bug to the Wine
  93.            programming team? 
  94.       4.9: I was able to get various MS Windows programs to run, but
  95.            parts of them do not work. What is wrong? 
  96.      4.10: I have run various MS Windows programs but since the program
  97.            menus do not work, how can I exit these programs? 
  98.      4.11: How do I remove Wine from my computer? 
  99.  
  100. Section 5: How to get help with Wine
  101.  
  102.       5.1: Is there a Usenet newsgroup for Wine? 
  103.       5.2: Is there a World Wide Web site for Wine? 
  104.  
  105. Section 6: How You Can Help with the Wine Project
  106.  
  107.       6.1: How can I help contribute to the Wine project, and in what
  108.            way(s)? 
  109.       6.2: I want to help beta test Wine. How can I do this? 
  110.       6.3: I have written some code that I would like to submit to the
  111.            Wine project. How do I go about doing this? 
  112.  
  113. Section 7: Who's responsible for Wine? 
  114.  
  115.       7.1: Who is responsible for writing and maintaining the Wine source
  116.            code? 
  117.       7.2: Who is responsible for writing and maintaining the Wine FAQ? 
  118.       7.3: Who are the folks and organizations who have contributed money
  119.            and/or equipment to the Wine project? 
  120.  
  121. Copyright Information
  122.  
  123.  
  124.                              What's New
  125.  
  126. The following things have changed since the last issue of the Wine FAQ: 
  127.  
  128.     1.2:  The old question 1.2 was obsolete and so it was deleted. The old 
  129.           question 1.3 has been renamed as question 1.2.
  130.     1.3:  The old question 1.3 was renamed as question 1.2.
  131.     1.4:  The old question 1.4 was renamed as question 1.3, and 1.4 was 
  132.           deleted.
  133.     2.4:  Added more precise references to advantages and disadvantages.
  134.     2.6:  Deleted obsolete references.
  135.     4.1:  Added CVS tree info.
  136.     4.3:  More detailed installation instructions added.
  137.     4.4:  More detailed compilation instructions added.
  138.     4.5:  More detailed configuration instructions added.
  139.     4.6:  More detailed operation instructions added.
  140.  
  141.  
  142.                          General Information
  143.  
  144. This is the FAQ (Frequently Asked Questions) for the Wine development
  145. project. It contains both general and technical information about Wine:
  146. project status, what it is and what it does, how to obtain and configure
  147. and run it, and more. Please read this FAQ carefully before you post
  148. questions about Wine to Usenet to see if your question is already answered
  149. here first.
  150.  
  151. Note that this FAQ will no longer contain any references to the latest
  152. Wine release available at the time of the release of this version of the
  153. Wine FAQ. This is done now because of the longevity of this FAQ, which
  154. confuses some folks when trying to match a version of the FAQ with a
  155. version of the Wine release that they have obtained. You can always easily
  156. find out what the current version of Wine is by checking the ftp sites
  157. mentioned in question 4.1 below.
  158.  
  159. The Standard Disclaimer: Please note that since Wine is still alpha code,
  160. it may or may not work to varying degrees on your system. Also note that
  161. from release to release, programs may work and then not work, then work
  162. again. Neither the Wine developers nor the Wine FAQ author/maintainer can
  163. be held responsible for any damage that may be caused to your computer
  164. hardware, software or data by your obtaining, installing, configuring,
  165. operating and/or removing Wine. If you use Wine, you use it completely at
  166. your own risk.
  167.  
  168. The Wine FAQ is posted monthly to these newsgroups:
  169.  
  170.     comp.emulators.ms-windows.wine
  171.     comp.os.linux.answers
  172.     comp.windows.x.i386unix
  173.     comp.answers
  174.     news.answers
  175.  
  176. (The Wine FAQ used to also be posted to:
  177.  
  178.     comp.emulators.announce
  179.     comp.unix.bsd.386bsd.announce
  180.     comp.unix.bsd.freebsd.announce
  181.     comp.unix.bsd.netbsd.announce
  182.  
  183. but I as have been unsuccessful in getting current posting approval from
  184. these groups' moderators, the FAQ cannot be posted to these newsgroups at
  185. this time.)
  186.  
  187. The Wine FAQ is reposted mid-month to: 
  188.  
  189.     comp.emulators.ms-windows.wine
  190.  
  191. The plain text version of the Wine FAQ is available by anonymous ftp from
  192. the following systems: 
  193.  
  194.     ftp://tsx-11.mit.edu/pub/linux/ALPHA/Wine/Wine.FAQ
  195.     ftp://rtfm.mit.edu/pub/usenet-by-group/
  196.         comp.emulators.ms-windows.wine/
  197.         WINE_(WINdows_Emulator)_Frequently_Asked_Questions
  198.     ftp://sunsite.unc.edu/pub/Linux/ALPHA/wine/Wine.FAQ
  199.  
  200. and on the World Wide Web at: 
  201.  
  202.     http://pw1.netcom/com/~dagar/winefaq.txt
  203.  
  204. and quite likely most of the other sites around the globe that mirror the
  205. Wine distribution from the its main distribution site: 
  206.  
  207.     tsx-11.mit.edu
  208.  
  209. The Wine FAQ is available on the World Wide Web (WWW), reachable with any
  210. web browser that can understand frames, at: 
  211.  
  212.     http://pw1.netcom.com/~dagar/winefaq.html
  213.  
  214. An unframed version is available at: 
  215.  
  216.     http://pw1.netcom.com/~dagar/winecontent.html
  217.  
  218. If you have any technical questions about Wine, please post these to the
  219. newsgroup: 
  220.  
  221.     comp.emulators.ms-windows.wine
  222.  
  223. If you have any suggestions for corrections, changes, expansion or further
  224. clarification of this FAQ, please send them to the Wine FAQ author and
  225. maintainer listed in question 7.2. 
  226.  
  227.  
  228.                               SECTION 1
  229.                    An Overview of the Wine Project
  230.  
  231. 1.1: What is Wine, and what is it supposed to do? 
  232.  
  233. Wine is a program which allows the operation of DOS and MS Windows 
  234. programs (Windows 3.x and Win32 executables) on UNIX. It consists of 
  235. a program loader, which loads and executes a Windows binary, and a
  236. library that implements Windows API calls using their UNIX or X11
  237. equivalents. The library may also be used for porting Win32 code into
  238. native UNIX executables.
  239.  
  240. Wine is free software, and its license (contained in the file LICENSE in
  241. each distribution) is BSD style. Basically, this means that you can do 
  242. anything with Wine except claim that you wrote it.
  243.  
  244. 1.2: What is the current version of Wine? 
  245.  
  246. A new version of Wine is distributed about twice a month. You will be able
  247. to keep up on all the latest releases by reading the newsgroup: 
  248.  
  249.     comp.emulators.ms-windows.wine
  250.  
  251. where new release announcements are made. When downloading Wine from your
  252. ftp site of choice (see question 4.1 for some of these choices), you can
  253. make sure that you are getting the latest version by watching the version
  254. numbers in the distribution filename. 
  255.  
  256. For instance, the distribution released on June 20, 1994 was called
  257. Wine-940620.tar.gz. 
  258.  
  259. Patch files are also available. If you are current to the previous
  260. version, you can download and apply just the current patch file rather
  261. than the entire new distribution. The patch filenames follow the same
  262. conventions as the monthly distribution. 
  263.  
  264. 1.3: When will Wine be ready for general release? 
  265.  
  266. Because Wine is being developed by volunteers, it is difficult to predict
  267. when it will be ready for general release. Between 90-98% of the functions
  268. used by MS Windows applets, and 80-90% of the functions used by major
  269. programs, have been at least partially implemented at this time. However,
  270. the remaining 10% will likely take another 90% of the time, not including
  271. debugging. 
  272.  
  273.  
  274.                               SECTION 2
  275.                      What Programs Can Wine Run? 
  276.  
  277. 2.1: Which MS Windows programs does Wine currently run? 
  278.  
  279. The newsgroup: 
  280.  
  281.     comp.emulators.ms-windows.wine
  282.  
  283. contains posts that tell of successes, partial successes and failures to
  284. run certain MS Windows programs under Wine. As such successes, partial
  285. successes and failures change rapidly with every release, please read that
  286. newsgroup for details rather than check here in the FAQ. 
  287.  
  288. There are a number of web sites that maintain lists of successes and
  289. failures in attempts to run MS Windows programs under Wine, and these
  290. include: 
  291.  
  292.     http://www.progsoc.uts.edu.au/~wildfire/
  293.     http://www.winehq.com/apps.cgi
  294.  
  295. Please keep in mind that although work on Wine has come pretty far, it is
  296. still considered a developers'-only release. Programs may 'break' and then
  297. run again from release to release. 
  298.  
  299. Many people have reported that some of the larger shareware and commercial 
  300. programs are now beginning to run under Wine to varying degrees of success. 
  301. Windows colors can vary from system to system, depending on your video card 
  302. and monitor, but it's been reported that colors are generally darker under 
  303. X Window and Wine than under native DOS and MS Windows.
  304.  
  305. Keep an eye on the newsgroup: 
  306.  
  307.     comp.emulators.ms-windows.wine
  308.  
  309. for up-to-date reports of successes. 
  310.  
  311. 2.2: Which MS Windows programs do you expect Wine to never be able to run
  312.      at all, and for what reason(s)? 
  313.  
  314. Back when work on Wine was just getting started, it was said that any MS
  315. Windows program that required a special enhanced mode device driver (VxD)
  316. that couldn't be rewritten specifically for Wine, would not run under
  317. Wine. While this is quite likely still a true statement for the most part,
  318. there is preliminary VxD support being added to Wine at this time. 
  319.  
  320. 2.3: Will MS Windows programs typically run faster or slower under UNIX
  321.      and Wine than they do under DOS and MS Windows? Will certain kinds of
  322.      programs run slower or faster? 
  323.  
  324. When work on Wine is completed, programs should typically run at about the
  325. same speed under Wine as they do under DOS and MS Windows. Currently,
  326. there are debugging features built into each release, and this slows down
  327. the execution of programs. However, these debugging features will be
  328. removed for any post-development releases. 
  329.  
  330. 2.4: Are there any advantages or disadvantages to running MS Windows
  331.      applications under Wine that I should be aware of? 
  332.  
  333. As with OS/2, you will be running MS Windows programs under a protected
  334. mode operating system, which brings certain advantages (and some
  335. disadvantages).
  336.  
  337. For instance, there will be crash protection. That is, each MS Windows
  338. application running under Wine will be running in its own X window and its
  339. own portion of reserved memory. If one MS Windows application crashes, it
  340. will not crash the other MS Windows or UNIX applications that you may have
  341. running at the same time.
  342.  
  343. However, be aware that some applications are "broken" and they access memory
  344. that they haven't properly (or at all) allocated. Under OS/2 or Wine, they 
  345. will crash. Under MS Windows, they may work for a period of time, but then 
  346. eventually you will have to reboot the machine.
  347.  
  348. Also, MS Windows programs should run at about the same speed under Wine as
  349. they do under MS Windows. 
  350.  
  351. When Wine is finished, you will be able to run your favorite MS Windows
  352. applications in a UNIX environment. However, be aware that any application
  353. written for MS Windows will run much less efficiently than its native UNIX
  354. cousin. 
  355.  
  356. For Linux, there is a database of such applications at: 
  357.  
  358.     http://www.xnet.com/~blatura/linapps.shtml
  359.  
  360. 2.5: Will Wine support MS Windows networked applications that use
  361.      winsock.dll? 
  362.  
  363. Yes, Wine does support such applications, more so the 16-bit than the
  364. 32-bit version of winsock. Working applications include Agent (a Usenet
  365. newsreader), mIRC, ws-FTP and Internet Explorer. 
  366.  
  367. 2.6: I'm a software developer who wants to use UNIX to develop programs
  368.      rather than DOS, but I need to write DOS and MS Windows programs as
  369.      well. Will I be able to run my favorite DOS and/or MS Windows
  370.      compilers under Wine? 
  371.  
  372. Wine now supports DOS applications natively, which means that you can now
  373. run MS Windows 3.x in standard mode. Some have reported success in running
  374. (to varying degrees of success) various C++ compilers, and the Borland
  375. Dephi and Turbo Pascal for Windows compilers. Others have reported success
  376. in running the Borland C++ 5.0 command line compiler (bcc) as well as some
  377. of the debugging tools in the MS SDK, but these compilers' IDEs generally
  378. do not run.
  379.  
  380.  
  381.                              SECTION 3
  382.                      What You Need to Run Wine
  383.  
  384. 3.1: Under what hardware platform(s) and operating system(s) will Wine
  385.      run? 
  386.  
  387. Wine is being developed specifically to run on the Intel x86 class of CPUs
  388. under certain UNIXes that run on the x86 platform.  UNIXes currently being
  389. tested for Wine compatibility include Linux, NetBSD, FreeBSD and Unixware,
  390. and there is now support for SCO OpenServer 5. The Wine development team
  391. hopes to attract the interest of other commercial UNIX and UNIX clone
  392. vendors as well. 
  393.  
  394. There are side efforts underway to port Wine to the Alpha and OS/2
  395. platforms. You can find out more information about the OS/2 port at: 
  396.  
  397.     http://www.winehq.com/wine/documentation/wine_os2
  398.  
  399. 3.2: What minimum CPU must I have in my computer to be able to run Wine
  400.      and MS Windows applications smoothly? 
  401.  
  402. Wine won't run on any x86 CPU less than an 80386. It is known to also work
  403. in the 80486 and Pentium CPUs. Beyond that, the basic test is, if you can
  404. run X11 now, you should be able to run Wine and MS Windows applications
  405. under it. 
  406.  
  407. As always, the faster your CPU, the better. Having a math coprocessor is
  408. unimportant. However, having a graphics accelerated video card supported
  409. by X will help greatly. 
  410.  
  411. 3.3: How much disk space will the Wine source code and binaries take on my
  412.      hard drive? What other software do I need to have installed to
  413.      compile and run Wine? 
  414.  
  415. You need approximately 125 megabytes of free hard drive space to store and
  416. compile the source code. Wine also needs about 18 megs in your /tmp
  417. directory.
  418.  
  419. As far as other software, you will need the following to compile Wine: 
  420.  
  421.     - gcc
  422.     - Xlibpm
  423.  
  424. To run Wine, you will need the following: 
  425.  
  426.     - The compiled Wine binary
  427.     - A properly configured wine.conf and wine.sym
  428.     - An installed and working X Window system
  429.     - Some MS Windows programs to test
  430.  
  431. 3.4: How much RAM do I need to have on my UNIX system to be able to run
  432.      Wine and MS Windows applications smoothly? 
  433.  
  434. If you can run X smoothly on your UNIX system now, you should be able to
  435. run Wine and MS Windows applications just fine too. 
  436.  
  437. A typical Wine workstation should realistically have at least 16 megabytes
  438. of RAM and a 16 megabyte swap partition. More is better, of course. You
  439. can run Wine with 8/8, but it is not recommended. 
  440.  
  441. If you wish to be part of the development team and program Wine itself, be
  442. aware that the new debugger is rather memory intensive. Some have
  443. suggested that 64 megabytes is the minimum RAM needed for Wine
  444. development, although some are able to work (albeit slowly) with 24
  445. megabytes of physical RAM and lots of swap space. 
  446.  
  447. 3.5: I have a Drivespaced, Doublespaced or Stackered DOS partition. Can
  448.      Wine run MS Windows binaries located in such a partition? 
  449.  
  450. Yes, but only if the operating system supports mounting those types of
  451. drives. Currently, NetBSD and FreeBSD do not. 
  452.  
  453. There is a Linux filesystem driver that will allow read/write access
  454. through Doublespaced and Drivespace 1.0 drives. More specifically, it
  455. supports mounting DOS 6.0 and 6.2 Doublespaced, DOS 6.22 Drivespaced, and
  456. Windows 95 Doublespaced compressed partitions (read and write access works
  457. fine, but write access is slow). It can be found at: 
  458.  
  459.     ftp://sunsite.unc.edu/pub/Linux/system/filesystems/dosfs/
  460.  
  461. 3.6: Do I need to have a DOS partition on my system to use Wine? Does MS
  462.      Windows need to be loaded into that partition in order to run MS
  463.      Windows programs under Wine? 
  464.  
  465. Unlike WABI, you do not need a licensed and installed copy of DOS or MS
  466. Windows to install, configure and run Wine. However, Wine has to be able
  467. to 'see' an MS Windows binary if it is to run it. 
  468.  
  469. Some folks have successfully installed and run some small programs in
  470. their UNIX filesystem without having a DOS partition or MS Windows.
  471. However, not all programs will work this way yet. Some applications'
  472. installation programs want to distribute some of the package's files into
  473. the /windows and /windows/system directories in order to run, and unless
  474. these exist on your UNIX filesystem, those programs will not install
  475. correctly and probably will not run well, if at all. 
  476.  
  477. If you have a DOS partition with MS Windows installed in it, make sure
  478. that your UNIX system can 'see' this partition (check your /etc/fstab file
  479. or mount the partition manually) so that Wine can run the MS Windows
  480. binaries located in the DOS partition. 
  481.  
  482. When it is finished, Wine will not require that you have a DOS partition
  483. on your system at all, meaning that you will not need to have MS Windows
  484. installed either. Wine programmers will provide an application setup
  485. program to allow you to install your MS Windows programs straight from
  486. your distribution diskettes or CDs onto your UNIX filesystem, or from
  487. within your UNIX filesystem if you ftp an MS Windows program over the
  488. Internet. 
  489.  
  490. To run without a DOS partition, you need to set a UNIX path to be your
  491. drive C:, and make sure that the /windows and /windows/system directories
  492. point to some place that actually exist. Here's an example, copied from a
  493. machine which has no DOS partition but successfully runs Wine: 
  494.  
  495.     [Drive C]
  496.     Path=/var/lib/wine
  497.     Type=hd
  498.     Label=MS-DOS
  499.     Filesystem=unix
  500.  
  501.     [wine]
  502.     Windows=c:\windows
  503.     System=c:\windows\system
  504.     Temp=e:\ Path=c:\windows;c:\windows\system;c:\
  505.  
  506. In /var/lib/wine/windows, you will need to install a win.ini config file
  507. that you might find on a typical MS Windows 3.1 machine. The directory
  508. /var/lib/wine/windows/system should exist, but doesn't need to contain
  509. anything. However, to use MS DLLs, you can copy them into that directory. 
  510.  
  511. If you have DOS/MS Windows installed on your system, you can mount that
  512. partition at bootup by modifying the file /etc/fstab in your UNIX
  513. partition. If you edit this file by hand, it should contain something
  514. similar to the following: 
  515.  
  516.     /dev/hda1 /dosc msdos uid=0,gid=100,umask=007 0 0
  517.  
  518. This will allow you to read and write to the DOS partition without being
  519. root. 
  520.  
  521. 3.7: If Wine completely replaces MS Windows, will it duplicate all of the
  522.      functions of MS Windows? 
  523.  
  524. Most of them, yes. However, some applications and applets that come with
  525. MS Windows, such as File Manager and Calculator, can be considered by some
  526. to be redundant, since 32-bit UNIX programs that duplicate these applets'
  527. functions already exist. 
  528.  
  529. 3.8: Will I be able to install MS Windows applications in any flavor of a
  530.      UNIX filesystem? 
  531.  
  532. Wine is written to be filesystem independent, so MS Windows applications
  533. will install and run under any filesystem supported by your brand of UNIX. 
  534.  
  535. 3.9: Will Wine run only under X, or can it run in character mode? 
  536.  
  537. Being a GUI (graphical user interface), MS Windows does not have a
  538. character mode, so there will be no character mode for Wine. So yes, you
  539. must run Wine under X. 
  540.  
  541. On the other hand, Win32 does have a character mode. Currently, Wine must
  542. have a display even to run console-only Win32 apps. 
  543.  
  544. 3.10: Will Wine run under any X window manager? 
  545.  
  546. Wine is window manager independent, so the X window manager you choose to
  547. run has no bearing on your ability to run MS Windows programs under Wine.
  548. Wine uses standard X libraries, so no additional ones are needed. Wine has
  549. its own window management, which acts like MS Windows. It can be turned
  550. off to use the native window manager with the -managed command-line
  551. switch. 
  552.  
  553. 3.11: Will 32-bit Windows 95 or Win NT applications run under Wine? 
  554.  
  555. Wine developers have already incorporated some Win32 code into Wine, and
  556. improvements appear with every new release of Wine. 
  557.  
  558.  
  559.                               SECTION 4
  560.             How to Find, Install, Configure and Run Wine
  561.  
  562. 4.1: Where can I get Wine? 
  563.  
  564. Because of lags created by using mirror, word of this newest release may
  565. reach you before the release is actually available at the ftp sites listed
  566. here. The sources are available from the following locations: 
  567.  
  568.     ftp://sunsite.unc.edu/pub/Linux/ALPHA/wine/development/
  569.     ftp://tsx-11.mit.edu/pub/linux/ALPHA/Wine/development/
  570.     ftp://ftp.infomagic.com/pub/mirrors/linux/sunsite/ALPHA/wine/development/
  571.     ftp://ftp.progsoc.uts.edu.au/pub/Wine/development/
  572.  
  573. It should also be available from any site that mirrors tsx-11 or sunsite.
  574.  
  575. Some of these ftp sites may archive previous versions of Wine as well as
  576. the current one. To determine which is the latest one, look at the
  577. distribution filename, which will take the form Wine-[yymmdd].tar.gz.
  578. Simply replace [yymmdd] in the distribution filename with the numbers for
  579. year, month and date, respectively. The latest one is the one to get. 
  580.  
  581. Wine is also available in RedHat and Debian packaged versions, but the
  582. packaging delays the release in these formats for about a week after the
  583. *.tar.gz file is released. You can obtain these packages from the following 
  584. systems: 
  585.  
  586.     ftp://ftp.rwii.com/pub/linux/Redhat/contrib/
  587.     http://www.debian.org/Packages/unstable/otherosfs/wine.html
  588.  
  589. Compiled binaries for the Solaris operating system can be found at:
  590.  
  591.     http://www.ecn.purdue.edu/~laird/WINE/
  592.  
  593. Current Wine sources are also available via anonymous client/server CVS. 
  594. You will need CVS 1.9 or above. If you are coming from behind a firewall, 
  595. you will either need a hole in the firewall for the CVS port (2401) or use 
  596. SOCKS. To login to the CVS tree, do 
  597.  
  598.     export CVSROOT=:pserver:cvs@cvs.winehq.com:/home/wine
  599.     cvs login
  600.  
  601. Use "cvs" as the password (without the quotes). Note that /home/wine is 
  602. a path on the server, not on your machine. 
  603.  
  604. To check out the entire Wine source tree (which may be slow), use: 
  605.  
  606.     cvs -z 3 checkout wine
  607.  
  608. or if you just want a subtree, or individual file, you can do that too 
  609. with:
  610.  
  611.     cvs -z 3 checkout wine/ANNOUNCE
  612.  
  613. Be aware, though, that getting the entire Wine source tree via CVS is 
  614. pretty slow, especially compared to getting Wine from an FTP mirror near 
  615. you.
  616.  
  617. Patch files are also available, so that you don't have to download,
  618. install and configure the entire distribution each week if you are current
  619. to the previous release. Patch file release names follow the same
  620. numbering convention as do the general releases, and take the form: 
  621.  
  622.     Wine-[yymmdd].diff.gz
  623.  
  624. Patch files are available from the same sites that distribute the full
  625. release. To upgrade to a new release by using a patch file, first cd to 
  626. the top-level directory of the release (the one containing the README
  627. file), then do a "make clean", and patch the release with:
  628.  
  629.     gunzip -c patch-file | patch -p1
  630.  
  631. where "patch-file" is the name of the patch file (something like
  632. Wine-yymmdd.diff.gz). You can then re-run "./configure", and then
  633. run "make depend; make".
  634.  
  635. Note that any mirror of tsx-11 will likely carry the Wine distribution and
  636. diff files, but may not be listed here in this FAQ. 
  637.  
  638. If you are mirroring the Wine distribution from the tsx-11 site and wish
  639. to be listed here in this FAQ, please send email to the FAQ
  640. author/maintainer listed in question 7.2. 
  641.  
  642. 4.2: If I do not have an Internet account, how can I get Wine? 
  643.  
  644. Some CD-ROM archives of Internet sites, notably those from Walnut Creek
  645. that archive ftp.cdrom.com and sunsite.unc.edu, may include some versions
  646. of Wine on their CD releases. However, the age of these distributions
  647. should always be questioned, as the 'snapshot' of the ftp site may have
  648. been taken anywhere from 1-4 months (or more) prior to the CD's pressing
  649. date. 
  650.  
  651. Your best bet to get the very latest distribution of Wine, if you do not
  652. have your own Internet account, is to find a friend who does have an
  653. Internet account, and have him/her ftp the necessary file(s) for you. 
  654.  
  655. If you have an email account on a BBS that can reach the Internet through
  656. a gateway, you may be able to use 'email ftp' to get the Wine release sent
  657. to you; check with your BBS system operator for details. 
  658.  
  659. If you are running a BBS that is not connected to the Internet but does
  660. offer the Wine distribution for download, and would like to be listed in
  661. this FAQ, please forward such information to the FAQ author/maintainer as
  662. listed in question 7.2. 
  663.  
  664. 4.3: How do I install Wine on my hard drive? 
  665.  
  666. Just un-gzip and un-tar the file, and follow the instructions contained in
  667. the README file that will be located in the base Wine directory. 
  668.  
  669. 4.4: How do I compile the Wine distribution source code? 
  670. 4.5: How do I configure Wine to run on my system? 
  671.  
  672. To compile Wine, you must have one of:
  673.  
  674.     Linux version 0.99.13 or above
  675.     NetBSD-current
  676.     FreeBSD-current or FreeBSD 1.1 or later
  677.     OpenBSD/i386 2.1 or later
  678.     Solaris x86 2.5 or later
  679.  
  680. You also need to have libXpm installed on your system. The sources for
  681. it are probably available on the ftp site where you got Wine. They can
  682. also be found on ftp.x.org and all of its mirror sites.
  683.  
  684. On x86 systems, gcc >= 2.7.0 is required. You will probably need flex too.
  685.  
  686. To build Wine, first do a "./configure" and then a "make depend; make" from
  687. the Wine directory. This will build the library "libwine.a", which can be
  688. used to compile and link Windows source code under Unix, and the program 
  689. "wine",  which will load and run Windows executables. If you have an ELF 
  690. compiler, you can use "./configure --enable-dll" to build a shared library 
  691. instead.
  692.  
  693. Additionally, you may want to set the TMPDIR environment variable, as in:
  694.  
  695.    TMPDIR=~/tmp 
  696.  
  697.       or
  698.  
  699.    TMPDIR=/tmp (if you are root)
  700.  
  701. Wine requires that you have a file called "/usr/local/etc/wine.conf" (you 
  702. can supply a different filename when configuring wine) or a file called 
  703. ".winerc" in your home directory. The format of this file is explained in 
  704. the Wine man page. The file "wine.ini" contains a config file example.
  705.  
  706. More explicit directions can be found in the README file that will be 
  707. located in the base Wine directory after you ungzip and untar the 
  708. distribution file.
  709.  
  710. 4.6: How do I run an MS Windows program under Wine? 
  711.  
  712. When invoking Wine, you must specify the entire path to the executable,
  713. or by filename only.
  714.  
  715. For example: to run Windows' solitaire:
  716.  
  717.         wine sol                   (using the search path to locate 
  718.         wine sol.exe               the file)
  719.  
  720.         wine c:\\windows\\sol.exe  (using a DOS filename)
  721.  
  722.         wine /usr/windows/sol.exe  (using a UNIX filename)
  723.  
  724. The path of the file will also be added to the path when a full name is 
  725. supplied on the command line.
  726.  
  727. 4.7: I have installed and configured Wine, but Wine cannot find MS Windows
  728.      on my drive. Where did I go wrong? 
  729.  
  730. If you have a DOS partition, first make sure that you have mounted it,
  731. either by putting the entry into /etc/fstab, or by manually mounting it.
  732. Remember too that unless your version of UNIX can see through it, or you
  733. are running a utility that can see through it, your DOS partition must not
  734. be located on a Drivespaced, Doublespaced or Stackered partition, as
  735. neither Linux, FreeBSD, NetBSD or Wine can natively 'see' files located in
  736. these compressed DOS partitions. 
  737.  
  738. Check your path statements in the wine.conf file. No capital letters may
  739. be used in paths, as they are automatically converted to lowercase. 
  740.  
  741. 4.8: I think I've found a bug.  How do I report this bug to the Wine
  742.      programming team? 
  743.  
  744. Bug reports should be posted to the newsgroup: 
  745.  
  746.     comp.emulators.ms-windows.wine
  747.  
  748. Be sure to include, in your report, the following information: 
  749.  
  750.     - The Wine version tested
  751.     - The MS Windows program name and, if possible, the version number of
  752.       the software tested
  753.     - A brief description of the bug
  754.     - The relevant part(s) of the output of the Wine debugger
  755.  
  756. 4.9: I was able to get various MS Windows programs to run, but parts of
  757.      them do not work. What is wrong? 
  758.  
  759. Wine is not complete at this time, so some of each programs' features may
  760. not work. They will in time as more of the MS Windows API calls are
  761. included in Wine. 
  762.  
  763. 4.10: I have run various MS Windows programs, but since the program menus
  764.       do not work, how can I exit these programs? 
  765.  
  766. Kill the xterm shell window that you called up to run your MS Windows
  767. program, and the X window that appeared with the program will be killed
  768. too. 
  769.  
  770. 4.11: How do I remove Wine from my computer? 
  771.  
  772. All you have to do is to type: 
  773.  
  774.     rm -fR [/path/]Wine*
  775.  
  776. Make sure that you specify the exact path when using the powerful 'rm -fR'
  777. command. If you are afraid that you might delete something important, or
  778. might otherwise delete other files within your filesystem, cd into each
  779. Wine subdirectory singly and delete the files found there manually, one
  780. file or directory at a time.  Neither the Wine developers and programmers,
  781. nor the Wine FAQ author/maintainer, can be held responsible for your
  782. deleting any files in your own filesystem. 
  783.  
  784.  
  785.                                SECTION 5
  786.                        How to Get Help with Wine
  787.  
  788. 5.1: Is there a Usenet newsgroup for Wine? 
  789.  
  790. Yes, and it's called: 
  791.  
  792.     comp.emulators.ms-windows.wine
  793.  
  794. The newsgroup serves as a place for developers to discuss Wine, and for
  795. minor announcements for the general public. Major announcements will be
  796. crossposted to other appropriate newsgroups, such as the following: 
  797.  
  798.     comp.os.linux.announce
  799.     comp.windows.x.announce
  800.     comp.emulators.announce
  801.  
  802. If your Usenet site does not carry these newsgroups, please urge your
  803. ISP's sysadmin and/or uplink to add them. 
  804.  
  805. 5.2: Is there a World Wide Web site for Wine? 
  806.  
  807. Here are a few sites: 
  808.  
  809.     http://www.qbc.clic.net/~krynos/wine_en.html
  810.     http://www.winehq.com/
  811.  
  812. If you are installing or maintain a WWW page pertaining to Wine that you
  813. feel would be useful for others to read, please inform the FAQ
  814. author/maintainer detailed in question 7.2 for inclusion in the next
  815. edition of the Wine FAQ. 
  816.  
  817.  
  818.                              SECTION 6
  819.                How You Can Help with the Wine Project
  820.  
  821. 6.1: How can I help contribute to the Wine project, and in what way(s)? 
  822.  
  823. You can contribute programming skills, or monetary or equipment donations,
  824. to aid the Wine developers in reaching their goals. To find out who, what,
  825. where, when and why, please post your desire to contribute to the
  826. newsgroup: 
  827.  
  828.     comp.emulators.ms-windows.wine
  829.  
  830. 6.2: I want to help beta test Wine. How can I do this? 
  831.  
  832. Beta testers are currently not needed, as Wine is still Alpha code at this
  833. time. However, anyone is welcome to download the latest version and try it
  834. out at any time. 
  835.  
  836. 6.3: I have written some code that I would like to submit to the Wine
  837.      project. How do I go about doing this? 
  838.  
  839. Send your weekly code contributions to Alexandre Julliard at
  840. julliard@lrc.epfl.ch. 
  841.  
  842. You should verify that your code was included in the subsequent release of
  843. Wine, as project managers cannot guarantee that the mail server will not
  844. suffer some failure that will cause the loss of your message and code
  845. after it is received. 
  846.  
  847.  
  848.                               SECTION 7
  849.                     Who's Responsible for Wine? 
  850.  
  851. 7.1: Who is responsible for writing and maintaining the Wine source code? 
  852.  
  853. Wine is available thanks to the work of many people. Please see the file
  854. AUTHORS in the distribution for the complete list. 
  855.  
  856. 7.2: Who is responsible for writing and maintaining the Wine FAQ? 
  857.  
  858. This FAQ was written and is being maintained by Dave Gardner at
  859. dagar@ix.netcom.com, who is not otherwise involved in Wine. Please do not
  860. email technical questions about the Wine project to the FAQ maintainer,
  861. but rather post them to the newsgroup: 
  862.  
  863.     comp.emulators.ms-windows.wine
  864.  
  865. 7.3: Who are the folks and organizations who have contributed money or
  866.      equipment to the Wine project? 
  867.  
  868. People and organizations who have given generous contributions of money
  869. and/or equipment include: 
  870.  
  871.     - David L. Harper
  872.     - Bob Hepple
  873.     - Mark A. Horton
  874.     - Kevin P. Lawton
  875.     - the Syntropy Institute
  876.     - James Woulfe
  877.  
  878.  
  879.                           Copyright Notice
  880.  
  881. The Wine FAQ is Copyright (C) 1995-1998 by P. David Gardner at
  882. dagar@ix.netcom.com and at http://pw1.netcom.com/~dagar/index.html.
  883. Permission is hereby granted to freely link to, copy, archive and
  884. republish this FAQ in its entirety without remuneration to the
  885. author/maintainer, provided that all information contained herein is kept
  886. intact and that no portion is altered in any way without prior written
  887. permission of the author/maintainer. If you have any questions concerning
  888. these permissions, please email or write the FAQ author/maintainer at one
  889. of the addresses contained herein for clarification.
  890.  
  891. --
  892. Dagar <dagar@ix.netcom.com>
  893. http://pw1.netcom.com/~dagar/
  894.  
  895.  
  896.