git.oblomov.eu Git - wine/blob - documentation/wine.conf.man.in

   1 .\" -*- nroff -*-
   2 .TH WINE.CONF 5 "July 16, 1999" "Version 990704" "Wine Configuration File"
   3 .SH NAME
   4 wine.conf \- Wine configuration file
   5 .SH DESCRIPTION
   6 .B wine
   7 expects a configuration file (
   8 .I @sysconfdir@/wine.conf
   9 ), which should
  10 conform to the following rules (the format is just like a Windows .ini
  11 file). Common locations are /usr/local/etc/wine.conf or
  12 (in some distributions) /etc/wine.conf. The actual directory
  13 where that file resides may be specified during the execution of the
  14 .B configure
  15 script with the --sysconfdir option. Alternatively, you may have a
  16 .I .winerc
  17 file of this format in your home directory or have the environment variable
  18 .B WINE_INI
  19 pointing to a configuration file, or use the --config option on the command
  20 line.
  21 A sample configuration file is available as wine.ini in the base directory
  22 of the Wine source distribution.
  23 .SH CONFIGURATION FILE FORMAT
  24 All entries are grouped in sections; a section begins with the line
  25 .br
  26 .I [section name]
  27 .br
  28 and continues until the next section starts. Individual entries
  29 consist of lines of the form
  30 .br
  31 .I entry=value
  32 .br
  33 The value can be any text string, optionally included in single or
  34 double quotes; it can also contain references to environment variables
  35 surrounded by
  36 .I ${}.
  37 Supported section names and entries are listed below.
  38 .PP
  39 .B [Drive X]
  40 .br
  41 This section is used to specify the root directory and type of each
  42 .B DOS
  43 drive, since most Windows applications require a DOS/MS-Windows based
  44 disk drive & directory scheme. There is one such section for every
  45 drive you want to configure.
  46 .PP
  47 .I format: Path = <rootdirectory>
  48 .br
  49 default: none
  50 .br
  51 If you mounted your dos partition as
  52 .I /dos
  53 and installed Microsoft Windows in
  54 C:\\WINDOWS then you should specify
  55 .I Path=/dos
  56 in the
  57 .I [Drive C]
  58 section.
  59 .PP
  60 .I format: Type = <type>
  61 .br
  62 default: hd
  63 .br
  64 Used to specify the drive type this drive appears as in Windows
  65 or DOS programs; supported types are floppy, hd, cdrom
  66 and network.
  67 .PP
  68 .I format: Label = <label>
  69 .br
  70 default: 'Drive X'
  71 .br
  72 Used to specify the drive label; limited to 11 characters.
  73 .PP
  74 .I format: Serial = <serial>
  75 .br
  76 default: 12345678
  77 .br
  78 Used to specify the drive serial number, as an 8-character hexadecimal
  79 number.
  80 .PP
  81 .I format: Filesystem = <fstype>
  82 .br
  83 default: win95
  84 .br
  85 Used to specify the type of the file system Wine should emulate on a given
  86 directory structure/underlying file system.
  87 .br
  88 Supported types are msdos (or fat), win95 (or vfat), unix.
  89 .br
  90 Recommended:
  91 .br
  92   win95 for ext2fs, VFAT and FAT32
  93 .br
  94   msdos for FAT16 (ugly)
  95 .br
  96 You definitely don't want to use "unix" unless you intend to port programs using Winelib.
  97 .br
  98 Always try to avoid using FAT16. Use VFAT/FAT32 OS file system driver instead !
  99 .PP
 100 .I format: FailReadOnly=<boolean>
 101 .br
 102 Read-only files may not be opened in write mode (the default is to
 103 allow opening read-only files for writing, because most Windows
 104 programs always request read-write access, even on CD-ROM drives...).
 105 .PP
 106 .B [wine]
 107 .br
 108 .I format: windows = <directory>
 109 .br
 110 default: C:\\WINDOWS
 111 .br
 112 Used to specify a different Windows directory
 113 .PP
 114 .I format: system = <directory>
 115 .br
 116 default: C:\\WINDOWS\\SYSTEM
 117 .br
 118 Used to specify a different system directory
 119 .PP
 120 .I format: temp = <directory>
 121 .br
 122 default: C:\\TEMP
 123 .br
 124 Used to specify a directory where Windows applications can store
 125 temporary files.
 126 .PP
 127 .I format: profile = <directory>
 128 .br
 129 default: nothing
 130 .br
 131 Used to specify a directory where Windows stores special folders and the user-registry files (user.dat or ntuser.dat).
 132 Mapped to environment variable %USERPROFILE%.
 133 Set this value when running with a native NT or a native win95 directory with per-user settings.
 134 .PP
 135 .I format: path = <directories separated by semi-colons>
 136 .br
 137 default: C:\\WINDOWS;C:\\WINDOWS\\SYSTEM
 138 .br
 139 Used to specify the path which will be used to find executables and .DLL's.
 140 .PP
 141 .I format: symboltablefile = <filename>
 142 .br
 143 default: wine.sym
 144 .br
 145 Used to specify the path and file name of the symbol table used by the built-in
 146 debugger.
 147 .PP
 148 .B [DllDefaults]
 149 .br
 150 .I format: EXTRA_LD_LIBRARY_PATH=@prefix@/lib/wine[:/more/path/to/search[:...]]
 151 .br
 152 The path will be appended to any existing LD_LIBRARY_PATH from the
 153 environment for the search of .so libraries.
 154 .PP
 155 .I format: DefaultLoadOrder=native,so,builtin
 156 .br
 157 A comma separated list of module-types to try to load in that specific
 158 order. The DefaultLoadOrder key is used as a fallback when a module is
 159 not specified explicitely. If the DefaultLoadOrder key is not found,
 160 then the order "native,builtin,so" is used.
 161 .br
 162 Case is not (yet) important and only the first letter of each type is
 163 enough to identify the type n[ative], s[o], b[uiltin]. Also whitespace
 164 is ignored. Keep everything in lower case to be sure that your entries
 165 keep the same meaning. See also commandline option
 166 .I --dll
 167 for details about the allowable types.
 168 .PP
 169 .B [DllOverrides]
 170 .br
 171 There are no explicit keys defined other than module/library names. A
 172 module namd is followed by an assignment of the load order for this
 173 specific module. See above for possible types. You should not specify
 174 an extension.
 175 .br
 176 Examples:
 177 .br
 178 .I kernel32 = builtin
 179 .br
 180 .I kernel = builtin
 181 .br
 182 .I comdlg32 = native, builtin
 183 .br
 184 .I commdlg = native, builtin
 185 .br
 186 Changing the load order of kernel/kernel32 and gdi/gdi32 to
 187 anything other than builtin will cause wine to fail because wine cannot
 188 use native versions for these libraries (gdi[32] might work native someday,
 189 but kernel[32] will never work native).
 190 Note that using the native versions of user[32] isn't recommended right now,
 191 as these modules face nearly the same problems as kernel/gdi and we only
 192 just managed to make them work partially. But trying to use it might get
 193 your program running.
 194 .br
 195 Always make sure that you have some kind of strategy in mind when you start
 196 fiddling with the current defaults and needless to say that you must know
 197 what you are doing.
 198 .PP
 199 .B [serialports]
 200 .br
 201 .I format: com[12345678] = <devicename>
 202 .br
 203 default: none
 204 .br
 205 Used to specify the devices which are used as COM1 - COM8.
 206 .PP
 207 .B [parallelports]
 208 .br
 209 .I format: lpt[12345678] = <devicename>
 210 .br
 211 default: none
 212 .br
 213 Used to specify the devices which are used as LPT1 - LPT8.
 214 .PP
 215 .B [spy]
 216 .br
 217 .I format: file = <filename or CON when logging to stdout>
 218 .br
 219 default: none
 220 .br
 221 Used to specify the file which will be used as
 222 .B logfile.
 223 .PP
 224 .I format: exclude = <message names separated by semicolons>
 225 .br
 226 default: none
 227 .br
 228 Used to specify which messages will be excluded from the logfile.
 229 .PP
 230 .I format: include = <message names separated by semicolons>
 231 .br
 232 default: none
 233 .br Used to specify which messages will be included in the logfile.
 234 .PP
 235 .B [Tweak.Layout]
 236 .br
 237 .I format: WineLook=<Win31|Win95|Win98>
 238 .br
 239 default: Win31
 240 .br
 241 Use Win95-like window displays or Win3.1-like window displays.
 242 .PP
 243 .B [Registry]
 244 .br
 245 .I format: LoadGlobalRegistryFiles=<boolean>
 246 .br
 247 Global registries (stored in /etc)
 248 .PP
 249 .I format: LoadHomeRegistryFiles=<boolean>
 250 .br
 251 Home registries (stored in ~user/.wine/)
 252 .PP
 253 .I format: WritetoHomeRegistryFiles=<boolean>
 254 .br
 255 TRY to write all changes to alt registries
 256 .PP
 257 .I format: LoadWindowsRegistryFiles=<boolean>
 258 .br
 259 Load Windows registry from the current Windows directory.
 260 .PP
 261 booleans: Y/y/T/t/1 are true, N/n/F/f/0 are false.
 262 .br
 263 Defaults are read all, write to Home
 264 .PP
 265 .SH SAMPLE CONFIGURATION FILE
 266 A sample configuration file is distributed as
 267 .B wine.ini
 268 in the top-level directory of the source distribution.
 269 .SH FILES
 270 .PD 0
 271 .TP
 272 .I @sysconfdir@/wine.conf
 273 Global configuration file for wine.
 274 .TP
 275 .I ~/.winerc
 276 User-specific configuration file
 277 .SH "SEE ALSO"
 278 .BR wine (1)