1WINE(1)                         Windows On Unix                        WINE(1)
2
3
4

NAME

6       wine - run Windows programs on Unix
7

SYNOPSIS

9       wine program [arguments]
10       wine --help
11       wine --version
12
13       For  instructions  on passing arguments to Windows programs, please see
14       the PROGRAM/ARGUMENTS section of the man page.
15

DESCRIPTION

17       wine loads and runs the given program, which can be a DOS, Windows 3.x,
18       Win32 or Win64 executable (on 64-bit systems).
19
20       For debugging wine, use winedbg instead.
21
22       For running CUI executables (Windows console programs), use wineconsole
23       instead of wine.  This will display the output in  a  separate  window.
24       Not  using  wineconsole for CUI programs will only provide very limited
25       console support, and your program might not function properly.
26
27       When invoked with --help or --version as the only argument,  wine  will
28       simply print a small help message or its version respectively and exit.
29

PROGRAM/ARGUMENTS

31       The  program name may be specified in DOS format (C:\\WINDOWS\\SOL.EXE)
32       or in Unix format (/msdos/windows/sol.exe).  You may pass arguments  to
33       the  program  being  executed  by adding them to the end of the command
34       line invoking wine (such as: wine notepad C:\\TEMP\\README.TXT).   Note
35       that you need to '\' escape special characters (and spaces) when invok‐
36       ing Wine via a shell, e.g.
37
38       wine C:\\Program\ Files\\MyPrg\\test.exe
39
40       It can also be one of the Windows executables  shipped  with  Wine,  in
41       which  case  specifying  the  full  path  is  not  mandatory, e.g. wine
42       explorer or wine notepad.
43

ENVIRONMENT

45       wine makes the environment variables of the  shell  from  which  it  is
46       started  accessible  to  the  Windows/DOS processes started. So use the
47       appropriate syntax for your shell to enter  environment  variables  you
48       need.
49
50       WINEPREFIX
51              If  set,  the  contents of this variable is taken as the name of
52              the directory  where  Wine  stores  its  data  (the  default  is
53              $HOME/.wine).   This  directory  is  also  used  to identify the
54              socket which is used to communicate with  the  wineserver.   All
55              wine processes using the same wineserver (i.e.: same user) share
56              certain things like registry, shared memory,  and  config  file.
57              By  setting  WINEPREFIX  to  different values for different wine
58              processes, it is possible to run a number of  truly  independent
59              wine processes.
60
61       WINESERVER
62              Specifies  the  path  and  name of the wineserver binary. If not
63              set, Wine will try to  load  /usr/bin/wineserver,  and  if  this
64              doesn't exist it will then look for a file named "wineserver" in
65              the path and in a few other likely locations.
66
67       WINELOADER
68              Specifies the path and name of the wine binary to use to  launch
69              new  Windows  processes.  If  not  set,  Wine  will  try to load
70              /usr/bin/wine, and if this doesn't exist it will then look for a
71              file  named  "wine"  in the path and in a few other likely loca‐
72              tions.
73
74       WINEDEBUG
75              Turns debugging messages on or off. The syntax of  the  variable
76              is of the form [class][+|-]channel[,[class2][+|-]channel2]
77
78              class  is  optional  and can be one of the following: err, warn,
79              fixme, or trace.  If class is not specified, all debugging  mes‐
80              sages  for  the  specified  channel are turned on.  Each channel
81              will print messages about a particular component of  Wine.   The
82              following character can be either + or - to switch the specified
83              channel on or off respectively.   If  there  is  no  class  part
84              before  it, a leading + can be omitted. Note that spaces are not
85              allowed anywhere in the string.
86
87              Examples:
88
89              WINEDEBUG=warn+all
90                     will turn on all warning messages (recommended for debug‐
91                     ging).
92
93              WINEDEBUG=warn+dll,+heap
94                     will turn on DLL warning messages and all heap messages.
95
96              WINEDEBUG=fixme-all,warn+cursor,+relay
97                     will  turn off all FIXME messages, turn on cursor warning
98                     messages, and turn on all relay messages (API calls).
99
100              WINEDEBUG=relay
101                     will turn on all relay  messages.  For  more  control  on
102                     including  or excluding functions and dlls from the relay
103                     trace,    look    into    the     HKEY_CURRENT_USER\Soft‐
104                     ware\Wine\Debug registry key.
105
106              For more information on debugging messages, see the Running Wine
107              chapter of the Wine User Guide.
108
109       WINEDLLPATH
110              Specifies the path(s) in which to search for  builtin  dlls  and
111              Winelib applications. This is a list of directories separated by
112              ":". In addition to any directory specified in WINEDLLPATH, Wine
113              will also look in /usr/lib/wine.
114
115       WINEDLLOVERRIDES
116              Defines  the  override  type  and load order of dlls used in the
117              loading process for any dll. There are currently  two  types  of
118              libraries  that  can  be  loaded  into  a process address space:
119              native windows dlls (native) and Wine internal  dlls  (builtin).
120              The type may be abbreviated with the first letter of the type (n
121              or b).  The library may also be disabled (''). Each sequence  of
122              orders must be separated by commas.
123
124              Each  dll  may  have its own specific load order. The load order
125              determines which version of the dll is attempted  to  be  loaded
126              into  the  address  space.  If the first fails, then the next is
127              tried and so on. Multiple libraries with the same load order can
128              be  separated  with  commas.  It is also possible to use specify
129              different loadorders for different libraries by  separating  the
130              entries by ";".
131
132              The  load  order  for a 16-bit dll is always defined by the load
133              order of the 32-bit dll that contains it (which can  be  identi‐
134              fied  by  looking  at  the  symbolic  link of the 16-bit .dll.so
135              file). For instance if ole32.dll is configured as builtin, stor‐
136              age.dll  will  be  loaded  as  builtin  too,  since  the  32-bit
137              ole32.dll contains the 16-bit storage.dll.
138
139              Examples:
140
141              WINEDLLOVERRIDES="comdlg32,shell32=n,b"
142                     Try to load comdlg32 and shell32 as  native  windows  dll
143                     first  and  try  the  builtin  version if the native load
144                     fails.
145
146              WINEDLLOVERRIDES="comdlg32,shell32=n;c:\\foo\\bar\\baz=b"
147                     Try to load the libraries comdlg32 and shell32 as  native
148                     windows  dlls.  Furthermore, if an application request to
149                     load c:\foo\bar\baz.dll load the builtin library baz.
150
151              WINEDLLOVERRIDES="comdlg32=b,n;shell32=b;comctl32=n;oleaut32="
152                     Try to load comdlg32 as builtin first and try the  native
153                     version if the builtin load fails; load shell32 always as
154                     builtin and comctl32 always as native; oleaut32  will  be
155                     disabled.
156
157       WINEPATH
158              Specifies additional path(s) to be prepended to the default Win‐
159              dows PATH environment variable. This is a list of  Windows-style
160              directories separated by ";".
161
162              For  a  permanent  alternative, edit (create if needed) the PATH
163              value under the HKEY_CURRENT_USER\Environment registry key.
164
165       WINEARCH
166              Specifies the Windows architecture to support.  It  can  be  set
167              either  to win32 (support only 32-bit applications), or to win64
168              (support both 64-bit  applications  and  32-bit  ones  in  WoW64
169              mode).
170              The architecture supported by a given Wine prefix is set at pre‐
171              fix creation time and cannot be changed afterwards. When running
172              with  an  existing prefix, Wine will refuse to start if WINEARCH
173              doesn't match the prefix architecture.
174
175       DISPLAY
176              Specifies the X11 display to use.
177
178       OSS sound driver configuration variables:
179
180       AUDIODEV
181              Set the device for audio input / output. Default /dev/dsp.
182
183       MIXERDEV
184              Set the device for mixer controls. Default /dev/mixer.
185
186       MIDIDEV
187              Set the MIDI (sequencer) device. Default /dev/sequencer.
188

FILES

190       /usr/bin/wine
191              The Wine program loader.
192
193       /usr/bin/wineconsole
194              The Wine program loader for CUI (console) applications.
195
196       /usr/bin/wineserver
197              The Wine server
198
199       /usr/bin/winedbg
200              The Wine debugger
201
202       /usr/lib/wine
203              Directory containing Wine shared libraries
204
205       $WINEPREFIX/dosdevices
206              Directory containing the DOS device mappings. Each file in  that
207              directory  is  a  symlink to the Unix device file implementing a
208              given device. For instance, if  COM1  is  mapped  to  /dev/ttyS0
209              you'd  have a symlink of the form $WINEPREFIX/dosdevices/com1 ->
210              /dev/ttyS0.
211              DOS drives are also specified with  symlinks;  for  instance  if
212              drive  D:  corresponds to the CDROM mounted at /mnt/cdrom, you'd
213              have a symlink $WINEPREFIX/dosdevices/d: -> /mnt/cdrom. The Unix
214              device  corresponding  to  a DOS drive can be specified the same
215              way, except with '::' instead of ':'. So for the previous  exam‐
216              ple,  if  the  CDROM device is mounted from /dev/hdc, the corre‐
217              sponding  symlink   would   be   $WINEPREFIX/dosdevices/d::   ->
218              /dev/hdc.
219

AUTHORS

221       Wine  is available thanks to the work of many developers. For a listing
222       of the authors, please see the file AUTHORS in the top-level  directory
223       of the source distribution.
224
226       Wine  can be distributed under the terms of the LGPL license. A copy of
227       the license is in the file COPYING.LIB in the  top-level  directory  of
228       the source distribution.
229

BUGS

231       A  status  report  on  many  applications  is  available  from the Wine
232       Application Database https://appdb.winehq.org⟩.  Please add entries to
233       this list for applications you currently run, if necessary.
234
235       Bugs can be reported on the Wine bug tracker https://bugs.winehq.org⟩.
236

AVAILABILITY

238       The most recent public version of wine is available through WineHQ, the
239       Wine development headquarters https://www.winehq.org/⟩.
240

SEE ALSO

242       wineserver(1), winedbg(1),
243       Wine documentation and support https://www.winehq.org/help⟩.
244
245
246
247Wine 4.10                          July 2013                           WINE(1)
Impressum