Wine User Guide

Table of Contents

1. Introduction

Overview / About

Purpose of this document and intended audience
Further questions and comments
Content overview / Steps to take

What is Wine?

Windows and Linux
What is Wine, and how can it help me?
Wine features

Versions of Wine

Wine from Wine HQ
Other Versions of Wine

Alternatives to Wine you might want to consider

Native Applications
Another Operating System
Virtual Machines

2. Getting Wine

Wine Installation Methods

Installation from a package
Installation from a source archive
Installation from a cvs snapshot

Installing Wine from a package

Installing a fresh package
Different Distributions

Installing Wine from source

Getting the Build Dependencies
Compiling Wine
Uninstalling Wine from Source

3. Configuring Wine

What are the requirements of a fully working Windows environment?

Easy configuration helper programs

wineinstall

Verification of correct configuration

The Wine Configuration File

Configuration File Introduction
Creating Or Modifying The Configuration File
What Does It Contain?
What If It Doesn't Work?

Disc Drives, Serial and Parallel Ports

Extremely Important Prerequisites
Short Introduction
Windows Directory Structure
The dosdevices Directory
File system settings in the [wine] section
More detailed explanation about file system differences
Installing Wine Without Windows
Installing Wine Using An Existing Windows Partition As Base
Dealing With FAT/VFAT Partitions
Drive labels and serial numbers

The Registry

The default registry
Using a Windows registry
The Registry
Registry structure
Wine registry data files
System administration
The [registry] section

DLL configuration

Introduction
Introduction To DLL Sections
DLL Overrides
System DLLs
Missing DLLs
Fetching native DLLs from a Windows CD

Configuring the graphics driver (x11drv, ttydrv etc.)

Configuring the x11drv graphics driver
Configuring the ttydrv graphics driver

Setting the Windows and DOS version value

How to configure the Windows and DOS version value Wine should return

Dealing with Fonts

Fonts
Setting up a TrueType Font Server

Printing in Wine

Printing
The Wine PostScript Driver

SCSI Support

Windows requirements
Linux requirements
Notes

Using a Unix ODBC system with Wine
Using Windows ODBC drivers

4. Running Wine

Basic usage: applications and control panel applets

How to run Wine

Explorer-like graphical Wine environments

Wine Command Line Options

--help
--version

Environment variables

WINEDEBUG=[channels]

wineserver Command Line Options

-d<n>
-h
-k[n]
-p[n]
-w

Setting Windows/DOS environment variables

Text mode programs (CUI: Console User Interface)

Configuration of CUI executables

5. Troubleshooting / Reporting bugs

What to do if some program still doesn't work?

Verify your wine configuration
Use different windows version settings
Use different startup paths
Fiddle with DLL configuration
Check your system environment !
Use different GUI (Window Manager) modes
Check your app !
Check your Wine environment !
Reconfigure Wine
Check out further information
Debug it!

How To Report A Bug

All Bug Reports
Crashes

List of Tables
1-1. Various Wine offerings
4-1. Debug Channels
4-2. Basic differences in consoles
4-3. Wineconsole configuration options

		Next
		Introduction