Chapter 5. Troubleshooting / Reporting bugs

5.1. What to do if some program still doesn't work?

There are times when you've been trying everything, you even killed a cat at full moon and ate it with rotten garlic and foul fish while doing the Devil's Dance, yet nothing helped to make some damn program work on some Wine version. Don't despair, we're here to help you... (in other words: how much do you want to pay?)

5.1.1. Verify your Wine configuration

Look at the output from wine --version to make sure you're running a recent version of Wine. Launch winecfg and look over the settings to make sure you have settings that look normal. Look in ~/.wine/dosdevices to make sure your c: points to where you think it should.

5.1.3. Use different startup paths

The following sometimes helps, too:

  • wine x:\\full\\path\\to\\prg.exe

  • wine ~/.wine/drive_c/full/path/to/prg.exe

  • cd ~/.wine/drive_c/full/path/to/ && wine prg.exe

5.1.4. Fiddle with DLL configuration

Run with WINEDEBUG=+loaddll to figure out which DLLs are being used, and whether they're being loaded as native or built-in. Then make sure you have proper native DLL files in your configured C:\windows\system32 directory and fiddle with DLL load order settings at command line or with winecfg.

5.1.5. Check your system environment!

Just an idea: could it be that your Wine build/execution environment is broken? Make sure that there are no problems whatsoever with the packages that Wine depends on (gcc, glibc, X libraries, OpenGL (!), ...)

5.1.6. Use different GUI (Window Manager) modes

Instruct Wine via winecfg to use either desktop mode, or normal managed mode. That can make a lot of difference, too.

5.1.7. Check your app!

Maybe your app is using some kind of copy protection? Many copy protections currently don't work on Wine. Some might work in the future, though. (the CD-ROM layer isn't really full-featured yet).

5.1.8. Reconfigure Wine

Sometimes Wine installation process changes and new versions of Wine account on these changes. This is especially true if your setup was created long time ago. Rename your existing ~/.wine directory for backup purposes. Use the setup process that's recommended for your Wine distribution to create new configuration. Use information in old ~/.wine directory as a reference. Later you can remove the new ~/.wine directory and rename your old one back.

5.1.9. Check out further information

There is a really good chance that someone has already tried to do the same thing as you. You may find the following resources helpful:

  • Search WineHQ Application Database to check for any tips relating to the program. If your specific version of the program isn't listed you may find a different one contains enough information to help you out.

  • Google can be useful depending on how you use it. You may find it helpful to search Google Groups, in particular the group.

  • hosts an IRC channel for Wine. You can access it by using any IRC client such as Xchat. The settings you'll need are:

  • If you have a program that requires a redistributable runtime to be installed, e.g. for mfc42.dll, Visual Basic and so on, winetricks can be used to supply this. Note, these components are subject to their own license and are not part of the Wine project. For further information on winetricks see the winetricks wiki entry.

  • Wine forums and mailing lists may also help, especially wine-users. The wine-devel list may be appropriate depending on the type of problem you are experiencing. If you post to wine-devel you should be prepared to do a little work to help diagnose the problem. Read the section below to find out how to debug the source of your problem.

  • If all else fails, you may wish to investigate commercial versions of Wine to see if your application is supported.

5.1.10. Debug it!

Finding the source of your problem is the next step to take. There is a wide spectrum of possible problems ranging from simple configurations issues to completely unimplemented functionality in Wine. The next section will describe how to file a bug report and how to begin debugging a crash. For more information on using Wine debugging facilities be sure to read the Wine Developers Guide.