Wine User Guide


Table of Contents
1. Introduction
1.1. Overview / About
1.1.1. Purpose of this document and intended audience
1.1.2. Burning questions and comments
1.1.3. Content overview / Steps to take
1.2. What is Wine?
1.2.1. Windows and Linux
1.2.2. What is Wine, and how can it help me?
1.2.3. Wine capabilities
1.3. Other, often "Enhanced" Wine offerings
1.4. Alternatives to Wine you might want to consider
1.4.1. VMWare
1.4.2. Win4Lin
1.5. Basic Wine Requirements
1.5.1. System requirements
2. Getting Wine
2.1. How to download Wine?
2.1.1. Which Wine form should I pick?
2.2. Getting a Wine package
2.2.1. Debian Linux
2.2.2. Red Hat Linux
2.2.3. FreeBSD
2.2.4. Other systems
2.3. Getting Wine source code
2.3.1. Getting Wine Source Code from an FTP Archive
2.3.2. Getting Wine Source Code from CVS
2.3.3. Updating the Wine CVS tree
2.3.4. Updating Wine with a Patch
3. Compiling the Wine Source
3.1. Compiling Wine
3.1.1. Requirements
3.1.2. Space required
3.1.3. Common problems
4. Installing or uninstalling Wine
4.1. Installing or uninstalling Wine packages
4.1.1. Debian Linux
4.1.2. Red Hat (RPM) Linux
4.2. Installing or uninstalling a Wine source code tree
5. Configuring Wine
5.1. What are the requirements of a fully working Windows environment?
5.2. Easy configuration helper programs
5.2.1. WineSetupTk
5.2.2. wineinstall
5.2.3. winecfg
5.3. Verification of correct configuration
5.4. The Wine Configuration File
5.4.1. Configuration File Introduction
5.4.2. Creating Or Modifying The Configuration File
5.4.3. What Does It Contain?
5.4.4. What If It Doesn't Work?
5.5. The Wine File System And Drive Layer
5.5.1. Extremely Important Prerequisites
5.5.2. Short Introduction
5.5.3. Windows Directory Structure
5.5.4. The [Drive x] Sections
5.5.5. File system settings in the [wine] section
5.5.6. More detailed explanation about file system differences
5.5.7. Installing Wine Without Windows
5.5.8. Installing Wine Using An Existing Windows Partition As Base
5.5.9. Dealing With FAT/VFAT Partitions
5.5.10. Drive labels and serial numbers
5.6. The Registry
5.6.1. The default registry
5.6.2. Using a Windows registry
5.6.3. The Registry
5.6.4. Registry structure
5.6.5. Wine registry data files
5.6.6. System administration
5.6.7. The [registry] section
5.7. DLL configuration
5.7.1. Introduction
5.7.2. Introduction To DLL Sections
5.7.3. DLL Overrides
5.7.4. System DLLs
5.7.5. Missing DLLs
5.7.6. Fetching native DLLs from a Windows CD
5.8. Configuring the graphics driver (x11drv, ttydrv etc.)
5.8.1. Configuring the x11drv graphics driver
5.8.2. Configuring the ttydrv graphics driver
5.9. Setting the Windows and DOS version value
5.9.1. How to configure the Windows and DOS version value Wine should return
5.10. Dealing with Fonts
5.10.1. Fonts
5.10.2. Setting up a TrueType Font Server
5.11. Printing in Wine
5.11.1. Printing
5.11.2. The Wine PostScript Driver
5.12. Win95/98 Look And Feel
5.13. Keyboard
5.14. SCSI Support
5.14.1. Windows requirements
5.14.2. Linux requirements
5.14.3. General Information
5.14.4. NOTES/BUGS
5.15. Using ODBC
5.15.1. Using a Unix ODBC system with Wine
5.15.2. Using Windows ODBC drivers
6. Running Wine
6.1. Basic usage: applications and control panel applets
6.2. How to run Wine
6.3. Explorer-like graphical Wine environments
6.4. Wine Command Line Options
6.4.1. --debugmsg [channels]
6.4.2. --dll
6.4.3. --help
6.4.4. --version
6.5. wineserver Command Line Options
6.5.1. -d<n>
6.5.2. -h
6.5.3. -k[n]
6.5.4. -p[n]
6.5.5. -w
6.6. Setting Windows/DOS environment variables
6.7. Text mode programs (CUI: Console User Interface)
6.7.1. Configuration of CUI executables
7. Troubleshooting / Reporting bugs
7.1. What to do if some program still doesn't work?
7.1.1. Run "winecheck" to check your configuration
7.1.2. Use different windows version settings
7.1.3. Use different startup paths
7.1.4. Fiddle with DLL configuration
7.1.5. Check your system environment !
7.1.6. Use different GUI (Window Manager) modes
7.1.7. Check your app !
7.1.8. Check your Wine environment !
7.1.9. Reconfigure Wine
7.1.10. Check out further information
7.1.11. Debug it!
7.2. How To Report A Bug
7.2.1. All Bug Reports
7.2.2. Crashes
Glossary
List of Tables
1-1. Various Wine offerings
6-1. Debug Channels
6-2. Basic differences in consoles
6-3. Wineconsole configuration options