Setting up config files, etc. Copyright 1999 Adam Sacarny (magicbox@bestweb.net) (Extracted from wine/documentation/config) The Wine config file stores various settings for Wine. These include: Drives and Information about them Directory Settings Port Settings The Wine look and feel Wine's DLL Usage This section will guide you through the process of making a config file. Take a look at the file <dirs to wine>/wine.ini. It is organized by section. Section Name Needed? What it Does [Drive X] yes Sets up drives recognized by wine [wine] yes Settings for wine directories [DllDefaults] recmd Defaults for loading DLL's [DllPairs] recmd Sanity checkers for DLL's [DllOverrides] recmd Overides defaults for DLL loading [options] no No one seems to know [fonts] yes Font appearance and recognition [serialports] no COM ports seen by wine [parallelports] no LPT ports seen by wine [spooler] no Print spooling [ports] no Direct port access [spy] no What to do with certain debug messages [Registry] no Specifies locations of windows registry files [tweak.layout] recmd Appearance of wine [programs] no Programs to be run automatically [Console] no Console settings It should be pretty self explanatory, but here is an in-depth tutorial about them. There are up to 6 lines for each drive in Wine. [Drive X] The above line begins the section for a drive whose letter is X. Path=/dir/to/path This path is where the drive will begin. When Wine is browsing in drive X, it will see the files that are in the directory /dir/to/path. Don't forget to leave off the trailing slash! Type=floppy|hd|cdrom|network <--- the |'s mean Type=<one of the options> Sets up the type of drive Wine will see it as. Type must equal one of the four floppy, hd, cdrom, or network. They are self-explanatory. Label=blah Defines the drive label. Generally only needed for programs that look for a special CD-ROM. Info on finding the lable is in <dirs to wine>/documentation/cdrom-labels. The label may be up to 11 characters. Serial=deadbeef Tells Wine the serial number of the drive. A few programs with intense protection for pirating might need this, but otherwise don't use it. Up to 8 characters and hexadecimal. Filesystem=msdos|win95|unix Sets up the way Wine looks at files on the drive. msdos Case insensitive filesystem. Alike to DOS and Windows 3.x. 8.3 is the maximum length of files (eightdot.123) - longer ones will be truncated. (NOTE: this is a very bad choice if you plan on running apps that use long filenames. win95 should work fine with apps that were designed to run under the msdos system. In other words, you might not want to use this.) win95 Case insensitive. Alike to Windows 9x/NT 4. This is the long filename filesystem you are probably used to working with. The filesystem of choice for most applications to be run under wine. PROBABLY THE ONE YOU WANT! unix Case sensitive. This filesystem has almost no use (Windows apps expect case insensitive filenames). Try it if you dare, but win95 is a much better choice. Device=/dev/xx Use this ONLY for floppy and cdrom devices. Using it on Extended2 partitions can have dire results (when a windows app tries to do a lowlevel write, they do it in a FAT way -- FAT does not mix with Extended2). This setting is not really important; almost all apps will have no problem if it remains unspecified. For CD-ROMs you might want to add it to get automatic label detection, though. If you are unsure about specifying device names, just leave out this setting for your drives. Here is a setup for Drive X, a generic hard drive: [Drive X] Path=/dos-a Type=hd Label=Hard Drive Filesystem=win95 This is a setup for Drive X, a generic CD-ROM drive: [Drive X] Path=/dos-d Type=cdrom Label=Total Annihilation Filesystem=win95 Device=/dev/hdc And here is a setup for Drive X, a generic floppy drive: [Drive X] Type=floppy Path=/mnt/floppy Label=Floppy Drive Serial=87654321 Filesystem=win95 Device=/dev/fd0 The [wine] section of the configuration file contains information wine uses for directories. When specifying the directories for the settings, make them as they would appear in wine. If your drive C has a path of /dos, and your windows directory is located in /dos/windows, then use: Windows=c:\windows This sets up the windows directory. Make one if you don't already have one. NO TRAILING SLASH (NOT C:\windows\)! System=c:\windows\system This sets up where the windows system files are. Should reside in the directory used for the Windows setting. If you don't have windows then this is where the system files will go. Again, NO TRAILING SLASH! Temp=c:\temp This should be the directory you want your temp files stored in. YOU MUST HAVE WRITE ACCESS TO IT. Path=c:\windows;c:\windows\system;c:\blanco Behaves like the PATH setting on UNIX boxes. When wine is run like wine sol.exe, if sol.exe resides in a directory specified in the Path setting, wine will run it (Of course, if sol.exe resides in the current directory, wine will run that one). Make sure it always has your windows directory and system directory (For this setup, it must have c:\windows;c:\windows\system). SymbolTableFile=wine.sym Sets up the symbol table file for the wine debugger. You probably don't need to fiddle with this. May be useful if your wine is stripped. printer=off|on Tells wine whether to allow printer drivers and printing to work. Using these things are pretty alpha, so you might want to watch out. Some people might find it useful, however. If you're not planning on working on printing, don't even add this to your wine.ini (It probably isn't already in it). Check out the [spooler] and [parallelports] sections too. There are a few things you will need to know before configuring the DLL sections in your wine configuration file. Most windows DLL's have a win16 (Windows 3.x) and win32 (Windows 9x/NT) form. The combination of the win16 and win32 DLL versions are called the "DLL pair". This is a list of the most common pairs: Win16 Win32 Native Is it possible to use native dll with wine? (See next section) KERNEL KERNEL32 No! USER USER32 No! SHELL SHELL32 Yes GDI GDI32 No! COMMDLG COMDLG32 Yes VER VERSION Yes There are a few different forms of DLL's wine can load: native The DLL's that are included with windows. Many windows DLL's can be loaded in their native form. Many times these native versions work better than their non-Microsoft equivalent -- other times they don't. elfdll ELF encapsulated windows DLL's. This is currently experimental (Not working yet). so Native ELF libraries. Will not work yet. builtin The most common form of DLL loading. This is what you will use if the DLL is error-prone in native form (KERNEL for example), you don't have the native DLL, or you just want to be Microsoft-free. These settings provide wine's default handling of DLL loading. EXTRA_LD_LIBRARY_PATH=/dirs The directory specified here is appended to the normal search path for certain forms of DLL's (elfdll and .so). DefaultLoadOrder = native, elfdll, so, builtin This setting is a comma-delimited list of which order to attempt loading DLL's. If the first option fails, it will try the second, and so on. The order specified above is probably the best in most conditions. This section is optional, but strongly recommended. If you try to use native SHELL32, but builtin SHELL, you could have some big problems (native and builtin/so/elfdll do certain things in different ways). Using different forms of a pair is a *very*, **very** bad idea. By specifying DLL pairs here, wine will print out a message if you use different forms of a pair. You shouldn't need to change anything in this section, the following should work fine in all cases: [DllPairs] kernel = kernel32 gdi = gdi32 user = user32 commdlg = comdlg32 commctrl= comctl32 ver = version shell = shell32 lzexpand= lz32 winsock = wsock32 The format for this section is the same for each line: <DLL>{,<DLL>,<DLL>...} = <FORM>{,<FORM>,<FORM>...} For example, to load builtin KERNEL pair (Case doesn't matter here): kernel,kernel32 = builtin To load the native COMMDLG pair, but if that doesn't work try builtin: commdlg,comdlg32 = native,builtin To load the native COMCTL32: comctl32 = native Here is a good generic setup (As it is defined in wine.ini that was included with your wine package): [DllOverrides] kernel32, gdi32, user32 = builtin kernel, gdi, user = builtin toolhelp = builtin comdlg32, commdlg = elfdll, builtin, native version, ver = elfdll, builtin, native shell32, shell = builtin, native lz32, lzexpand = builtin, native commctrl, comctl32 = builtin, native wsock32, winsock = builtin advapi32, crtdll, ntdll = builtin, native mpr, winspool = builtin, native ddraw, dinput, dsound = builtin, native winmm, w32skrnl, msvfw32= builtin wnaspi32, wow32 = builtin system, display, wprocs = builtin wineps = builtin You see that elfdll or so is the first option for a few of these dll's. This will fail for you, but you won't notice it as wine will just use the second or third option. No one seems to know what this section is... AllocSystemColors=100 System colors to allocate? Just leave it at 100. This section sets up wine's font handling. Resolution = 96 Since the way X handles fonts is different from the way Windows does, wine uses a special mechanism to deal with them. It must scale them using the number defined in the "Resolution" setting. 60-120 are reasonable values, 96 is a nice in the middle one. If you have the real windows fonts available (<dirs to wine>/documentation/ttfserver and fonts), this parameter will not be as important. Of course, it's always good to get your X fonts working acceptably in wine. Default = -adobe-times- The default font wine uses. Fool around with it if you'd like. OPTIONAL: The Alias setting allows you to map an X font to a font used in wine. This is good for apps that need a special font you don't have, but a good replacement exists. The syntax is like so: AliasX = [Fake windows name],[Real X name]<,optional "masking" section> Pretty straightforward. Replace "AliasX" with "Alias0", then "Alias1" and so on. The fake windows name is the name that the font will be under a windows app in wine. The real X name is the font name as seen by X (Run "xfontsel"). The optional "masking" section allows you to utilize the fake windows name you define. If it is not used, then wine will just try to extract the fake windows name itself and not use the value you enter. Here is an example of an alias without masking. The font will show up in windows apps as "Google". When defining an alias in a config file, forget about my comment text (The "<-- blah" stuff) Alias0 = Foo,--google- <-- Note the no spaces after the " = ". Important! Here is an example with masking enabled. The font will show up as "Foo" in windows apps. Alias1 = Foo,--google-,subst For more info check out <dirs to wine>/documentation/fonts Even though it sounds like a lot of sections, these are all closely related. They all are for communications and parallel ports. The [serialports] section tells wine what serial ports it is allowed to use. ComX=/dev/cuaY Replace X with the number of the COM port in Windows (1-8) and Y with the number of it in X (Usually the number of the port in Windows minus 1). ComX can actually equal any device (/dev/modem is acceptable). It is not always necessary to define any COM ports (An optional setting). Here is an example: Com1=/dev/cua0 Use as many of these as you like in the section to define all of the COM ports you need. The [parallelports] section sets up any parallel ports that will be allowed access under wine. LptX=/dev/lpY Seem farmiliar? Syntax is just like the COM port setting. Replace X with a value from 1-4 as it is in Windows and Y with a value from 0-3 (Y is usually the value in windows minus 1, just like for COM ports). You don't always need to define a parallel port (AKA, it's optional). As with the other section, LptX can equal any device (Maybe /dev/printer). Here is an example: Lpt1=/dev/lp0 The [spooler] section will inform wine where to spool print jobs. Use this if you want to try printing. Wine docs claim that spooling is "rather primitive" at this time, so it won't work perfectly. IT IS OPTIONAL. The only setting you use in this section works to map a port (LPT1, for example) to a file or a command. Here is an example, mapping LPT1 to the file out.ps: LPT1:=out.ps The following command maps printing jobs to LPT1 to the command lpr. Notice the |: LPT1:=|lpr The [ports] section is usually useful only for people who need direct port access for programs requiring dongles or scanners. IF YOU DON'T NEED IT, DON'T USE IT! read=0x779,0x379,0x280-0x2a0 Gives direct read access to those IO's. write=0x779,0x379,0x280-0x2a0 Gives direct write access to those IO's. It probably a good idea to keep the values of the read and write settings the same. This stuff will only work when you're root. [spy] is used to Include or exclude debug messages, and to output them to a file. The latter is rarely used. THESE ARE ALL OPTIONAL AND YOU PROBABLY DON'T NEED TO ADD OR REMOVE ANYTHING IN THIS SECTION TO YOUR CONFIG. File=/blanco Sets the logfile for wine. Set to CON to log to standard out. THIS IS RARELY USED. Exclude=WM_SIZE;WM_TIMER; Excludes debug messages about WM_SIZE and WM_TIMER in the logfile. Include=WM_SIZE;WM_TIMER; Includes debug messages about WM_SIZE and WM_TIMER in the logfile. [Registry] can be used to tell wine where your old windows registry files exist. This section is completely optional and useless to people using wine without an existing windows installation. UserFileName=/dirs/to/user.reg The location of your old user.reg file. LocalMachineFileName=/dirs/to/system.reg The location of your old system.reg file. [tweak.layout] is devoted to wine's look. There is only one setting for it. WineLook=win31|win95|win98 Will change the look of wine from Windows 3.1 to Windows 95. The win98 setting behaves just like win95 most of the time. [programs] can be used to say what programs run under special conditions. Default=/program/to/execute.exe Sets the program to be run if wine is started without specifying a program. Startup=/program/to/execute.exe Sets the program to automatically be run at startup every time. The wine config file can go in two places. /usr/local/etc/wine.conf A systemwide config file, used for anyone who doesn't have their own. $HOME/.winerc Your own config file, that only is used for your user. So copy your version of the wine.conf file to /usr/local/etc/wine.conf or $HOME/.winerc for wine to recognize it. There is always a chance that things will go wrong. If the unthinkable happens, try the newsgroup, comp.emulators.ms-windows.wine Make sure that you have looked over this document thoroughly, and have also read: README documentation/bugreports http://www.westfalen.de/witch/wine-HOWTO.txt (Optional but recommended) If indeed it looks like you've done your research, be prepared for helpful suggestions. If you haven't, brace yourself for heaving flaming. by ??? (Extracted from wine/documentation/win95look) Win95/Win98 interface code is being introduced. Instead of compiling Wine for Win3.1 vs. Win95 using #define switches, the code now looks in a special [Tweak.Layout] section of wine.conf for a WineLook=Win95 or WineLook=Win98 entry. A few new sections and a number of entries have been added to the wine.conf file -- these are for debugging the Win95 tweaks only and may be removed in a future release! These entries/sections are: [Tweak.Fonts] System.Height=<point size> # Sets the height of the system typeface System.Bold=[true|false] # Whether the system font should be boldfaced System.Italic=[true|false] # Whether the system font should be italicized System.Underline=[true|false] # Whether the system font should be underlined System.StrikeOut=[true|false] # Whether the system font should be struck out OEMFixed.xxx # Same parameters for the OEM fixed typeface AnsiFixed.xxx # Same parameters for the Ansi fixed typeface AnsiVar.xxx # Same parameters for the Ansi variable typeface SystemFixed.xxx # Same parameters for the System fixed typeface [Tweak.Layout] WineLook=[Win31|Win95|Win98] # Changes Wine's look and feel written by Ove Kåven (Extracted from wine/documentation/x11drv) Most Wine users run Wine under the windowing system known as X11. During most of Wine's history, this was the only display driver available, but in recent years, parts of Wine has been reorganized to allow for other display drivers (although the only alternative currently available is Patrik Stridvall's ncurses-based ttydrv, which he claims works for displaying calc.exe). The display driver is chosen with the GraphicsDriver option in the [wine] section of wine.conf or .winerc, but I will only cover the x11drv driver in this article. The x11drv driver consists of two conceptually distinct pieces, the graphics driver (GDI part), and the windowing driver (USER part). Both of these are linked into the libx11drv.so module, though (which you load with the GraphicsDriver option). In Wine, running on X11, the graphics driver must draw on drawables (window interiors) provided by the windowing driver. This differs a bit from the Windows model, where the windowing system creates and configures device contexts controlled by the graphics driver, and applications are allowed to hook into this relationship anywhere they like. Thus, to provide any reasonable tradeoff between compatibility and usability, the x11drv has three different modes of operation. Unmanaged/Normal The default. Window-manager-independent (any running window manager is ignored completely). Window decorations (title bars, borders, etc) are drawn by Wine to look and feel like the real Windows. This is compatible with applications that depend on being able to compute the exact sizes of any such decorations, or that want to draw their own. Managed Specified by using the --managed command-line option or the Managed wine.conf option (see below). Ordinary top-level frame windows with thick borders, title bars, and system menus will be managed by your window manager. This lets these applications integrate better with the rest of your desktop, but may not always work perfectly. (A rewrite of this mode of operation, to make it more robust and less patchy, is highly desirable, though, and is planned to be done before the Wine 1.0 release.) Desktop-in-a-Box Specified by using the --desktop command-line option (with a geometry, e.g. --desktop 800x600 for a such-sized desktop, or even --desktop 800x600+0+0 to automatically position the desktop at the upper-left corner of the display). This is the mode most compatible with the Windows model. All application windows will just be Wine-drawn windows inside the Wine-provided desktop window (which will itself be managed by your window manager), and Windows applications can roam freely within this virtual workspace and think they own it all, without disturbing your other X apps. AllocSystemColors Applies only if you have a palette-based display, i.e. if your X server is set to a depth of 8bpp, and if you haven't requested a private color map. It specifies the maximum number of shared colormap cells (palette entries) Wine should occupy. The higher this value, the less colors will be available to other applications. PrivateColorMap Applies only if you have a palette-based display, i.e. if your X server is set to a depth of 8bpp. It specifies that you don't want to use the shared color map, but a private color map, where all 256 colors are available. The disadvantage is that Wine's private color map is only seen while the mouse pointer is inside a Wine window, so psychedelic flashing and funky colors will become routine if you use the mouse a lot. PerfectGraphics This option only determines whether fast X11 routines or exact Wine routines will be used for certain ROP codes in blit operations. Most users won't notice any difference. ScreenDepth Applies only to multi-depth displays. It specifies which of the available depths Wine should use (and tell Windows apps about). Display This specifies which X11 display to use, and if specified, will override both the DISPLAY environment variable and the --display command-line option. Managed Wine can let frame windows be managed by your window manager. This option specifies whether you want that by default. UseDGA This specifies whether you want DirectDraw to use XFree86's Direct Graphics Architecture (DGA), which is able to take over the entire display and run the game full-screen at maximum speed. (With DGA1 (XFree86 3.x), you still have to configure the X server to the game's requested bpp first, but with DGA2 (XFree86 4.x), runtime depth-switching may be possible, depending on your driver's capabilities.) But be aware that if Wine crashes while in DGA mode, it may not be possible to regain control over your computer without rebooting. DGA normally requires either root privileges or read/write access to /dev/mem. UseXShm If you don't want DirectX to use DGA, you can at least use X Shared Memory extensions (XShm). It is much slower than DGA, since the app doesn't have direct access to the physical frame buffer, but using shared memory to draw the frame is at least faster than sending the data through the standard X11 socket, even though Wine's XShm support is still known to crash sometimes. DXGrab If you don't use DGA, you may want an alternative means to convince the mouse cursor to stay within the game window. This option does that. Of course, as with DGA, if Wine crashes, you're in trouble (although not as badly as in the DGA case, since you can still use the keyboard to get out of X). DesktopDoubleBuffered Applies only if you use the --desktop command-line option to run in a desktop window. Specifies whether to create the desktop window with a double-buffered visual, something most OpenGL games need to run correctly. ®istry; Petr Tomasek

<tomasek@etf.cuni.cz>

Nov 14 1999 Andreas Mohr

<a.mohr@mailto.de>

Jan 25 2000 by Petr Tomasek <tomasek@etf.cuni.cz> Nov 14 1999 changes by Andreas Mohr <a.mohr@mailto.de> Jan 25 2000 (Extracted from wine/documentation/cdrom-labels) Until now, your only possibility of specifying drive volume labels and serial numbers was to set them manually in the wine config file. By now, wine can read them directly from the device as well. This may be useful for many Win 9x games or for setup programs distributed on CD-ROMs that check for volume label. File System Types Comment FAT systems hd, floppy reads labels and serial numbers ISO9660 cdrom reads labels only Reading labels and serial numbers just works automagically if you specify a Device= line in the [Drive X] section in your wine.conf. Note that the device has to exist and must be accessible if you do this, though. If you don't do that, then you should give fixed Label= or Serial= entries in wine.conf, as Wine returns these entries instead if no device is given. If they don't exist, then Wine will return default values (label Drive X and serial 12345678). If you want to give a Device= entry *only* for drive raw sector accesses, but not for reading the volume info from the device (i.e. you want a fixed, preconfigured label), you need to specify ReadVolInfo=0 to tell Wine to skip the volume reading. Here's a simple example of cdrom and floppy; labels will be read from the device on both cdrom and floppy; serial numbers on floppy only: [Drive A] Path=/mnt/floppy Type=floppy Device=/dev/fd0 Filesystem=msdos [Drive R] Path=/mnt/cdrom Type=cdrom Device=/dev/hda1 Filesystem=win95 Here's an example of overriding the CD-ROM label: [Drive J] Path=/mnt/cdrom Type=cdrom Label=X234GCDSE ; note that the device isn't really needed here as we have a fixed label Device=/dev/cdrom Filesystem=msdos The cdrom label can be read only if the data track of the disk resides in the first track and the cdrom is iso9660. Better checking for FAT superblock (it now checks only one byte). Support for labels/serial nums WRITING. Can the label be longer than 11 chars? (iso9660 has 32 chars). What about reading ext2 volume label? .... by Ove Kaaven <ovek@arcticnet.no> (Extracted from wine/documentation/dll-overrides) The wine.conf directives [DllDefaults] and [DllOverrides] are the subject of some confusion. The overall purpose of most of these directives are clear enough, though - given a choice, should Wine use its own built-in DLLs, or should it use .DLL files found in an existing Windows installation? This document explains how this feature works. native A "native" DLL is a .DLL file written for the real Microsoft Windows. builtin A "builtin" DLL is a Wine DLL. These can either be a part of libwine.so, or more recently, in a special .so file that Wine is able to load on demand. elfdll An "elfdll" is a Wine .so file with a special Windows-like file structure that is as close to Windows as possible, and that can also seamlessly link dynamically with "native" DLLs, by using special ELF loader and linker tricks. Bertho Stultiens did some work on this, but this feature has not yet been merged back into Wine (because of political reasons and lack of time), so this DLL type does not exist in the official Wine at this time. In the meantime, the "builtin" DLL type gained some of the features of elfdlls (such as dynamic loading), so it's possible that "elfdll" functionality will be folded into "builtin" at some point. so A native Unix .so file, with calling convention conversion thunks generated on the fly as the library is loaded. This is mostly useful for libraries such as "glide" that has exactly the same API on both Windows and Unix. EXTRA_LD_LIBRARY_PATH This specifies the location of the Wine's DLL .so files. Wine will search this path when trying to locate a DLL of the type builtin or elfdll. (This does not apply to libwine.so, since libwine.so is not a DLL in this sense.) DefaultLoadOrder This specifies in what order Wine should search for available DLL types, if the DLL in question was not found in the [DllOverrides] section. At one time, there was a section called [DllPairs] in the default configuration file, but this has been obsoleted because the pairing information has now been embedded into Wine itself. (The purpose of this section was merely to be able to issue warnings if the user attempted to pair codependent 16-bit/32-bit DLLs of different types.) If you still have this in your wine.conf or .winerc, you may safely delete it. This section specifies how you want specific DLLs to be handled, in particular whether you want to use "native" DLLs or not, if you have some from a real Windows configuration. Because builtins do not mix seamlessly with native DLLs yet, certain DLL dependencies may be problematic, but workarounds exist in Wine for many popular DLL configurations. Also see WWN's [16]Status Page to figure out how well your favorite DLL is implemented in Wine. It is of course also possible to override these settings by explictly using Wine's --dll command-line option (see the man page for details). Some hints for choosing your optimal configuration (listed by 16/32-bit DLL pair): krnl386, kernel32 Native versions of these will never work, so don't try. Leave at builtin. gdi, gdi32 Graphics Device Interface. No effort has been made at trying to run native GDI. Leave at builtin. user, user32 Window management and standard controls. It was possible to use Win95's native versions at some point (if all other DLLs that depend on it, such as comctl32 and comdlg32, were also run native). However, this is no longer possible after the Address Space Separation, so leave at builtin. ntdll NT kernel API. Although badly documented, the native version of this will never work. Leave at builtin. w32skrnl Win32s (for Win3.x). The native version will probably never work. Leave at builtin. wow32 Win16 support library for NT. The native version will probably never work. Leave at builtin. system Win16 kernel stuff. Will never work native. Leave at builtin. display Display driver. Definitely leave at builtin. toolhelp Tool helper routines. This is rarely a source of problems. Leave at builtin. ver, version Versioning. Seldom useful to mess with. advapi32 Registry and security features. Trying the native version of this may or may not work. commdlg, comdlg32 Common Dialogs, such as color picker, font dialog, print dialog, open/save dialog, etc. It is safe to try native. commctrl, comctl32 Common Controls. This is toolbars, status bars, list controls, the works. It is safe to try native. shell, shell32 Shell interface (desktop, filesystem, etc). Being one of the most undocumented pieces of Windows, you may have luck with the native version, should you need it. winsock, wsock32 Windows Sockets. The native version will not work under Wine, so leave at builtin. icmp ICMP routines for wsock32. As with wsock32, leave at builtin. mpr The native version may not work due to thunking issues. Leave at builtin. lzexpand, lz32 Lempel-Ziv decompression. Wine's builtin version ought to work fine. winaspi, wnaspi32 Advanced SCSI Peripheral Interface. The native version will probably never work. Leave at builtin. crtdll C Runtime library. The native version will easily work better than Wine's on this one. winspool.drv Printer spooler. You are not likely to have more luck with the native version. ddraw DirectDraw/Direct3D. Since Wine does not implement the DirectX HAL, the native version will not work at this time. dinput DirectInput. Running this native may or may not work. dsound DirectSound. It may be possible to run this native, but don't count on it. dplay/dplayx DirectPlay. The native version ought to work best on this, if at all. mmsystem, winmm Multimedia system. The native version is not likely to work. Leave at builtin. msacm, msacm32 Audio Compression Manager. The builtin version works best, if you set msacm.drv to the same. msvideo, msvfw32 Video for Windows. It is safe (and recommended) to try native. mcicda.drv CD Audio MCI driver. mciseq.drv MIDI Sequencer MCI driver (.MID playback). mciwave.drv Wave audio MCI driver (.WAV playback). mciavi.drv AVI MCI driver (.AVI video playback). Best to use native. mcianim.drv Animation MCI driver. msacm.drv Audio Compression Manager. Set to same as msacm32. midimap.drv MIDI Mapper. wprocs This is a pseudo-DLL used by Wine for thunking purposes. A native version of this doesn't exist. by Ove Kaaven <ovek@arcticnet.no> (Extracted from wine/documentation/keyboard) Wine now needs to know about your keyboard layout. This requirement comes from a need from many apps to have the correct scancodes available, since they read these directly, instead of just taking the characters returned by the X server. This means that Wine now needs to have a mapping from X keys to the scancodes these applications expect. On startup, Wine will try to recognize the active X layout by seeing if it matches any of the defined tables. If it does, everything is alright. If not, you need to define it. To do this, open the file windows/x11drv/keyboard.c and take a look at the existing tables. Make a backup copy of it, especially if you don't use CVS. What you really would need to do, is find out which scancode each key needs to generate. Find it in the main_key_scan table, which looks like this: static const int main_key_scan[MAIN_LEN] = { /* this is my (102-key) keyboard layout, sorry if it doesn't quite match yours */ 0x29,0x02,0x03,0x04,0x05,0x06,0x07,0x08,0x09,0x0A,0x0B,0x0C,0x0D, 0x10,0x11,0x12,0x13,0x14,0x15,0x16,0x17,0x18,0x19,0x1A,0x1B, 0x1E,0x1F,0x20,0x21,0x22,0x23,0x24,0x25,0x26,0x27,0x28,0x2B, 0x2C,0x2D,0x2E,0x2F,0x30,0x31,0x32,0x33,0x34,0x35, 0x56 /* the 102nd key (actually to the right of l-shift) */ }; Next, assign each scancode the characters imprinted on the keycaps. This was done (sort of) for the US 101-key keyboard, which you can find near the top in keyboard.c. It also shows that if there is no 102nd key, you can skip that. However, for most international 102-key keyboards, we have done it easy for you. The scancode layout for these already pretty much matches the physical layout in the main_key_scan, so all you need to do is to go through all the keys that generate characters on your main keyboard (except spacebar), and stuff those into an appropriate table. The only exception is that the 102nd key, which is usually to the left of the first key of the last line (usually Z), must be placed on a separate line after the last line. For example, my Norwegian keyboard looks like this § ! " # ¤ % & / ( ) = ? ` Back- | 1 2@ 3£ 4$ 5 6 7{ 8[ 9] 0} + \´ space Tab Q W E R T Y U I O P Å ^ ¨~ Enter Caps A S D F G H J K L Ø Æ * Lock ' Sh- > Z X C V B N M ; : _ Shift ift < , . - Ctrl Alt Spacebar AltGr Ctrl Note the 102nd key, which is the <> key, to the left of Z. The character to the right of the main character is the character generated by AltGr. This keyboard is defined as follows: static const char main_key_NO[MAIN_LEN][4] = { "|§","1!","2\"@","3#£","4¤$","5%","6&","7/{","8([","9)]","0=}","+?","\\´", "qQ","wW","eE","rR","tT","yY","uU","iI","oO","pP","åÅ","¨^~", "aA","sS","dD","fF","gG","hH","jJ","kK","lL","øØ","æÆ","'*", "zZ","xX","cC","vV","bB","nN","mM",",;",".:","-_", "<>" }; Except that " and \ needs to be quoted with a backslash, and that the 102nd key is on a separate line, it's pretty straightforward. After you have written such a table, you need to add it to the main_key_tab[] layout index table. This will look like this: static struct { WORD lang, ansi_codepage, oem_codepage; const char (*key)[MAIN_LEN][4]; } main_key_tab[]={ ... ... {MAKELANGID(LANG_NORWEGIAN,SUBLANG_DEFAULT), 1252, 865, &main_key_NO}, ... After you have added your table, recompile Wine and test that it works. If it fails to detect your table, try running wine --debugmsg +key,+keyboard >& key.log and look in the resulting key.log file to find the error messages it gives for your layout. Note that the LANG_* and SUBLANG_* definitions are in include/winnls.h, which you might need to know to find out which numbers your language is assigned, and find it in the debugmsg output. The numbers will be (SUBLANG * 0x400 + LANG), so, for example the combination LANG_NORWEGIAN (0x14) and SUBLANG_DEFAULT (0x1) will be (in hex) 14 + 1*400 = 414, so since I'm Norwegian, I could look for 0414 in the debugmsg output to find out why my keyboard won't detect. Once it works, submit it to the Wine project. If you use CVS, you will just have to do cvs -z3 diff -u windows/x11drv/keyboard.c > layout.diff from your main Wine directory, then submit layout.diff to wine-patches@winehq.com along with a brief note of what it is. If you don't use CVS, you need to do diff -u the_backup_file_you_made windows/x11drv/keyboard.c > layout.diff and submit it as explained above. If you did it right, it will be included in the next Wine release, and all the troublesome applications (especially remote-control applications) and games that use scancodes will be happily using your keyboard layout, and you won't get those annoying fixme messages either. Good luck.