Wine
Wine(Wine Is Not an Emulator) is an application that allows Windows software to run on Linux. This article deals with installing, configuring and maintaining a general purpose Wine environment on Gentoo.
Contents |
Installation
Enable the USE flags of choice and emerge app-emulation:
root # emerge --ask app-emulation/wineMedia
Generally want your Wine environment to support as much media as possible so the recommendation is to enable as many of the following USE flag.
| USE flag | Default | Recommended | Description |
|---|---|---|---|
| fontconfig | No | Yes | Support for configuring and customizing font access via media-libs/fontconfig |
| gecko | Yes | Yes | Add support for the Gecko engine when using iexplore |
| gsm | No | Yes | Adds support for the gsm lossy speech compression codec |
| gstreamer | No | Yes | Adds support for media-libs/gstreamer (Streaming media) |
| jpeg | No | Yes | Adds JPEG image support |
| lcms | No | Adds lcms support (color management engine) | |
| mp3 | No | Yes | Add support for reading mp3 files |
| png | No | Yes | Adds support for libpng (PNG images) |
| truetype | Yes | Yes | Adds support for FreeType and/or FreeType2 fonts |
Audio Output
| USE flag | Default | Recommended | Description |
|---|---|---|---|
| alsa | No | Yes | Adds support for media-libs/alsa-lib (Advanced Linux Sound Architecture) |
| esd | No | {{USEflag}} No valid global USE flag. | |
| nas | No | Adds support for network audio sound | |
| pulseaudio | No | See the Pulseaudio section. | |
| oss | Yes | No | Adds support for OSS (Open Sound System) |
Input/Output
| USE flag | Default | Recommended | Description |
|---|---|---|---|
| X | Yes | Yes | Adds support for X11 |
| cups | No | Add support for CUPS (Common Unix Printing System) | |
| gphoto2 | No | Adds digital camera support | |
| hardened | No | activate default security enhancements for toolchain (gcc, glibc, binutils) | |
| jack | No | Adds support for the JACK Audio Connection Kit | |
| ldap | No | Adds LDAP support (Lightweight Directory Access Protocol) | |
| mousewrap | No | Applies the mousewrap patch. | |
| nls | No | Yes | Adds Native Language Support (using gettext - GNU locale utilities) |
| openal | No | Adds support for the Open Audio Library | |
| opencl | No | Enable OpenCL support | |
| opengl | Yes | Yes | Adds support for OpenGL (3D graphics) |
| vl4 | No | {{USEflag}} No valid global USE flag. | |
| xcomposite | No | Yes | Enable support for the Xorg composite extension |
| xinerama | No | Yes | Add support for the xinerama X11 extension, which is mandatory if you work in multiple monitors setup |
Networking
| USE flag | Default | Recommended | Description |
|---|---|---|---|
| capi | No | Enable ISDN support via CAPI | |
| dbus | No | Enable dbus support for anything that needs it (gpsd, gnomemeeting, etc) | |
| gnutls | No | Adds support for net-libs/gnutls (TLS 1.0 and SSL 3.0 support) | |
| ncurses | No | Enable curses support in wineconsole. | |
| samba | No | Add support for NTLM auth[1][2] | |
| ssl | No | Yes | Adds support for Secure Socket Layer connections |
Miscellaneous
| USE flag | Default | Recommended | Description |
|---|---|---|---|
| custom‑cflags | No | Bypass strip-flags, See Debugging. | |
| perl | Yes | Install helpers written in perl (winedump/winemaker) | |
| scanner | No | Adds support for scanner hardware (e.g. build the sane frontend in kdegraphics) | |
| test | No | No | Workaround to pull in packages needed to run with FEATURES=test. Portage-2.1.2 handles this internally, so don't set it in make.conf/package.use anymore |
| threads | Yes | Yes | Adds threads support for various packages. Usually pthreads |
| win32 | Yes | Yes | Build a 32bit version of Wine (won't run Win64 binaries) |
| win64 | Yes | Build a 64bit version of Wine (won't run Win32 binaries) | |
| xml | No | Yes | Add support for XML files |
# Prevent wine from adding menu entries and desktop links export WINEDLLOVERRIDES='winemenubuilder.exe=d'
To delete already added menu entries you have to delete the corresponding files from ~/.local/share/applications
Debugging
If you find a bug and want to file a bug report you'll probably be asked to try the latest version, and if you are not running testing, you'll need to un-keyword it:
root # echo "app-emulation/wine" >> /etc/portage/package.accept_keywordsNow when you update it you should make sure the custom-cflags USE flag is enabled, as debugging will be impossible without it.
root # emerge --ask app-emulation/wine