Add documentation on the Wine initialization process.
[wine] / documentation / samples / config
1 WINE REGISTRY Version 2
2 ;; All keys relative to \\Machine\\Software\\Wine\\Wine\\Config
3
4 ;; If you think it is necessary to show others your complete config for a
5 ;; bug report, filter out empty lines and comments with
6 ;; grep -v "^;" ~/.wine/config | grep '.'
7
8 [wine]
9 "Windows" = "c:\\windows"
10 "System" = "c:\\windows\\system"
11 "Temp" = "e:\\"
12 "Path" = "c:\\windows;c:\\windows\\system;e:\\;e:\\test;f:\\"
13 "Profile" = "c:\\windows\\Profiles\\Administrator"
14 "GraphicsDriver" = "x11drv"
15 ;"ShowDirSymlinks" = "1"
16 ;"ShowDotFiles" = "1"
17 "ShellLinker" = "wineshelllink"
18
19 # [wineconf]
20
21 [Version]
22 ; Windows version to imitate (win95,win98,winme,nt351,nt40,win2k,winxp,win2k3,win20,win30,win31)
23 ;"Windows" = "win98"
24 ; DOS version to imitate
25 ;"DOS" = "6.22"
26
27 ; Be careful here, wrong DllOverrides settings have the potential
28 ; to pretty much kill your setup.
29 [DllOverrides]
30 ; some dlls you may want to change
31 "oleaut32"     = "builtin, native"
32 "ole32"        = "builtin, native"
33 "comdlg32"     = "builtin, native"
34 "shell32"      = "builtin, native"
35 "shfolder"     = "builtin, native"
36 "shlwapi"      = "builtin, native"
37 "shdocvw"      = "builtin, native"
38 "advapi32"     = "builtin, native"
39 "msvcrt"       = "native, builtin"
40 "mciavi.drv"   = "native, builtin"
41 "mcianim.drv"  = "native, builtin"
42 "msi"          = "native, builtin"
43 "d3drm"        = "native, builtin"
44 "d3dxof"       = "native, builtin"
45 "dpnhpast"     = "native, builtin"
46 ; you can specify applications too
47 ; this one will apply for all notepad.exe
48 ;"*notepad.exe" = "native, builtin"
49 ; this one will apply only for a particular file
50 ;"C:\\windows\\regedit.exe" = "native, builtin"
51 ; default for all other dlls
52 "*" = "builtin, native"
53
54 [x11drv]
55 ; Number of colors to allocate from the system palette
56 "AllocSystemColors" = "100"
57 ; Use a private color map
58 "PrivateColorMap" = "N"
59 ; Favor correctness over speed in some graphics operations
60 "PerfectGraphics" = "N"
61 ; Color depth to use on multi-depth screens
62 ;;"ScreenDepth" = "16"
63 ; Allow the window manager to manage created windows
64 "Managed" = "Y"
65 ; Use a desktop window of 640x480 for Wine
66 ;"Desktop" = "640x480"
67 ; Use XFree86 DGA extension if present
68 ; (make sure /dev/mem is accessible by you !)
69 "UseDGA" = "Y"
70 ; Use XVidMode extension if present
71 "UseXVidMode" = "Y"
72 ; Use XRandR extension if present
73 "UseXRandR" = "Y"
74 ; Use the take focus protocol
75 "UseTakeFocus" = "Y"
76 ; Enable DirectX mouse grab
77 "DXGrab" = "N"
78 ; Create the desktop window with a double-buffered visual
79 ; (useful to play OpenGL games)
80 "DesktopDoubleBuffered" = "N"
81 ; Run in synchronous mode (useful for debugging X11 problems)
82 ;;"Synchronous" = "Y"
83 ;
84 ; Use the Render extension to render client side fonts (default "Y")
85 ;;"ClientSideWithRender" = "Y"
86 ; Fallback on X core requests to render client side fonts (default "Y")
87 ;;"ClientSideWithCore" = "Y"
88 ; Set both of the previous two to "N" in order to force X11 server side fonts
89 ;
90 ; Anti-alias fonts if using the Render extension (default "Y")
91 ;;"ClientSideAntiAliasWithRender" = "Y"
92 ; Anti-alias fonts if using core requests fallback (default "Y")
93 ;;"ClientSideAntiAliasWithCore" = "Y"
94 ;
95
96 [fonts]
97 ;Read the Fonts topic in the Wine User Guide before adding aliases
98 ;See a couple of examples for russian users below
99 "Resolution" = "96"
100 "Default" = "-adobe-helvetica-"
101 "DefaultFixed" = "fixed"
102 "DefaultSerif" = "-adobe-times-"
103 "DefaultSansSerif" = "-adobe-helvetica-"
104
105 ;; default TrueType fonts with russian koi8-r encoding
106 ;"Default" = "-monotype-arial-*-*-*--*-*-*-*-*-*-koi8-r"
107 ;"DefaultFixed" = "-monotype-courier new-*-*-*--*-*-*-*-*-*-koi8-r"
108 ;"DefaultSerif" = "-monotype-times new roman-*-*-*--*-*-*-*-*-*-koi8-r"
109 ;"DefaultSansSerif" = "-monotype-arial-*-*-*--*-*-*-*-*-*-koi8-r"
110 ;; default cyrillic bitmap X fonts
111 ;"Default" = "-cronyx-helvetica-"
112 ;"DefaultFixed" = "fixed"
113 ;"DefaultSerif" = "-cronyx-times-"
114 ;"DefaultSansSerif" = "-cronyx-helvetica-"
115
116 ; the TrueType font dirs you want to make accessible to wine
117 [FontDirs]
118 ;"dir1" = "/usr/X11R6/lib/X11/fonts/TrueType"
119 ;"dir2" = "/usr/share/fonts/truetype"
120 ;"dir3" = "/usr/X11R6/lib/X11/fonts/TT"
121 ;"dir4" = "/usr/share/fonts/TT"
122
123 [ppdev]
124 ;; key:  io-base of the emulated port
125 ;; value : parport-device{,timeout}
126 ;; timeout for auto closing an open device ( not yet implemented)
127 ;"378" = "/dev/parport0"
128 ;"278" = "/dev/parport1"
129 ;"3bc" = "/dev/parport2"
130
131 [spooler]
132 "FILE:" = "tmp.ps"
133 "LPT1:" = "|lpr"
134 "LPT2:" = "|gs -sDEVICE=bj200 -sOutputFile=/tmp/fred -q -"
135 "LPT3:" = "/dev/lp3"
136
137 [ports]
138 ;"read"  = "0x779,0x379,0x280-0x2a0"
139 ;"write" = "0x779,0x379,0x280-0x2a0"
140
141 [Debug]
142 ;"RelayExclude" = "RtlEnterCriticalSection;RtlLeaveCriticalSection"
143 ;"RelayInclude" = "user32.CreateWindowA"
144 ;"RelayFromExclude" = "user32;x11drv"
145 ;"RelayFromInclude" = "sol.exe"
146 ;"SnoopExclude" = "RtlEnterCriticalSection;RtlLeaveCriticalSection"
147 ;"SpyExclude" = "WM_SIZE;WM_TIMER;"
148
149 [registry]
150 ;These are all booleans.  Y/y/T/t/1 are true, N/n/F/f/0 are false.
151 ;Defaults are read all, write to Home
152 ; Where to find the global registries
153 ;"GlobalRegistryDir" = "/etc";
154 ; Global registries (stored in /etc)
155 "LoadGlobalRegistryFiles" = "Y"
156 ; Load Windows registries from the Windows directory
157 "LoadWindowsRegistryFiles" = "Y"
158 ; Registry periodic save timeout in seconds
159 ; "PeriodicSave" = "600"
160 ; Save only modified keys
161 "SaveOnlyUpdatedKeys" = "Y"
162
163 [Clipboard]
164 "ClearAllSelections" = "0"
165 "PersistentSelection" = "1"
166 "UsePrimary" = "0"
167
168 ; List of all directories directly contain .AFM files
169 [afmdirs]
170 "1" = "/usr/share/ghostscript/fonts"
171 "2" = "/usr/share/a2ps/afm"
172 "3" = "/usr/share/enscript"
173 "4" = "/usr/X11R6/lib/X11/fonts/Type1"
174
175 [WinMM]
176 ; Uncomment the "Drivers" line matching your sound setting.
177
178 "Drivers" = "wineoss.drv"      ; default for most common configurations
179 ;"Drivers" = "winearts.drv"    ; for KDE
180 ;"Drivers" = "winealsa.drv"    ; for ALSA users
181 ;"Drivers" = "winejack.drv"    ; for Jack sound server
182 ;"Drivers" = "winenas.drv"     ; for NAS sound system
183 ;"Drivers" = "wineaudioio.drv" ; for Solaris machines
184 ;"Drivers" = ""                ; to disable sound
185 "WaveMapper" = "msacm.drv"
186 "MidiMapper" = "midimap.drv"
187
188 [dsound]
189 ;; HEL only: Number of waveOut fragments ahead to mix in new buffers.
190 ;"HELmargin" = "5"
191 ;; HEL only: Number of waveOut fragments ahead to queue to driver.
192 ;"HELqueue" = "5"
193 ;; Max number of fragments to prebuffer
194 ;"SndQueueMax" = "28"
195 ;; Min number of fragments to prebuffer
196 ;"SndQueueMin" = "12"
197 ;; Forces emulation mode (using wave api)
198 ;"HardwareAcceleration" = "Emulation"
199 ;; Sets default playback device (0 - number of devices - 1)
200 ;"DefaultPlayback" = "0"        ; use first device (/dev/dsp)
201 ;"DefaultPlayback" = "1"        ; use second device (/dev/dsp1)
202 ;"DefaultPlayback" = "2"        ; use third device (/dev/dsp2)
203 ;; Sets default capture device (0 - number of devices - 1)
204 ;"DefaultCapture" = "0"         ; use first device (/dev/dsp)
205 ;"DefaultCapture" = "1"         ; use second device (/dev/dsp1)
206 ;"DefaultCapture" = "2"         ; use third device (/dev/dsp2)
207
208 [Network]
209 ;; Use the DNS (Unix) host name always as NetBIOS "ComputerName" (boolean, default "Y").
210 ;; Set to N if you need a persistent NetBIOS ComputerName that possibly differs 
211 ;; from the Unix host name. You'll need to set ComputerName in 
212 ;; HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\ComputerName\ComputerName, too.
213 ;"UseDnsComputerName" = "N"
214
215 ;; sample AppDefaults entries
216
217 ; 3 InstallShield versions who like to put their full screen window in front,
218 ; without any chance to switch to another X11 application.
219 ; So just catch them in a desktop window.
220
221 [AppDefaults\\_INS0432._MP\\x11drv]
222 "Desktop" = "640x480"
223
224 [AppDefaults\\_INS0466._MP\\x11drv]
225 "Desktop" = "640x480"
226
227 [AppDefaults\\_INS0576._MP\\x11drv]
228 "Desktop" = "640x480"
229
230 [AppDefaults\\_INS5176._MP\\x11drv]
231 "Desktop" = "640x480"
232
233 [AppDefaults\\_INS5576._MP\\x11drv]
234 "Desktop" = "640x480"
235
236 ;[AppDefaults\\iexplore.exe\\DllOverrides]
237 ;"shlwapi" = "native"
238 ;"rpcrt4" = "native"
239 ;"ole32" = "native"
240 ;"shdocvw" = "native"
241 ;"wininet" = "native"
242 ;"shfolder" = "native"
243 ;"shell32" = "native"
244 ;"shell" = "native"
245 ;"comctl32" = "native"
246 ;
247 ;[AppDefaults\\setup.exe\\x11drv]
248 ;"Desktop" = "800x600"
249 ;
250 ;[AppDefaults\\sol.exe\\Version]
251 ;"Windows" = "nt40"
252 ;
253 ;; Some games (Quake 2, UT) refuse to accept emulated dsound devices.
254 ;; You can add an AppDefault entry like this for such cases.
255 ;[AppDefaults\\pickygame.exe\\dsound]
256 ;"EmulDriver" = "N"
257
258 # [/wineconf]