2 .TH WINE.CONF 5 "September 2003" "Version 20030911" "Wine Configuration File"
4 wine.conf \- Wine configuration file
7 expects a configuration file (
10 ), which should conform to the following rules.
11 A sample configuration file is available as
12 .I documentation/samples/config
13 in the Wine source distribution.
14 .SH CONFIGURATION FILE FORMAT
15 All entries are grouped in sections; a section begins with the line
19 and continues until the next section starts. Individual entries
20 consist of lines of the form
22 .I """entry""=""value"""
24 The entry and value can be any text strings, included in double
25 quotes; it can also contain references to environment variables
28 Inside the double quotes, special characters, backslashes and quotes
29 must be escaped with backslashes. Supported section names and entries
34 This section is used to specify the root directory and type of each emulated
36 drive, since most Windows applications require a DOS/MS-Windows based
37 disk drive & directory scheme, which is either provided by a real
38 DOS partition mounted somewhere or by some carefully crafted directory layout
39 on a Unix file system ("no-windows fake installation").
40 There is one such section for every drive you want to configure.
42 .I format: """Path""=""<rootdirectory>"""
46 If you mounted your dos partition as
48 and installed Microsoft Windows in
49 C:\\WINDOWS (thus it shows up as /dos/WINDOWS), then you should specify
50 .I """Path""=""/dos"""
53 section in order to configure /dos as the drive root of drive C:.
55 .I format: """Type""=""<type>"""
59 Used to specify the drive type this drive appears as in Windows
60 or DOS programs; supported types are "floppy", "hd", "cdrom"
63 .I format: """FailReadOnly""=""<boolean>"""
65 Read-only files may not be opened in write mode (the default is to
66 allow opening read-only files for writing, because most Windows
67 programs always request read-write access, even on CD-ROM drives...).
71 .I format: """windows""=""<directory>"""
73 default: "C:\\\\WINDOWS"
75 Used to specify where Wine is supposed to have its Windows directory
76 (which is an essential part of a Windows environment); make sure to double
78 In case of e.g. C:\\WINDOWS, with drive C: being configured as
79 /home/user/wine_c, the /home/user/wine_c/WINDOWS directory would be used for
82 .I format: """system""=""<directory>"""
84 default: "C:\\\\WINDOWS\\\\System"
86 Used to specify where Wine is supposed to have its Windows system directory
87 (again, essential part of Windows environment); make sure to double the backslashes.
88 Given a setting of C:\\WINDOWS\\System (the standard setting on Windows)
89 and a C: drive again at /home/user/wine_c, the /home/user/wine_c/WINDOWS/System
90 directory would be used for this.
92 .I format: """temp""=""<directory>"""
96 Used to specify a directory where Windows applications can store
97 temporary files. E.g. with a C: drive at /home/user/wine_c, this would be
98 the /home/user/wine_c/TEMP directory.
100 .I format: """profile""=""<directory>"""
104 Used to specify a directory where Windows stores special folders and
105 the user-registry files (user.dat or ntuser.dat). Mapped to
106 environment variable %USERPROFILE%. Set this value when running with
107 a native NT or a native win95 directory with per-user settings.
109 .I format: """path""=""<directories separated by semi-colons>"""
111 default: "C:\\\\WINDOWS;C:\\\\WINDOWS\\\\SYSTEM"
113 Used to specify the path which will be used to find executables and
114 dlls. Make sure to double the backslashes.
116 .I format: """GraphicsDriver""=""<x11drv|ttydrv>"""
120 Tells Wine which graphics driver to use. Normally you'd want to use
121 x11drv (for X11). In case you want to run programs as text console/TTY only
122 without having Wine rely on X11 support, then use ttydrv.
124 .I format: """ShowDirSymlinks""=""<0|1>"""
128 Wine doesn't pass directory symlinks to Windows programs by default.
129 Enabling this may crash some programs that do recursive lookups of a whole
130 subdir tree in case of a symlink pointing back to itself.
132 .I format: """ShowDotFiles""=""<0|1>"""
136 Under Unix, files starting with a dot, are considered hidden,
137 and should not be shown in directory listing (unless explicitly asked for),
138 just like DOS-style hidden files. If you want them treated as regular
139 files, set this value to 1.
143 .I format: """Windows""=""<version string>"""
145 default: none; chosen by semi-intelligent detection mechanism based on DLL environment
147 Used to specify which Windows version to return to programs (forced value,
148 overrides standard detection mechanism !).
149 Valid settings are e.g. "win31", "win95", "win98", "win2k", "winxp".
150 Also valid as an AppDefaults setting (recommended/preferred use).
152 .I format: """DOS""=""<version string>"""
154 default: "<Windows version specific>"
156 Used to specify the DOS version that should be returned to programs.
157 Only takes effect in case Wine acts as "win31" Windows version !
158 Common DOS version settings include 6.22, 6.20, 6.00, 5.00, 4.00, 3.30, 3.10.
159 Also valid as an AppDefaults setting (recommended/preferred use).
163 .I format: """modulename""=""native,builtin"""
166 can be any valid DLL module name. If no extension is specified .dll is
167 assumed. The specified value is a comma separated list of module-types
168 to try to load in that specific order. Case is not important and only
169 the first letter of each type is enough to identify the type n[ative]
170 or b[uiltin]. Also whitespace is ignored. See also the description of
173 environment variable in
175 for details about the allowed types.
179 specifies the load order to use for modules not explicitly
180 mentioned. If the wildcard entry is not found, then the order
181 "native,builtin" is used.
185 .I """kernel32""=""builtin"""
187 .I """comdlg32""=""native,builtin"""
189 .I """*""=""builtin,native"""
191 When the specified module name does not contain a path, it matches
192 only dlls loaded from the Windows system directory. If the application
193 explicitly loads a dll from a different directory, it has to be
194 configured separately. This can be done either by specifying the full
195 path in the module name, or by using a path wildcard of the form
196 .I """*modulename""".
198 For instance, the following will load the native shell32 when loaded
199 from C:\\Program Files, and the builtin when loaded from any other
202 .I """C:\\\\\\\\Program Files\\\\\\\\shell32"" = ""native"""
204 .I """*shell32"" = ""builtin"""
206 Changing the load order of low-level dlls like kernel32, gdi32 or
207 user32 to anything other than builtin will cause wine to fail because
208 wine cannot use native versions for these libraries.
210 Always make sure that you have some kind of strategy in mind when you start
211 fiddling with the current defaults and needless to say that you must know
213 --debugmsg +loaddll might come in handy for experimenting with that stuff.
217 .I format: """com[12345678]""=""<devicename>"""
221 Used to specify the devices which are used as COM1 - COM8.
225 .I format: """lpt[12345678]""=""<devicename>"""
229 Used to specify the devices which are used as LPT1 - LPT8.
233 .I format: """SpyExclude""=""<message names separated by semicolons>"""
237 Used to specify which messages will be excluded from the logfile.
239 .I format: """SpyInclude""=""<message names separated by semicolons>"""
242 .br Used to specify which messages will be included in the logfile.
244 .I format: """RelayFromExclude""=""<module names separated by semicolons>"""
248 Used to specify a set of modules whose calls are excluded from a relay debug log.
250 .I format: """RelayFromInclude""=""<module names separated by semicolons>"""
252 default: include all modules
254 Used to specify the set of modules whose calls are included in a relay debug log.
256 .I format: """RelayExclude""=""<functions or dll.functions separated by semicolons>"""
260 Used to specify which functions will be excluded from a relay debug log.
262 .I format: """RelayInclude""=""<functions or dll.functions separated by semicolons>"""
264 default: include all functions
266 Used to specify which functions will be included in a relay debug log.
268 .I format: """SnoopExclude""=""<functions or dll.functions separated by semicolons>"""
272 Used to specify which functions will be excluded from the snoop debug log.
274 .I format: """SnoopInclude""=""<functions or dll.functions separated by semicolons>"""
276 default: include all functions
278 Used to specify which functions will be included in the snoop debug log.
280 For Relay and Snoop <dllname>.* includes or excludes the whole dll. Exclude
281 entries have priority over Include entries.
285 .I format: """WineLook""=""<Win31|Win95|Win98>"""
289 Use Win95-like window displays or Win3.1-like window displays.
293 .I format: """LoadGlobalRegistryFiles""=""<boolean>"""
295 Global registries (stored in /etc)
297 .I format: """LoadHomeRegistryFiles""=""<boolean>"""
299 Home registries (stored in ~user/.wine/)
301 .I format: """WritetoHomeRegistryFiles""=""<boolean>"""
303 TRY to write all changes to the home registry files
305 .I format: """LoadWindowsRegistryFiles""=""<boolean>"""
307 Load Windows registry from the current Windows directory.
309 booleans: Y/y/T/t/1 are true, N/n/F/f/0 are false.
311 Defaults are read all, write to home files.
315 .I format: """UseDnsComputerName""=""<boolean>"""
317 If Y, always override the registry setting for ComputerName
318 with the Unix hostname.
320 .B [AppDefaults\\\\\\\\<appname>\\\\\\\\...]
322 This section allows specifying application-specific values for
323 the other sections described above.
325 is the name of the application exe file, without path. The "..."
326 should be replaced by the name of one of the above configuration
331 .I [AppDefaults\\\\\\\\sol.exe\\\\\\\\DllOverrides]
333 .I """shell32""" = """native"""
335 means that Solitaire will use "native" load order for the shell32
336 dll. All other applications will continue to use what was specified in
341 The only sections that support application-specific information at the
343 .I DllOverrides, dsound, Version
347 Make sure to use double backslashes in the section name.
349 .SH SAMPLE CONFIGURATION FILE
350 A sample configuration file is distributed as
351 .B documentation/samples/config
352 in the Wine source distribution.
356 User-specific configuration file
357 .SH ENVIRONMENT VARIABLES
360 Specifies the directory that contains the per-user
362 file, the registry files, and the wineserver socket. The default is