Warning, /loader/wine.man.in is written in an unsupported language. File is not indexed.
5f50ebb84… Fréd*0001 .TH WINE 1 "July 2013" "@PACKAGE_STRING@" "Windows On Unix"
ded3038c1… Alex*0002 .SH NAME
692389d09… Doug*0003 wine \- run Windows programs on Unix
ded3038c1… Alex*0004 .SH SYNOPSIS
5cbf17363… Fréd*0005 .B wine
0006 .IR "program " [ arguments ]
f950d9738… Dimi*0007 .br
0008 .B wine --help
0009 .br
0010 .B wine --version
38a3d264f… Jame*0011 .PP
70c82e805… Andr*0012 For instructions on passing arguments to Windows programs, please see the
38a3d264f… Jame*0013 .B
0014 PROGRAM/ARGUMENTS
0015 section of the man page.
ded3038c1… Alex*0016 .SH DESCRIPTION
0017 .B wine
5f50ebb84… Fréd*0018 loads and runs the given program, which can be a DOS, Windows
0019 3.x, Win32 or Win64 executable (on 64-bit systems).
ded3038c1… Alex*0020 .PP
6f83a5ee8… Andr*0021 For debugging wine, use
0022 .B winedbg
0023 instead.
0024 .PP
0b83d4cbc… Eric*0025 For running CUI executables (Windows console programs), use
0026 .B wineconsole
0027 instead of
db7928c38… Fréd*0028 .BR wine .
da26ee745… Hugh*0029 This will display the output in a separate window. Not using
0b83d4cbc… Eric*0030 .B wineconsole
0031 for CUI programs will only provide very limited console support, and your
0032 program might not function properly.
0033 .PP
f950d9738… Dimi*0034 When invoked with
0035 .B --help
0036 or
0037 .B --version
0038 as the only argument,
0039 .B wine
0040 will simply print a small help message or its version respectively and exit.
ded3038c1… Alex*0041 .SH PROGRAM/ARGUMENTS
db7928c38… Fréd*0042 The program name may be specified in DOS format
0043 .RI ( C:\(rs\(rsWINDOWS\(rs\(rsSOL.EXE )
0044 or in Unix format
0045 .RI ( /msdos/windows/sol.exe ).
0046 You may pass arguments to the program being executed by adding them to the
0047 end of the command line invoking
ded3038c1… Alex*0048 .B wine
5cbf17363… Fréd*0049 (such as: \fIwine notepad C:\(rs\(rsTEMP\(rs\(rsREADME.TXT\fR).
da920ee9b… Andr*0050 Note that you need to '\(rs' escape special characters (and spaces) when invoking Wine via
0051 a shell, e.g.
0052 .PP
0053 wine C:\(rs\(rsProgram\(rs Files\(rs\(rsMyPrg\(rs\(rstest.exe
0054 .PP
ee771fdda… Fréd*0055 It can also be one of the Windows executables shipped with Wine, in
0056 which case specifying the full path is not mandatory, e.g. \fIwine
0057 explorer\fR or \fIwine notepad\fR.
0058 .PP
5cbf17363… Fréd*0059 .SH ENVIRONMENT
d6baf1bb1… Alex*0060 .B wine
5cbf17363… Fréd*0061 makes the environment variables of the shell from which it
0062 is started accessible to the Windows/DOS processes started. So use the
d6baf1bb1… Alex*0063 appropriate syntax for your shell to enter environment variables you need.
48320f744… Pete*0064 .TP
5cbf17363… Fréd*0065 .B WINEPREFIX
0066 If set, the contents of this variable is taken as the name of the directory where
0067 Wine stores its data (the default is
db7928c38… Fréd*0068 .IR $HOME/.wine ).
0069 This directory is also used to identify the socket which is used to
553a75e16… Alex*0070 communicate with the
5cbf17363… Fréd*0071 .BR wineserver .
48320f744… Pete*0072 All
0073 .B wine
ff96f919c… Andr*0074 processes using the same
48320f744… Pete*0075 .B wineserver
b37b863b9… Laws*0076 (i.e.: same user) share certain things like registry, shared memory,
0077 and config file.
ff96f919c… Andr*0078 By setting
5cbf17363… Fréd*0079 .B WINEPREFIX
48320f744… Pete*0080 to different values for different
0081 .B wine
0082 processes, it is possible to run a number of truly independent
0083 .B wine
0084 processes.
32fcfc24a… Alex*0085 .TP
5cbf17363… Fréd*0086 .B WINESERVER
32fcfc24a… Alex*0087 Specifies the path and name of the
0088 .B wineserver
8d628b125… Alex*0089 binary. If not set, Wine will look for a file named "wineserver" in
0090 the path and in a few other likely locations.
32fcfc24a… Alex*0091 .TP
5cbf17363… Fréd*0092 .B WINELOADER
32fcfc24a… Alex*0093 Specifies the path and name of the
0094 .B wine
3536316a3… Alex*0095 binary to use to launch new Windows processes. If not set, Wine will
8d628b125… Alex*0096 look for a file named "wine" in the path and in a few other likely
0097 locations.
32fcfc24a… Alex*0098 .TP
5cbf17363… Fréd*0099 .B WINEDEBUG
bb4ddfec2… Alex*0100 Turns debugging messages on or off. The syntax of the variable is
8a37297fe… Alex*0101 of the form
5cbf17363… Fréd*0102 .RI [ class ][\fB+\fR|\fB-\fR] channel [,[ class2 ][\fB+\fR|\fB-\fR] channel2 ]
8a37297fe… Alex*0103 .RS +7
0104 .PP
0105 .I class
0106 is optional and can be one of the following:
db7928c38… Fréd*0107 .BR err ,
0108 .BR warn ,
0109 .BR fixme ,
8a37297fe… Alex*0110 or
db7928c38… Fréd*0111 .BR trace .
8a37297fe… Alex*0112 If
0113 .I class
0114 is not specified, all debugging messages for the specified
0115 channel are turned on. Each channel will print messages about a particular
5cbf17363… Fréd*0116 component of Wine.
0117 The following character can be either \fB+\fR or \fB-\fR to switch the specified
8a37297fe… Alex*0118 channel on or off respectively. If there is no
0119 .I class
5cbf17363… Fréd*0120 part before it, a leading \fB+\fR\fR can be omitted. Note that spaces are not
8a37297fe… Alex*0121 allowed anywhere in the string.
0122 .PP
0123 Examples:
0124 .TP
0125 WINEDEBUG=warn+all
0126 will turn on all warning messages (recommended for debugging).
0127 .br
0128 .TP
0129 WINEDEBUG=warn+dll,+heap
0130 will turn on DLL warning messages and all heap messages.
0131 .br
0132 .TP
0133 WINEDEBUG=fixme-all,warn+cursor,+relay
0134 will turn off all FIXME messages, turn on cursor warning messages, and turn
0135 on all relay messages (API calls).
0136 .br
0137 .TP
0138 WINEDEBUG=relay
0139 will turn on all relay messages. For more control on including or excluding
a49891f1e… Alex*0140 functions and dlls from the relay trace, look into the
0141 .B HKEY_CURRENT_USER\\\\Software\\\\Wine\\\\Debug
0142 registry key.
8a37297fe… Alex*0143 .PP
0144 For more information on debugging messages, see the
0145 .I Running Wine
0146 chapter of the Wine User Guide.
0147 .RE
bb4ddfec2… Alex*0148 .TP
5cbf17363… Fréd*0149 .B WINEDLLPATH
3536316a3… Alex*0150 Specifies the path(s) in which to search for builtin dlls and Winelib
0151 applications. This is a list of directories separated by ":". In
0152 addition to any directory specified in
5cbf17363… Fréd*0153 .BR WINEDLLPATH ,
8d628b125… Alex*0154 Wine will also look in the installation directory.
26320d1f7… Alex*0155 .TP
5cbf17363… Fréd*0156 .B WINEDLLOVERRIDES
2052538a4… Alex*0157 Defines the override type and load order of dlls used in the loading
4ae532501… Andr*0158 process for any dll. There are currently two types of libraries that can be loaded
5cbf17363… Fréd*0159 into a process address space: native windows dlls
0160 .RI ( native ") and Wine internal dlls (" builtin ).
db7928c38… Fréd*0161 The type may be abbreviated with the first letter of the type
5cbf17363… Fréd*0162 .RI ( n " or " b ).
db7928c38… Fréd*0163 The library may also be disabled (''). Each sequence of orders must be separated by commas.
8a37297fe… Alex*0164 .RS
0165 .PP
2052538a4… Alex*0166 Each dll may have its own specific load order. The load order
0167 determines which version of the dll is attempted to be loaded into the
0168 address space. If the first fails, then the next is tried and so
0169 on. Multiple libraries with the same load order can be separated with
0170 commas. It is also possible to use specify different loadorders for
0171 different libraries by separating the entries by ";".
8a37297fe… Alex*0172 .PP
7412125e4… Alex*0173 The load order for a 16-bit dll is always defined by the load order of
0174 the 32-bit dll that contains it (which can be identified by looking at
0175 the symbolic link of the 16-bit .dll.so file). For instance if
5cbf17363… Fréd*0176 \fIole32.dll\fR is configured as builtin, \fIstorage.dll\fR will be loaded as
0177 builtin too, since the 32-bit \fIole32.dll\fR contains the 16-bit
0178 \fIstorage.dll\fR.
8a37297fe… Alex*0179 .PP
2052538a4… Alex*0180 Examples:
0181 .TP
7412125e4… Alex*0182 WINEDLLOVERRIDES="comdlg32,shell32=n,b"
2052538a4… Alex*0183 .br
7412125e4… Alex*0184 Try to load comdlg32 and shell32 as native windows dll first and try
2052538a4… Alex*0185 the builtin version if the native load fails.
0186 .TP
7412125e4… Alex*0187 WINEDLLOVERRIDES="comdlg32,shell32=n;c:\(rs\(rsfoo\(rs\(rsbar\(rs\(rsbaz=b"
2052538a4… Alex*0188 .br
7412125e4… Alex*0189 Try to load the libraries comdlg32 and shell32 as native windows dlls. Furthermore, if
5cbf17363… Fréd*0190 an application request to load \fIc:\(rsfoo\(rsbar\(rsbaz.dll\fR load the builtin library \fIbaz\fR.
2052538a4… Alex*0191 .TP
5e10ef042… Aust*0192 WINEDLLOVERRIDES="comdlg32=b,n;shell32=b;comctl32=n;oleaut32="
2052538a4… Alex*0193 .br
7412125e4… Alex*0194 Try to load comdlg32 as builtin first and try the native version if
0195 the builtin load fails; load shell32 always as builtin and comctl32
5cbf17363… Fréd*0196 always as native; oleaut32 will be disabled.
2052538a4… Alex*0197 .RE
0198 .TP
3c6404707… Mike*0199 .B WINEPATH
0200 Specifies additional path(s) to be prepended to the default Windows
0201 .B PATH
0202 environment variable. This is a list of Windows-style directories
0203 separated by ";".
0204 .RS
0205 .PP
0206 For a permanent alternative, edit (create if needed) the
0207 .B PATH
0208 value under the
0209 .B HKEY_CURRENT_USER\\\\Environment
0210 registry key.
0211 .RE
0212 .TP
5cbf17363… Fréd*0213 .B WINEARCH
a49891f1e… Alex*0214 Specifies the Windows architecture to support. It can be set either to
0215 .B win32
0216 (support only 32-bit applications), or to
0217 .B win64
0218 (support both 64-bit applications and 32-bit ones in WoW64 mode).
0219 .br
0220 The architecture supported by a given Wine prefix is set at prefix
0221 creation time and cannot be changed afterwards. When running with an
0222 existing prefix, Wine will refuse to start if
5cbf17363… Fréd*0223 .B WINEARCH
a49891f1e… Alex*0224 doesn't match the prefix architecture.
0225 .TP
11bd4b53a… Flor*0226 .B WINE_D3D_CONFIG
0227 Specifies Direct3D configuration options. It can be used instead of
0228 modifying the
0229 .B HKEY_CURRENT_USER\\\\Software\\\\Wine\\\\Direct3D
0230 registry key. The value is a comma- or semicolon-separated list
0231 of key-value pairs. For example:
0232 .IP
0233 WINE_D3D_CONFIG="renderer=vulkan;VideoPciVendorID=0xc0de"
0234 .IP
0235 If an individual setting is specified in both
0236 the environment variable and the registry, the former takes precedence.
0237 .TP
5cbf17363… Fréd*0238 .B DISPLAY
26320d1f7… Alex*0239 Specifies the X11 display to use.
b7addaab6… Vita*0240 .TP
5cbf17363… Fréd*0241 OSS sound driver configuration variables:
b7addaab6… Vita*0242 .TP
5cbf17363… Fréd*0243 .B AUDIODEV
b7addaab6… Vita*0244 Set the device for audio input / output. Default
5cbf17363… Fréd*0245 .IR /dev/dsp .
b7addaab6… Vita*0246 .TP
5cbf17363… Fréd*0247 .B MIXERDEV
b7addaab6… Vita*0248 Set the device for mixer controls. Default
5cbf17363… Fréd*0249 .IR /dev/mixer .
b7addaab6… Vita*0250 .TP
5cbf17363… Fréd*0251 .B MIDIDEV
b7addaab6… Vita*0252 Set the MIDI (sequencer) device. Default
5cbf17363… Fréd*0253 .IR /dev/sequencer .
553a75e16… Alex*0254 .SH FILES
0255 .TP
8d628b125… Alex*0256 .I wine
5cbf17363… Fréd*0257 The Wine program loader.
553a75e16… Alex*0258 .TP
8d628b125… Alex*0259 .I wineconsole
5cbf17363… Fréd*0260 The Wine program loader for CUI (console) applications.
553a75e16… Alex*0261 .TP
8d628b125… Alex*0262 .I wineserver
5cbf17363… Fréd*0263 The Wine server
0264 .TP
8d628b125… Alex*0265 .I winedbg
5cbf17363… Fréd*0266 The Wine debugger
0267 .TP
553a75e16… Alex*0268 .I $WINEPREFIX/dosdevices
0269 Directory containing the DOS device mappings. Each file in that
0270 directory is a symlink to the Unix device file implementing a given
5cbf17363… Fréd*0271 device. For instance, if COM1 is mapped to \fI/dev/ttyS0\fR you'd have a
0272 symlink of the form \fI$WINEPREFIX/dosdevices/com1\fR -> \fI/dev/ttyS0\fR.
553a75e16… Alex*0273 .br
0274 DOS drives are also specified with symlinks; for instance if drive D:
5cbf17363… Fréd*0275 corresponds to the CDROM mounted at \fI/mnt/cdrom\fR, you'd have a symlink
0276 \fI$WINEPREFIX/dosdevices/d:\fR -> \fI/mnt/cdrom\fR. The Unix device corresponding
553a75e16… Alex*0277 to a DOS drive can be specified the same way, except with '::' instead
0278 of ':'. So for the previous example, if the CDROM device is mounted
5cbf17363… Fréd*0279 from \fI/dev/hdc\fR, the corresponding symlink would be
0280 \fI$WINEPREFIX/dosdevices/d::\fR -> \fI/dev/hdc\fR.
ded3038c1… Alex*0281 .SH AUTHORS
5cbf17363… Fréd*0282 Wine is available thanks to the work of many developers. For a listing
0283 of the authors, please see the file
0284 .I AUTHORS
642d3136d… Alex*0285 in the top-level directory of the source distribution.
32fcfc24a… Alex*0286 .SH COPYRIGHT
5cbf17363… Fréd*0287 Wine can be distributed under the terms of the LGPL license. A copy of the
32fcfc24a… Alex*0288 license is in the file
5cbf17363… Fréd*0289 .I COPYING.LIB
32fcfc24a… Alex*0290 in the top-level directory of the source distribution.
ded3038c1… Alex*0291 .SH BUGS
0292 .PP
dcc97a186… Alex*0293 A status report on many applications is available from the
3bc68c24b… Aust*0294 .UR https://appdb.winehq.org
dcc97a186… Alex*0295 .B Wine Application Database
0296 .UE .
0bd72d0a5… Marc*0297 Please add entries to this list for applications you currently run, if
dcc97a186… Alex*0298 necessary.
ded3038c1… Alex*0299 .PP
dcc97a186… Alex*0300 Bugs can be reported on the
3bc68c24b… Aust*0301 .UR https://bugs.winehq.org
dcc97a186… Alex*0302 .B Wine bug tracker
0303 .UE .
ded3038c1… Alex*0304 .SH AVAILABILITY
0305 The most recent public version of
0306 .B wine
dcc97a186… Alex*0307 is available through WineHQ, the
3bc68c24b… Aust*0308 .UR https://www.winehq.org/
dcc97a186… Alex*0309 .B Wine development headquarters
0310 .UE .
32fcfc24a… Alex*0311 .SH "SEE ALSO"
db7928c38… Fréd*0312 .BR wineserver (1),
dcc97a186… Alex*0313 .BR winedbg (1),
0314 .br
3bc68c24b… Aust*0315 .UR https://www.winehq.org/help
dcc97a186… Alex*0316 .B Wine documentation and support
0317 .UE .
