Put console documentation in sync with current console status.
[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 ;; MS-DOS drives configuration
9 ;;
10 ;; Each section has the following format:
11 ;; [Drive X]
12 ;; "Path"="xxx"       (Unix path for drive root)
13 ;; "Type"="xxx"       (supported types are 'floppy', 'hd', 'cdrom' and 'network')
14 ;; "Label"="xxx"      (drive label, at most 11 characters)
15 ;; "Serial"="xxx"     (serial number, 8 characters hexadecimal number)
16 ;; "Filesystem"="xxx" (supported types are 'msdos'/'dos'/'fat', 'win95'/'vfat', 'unix')
17 ;;   This is the FS Wine is supposed to emulate on a certain
18 ;;   directory structure.
19 ;;   Recommended:
20 ;;   - "win95" for ext2fs, VFAT and FAT32
21 ;;   - "msdos" for FAT16 (ugly, upgrading to VFAT driver strongly recommended)
22 ;;   DON'T use "unix" unless you intend to port programs using Winelib !
23 ;; "Device"="/dev/xx" (only if you want to allow raw device access)
24 ;;
25 [Drive A]
26 "Path" = "/mnt/fd0"
27 "Type" = "floppy"
28 "Label" = "Floppy"
29 "Filesystem" = "win95"
30 "Serial" = "87654321"
31 "Device" = "/dev/fd0"
32
33 [Drive C]
34 "Path" = "/c"
35 "Type" = "hd"
36 "Label" = "MS-DOS"
37 "Filesystem" = "win95"
38
39 [Drive D]
40 "Path" = "/cdrom"
41 "Type" = "cdrom"
42 "Label" = "CD-Rom"
43 "Filesystem" = "win95"
44 ; make sure that device is correct and has proper permissions !
45 "Device" = "/dev/cdrom"
46
47 [Drive E]
48 "Path" = "/tmp"
49 "Type" = "hd"
50 "Label" = "Tmp Drive"
51 "Filesystem" = "win95"
52
53 [Drive F]
54 "Path" = "${HOME}"
55 "Type" = "network"
56 "Label" = "Home"
57 "Filesystem" = "win95"
58
59 [wine]
60 "Windows" = "c:\\windows"
61 "System" = "c:\\windows\\system"
62 "Temp" = "e:\\"
63 "Path" = "c:\\windows;c:\\windows\\system;e:\\;e:\\test;f:\\"
64 "Profile" = "c:\\windows\\Profiles\\Administrator"
65 "GraphicsDriver" = "x11drv"
66 ;"ShowDirSymlinks" = "1"
67 ;"ShowDotFiles" = "1"
68 "ShellLinker" = "wineshelllink"
69
70 # [wineconf]
71
72 [Version]
73 ; Windows version to imitate (win95,win98,winme,nt351,nt40,win2k,winxp,win20,win30,win31)
74 ;"Windows" = "win98"
75 ; DOS version to imitate
76 ;"DOS" = "6.22"
77
78 ; Be careful here, wrong DllOverrides settings have the potential
79 ; to pretty much kill your setup.
80 [DllOverrides]
81 ; some dlls you may want to change
82 "oleaut32"     = "builtin, native"
83 "ole32"        = "builtin, native"
84 "commdlg"      = "builtin, native"
85 "comdlg32"     = "builtin, native"
86 "shell"        = "builtin, native"
87 "shell32"      = "builtin, native"
88 "shfolder"     = "builtin, native"
89 "shlwapi"      = "builtin, native"
90 "shdocvw"      = "builtin, native"
91 "advapi32"     = "builtin, native"
92 "msvcrt"       = "native, builtin"
93 "mciavi.drv"   = "native, builtin"
94 "mcianim.drv"  = "native, builtin"
95 ; you can specify applications too
96 ; this one will apply for all notepad.exe
97 ;"*notepad.exe" = "native, builtin"
98 ; this one will apply only for a particular file
99 ;"C:\\windows\\regedit.exe" = "native, builtin"
100 ; default for all other dlls
101 "*" = "builtin, native"
102
103 [x11drv]
104 ; Number of colors to allocate from the system palette
105 "AllocSystemColors" = "100"
106 ; Use a private color map
107 "PrivateColorMap" = "N"
108 ; Favor correctness over speed in some graphics operations
109 "PerfectGraphics" = "N"
110 ; Color depth to use on multi-depth screens
111 ;;"ScreenDepth" = "16"
112 ; Name of X11 display to use
113 ;;"Display" = ":0.0"
114 ; Allow the window manager to manage created windows
115 "Managed" = "Y"
116 ; Use a desktop window of 640x480 for Wine
117 ;"Desktop" = "640x480"
118 ; Use XFree86 DGA extension if present
119 ; (make sure /dev/mem is accessible by you !)
120 "UseDGA" = "Y"
121 ; Use XShm extension if present
122 "UseXShm" = "Y"
123 ; Use XVidMode extension if present
124 "UseXVidMode" = "Y"
125 ; Use the take focus protocol
126 "UseTakeFocus" = "Y"
127 ; Enable DirectX mouse grab
128 "DXGrab" = "N"
129 ; Create the desktop window with a double-buffered visual
130 ; (useful to play OpenGL games)
131 "DesktopDoubleBuffered" = "N"
132 ; Code page used for captions in managed mode
133 ; 0 means default ANSI code page (CP_ACP == 0)
134 "TextCP" = "0"
135 ; Use this if you have more than one port for video on your setup
136 ; (Wine uses for now the first 'input image' it finds).
137 ;; "XVideoPort" = "43"
138 ; Run in synchronous mode (useful for debugging X11 problems)
139 ;;"Synchronous" = "Y"
140 ;
141 ; Use the Render extension to render client side fonts (default "Y")
142 ;;"ClientSideWithRender" = "Y"
143 ; Fallback on X core requests to render client side fonts (default "Y")
144 ;;"ClientSideWithCore" = "Y"
145 ; Set both of the previous two to "N" in order to force X11 server side fonts
146 ;
147 ; Anti-alias fonts if using the Render extension (default "Y")
148 ;;"ClientSideAntiAliasWithRender" = "Y"
149 ; Anti-alias fonts if using core requests fallback (default "Y")
150 ;;"ClientSideAntiAliasWithCore" = "Y"
151 ;
152
153 [fonts]
154 ;Read the Fonts topic in the Wine User Guide before adding aliases
155 ;See a couple of examples for russian users below
156 "Resolution" = "96"
157 "Default" = "-adobe-helvetica-"
158 "DefaultFixed" = "fixed"
159 "DefaultSerif" = "-adobe-times-"
160 "DefaultSansSerif" = "-adobe-helvetica-"
161
162 ;; default TrueType fonts with russian koi8-r encoding
163 ;"Default" = "-monotype-arial-*-*-*--*-*-*-*-*-*-koi8-r"
164 ;"DefaultFixed" = "-monotype-courier new-*-*-*--*-*-*-*-*-*-koi8-r"
165 ;"DefaultSerif" = "-monotype-times new roman-*-*-*--*-*-*-*-*-*-koi8-r"
166 ;"DefaultSansSerif" = "-monotype-arial-*-*-*--*-*-*-*-*-*-koi8-r"
167 ;; default cyrillic bitmap X fonts
168 ;"Default" = "-cronyx-helvetica-"
169 ;"DefaultFixed" = "fixed"
170 ;"DefaultSerif" = "-cronyx-times-"
171 ;"DefaultSansSerif" = "-cronyx-helvetica-"
172
173 ; the TrueType font dirs you want to make accessible to wine
174 [FontDirs]
175 ;"dir1" = "/usr/X11R6/lib/X11/fonts/TrueType"
176 ;"dir2" = "/usr/share/fonts/truetype"
177 ;"dir3" = "/usr/X11R6/lib/X11/fonts/TT"
178 ;"dir4" = "/usr/share/fonts/TT"
179
180 [serialports]
181 "Com1" = "/dev/ttyS0"
182 "Com2" = "/dev/ttyS1"
183 "Com3" = "/dev/ttyS2"
184 "Com4" = "/dev/modem"
185
186 [parallelports]
187 "Lpt1" = "/dev/lp0"
188
189 [ppdev]
190 ;; key:  io-base of the emulated port
191 ;; value : parport-device{,timeout}
192 ;; timeout for auto closing an open device ( not yet implemented)
193 ;"378" = "/dev/parport0"
194 ;"278" = "/dev/parport1"
195 ;"3bc" = "/dev/parport2"
196
197 [spooler]
198 "FILE:" = "tmp.ps"
199 "LPT1:" = "|lpr"
200 "LPT2:" = "|gs -sDEVICE=bj200 -sOutputFile=/tmp/fred -q -"
201 "LPT3:" = "/dev/lp3"
202
203 [ports]
204 ;"read"  = "0x779,0x379,0x280-0x2a0"
205 ;"write" = "0x779,0x379,0x280-0x2a0"
206
207 [Debug]
208 ;"RelayExclude" = "RtlEnterCriticalSection;RtlLeaveCriticalSection"
209 ;"RelayInclude" = "user32.CreateWindowA"
210 ;"SnoopExclude" = "RtlEnterCriticalSection;RtlLeaveCriticalSection"
211 ;"SpyExclude" = "WM_SIZE;WM_TIMER;"
212
213 [registry]
214 ;These are all booleans.  Y/y/T/t/1 are true, N/n/F/f/0 are false.
215 ;Defaults are read all, write to Home
216 ; Where to find the global registries
217 ;"GlobalRegistryDir" = "/etc";
218 ; Global registries (stored in /etc)
219 "LoadGlobalRegistryFiles" = "Y"
220 ; Home registries (stored in ~user/.wine/)
221 "LoadHomeRegistryFiles" = "Y"
222 ; Load Windows registries from the Windows directory
223 "LoadWindowsRegistryFiles" = "Y"
224 ; TRY to write all changes to home registries
225 "WritetoHomeRegistryFiles" = "Y"
226 ; Registry periodic save timeout in seconds
227 ; "PeriodicSave" = "600"
228 ; Save only modified keys
229 "SaveOnlyUpdatedKeys" = "Y"
230
231 [Tweak.Layout]
232 ;; supported styles are 'Win31'(default), 'Win95', 'Win98'
233 ;; this has *nothing* to do with the windows version Wine returns:
234 ;; set the "Windows" value in the [Version] section if you want that.
235 "WineLook" = "Win95"
236
237 [Clipboard]
238 "ClearAllSelections" = "0"
239 "PersistentSelection" = "1"
240
241 ; List of all directories directly contain .AFM files
242 [afmdirs]
243 "1" = "/usr/share/ghostscript/fonts"
244 "2" = "/usr/share/a2ps/afm"
245 "3" = "/usr/share/enscript"
246 "4" = "/usr/X11R6/lib/X11/fonts/Type1"
247
248 [WinMM]
249 ; Uncomment the "Drivers" line matching your sound setting.
250
251 "Drivers" = "wineoss.drv"      ; default for most common configurations
252 ;"Drivers" = "winearts.drv"    ; for KDE
253 ;"Drivers" = "winealsa.drv"    ; for ALSA users
254 ;"Drivers" = "winejack.drv"    ; for Jack sound server
255 ;"Drivers" = "winenas.drv"     ; for NAS sound system
256 ;"Drivers" = "wineaudioio.drv" ; for Solaris machines
257 ;"Drivers" = ""                ; to disable sound
258 "WaveMapper" = "msacm.drv"
259 "MidiMapper" = "midimap.drv"
260
261 [dsound]
262 ;; HEL only: Number of waveOut fragments ahead to mix in new buffers.
263 ;"HELmargin" = "5"
264 ;; HEL only: Number of waveOut fragments ahead to queue to driver.
265 ;"HELqueue" = "5"
266 ;; Max number of fragments to prebuffer
267 ;"SndQueueMax" = "28"
268 ;; Min number of fragments to prebuffer
269 ;"SndQueueMin" = "12"
270
271 [Network]
272 ;; Use the DNS (Unix) host name always as NetBIOS "ComputerName" (boolean, default "Y").
273 ;; Set to N if you need a persistent NetBIOS ComputerName that possibly differs 
274 ;; from the Unix host name. You'll need to set ComputerName in 
275 ;; HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\ComputerName\ComputerName, too.
276 ;"UseDnsComputerName" = "N"
277
278 ;; sample AppDefaults entries
279
280 ; 3 InstallShield versions who like to put their full screen window in front,
281 ; without any chance to switch to another X11 application.
282 ; So just catch them in a desktop window.
283
284 [AppDefaults\\_INS5576._MP\\x11drv]
285 "Desktop" = "640x480"
286
287 [AppDefaults\\_INS5176._MP\\x11drv]
288 "Desktop" = "640x480"
289
290 [AppDefaults\\_INS0466._MP\\x11drv]
291 "Desktop" = "640x480"
292
293 ;[AppDefaults\\iexplore.exe\\DllOverrides]
294 ;"shlwapi" = "native"
295 ;"rpcrt4" = "native"
296 ;"ole32" = "native"
297 ;"shdocvw" = "native"
298 ;"wininet" = "native"
299 ;"shfolder" = "native"
300 ;"shell32" = "native"
301 ;"shell" = "native"
302 ;"comctl32" = "native"
303 ;
304 ;[AppDefaults\\setup.exe\\x11drv]
305 ;"Desktop" = "800x600"
306 ;
307 ;[AppDefaults\\sol.exe\\Version]
308 ;"Windows" = "nt40"
309 ;
310 ;; Some games (Quake 2, UT) refuse to accept emulated dsound devices.
311 ;; You can add an AppDefault entry like this for such cases.
312 ;[AppDefaults\\pickygame.exe\\dsound]
313 ;"EmulDriver" = "N"
314
315 # [/wineconf]