mirror of
git://source.winehq.org/git/wine.git
synced 2024-09-01 16:13:38 +00:00
334 lines
9.4 KiB
Groff
334 lines
9.4 KiB
Groff
.\" -*- nroff -*-
|
|
.TH WINE 1 "October 2005" "@PACKAGE_STRING@" "Windows On Unix"
|
|
.SH NAME
|
|
wine \- run Windows programs on Unix
|
|
.SH SYNOPSIS
|
|
.BI "wine " program
|
|
[arguments ... ]
|
|
.br
|
|
.B wine --help
|
|
.br
|
|
.B wine --version
|
|
.PP
|
|
For instructions on passing arguments to Windows programs, please see the
|
|
.B
|
|
PROGRAM/ARGUMENTS
|
|
section of the man page.
|
|
.SH DESCRIPTION
|
|
.B wine
|
|
loads and runs the given program, where the program is a DOS, Windows
|
|
3.x, or Win32 executable (x86 binaries only).
|
|
.PP
|
|
For debugging wine, use
|
|
.B winedbg
|
|
instead.
|
|
.PP
|
|
For running CUI executables (Windows console programs), use
|
|
.B wineconsole
|
|
instead of
|
|
.BR wine .
|
|
This will display all the output in a separate windows (this requires X11 to
|
|
run). Not using
|
|
.B wineconsole
|
|
for CUI programs will only provide very limited console support, and your
|
|
program might not function properly.
|
|
.PP
|
|
When invoked with
|
|
.B --help
|
|
or
|
|
.B --version
|
|
as the only argument,
|
|
.B wine
|
|
will simply print a small help message or its version respectively and exit.
|
|
.SH PROGRAM/ARGUMENTS
|
|
The program name may be specified in DOS format
|
|
.RI ( C:\(rs\(rsWINDOWS\(rs\(rsSOL.EXE )
|
|
or in Unix format
|
|
.RI ( /msdos/windows/sol.exe ).
|
|
You may pass arguments to the program being executed by adding them to the
|
|
end of the command line invoking
|
|
.B wine
|
|
(such as: wine notepad C:\(rs\(rsTEMP\(rs\(rsREADME.TXT).
|
|
Note that you need to '\(rs' escape special characters (and spaces) when invoking Wine via
|
|
a shell, e.g.
|
|
.PP
|
|
wine C:\(rs\(rsProgram\(rs Files\(rs\(rsMyPrg\(rs\(rstest.exe
|
|
.PP
|
|
.SH ENVIRONMENT VARIABLES
|
|
.B wine
|
|
makes the environment variables of the shell from which
|
|
.B wine
|
|
is started accessible to the windows/dos processes started. So use the
|
|
appropriate syntax for your shell to enter environment variables you need.
|
|
.TP
|
|
.I WINEPREFIX
|
|
If set, the content of this variable is taken as the name of the directory where
|
|
.B wine
|
|
stores its data (the default is
|
|
.IR $HOME/.wine ).
|
|
This directory is also used to identify the socket which is used to
|
|
communicate with the
|
|
.IR wineserver .
|
|
All
|
|
.B wine
|
|
processes using the same
|
|
.B wineserver
|
|
(i.e.: same user) share certain things like registry, shared memory,
|
|
and config file.
|
|
By setting
|
|
.I WINEPREFIX
|
|
to different values for different
|
|
.B wine
|
|
processes, it is possible to run a number of truly independent
|
|
.B wine
|
|
processes.
|
|
.TP
|
|
.I WINESERVER
|
|
Specifies the path and name of the
|
|
.B wineserver
|
|
binary. If not set, Wine will try to load
|
|
.BR @bindir@/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.
|
|
.TP
|
|
.I WINELOADER
|
|
Specifies the path and name of the
|
|
.B wine
|
|
binary to use to launch new Windows processes. If not set, Wine will
|
|
try to load
|
|
.BR @bindir@/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.
|
|
.TP
|
|
.I WINEDEBUG
|
|
Turns debugging messages on or off. The syntax of the variable is
|
|
of the form
|
|
.RI [ class ][+/-] channel [,[ class2 ][+/-] channel2 ].
|
|
.RS +7
|
|
.PP
|
|
.I class
|
|
is optional and can be one of the following:
|
|
.BR err ,
|
|
.BR warn ,
|
|
.BR fixme ,
|
|
or
|
|
.BR trace .
|
|
If
|
|
.I class
|
|
is not specified, all debugging messages for the specified
|
|
channel are turned on. Each channel will print messages about a particular
|
|
component of
|
|
.BR wine .
|
|
The following character can be either + or - to switch the specified
|
|
channel on or off respectively. If there is no
|
|
.I class
|
|
part before it, a leading + can be omitted. Note that spaces are not
|
|
allowed anywhere in the string.
|
|
.PP
|
|
Examples:
|
|
.TP
|
|
WINEDEBUG=warn+all
|
|
will turn on all warning messages (recommended for debugging).
|
|
.br
|
|
.TP
|
|
WINEDEBUG=warn+dll,+heap
|
|
will turn on DLL warning messages and all heap messages.
|
|
.br
|
|
.TP
|
|
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).
|
|
.br
|
|
.TP
|
|
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
|
|
.B HKEY_CURRENT_USER\\\\Software\\\\Wine\\\\Debug
|
|
registry key.
|
|
.PP
|
|
For more information on debugging messages, see the
|
|
.I Running Wine
|
|
chapter of the Wine User Guide.
|
|
.RE
|
|
.TP
|
|
.I 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
|
|
.IR WINEDLLPATH ,
|
|
Wine will also look in
|
|
.BR @dlldir@ .
|
|
.TP
|
|
.I 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
|
|
.RI ( native ),
|
|
.B wine
|
|
internal dlls
|
|
.RI ( builtin ).
|
|
The type may be abbreviated with the first letter of the type
|
|
.RI ( n ", " b ).
|
|
The library may also be disabled (''). Each sequence of orders must be separated by commas.
|
|
.RS
|
|
.PP
|
|
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 ";".
|
|
.PP
|
|
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.
|
|
.PP
|
|
Examples:
|
|
.TP
|
|
WINEDLLOVERRIDES="comdlg32,shell32=n,b"
|
|
.br
|
|
Try to load comdlg32 and shell32 as native windows dll first and try
|
|
the builtin version if the native load fails.
|
|
.TP
|
|
WINEDLLOVERRIDES="comdlg32,shell32=n;c:\(rs\(rsfoo\(rs\(rsbar\(rs\(rsbaz=b"
|
|
.br
|
|
Try to load the libraries comdlg32 and shell32 as native windows dlls. Furthermore, if
|
|
an application request to load c:\(rsfoo\(rsbar\(rsbaz.dll load the builtin library baz.
|
|
.TP
|
|
WINEDLLOVERRIDES="comdlg32=b,n;shell32=b;comctl32=n;oleaut32="
|
|
.br
|
|
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.
|
|
.RE
|
|
.TP
|
|
.I WINEARCH
|
|
Specifies the Windows architecture to support. It can be set either to
|
|
.B win32
|
|
(support only 32-bit applications), or to
|
|
.B win64
|
|
(support both 64-bit applications and 32-bit ones in WoW64 mode).
|
|
.br
|
|
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
|
|
.I WINEARCH
|
|
doesn't match the prefix architecture.
|
|
.TP
|
|
.I DISPLAY
|
|
Specifies the X11 display to use.
|
|
.TP
|
|
OSS sound driver configuration variables
|
|
.TP
|
|
.I AUDIODEV
|
|
Set the device for audio input / output. Default
|
|
.BR /dev/dsp .
|
|
.TP
|
|
.I MIXERDEV
|
|
Set the device for mixer controls. Default
|
|
.BR /dev/mixer .
|
|
.TP
|
|
.I MIDIDEV
|
|
Set the MIDI (sequencer) device. Default
|
|
.BR /dev/sequencer .
|
|
.SH FILES
|
|
.TP
|
|
.I @bindir@/wine
|
|
The
|
|
.B wine
|
|
program loader.
|
|
.TP
|
|
.I @bindir@/wineconsole
|
|
The
|
|
.B wine
|
|
program loader for CUI (console) applications.
|
|
.TP
|
|
.I @bindir@/wineserver
|
|
The
|
|
.B wine
|
|
server
|
|
.TP
|
|
.I @bindir@/winedbg
|
|
The
|
|
.B wine
|
|
debugger
|
|
.TP
|
|
.I @dlldir@
|
|
Directory containing
|
|
.BR wine 's
|
|
shared libraries
|
|
.TP
|
|
.I $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.
|
|
.br
|
|
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.
|
|
.SH AUTHORS
|
|
.B wine
|
|
is available thanks to the work of many developers. For a listing
|
|
of the authors, please see the file
|
|
.B AUTHORS
|
|
in the top-level directory of the source distribution.
|
|
.SH COPYRIGHT
|
|
.B wine
|
|
can be distributed under the terms of the LGPL license. A copy of the
|
|
license is in the file
|
|
.B COPYING.LIB
|
|
in the top-level directory of the source distribution.
|
|
.SH BUGS
|
|
.PP
|
|
A status report on many applications is available from
|
|
.IR http://appdb.winehq.org .
|
|
Please add entries to this list for applications you currently run, if
|
|
there is no entry for this application.
|
|
.PP
|
|
Bug reports may be posted to Wine Bugzilla
|
|
.I http://bugs.winehq.org
|
|
If you want to post a bug report, please see
|
|
.I http://wiki.winehq.org/Bugs
|
|
in the
|
|
.B wine
|
|
source to see what information is necessary
|
|
.PP
|
|
Problems and suggestions with this manpage please also report to
|
|
.I http://bugs.winehq.org
|
|
.SH AVAILABILITY
|
|
The most recent public version of
|
|
.B wine
|
|
can be downloaded from
|
|
.I http://www.winehq.org/download
|
|
.PP
|
|
The latest snapshot of the code may be obtained via GIT. For information
|
|
on how to do this, please see
|
|
.I
|
|
http://www.winehq.org/site/git
|
|
.PP
|
|
WineHQ, the
|
|
.B wine
|
|
development headquarters, is at
|
|
.IR http://www.winehq.org .
|
|
This website contains a great deal of information about
|
|
.BR wine .
|
|
.PP
|
|
For further information about
|
|
.B wine
|
|
development, you might want to subscribe to the
|
|
.B wine
|
|
mailing lists at
|
|
.I http://www.winehq.org/forums
|
|
|
|
.SH "SEE ALSO"
|
|
.BR wineserver (1),
|
|
.BR winedbg (1)
|