WINE.CONF(F) Wine Configuration File WINE.CONF(F) NAME wine.conf - Wine configuration file DESCRIPTION wine expects a configuration file ( $WINEPREFIX/config (~/.wine/config) ), which should conform to the following rules. A sample configuration file is available as docu- mentation/samples/config in the Wine source distribution. CONFIGURATION FILE FORMAT All entries are grouped in sections; a section begins with the line [section name] and continues until the next section starts. Individual entries consist of lines of the form "entry"="value" The entry and value can be any text strings, included in double quotes; it can also contain references to environ- ment variables surrounded by ${}. Inside the double quotes, special characters, backslashes and quotes must be escaped with backslashes. Supported section names and entries are listed below. [Drive X] This section is used to specify the root directory and type of each emulated DOS drive, since most Windows appli- cations require a DOS/MS-Windows based disk drive & direc- tory scheme, which is either provided by a real DOS parti- tion mounted somewhere or by some carefully crafted direc- tory layout on a Unix file system ("no-windows fake installation"). There is one such section for every drive you want to configure. format: "Path"="<rootdirectory>" default: none If you mounted your dos partition as /dos and installed Microsoft Windows in C:\WINDOWS (thus it shows up as /dos/WINDOWS), then you should specify "Path"="/dos" in the [Drive C] section in order to configure /dos as the drive root of drive C:. format: "Type"="<type>" default: "hd" Used to specify the drive type this drive appears as in Windows or DOS programs; supported types are "floppy", "hd", "cdrom" and "network". format: "Label"="<label>" default: "Drive X" Used to specify the drive label; limited to 11 characters. format: "Serial"="<serial>" default: "12345678" Used to specify the drive serial number, as an 8-character hexadecimal number. format: "Filesystem"="<fstype>" default: "win95" Used to specify the type of the file system Wine should emulate on a given directory structure/underlying file system. Supported types are "msdos" (or "fat"), "win95" (or "vfat"), "unix". Recommended: "win95" for ext2fs, ReiserFS, ..., VFAT and FAT32 "msdos" for FAT16 file systems (ugly, 8.3 naming) You definitely do not want to use "unix" unless you intend to port programs using Winelib. Always try to avoid using a FAT16 FS. Use the VFAT/FAT32 OS file system driver instead. format: "FailReadOnly"="<boolean>" Read-only files may not be opened in write mode (the default is to allow opening read-only files for writing, because most Windows programs always request read-write access, even on CD-ROM drives...). [wine] format: "windows"="<directory>" default: "C:\\WINDOWS" Used to specify where Wine is supposed to have its Windows directory (which is an essential part of a Windows envi- ronment); make sure to double the backslashes. In case of e.g. C:\WINDOWS, with drive C: being configured as /home/user/wine_c, the /home/user/wine_c/WINDOWS directory would be used for this. format: "system"="<directory>" default: "C:\\WINDOWS\\System" Used to specify where Wine is supposed to have its Windows system directory (again, essential part of Windows envi- ronment); make sure to double the backslashes. Given a setting of C:\WINDOWS\System (the standard setting on Win- dows) and a C: drive again at /home/user/wine_c, the /home/user/wine_c/WINDOWS/System directory would be used for this. format: "temp"="<directory>" default: "C:\\TEMP" Used to specify a directory where Windows applications can store temporary files. E.g. with a C: drive at /home/user/wine_c, this would be the /home/user/wine_c/TEMP directory. format: "profile"="<directory>" default: nothing Used to specify a directory where Windows stores special folders and the user-registry files (user.dat or ntuser.dat). Mapped to environment variable %USERPRO- FILE%. Set this value when running with a native NT or a native win95 directory with per-user settings. format: "path"="<directories separated by semi-colons>" default: "C:\\WINDOWS;C:\\WINDOWS\\SYSTEM" Used to specify the path which will be used to find exe- cutables and dlls. Make sure to double the backslashes. format: "GraphicsDriver"="<x11drv|ttydrv>" default: "x11drv" Tells Wine which graphics driver to use. Normally you'd want to use x11drv (for X11). In case you want to run pro- grams as text console/TTY only without having Wine rely on X11 support, then use ttydrv. [DllOverrides] format: "modulename"="native,so,builtin" modulename can be any valid DLL module name, without extension. The specified value is a comma separated list of module-types to try to load in that specific order. Case is not important and only the first letter of each type is enough to identify the type n[ative], s[o], b[uiltin]. Also whitespace is ignored. See also command- line option --dll for details about the allowable types. The wildcard entry "*" specifies the load order to use for modules not explicitly mentioned. If the wildcard entry is not found, then the order "native,builtin,so" is used. Examples: "kernel32"="builtin" "kernel"="builtin" "comdlg32"="native,builtin" "*"="builtin,native" Changing the load order of kernel/kernel32 and gdi/gdi32 to anything other than builtin will cause wine to fail because wine cannot use native versions for these libraries. Always make sure that you have some kind of strategy in mind when you start fiddling with the current defaults and needless to say that you must know what you are doing. --debugmsg +loaddll might come in handy for experimenting with that stuff. [serialports] format: "com[12345678]"="<devicename>" default: none Used to specify the devices which are used as COM1 - COM8. [parallelports] format: "lpt[12345678]"="<devicename>" default: none Used to specify the devices which are used as LPT1 - LPT8. [spy] format: "exclude"="<message names separated by semi- colons>" default: none Used to specify which messages will be excluded from the logfile. format: "include"="<message names separated by semi- colons>" default: none [Tweak.Layout] format: "WineLook"="<Win31|Win95|Win98>" default: "Win31" Use Win95-like window displays or Win3.1-like window dis- plays. [Registry] format: "LoadGlobalRegistryFiles"="<boolean>" Global registries (stored in /etc) format: "LoadHomeRegistryFiles"="<boolean>" Home registries (stored in ~user/.wine/) format: "WritetoHomeRegistryFiles"="<boolean>" TRY to write all changes to the home registry files format: "LoadWindowsRegistryFiles"="<boolean>" Load Windows registry from the current Windows directory. booleans: Y/y/T/t/1 are true, N/n/F/f/0 are false. Defaults are read all, write to home files. [AppDefaults\\<appname>\\...] This section allows specifying application-specific values for the other sections described above. <appname> is the name of the application exe file, without path. The "..." should be replaced by the name of one of the above config- uration sections. Example: [AppDefaults\\sol.exe\\DllOverrides] "shell32" = "native" means that Solitaire will use "native" load order for the shell32 dll. All other applications will continue to use what was specified in the general DllOverrides section. The only sections that support application-specific infor- mation at the moment are DllOverrides and x11drv. Make sure to use double backslashes in the section name. SAMPLE CONFIGURATION FILE A sample configuration file is distributed as documenta- tion/samples/config in the Wine source distribution. FILES ~/.wine/config User-specific configuration file ENVIRONMENT VARIABLES WINEPREFIX Specifies the directory that contains the per-user config file, the registry files, and the wineserver socket. The default is $HOME/.wine. SEE ALSO wine(e) Version 20010824 September 1, 2001 WINE.CONF(F)