Linux Manual Pages

Free Software * Books

Source Code

Free Media

Linux

WINE

NAME
SYNOPSIS
DESCRIPTION
PROGRAM/ARGUMENTS
ENVIRONMENT
FILES
AUTHORS
COPYRIGHT
BUGS
AVAILABILITY
SEE ALSO

NAME

wine − run Windows programs on Unix

SYNOPSIS

wine program [arguments]
wine --help
wine --version

For instructions on passing arguments to Windows programs, please see the PROGRAM/ARGUMENTS section of the man page.

DESCRIPTION

wine loads and runs the given program, which can be a DOS, Windows 3.x, Win32 or Win64 executable (on 64-bit systems).

For debugging wine, use winedbg instead.

For running CUI executables (Windows console programs), use wineconsole instead of wine. This will display all the output in a separate windows (this requires X11 to run). Not using wineconsole for CUI programs will only provide very limited console support, and your program might not function properly.

When invoked with --help or --version as the only argument, wine will simply print a small help message or its version respectively and exit.

PROGRAM/ARGUMENTS

The program name may be specified in DOS format (C:\\WINDOWS\\SOL.EXE) or in Unix format (/msdos/windows/sol.exe). You may pass arguments to the program being executed by adding them to the end of the command line invoking wine (such as: wine notepad C:\\TEMP\\README.TXT). Note that you need to ’\’ escape special characters (and spaces) when invoking Wine via a shell, e.g.

wine C:\\Program\ Files\\MyPrg\\test.exe

It can also be one of the Windows executables shipped with Wine, in which case specifying the full path is not mandatory, e.g. wine explorer or wine notepad.

ENVIRONMENT

wine makes the environment variables of the shell from which it is started accessible to the Windows/DOS processes started. So use the appropriate syntax for your shell to enter environment variables you need.
WINEPREFIX

If set, the contents of this variable is taken as the name of the directory where Wine stores its data (the default is $HOME/.wine). This directory is also used to identify the socket which is used to communicate with the wineserver. All wine processes using the same wineserver (i.e.: same user) share certain things like registry, shared memory, and config file. By setting WINEPREFIX to different values for different wine processes, it is possible to run a number of truly independent wine processes.

WINESERVER

Specifies the path and name of the wineserver binary. If not set, Wine will try to load /usr/bin/wineserver, and if this doesn’t exist it will then look for a file named "wineserver" in the path and in a few other likely locations.

WINELOADER

Specifies the path and name of the wine binary to use to launch new Windows processes. If not set, Wine will try to load /usr/bin/wine, and if this doesn’t exist it will then look for a file named "wine" in the path and in a few other likely locations.

WINEDEBUG

Turns debugging messages on or off. The syntax of the variable is of the form [class][+|-]channel[,[class2][+|-]channel2]

class is optional and can be one of the following: err, warn, fixme, or trace. If class is not specified, all debugging messages for the specified channel are turned on. Each channel will print messages about a particular component of Wine. The following character can be either + or - to switch the specified channel on or off respectively. If there is no class part before it, a leading + can be omitted. Note that spaces are not allowed anywhere in the string.

Examples:
WINEDEBUG=warn+all

will turn on all warning messages (recommended for debugging).

WINEDEBUG=warn+dll,+heap

will turn on DLL warning messages and all heap messages.

WINEDEBUG=fixme-all,warn+cursor,+relay

will turn off all FIXME messages, turn on cursor warning messages, and turn on all relay messages (API calls).

WINEDEBUG=relay

will turn on all relay messages. For more control on including or excluding functions and dlls from the relay trace, look into the HKEY_CURRENT_USER\Software\Wine\Debug registry key.

For more information on debugging messages, see the Running Wine chapter of the Wine User Guide.

WINEDLLPATH

Specifies the path(s) in which to search for builtin dlls and Winelib applications. This is a list of directories separated by ":". In addition to any directory specified in WINEDLLPATH, Wine will also look in /usr/lib64/wine.

WINEDLLOVERRIDES

Defines the override type and load order of dlls used in the loading process for any dll. There are currently two types of libraries that can be loaded into a process address space: native windows dlls (native) and Wine internal dlls (builtin). The type may be abbreviated with the first letter of the type (n or b). The library may also be disabled (’’). Each sequence of orders must be separated by commas.

Each dll may have its own specific load order. The load order determines which version of the dll is attempted to be loaded into the address space. If the first fails, then the next is tried and so on. Multiple libraries with the same load order can be separated with commas. It is also possible to use specify different loadorders for different libraries by separating the entries by ";".

The load order for a 16-bit dll is always defined by the load order of the 32-bit dll that contains it (which can be identified by looking at the symbolic link of the 16-bit .dll.so file). For instance if ole32.dll is configured as builtin, storage.dll will be loaded as builtin too, since the 32-bit ole32.dll contains the 16-bit storage.dll.

Examples:
WINEDLLOVERRIDES="comdlg32,shell32=n,b"

Try to load comdlg32 and shell32 as native windows dll first and try the builtin version if the native load fails.

WINEDLLOVERRIDES="comdlg32,shell32=n;c:\\foo\ ar\ az=b"

Try to load the libraries comdlg32 and shell32 as native windows dlls. Furthermore, if an application request to load c:\foo ar az.dll load the builtin library baz.

WINEDLLOVERRIDES="comdlg32=b,n;shell32=b;comctl32=n;oleaut32="

Try to load comdlg32 as builtin first and try the native version if the builtin load fails; load shell32 always as builtin and comctl32 always as native; oleaut32 will be disabled.

WINEARCH

Specifies the Windows architecture to support. It can be set either to win32 (support only 32-bit applications), or to win64 (support both 64-bit applications and 32-bit ones in WoW64 mode).
The architecture supported by a given Wine prefix is set at prefix creation time and cannot be changed afterwards. When running with an existing prefix, Wine will refuse to start if WINEARCH doesn’t match the prefix architecture.

DISPLAY

Specifies the X11 display to use.

OSS sound driver configuration variables:
AUDIODEV

Set the device for audio input / output. Default /dev/dsp.

MIXERDEV

Set the device for mixer controls. Default /dev/mixer.

MIDIDEV

Set the MIDI (sequencer) device. Default /dev/sequencer.

FILES

/usr/bin/wine

The Wine program loader.

/usr/bin/wineconsole

The Wine program loader for CUI (console) applications.

/usr/bin/wineserver

The Wine server

/usr/bin/winedbg

The Wine debugger

/usr/lib64/wine

Directory containing Wine shared libraries

$WINEPREFIX/dosdevices

Directory containing the DOS device mappings. Each file in that directory is a symlink to the Unix device file implementing a given device. For instance, if COM1 is mapped to /dev/ttyS0 you’d have a symlink of the form $WINEPREFIX/dosdevices/com1 -> /dev/ttyS0.
DOS drives are also specified with symlinks; for instance if drive D: corresponds to the CDROM mounted at /mnt/cdrom, you’d have a symlink $WINEPREFIX/dosdevices/d: -> /mnt/cdrom. The Unix device corresponding to a DOS drive can be specified the same way, except with ’::’ instead of ’:’. So for the previous example, if the CDROM device is mounted from /dev/hdc, the corresponding symlink would be $WINEPREFIX/dosdevices/d:: -> /dev/hdc.

AUTHORS

Wine is available thanks to the work of many developers. For a listing of the authors, please see the file AUTHORS in the top-level directory of the source distribution.

COPYRIGHT

Wine can be distributed under the terms of the LGPL license. A copy of the license is in the file COPYING.LIB in the top-level directory of the source distribution.

BUGS

A status report on many applications is available from the ("http://appdb.winehq.org") Wine Application Database. Please add entries to this list for applications you currently run, if necessary.

Bugs can be reported on the ("http://bugs.winehq.org") Wine bug tracker.

AVAILABILITY

The most recent public version of wine is available through WineHQ, the ("http://www.winehq.org/") Wine development headquarters.

Opportunity

Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.

Free Software

Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.

Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.

Free Books

The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.

Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.

Education

Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.

Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.