Global USE flags

Flag Description Packages
X Enable audible bell for X11 3
amd64 4
apidoc Build html API documentation with sphinx-apidoc. 2
arm64 4
asterisk-patch Apply display asterisks on no-echo input patch 3
audit 2
berkdb Build the pam_userdb module, that allows to authenticate users against a Berkeley DB file. Please note that enabling this USE flag will create a PAM module that links to the Berkeley DB (as provided by <pkg>sys-libs/db</pkg>) installed in /usr/lib and will thus not work for boot-critical services authentication. 3
bzip2 2
cups 2
dbus 2
debug 9
doc 7
examples 2
experimental Enable experimental backend options 2
gcrypt Use message digest functions from <pkg>dev-libs/libgcrypt</pkg> instead of sudo's 2
gnutls 2
gstreamer Use <pkg>media-libs/gstreamer</pkg> to provide DirectShow functionality; 2
guile 2
hardened 2
kerberos 2
konsolebox Use https://github.com/konsolebox/geany.git as source, or use patches from https://github.com/konsolebox/geany-patches 4
ldap 3
lua 2
lzma Support lzma compression in ELF debug info 2
man 2
nls 6
nounset Inject '[[ BASH_VERSINFO -ge 5 ]] && set -u' to script 10
odbc Enable ODBC and SQL backend options 2
opengl 2
pam 2
perl Install helpers written in perl (winedump/winemaker) 4
plugins Add support for loading builtins at runtime via 'enable' 2
python Enable support for the new internal scripting language, as well as extended pretty printers 3
readline 3
ruby_single_target_ruby27 Use Ruby 2.7 as runtime 0
ruby_single_target_ruby28 Use Ruby 2.8 as runtime 0
ruby_single_target_ruby29 Use Ruby 2.9 as runtime 0
ruby_single_target_ruby30 Use Ruby 3.0 as runtime 0
ruby_single_target_ruby31 Use Ruby 3.1 as runtime 0
ruby_single_target_ruby32 Use Ruby 3.2 as runtime 0
ruby_single_target_ruby33 Use Ruby 3.3 as runtime 0
ruby_single_target_ruby34 Use Ruby 3.4 as runtime 0
ruby_single_target_ruby40 Use Ruby 4.0 as runtime 0
samba Add support for NTLM auth. See: https://web.archive.org/web/20160108123008/http://wiki.winehq.org:80/NtlmAuthSetupGuide and https://web.archive.org/web/20150906013746/http://wiki.winehq.org/NtlmSigningAndSealing (these pages are not currently in the updated WineHQ Wiki). 3
sasl 2
selinux 9
server Install the "gdbserver" program (useful for embedded/remote targets) 2
ssl Enable raop-sink support (needs <pkg>dev-libs/openssl</pkg>) 11
static 2
static-libs 3
systemd Use systemd's socket activation instead of creating the sockets itself 4
test Run tests. This may require FEATURES="test". 16
udev Use <pkg>virtual/libudev</pkg> to provide plug and play support 3
v4l 2
vanilla Only use release patches 3
x86 3
xml Support parsing XML data files needed (at least) for cpu features, memory maps, and syscall tracing 3
zstd 2

Category USE flags

app-emulation

Flag Description Packages
abi_x86_32 2
abi_x86_64 2
ncurses 2

app-shells

Flag Description Packages
bash-source-fullpath-default Enable the bash_source_fullpath option by default 2
bundled-readline Use bundled readline 2
mem-scramble Build with custom malloc/free overwriting allocated/freed memory 2
net Enable /dev/tcp/host/port redirection 2
pgo Optimize the build using Profile Guided Optimization (PGO) 2

dev-ruby

Flag Description Packages
rubyexec Use rubyexec as a wrapper for the binaries 3

media-video

Flag Description Packages
system-service Install systemd unit files for running as a system service. This disables user service files. 2

Local USE flags

app-admin

sudo

Flag Description
alt-secure-path-order Set default PATH values after extracted ones; not before
offensive Let sudo print insults when the user types the wrong password
secure-path Replace PATH variable with compile time secure paths
sendmail Allow sudo to send emails with sendmail
skey
sssd Add System Security Services Daemon support

app-crypt

gnupg

Flag Description
alternatives Install renamed, for compatibility with <pkg>app-alternatives/gpg</pkg>.
run-gnupg-user-socket lookup /run/gnupg/user or /var/run/gnupg/user first for socket diretories
run-user-socket lookup /run/user or /var/run/user for socket diretories
smartcard Build scdaemon software. Enables usage of OpenPGP cards. For other type of smartcards, try <pkg>app-crypt/gnupg-pkcs11-scd</pkg>. Bring in <pkg>dev-libs/libusb</pkg> as a dependency; enable scdaemon.
tofu Enable support for Trust on First use trust model; requires <pkg>dev-db/sqlite</pkg>.
tools Install extra tools (including gpgsplit and gpg-zip).
tpm Enable TPM support via <pkg>app-crypt/tpm2-tss</pkg> and build tpm2d.
usb Build direct CCID access for scdaemon; requires <pkg>dev-libs/libusb</pkg>.
wks-server Install the wks-server

app-emulation

vkd3d

Flag Description
spirv-tools Enable SPIRV shader debugging support using <pkg>dev-util/spirv-tools</pkg>

wine-d3d9

Flag Description
alsa
capi Enable ISDN support via CAPI
custom-cflags Bypass strip-flags; use at your own peril
d3d9 Apply highly experimental patches for Gallium Nine support. This patch may break some applications.
dos Pull in <pkg>games-emulation/dosbox</pkg> to run DOS applications
elibc_glibc
fontconfig
gecko Add support for the Gecko engine when using iexplore
gphoto2
gsm
gssapi Use GSSAPI (Kerberos SSP support)
jpeg
lcms
mono Add support for .NET using Wine's Mono add-on
mp3
netapi Use libnetapi from <pkg>net-fs/samba</pkg> to support Windows networks in netapi32.dll
openal
opencl Enable OpenCL support
osmesa Add support for OpenGL in bitmaps using libOSMesa
oss
pcap Support packet capture software (e.g. wireshark)
png
pulseaudio
realtime Pull in <pkg>sys-auth/rtkit</pkg> for low-latency pulseaudio support
run-exes Use Wine to open and run .EXE and .MSI files
scanner
sdl Add support for gamepad detection using SDL
threads
truetype
udisks
vkd3d Use <pkg>app-emulation/vkd3d</pkg> to provide Direct3D 12 support
vulkan Enable Vulkan drivers
xcomposite
xinerama

app-misc

mikefarah-yq-bin

Flag Description
arm

app-shells

bash

Flag Description
bashlogger Log ALL commands typed into bash; should ONLY be used in restricted environments such as honeypots

dev-debug

gdb

Flag Description
apply-remote-g-packet-reply-too-long-fix Apply remote-g-packet-reply-too-long-fix.patch
cet Enable Intel Control-flow Enforcement Technology.
debuginfod Enable debuginfod support via <pkg>dev-libs/elfutils</pkg> libdebuginfod
multitarget Support all known targets in one gdb binary
sim Build gdb's simulators for various hardware platforms. See https://sourceware.org/gdb/wiki/Sim.
source-highlight Enable listing highlighting via <pkg>dev-util/source-highlight</pkg>
xxhash Use <pkg>dev-libs/xxhash</pkg> to speed up internal hashing.

dev-games

cegui

Flag Description
devil Build the DevIL based ImageCodec module

dev-lang

ruby

Flag Description
gdbm
jemalloc
jit
socks5
systemtap Enable SystemTAP/DTrace tracing
tk
valgrind
xemacs

dev-ruby

digest-kangarootwelve

Flag Description
${IUSE-}
${REQUIRED_USE-}
${TARGET_FLAGS/target_compact/+target_compact}
${TARGET_FLAGS}
target_armv6 Build 'armv6' target
target_armv6m Build 'armv6m' target
target_armv7a Build 'armv7a' target
target_armv7m Build 'armv7m' target
target_armv8a Build 'armv8a' target
target_avr8 Build 'avr8' target
target_avx Build 'avx' target
target_avx2 Build 'avx2' target
target_avx2noasm Build 'avx2noasm' target
target_avx512 Build 'avx512' target
target_avx512noasm Build 'avx512noasm' target
target_compact Build 'compact' target
target_generi
target_generic32 Build 'generic32' target
target_generic32lc Build 'generic32lc' target
target_generic64 Build 'generic64' target
target_generic64lc Build 'generic64lc' target
target_ssse3 Build 'ssse3' target
target_xop Build 'xop' target

gist

Flag Description
rubyexec-autopick Autopick a Ruby implementation when the selected one isn't wanted

dev-util

geany

Flag Description
vte Enable Terminal support (<pkg>x11-libs/vte</pkg>)

games-arcade

smc

Flag Description
music Download and install the music files

media-gfx

mcomix

Flag Description
comicthumb Install comicthumb
thumbnailer Install comicthumb.thumbnailer

media-video

pipewire

Flag Description
bluetooth
echo-cancel Enable WebRTC-based echo canceller via <pkg>media-libs/webrtc-audio-processing</pkg>
extra Build pw-cat/pw-play/pw-record
ffmpeg
flatpak Enable Flatpak support
gsettings Use gsettings (<pkg>dev-libs/glib</pkg>) to read/save used modules (useful for e.g. <pkg>media-sound/paprefs</pkg>
ieee1394
jack-client Install a plugin for running PipeWire as a JACK client
jack-sdk Use PipeWire as JACK replacement
liblc3 Allow loading LC3 plugins via <pkg>media-sound/liblc3</pkg>
lv2 Allow loading LV2 plugins via <pkg>media-libs/lv2</pkg>
modemmanager Combined with USE=bluetooth, allows PipeWire to perform telephony on mobile devices.
pipewire-alsa Replace PulseAudio's ALSA plugin with PipeWire's plugin
roc Enable roc support for real-time audio streaming over the network, using <pkg>media-libs/roc-toolkit</pkg>. See https://gitlab.freedesktop.org/pipewire/pipewire/-/wikis/Network#roc
sound-server Provide sound server using ALSA and bluetooth devices
zeroconf

wireplumber

Flag Description
elogind

net-dns

dnscrypt-proxy-multi

Flag Description
chroot Add chroot support with /etc/init.d/dnscrypt-proxy-multi-chroot

net-irc

hexchat

Flag Description
gtk
libcanberra Enable sound event support using <pkg>media-libs/libcanberra</pkg>
plugin-checksum Build Checksum plugin (needs plugins)
plugin-fishlim Build FiSHLiM plugin (needs plugins)
plugin-sysinfo Build SysInfo plugin (needs plugins)
theme-manager Build the theme manager (mono)

net-misc

openssh

Flag Description
abi_mips_n32
ldns Use LDNS for DNSSEC/SSHFP validation.
libedit
livecd Enable root password logins for live-cd environment.
pie
security-key Include builtin U2F/FIDO support
xmss Enable XMSS post-quantum authentication algorithm

net-nds

openldap

Flag Description
${IUSE_CONTRIB}
crypt
cxx
iodbc
ipv6
kinit Enable support for kerberos init
minimal Build libraries &amp; userspace tools only. Does not install any server code
overlays Enable contributed OpenLDAP overlays
pbkdf2 Enable support for pbkdf2 passwords
sha2 Enable support for pw-sha2 password hashes
smbkrb5passwd Enable overlay for syncing ldap, unix and lanman passwords
syslog
tcpd

net-wireless

bluez

Flag Description
btpclient Enable BTP client
deprecated Build deprecated plugins
extra-tools Install tools that upstream doesn't install on purpose by default. All this tools shouldn't be used. Then, please notify upstream about you still need them to let them know the situation.
mesh Add support for Bluetooth Mesh control application and advertising bearer.
midi Enable MIDI support
obex Enable OBEX transfer support
test-programs Install tools for testing of various Bluetooth functions

sys-apps

portage

Flag Description
build
gentoo-dev Enable features required for Gentoo ebuild development.
ipc Use inter-process communication between portage and running ebuilds.
native-extensions Compiles native "C" extensions (speedups, instead of using python backup code). Currently includes libc-locales. This should only be temporarily disabled for some bootstrapping operations. Cross-compilation is not supported.
rsync-verify Enable full-tree cryptographic verification of Gentoo repository rsync checkouts using <pkg>app-portage/gemato</pkg>.
unofficial Include unofficial features. See #777393 and #782655.
xattr Preserve extended attributes (filesystem-stored metadata) when installing files. Usually only required for hardened systems.

sys-fs

cryptsetup

Flag Description
argon2 Enable password hashing algorithm from <pkg>app-crypt/argon2</pkg>
fips Enable FIPS mode restrictions
kernel Use kernel crypto backend (mainly for embedded systems)
nettle Use <pkg>dev-libs/nettle</pkg> crypto backend
openssl Use <pkg>dev-libs/openssl</pkg> crypto backend
pwquality Use <pkg>dev-libs/libpwquality</pkg> for password quality checking
reencrypt Build cryptsetup-reencrypt
ssh Build cryptsetup-ssh for experimental support of token via SSH-server
urandom Use /dev/urandom instead of /dev/random

sys-libs

pam

Flag Description
nis

www-client

elinks

Flag Description
bittorrent Enable support for the BitTorrent protocol
brotli
finger Enable support for the finger protocol
ftp
gopher Enable support for the gopher protocol
gpm
idn
javascript
mouse Make elinks to grab all mouse events
nntp
tre Enable support for regex searches via <pkg>dev-libs/tre</pkg>
unicode
zlib

x11-libs

vte

Flag Description
introspection

x11-misc

notification-daemon

Flag Description
auto-remove-old-notifications Enable automatic removal of old notifications
max-notifications-99 Enable maximum number of notifications set to 99