2 .TH WINE.CONF 5 "December 5, 2000" "Version 20001202" "Wine Configuration File"
4 wine.conf \- Wine configuration file
7 expects a configuration file (
8 .I @sysconfdir@/wine.conf
9 ), which should conform to the following rules. Common locations are
10 /usr/local/etc/wine.conf or (in some distributions)
11 /etc/wine.conf. The actual directory where that file resides may be
12 specified during the execution of the
14 script with the --sysconfdir option. Alternatively, you may have a
17 in this format in your ~/.wine directory or in the directory named in
20 environment variable. A sample configuration file is available as
21 .I documentation/samples/config
22 in the Wine source distribution.
23 .SH CONFIGURATION FILE FORMAT
24 All entries are grouped in sections; a section begins with the line
28 and continues until the next section starts. Individual entries
29 consist of lines of the form
31 .I """entry""=""value"""
33 The entry and value can be any text strings, included in double
34 quotes; it can also contain references to environment variables
37 Inside the double quotes, special characters, backslashes and quotes
38 must be escaped with backslashes. Supported section names and entries
43 This section is used to specify the root directory and type of each
45 drive, since most Windows applications require a DOS/MS-Windows based
46 disk drive & directory scheme. There is one such section for every
47 drive you want to configure.
49 .I format: """Path""=""<rootdirectory>"""
53 If you mounted your dos partition as
55 and installed Microsoft Windows in
56 C:\\WINDOWS then you should specify
57 .I """Path""=""/dos"""
62 .I format: """Type""=""<type>"""
66 Used to specify the drive type this drive appears as in Windows
67 or DOS programs; supported types are "floppy", "hd", "cdrom"
70 .I format: """Label""=""<label>"""
74 Used to specify the drive label; limited to 11 characters.
76 .I format: """Serial""=""<serial>"""
80 Used to specify the drive serial number, as an 8-character hexadecimal
83 .I format: """Filesystem""=""<fstype>"""
87 Used to specify the type of the file system Wine should emulate on a given
88 directory structure/underlying file system.
90 Supported types are "msdos" (or "fat"), "win95" (or "vfat"), "unix".
94 "win95" for ext2fs, VFAT and FAT32
96 "msdos" for FAT16 (ugly)
98 You definitely do not want to use "unix" unless you intend to port
99 programs using Winelib. Always try to avoid using FAT16. Use the
100 VFAT/FAT32 OS file system driver instead.
102 .I format: """FailReadOnly""=""<boolean>"""
104 Read-only files may not be opened in write mode (the default is to
105 allow opening read-only files for writing, because most Windows
106 programs always request read-write access, even on CD-ROM drives...).
110 .I format: """windows""=""<directory>"""
112 default: "C:\\\\WINDOWS"
114 Used to specify a different Windows directory; make sure to double the
117 .I format: """system""=""<directory>"""
119 default: "C:\\\\WINDOWS\\\\SYSTEM"
121 Used to specify a different system directory; make sure to double the
124 .I format: """temp""=""<directory>"""
126 default: "C:\\\\TEMP"
128 Used to specify a directory where Windows applications can store
131 .I format: """profile""=""<directory>"""
135 Used to specify a directory where Windows stores special folders and
136 the user-registry files (user.dat or ntuser.dat). Mapped to
137 environment variable %USERPROFILE%. Set this value when running with
138 a native NT or a native win95 directory with per-user settings.
140 .I format: """path""=""<directories separated by semi-colons>"""
142 default: "C:\\\\WINDOWS;C:\\\\WINDOWS\\\\SYSTEM"
144 Used to specify the path which will be used to find executables and
145 dlls. Make sure to double all the backslashes.
149 .I format: """EXTRA_LD_LIBRARY_PATH""=""@prefix@/lib/wine[:/more/path/to/search[:...]]"""
151 The path will be appended to any existing LD_LIBRARY_PATH from the
152 environment for the search of .so libraries.
154 .I format: """DefaultLoadOrder""=""native,so,builtin"""
156 A comma separated list of module-types to try to load in that specific
157 order. The DefaultLoadOrder key is used as a fallback when a module is
158 not specified explicitely. If the DefaultLoadOrder key is not found,
159 then the order "native,builtin,so" is used.
161 Case is not important and only the first letter of each type is enough
162 to identify the type n[ative], s[o], b[uiltin]. Also whitespace is
163 ignored. See also commandline option
165 for details about the allowable types.
169 There are no explicit keys defined other than module/library names. A
170 module namd is followed by an assignment of the load order for this
171 specific module. See above for possible types. You should not specify
176 .I """kernel32""=""builtin"""
178 .I """kernel""=""builtin"""
180 .I """comdlg32""=""native, builtin"""
182 .I """commdlg""=""native, builtin"""
184 Changing the load order of kernel/kernel32 and gdi/gdi32 to
185 anything other than builtin will cause wine to fail because wine cannot
186 use native versions for these libraries (gdi[32] might work native someday,
187 but kernel[32] will never work native).
188 Note that using the native versions of user[32] isn't recommended right now,
189 as these modules face nearly the same problems as kernel/gdi and we only
190 just managed to make them work partially. But trying to use it might get
191 your program running.
193 Always make sure that you have some kind of strategy in mind when you start
194 fiddling with the current defaults and needless to say that you must know
199 .I format: """com[12345678]""=""<devicename>"""
203 Used to specify the devices which are used as COM1 - COM8.
207 .I format: """lpt[12345678]""=""<devicename>"""
211 Used to specify the devices which are used as LPT1 - LPT8.
215 .I format: """exclude""=""<message names separated by semicolons>"""
219 Used to specify which messages will be excluded from the logfile.
221 .I format: """include""=""<message names separated by semicolons>"""
224 .br Used to specify which messages will be included in the logfile.
228 .I format: """WineLook""=""<Win31|Win95|Win98>"""
232 Use Win95-like window displays or Win3.1-like window displays.
236 .I format: """LoadGlobalRegistryFiles""=""<boolean>"""
238 Global registries (stored in /etc)
240 .I format: """LoadHomeRegistryFiles""=""<boolean>"""
242 Home registries (stored in ~user/.wine/)
244 .I format: """WritetoHomeRegistryFiles""=""<boolean>"""
246 TRY to write all changes to the home registry files
248 .I format: """LoadWindowsRegistryFiles""=""<boolean>"""
250 Load Windows registry from the current Windows directory.
252 booleans: Y/y/T/t/1 are true, N/n/F/f/0 are false.
254 Defaults are read all, write to home files.
256 .SH SAMPLE CONFIGURATION FILE
257 A sample configuration file is distributed as
258 .B documentation/samples/config
259 in the Wine source distribution.
262 .I @sysconfdir@/wine.conf
263 Global configuration file for wine.
266 User-specific configuration file
267 .SH ENVIRONMENT VARIABLES
270 Specifies the directory that contains the per-user
272 file, the registry files, and the wineserver socket. The default is