gentoo.LinuxHowtos.org
USE-FlagDescriptionused
XAdd support for X11397
Xaw3dAdd support for the 3d athena widget set8
a52Enable support for decoding ATSC A/52 streams used in DVD7
aacEnable support for MPEG-4 AAC Audio19
aalibAdd support for media-libs/aalib (ASCII-Graphics Library)8
accessibilityAdd support for accessibility (eg 'at-spi' library)13
aclAdd support for Access Control Lists35
acpiAdd support for Advanced Configuration and Power Interface2
adnsAdd support for asynchronous DNS resolution1
afsAdd OpenAFS support (distributed file system)5
alsaAdd support for media-libs/alsa-lib (Advanced Linux Sound Architecture)132
aoUse libao audio output library for sound playback13
apache2Add Apache2 support10
aquaInclude support for the Mac OS X Aqua (Carbon/Cocoa) GUI17
asmEnable using assembly for optimization3
atmEnable Asynchronous Transfer Mode protocol support2
apparmorEnable support for the AppArmor application security system16
appindicatorBuild in support for notifications using the libindicate or libappindicator plugin16
audiofileAdd support for libaudiofile where applicable6
auditEnable support for Linux audit subsystem using sys-process/audit21
avifAdd AV1 Image Format (AVIF) support13
bash-completionEnable bash-completion support4
berkdbAdd support for sys-libs/db (Berkeley DB)37
bidiEnable bidirectional language support11
big-endianBig-endian toolchain support12
bindistFlag to enable or disable options for prebuilt (GRP) packages (eg. due to licensing issues)6
blasAdd support for the virtual/blas numerical library8
bluetoothEnable Bluetooth Support36
brandingEnable Gentoo specific branding9
brotliEnable Brotli compression support18
build!!internal use only!! DO NOT SET THIS FLAG YOURSELF!, used for creating build images and the first half of bootstrapping [make stage1]6
bzip2Enable bzip2 compression support55
cairoEnable support for the cairo graphics library21
calendarAdd support for calendars (not using mcal!)7
capsUse Linux capabilities library to control privilege35
cdbAdd support for the CDB database engine from the author of qmail5
cddaAdd Compact Disk Digital Audio (Standard Audio CD) support14
cddbAccess cddb servers to retrieve and submit information about compact disks7
cdinstallCopy files from the CD rather than asking the user to copy them, mostly used with games6
cdrAdd support for CD writer hardware10
cgiAdd CGI script support8
cjkAdd support for Multi-byte character languages (Chinese, Japanese, Korean)16
clamavAdd support for Clam AntiVirus software (usually with a plugin)9
colordSupport color management using x11-misc/colord8
connmanAdd support for net-misc/connman3
coreaudioBuild the CoreAudio driver on Mac OS X systems8
cracklibSupport for cracklib strong password checking7
cryptAdd support for encryption -- using mcrypt or gpg where applicable39
cssEnable reading of encrypted DVDs0
cudaEnable NVIDIA CUDA support (computation on GPU)43
cupsAdd support for CUPS (Common Unix Printing System)32
curlAdd support for client-side URL transfer library60
custom-cflagsBuild with user-specified CFLAGS (unsupported)31
cvsEnable CVS (Concurrent Versions System) integration3
cxxBuild support for C++ (bindings, extra libraries, code generation, ...)17
dbiEnable dev-db/libdbi (database-independent abstraction layer) support7
dbmAdd support for generic DBM databases1
dbusEnable dbus support for anything that needs it (gpsd, gnomemeeting, etc)93
debugEnable extra debug codepaths, like asserts and extra output. If you want to get meaningful backtraces see https://wiki.gentoo.org/wiki/Project:Quality_Assurance/Backtraces842
dedicatedAdd support for dedicated game servers (some packages do not provide clients and servers at the same time)21
dgaAdd DGA (Direct Graphic Access) support for X1
dist-kernelEnable subslot rebuilds on Distribution Kernel upgrades3
djvuSupport DjVu, a PDF-like document format esp. suited for scanned documents9
docAdd extra documentation (API, Javadoc, etc). It is recommended to enable per package instead of globally1185
driEnable direct rendering: used for accelerated 3D and some 2D, like DMA3
dtsEnable DTS Coherent Acoustics decoder support5
dvEnable support for a codec used by many camcorders3
dvbAdd support for DVB (Digital Video Broadcasting)9
dvdAdd support for DVDs7
dvdrAdd support for DVD writer hardware (e.g. in xcdroast)2
edsEnable support for Evolution-Data-Server (EDS)6
eglEnable EGL (Embedded-System Graphics Library, interfacing between windowing system and OpenGL/GLES) support8
elogindEnable session tracking via sys-auth/elogind43
emacsAdd support for GNU Emacs84
embossAdd support for the European Molecular Biology Open Software Suite5
encodeAdd support for encoding of audio or video files4
examplesInstall examples, usually source code560
exifAdd support for reading EXIF headers from JPEG and TIFF images29
expatEnable the use of dev-libs/expat for XML parsing12
famEnable FAM (File Alteration Monitor) support7
fastcgiAdd support for the FastCGI interface4
fbconAdd framebuffer support for the console, via the kernel14
ffmpegEnable ffmpeg/libav-based audio/video codec support54
fftwUse FFTW library for computing Fourier transforms22
filecapsUse Linux file capabilities to control privilege rather than set*id (this is orthogonal to USE=caps which uses capabilities at runtime e.g. libcap)0
firebirdAdd support for the Firebird relational database6
flacAdd support for FLAC: Free Lossless Audio Codec53
fltkAdd support for the Fast Light Toolkit gui interface6
fontconfigSupport for configuring and customizing font access via media-libs/fontconfig10
fortranAdd support for fortran31
freetdsAdd support for the TDS protocol to connect to MSSQL/Sybase databases2
ftpAdd FTP (File Transfer Protocol) support4
gdAdd support for media-libs/gd (to generate graphics on the fly)14
gdbmAdd support for sys-libs/gdbm (GNU database libraries)24
geoipAdd geoip support for country and city lookup based on IPs23
geolocationEnable physical position determination9
ggiAdd support for media-libs/libggi (non-X video api/drivers)2
gifAdd GIF image support38
gimpBuild a plugin for the GIMP5
gitEnable git (version control system) support9
gles2Enable GLES 2.0 (OpenGL for Embedded Systems) support (independently of full OpenGL, see also: gles2-only)8
gles2-onlyUse GLES 2.0 (OpenGL for Embedded Systems) or later instead of full OpenGL (see also: gles2)26
glutBuild an OpenGL plugin using the GLUT library5
gmpAdd support for dev-libs/gmp (GNU MP library)18
gnomeAdd GNOME support24
gnome-keyringEnable support for storing passwords via gnome-keyring3
gnuplotEnable support for gnuplot (data and function plotting)8
gnutlsPrefer net-libs/gnutls as SSL/TLS provider (ineffective with USE=-ssl)74
gphoto2Add digital camera support6
gpmAdd support for sys-libs/gpm (Console-based mouse driver)23
gpsAdd support for Global Positioning System5
graphicsmagickBuild and link against GraphicsMagick instead of ImageMagick (requires USE=imagemagick if optional)12
graphvizAdd support for the Graphviz library11
gslUse the GNU scientific library for calculations14
gsmAdd support for the gsm lossy speech compression codec2
gstreamerAdd support for media-libs/gstreamer (Streaming media)32
gtkAdd support for x11-libs/gtk+ (The GIMP Toolkit)130
gtk-docBuild and install gtk-doc based developer documentation for dev-util/devhelp, IDE and offline use127
guiEnable support for a graphical user interface93
guileAdd support for the guile Scheme interpreter10
gzipCompress files with Lempel-Ziv coding (LZ77)3
handbookEnable handbooks generation for packages by KDE0
hardenedActivate default security enhancements for toolchain (gcc, glibc, binutils)34
hddtempEnable monitoring of hdd temperature (app-admin/hddtemp)5
hdf5Add support for the Hierarchical Data Format v525
headers-onlyInstall only C headers instead of whole package. Mainly used by sys-devel/crossdev for toolchain bootstrap.5
heifEnable support for ISO/IEC 23008-12:2017 HEIF/HEIC image format18
hscolourInclude coloured haskell sources to generated documentation (dev-haskell/hscolour)0
http2Enable support for the HTTP/2 protocol4
ibmAdd support for IBM ppc64 specific systems4
iconvEnable support for the iconv character set conversion library20
icuEnable ICU (Internationalization Components for Unicode) support, using dev-libs/icu26
idnEnable support for Internationalized Domain Names31
ieee1394Enable FireWire/iLink IEEE1394 support (dv, camera, ...)6
imagemagickEnable optional support for the ImageMagick or GraphicsMagick image converter22
imapAdd support for IMAP (Internet Mail Application Protocol)2
imlibAdd support for imlib, an image loading and rendering library7
infinibandEnable Infiniband RDMA transport support3
initramfsInclude kernel modules in the initramfs, and re-install the kernel (only effective for distribution kernels)0
inotifyEnable inotify filesystem monitoring support2
introspectionAdd support for GObject based introspection23
io-uringEnable the use of io_uring for efficient asynchronous IO and system requests9
iodbcAdd support for iODBC library9
iosEnable support for Apple's iDevice with iOS operating system (iPad, iPhone, iPod, etc)6
ipodEnable support for iPod device access4
ipv6Add support for IP version 689
jackAdd support for the JACK Audio Connection Kit88
javaAdd support for Java51
javascriptEnable javascript support5
jbigEnable jbig-kit support for tiff, Hylafax, ImageMagick, etc6
jemallocUse dev-libs/jemalloc for memory management20
jitEnable just-in-time compilation for improved performance. May prevent use of some PaX memory protection features in Gentoo Hardened.6
joystickAdd support for joysticks in all packages4
jpegAdd JPEG image support99
jpeg2kSupport for JPEG 2000, a wavelet-based image compression format19
jpegxlAdd JPEG XL image support20
kdeAdd support for software made by KDE, a free software community19
kerberosAdd kerberos support70
keyringEnable support for freedesktop.org Secret Service API password store28
ladspaEnable the ability to support ladspa plugins10
lameAdd support for MP3 encoding using LAME11
lapackAdd support for the virtual/lapack numerical library14
lashAdd LASH Audio Session Handler support10
latexAdd support for LaTeX (typesetting package)13
lcmsAdd lcms support (color management engine)24
ldapAdd LDAP support (Lightweight Directory Access Protocol)79
lercAdd LERC suppport (Limited Error Raster Compression)2
libassSRT/SSA/ASS (SubRip / SubStation Alpha) subtitle support3
libcacaAdd support for colored ASCII-art graphics7
libeditUse the libedit library (replacement for readline)21
libffiEnable support for Foreign Function Interface library1
libnotifyEnable desktop notification support40
libsamplerateBuild with support for converting sample rates using libsamplerate20
libwwwAdd libwww support (General purpose WEB API)2
lircAdd support for lirc (Linux's Infra-Red Remote Control)14
livecd!!internal use only!! DO NOT SET THIS FLAG YOURSELF!, used during livecd building7
llvm-libunwindUse llvm-runtimes/libunwind instead of sys-libs/libunwind16
lm-sensorsAdd linux lm-sensors (hardware sensors) support9
ltoEnable Link-Time Optimization (LTO) to optimize the build8
luaEnable Lua scripting support52
lz4Enable support for lz4 compression (as implemented in app-arch/lz4)27
lzipEnable support for lzip compression6
lzmaSupport for LZMA compression algorithm42
lzoEnable support for lzo compression22
m17n-libEnable m17n-lib support4
madAdd support for mad (high-quality mp3 decoder library and cli frontend)20
magicAdd support for file type detection via magic bytes (usually via libmagic from sys-apps/file)5
maildirAdd support for maildir (~/.maildir) style mail spools3
manBuild and install man pages35
matroskaAdd support for the matroska container format (extensions .mkv, .mka and .mks)1
mboxAdd support for mbox (/var/spool/mail) style mail spools6
memcachedAdd support for memcached7
mhashAdd support for the mhash library3
mikmodAdd libmikmod support to allow playing of SoundTracker-style music files8
milterAdd sendmail mail filter (milter) support2
minimalInstall a very minimal build (disables, for example, plugins, fonts, most drivers, non-critical features)167
mmapAdd mmap (memory map) support3
mmsSupport for Microsoft Media Server (MMS) streams6
mngAdd support for libmng (MNG images)7
modplugAdd libmodplug support for playing SoundTracker-style music files17
modulesBuild the kernel modules3
modules-compressInstall compressed kernel modules (if kernel config enables module compression)0
modules-signCryptographically sign installed kernel modules (requires CONFIG_MODULE_SIG=y in the kernel)0
monoBuild Mono bindings to support dotnet type stuff5
motifAdd support for the Motif toolkit12
mp3Add support for reading mp3 files39
mp4Support for MP4 container format8
mpegAdd libmpeg3 support to various packages3
mpiAdd MPI (Message Passing Interface) layer to the apps that support it61
mplayerEnable mplayer support for playback or encoding3
mssqlAdd support for Microsoft SQL Server database5
mtpEnable support for Media Transfer Protocol9
multilibOn 64bit systems, if you want to be able to compile 32bit and 64bit binaries5
musepackEnable support for the musepack audio codec15
musicbrainzLookup audio metadata using MusicBrainz community service (musicbrainz.org)3
mysqlAdd mySQL Database support125
mysqliAdd support for the improved mySQL libraries2
nasAdd support for network audio sound13
native-extensionsBuild native (e.g. C, Rust) extensions in addition to pure (e.g. Python) code (usually speedups)0
ncursesAdd ncurses support (console display library)72
neXtEnable neXt toolkit2
netcdfEnable NetCDF data format support9
networkmanagerEnable net-misc/networkmanager support19
nisSupport for NIS/YP services6
nlsAdd Native Language Support (using gettext - GNU locale utilities)450
nntpAdd support for newsgroups (Network News Transfer Protocol)3
nocdInstall all files required to run the application without a CD mounted1
nspluginBuild plugin for browsers supporting the Netscape plugin architecture (that is almost any modern browser)1
nvencAdd support for NVIDIA Encoder/Decoder (NVENC/NVDEC) API for hardware accelerated encoding and decoding on NVIDIA cards (requires x11-drivers/nvidia-drivers)4
ocamlAdd support/bindings for the Ocaml language5
ocamloptEnable ocamlopt support (ocaml native code compiler) -- Produces faster programs (Warning: you have to disable/enable it at a global scale)7
oci8Add Oracle 8 Database Support3
oci8-instant-clientUse dev-db/oracle-instantclient-basic as Oracle provider instead of requiring a full Oracle server install1
odbcAdd ODBC Support (Open DataBase Connectivity)34
offensiveEnable potentially offensive items in packages9
ofxEnable support for importing (and exporting) OFX (Open Financial eXchange) data files4
oggAdd support for the Ogg container format (commonly used by Vorbis, Theora and flac)19
openalAdd support for the Open Audio Library19
openclEnable OpenCL support (computation on GPU)26
openexrSupport for the OpenEXR graphics file format17
openglAdd support for OpenGL (3D graphics)103
openmpBuild support for the OpenMP (support parallel computing), requires >=sys-devel/gcc-4.2 built with USE="openmp"107
opentype-compatConvert BDF and PCF bitmap fonts to OTB wrapper format0
opusEnable Opus audio codec support30
oracleEnable Oracle Database support7
orcUse dev-lang/orc for just-in-time optimization of array operations2
oscEnable support for Open Sound Control9
ossAdd support for OSS (Open Sound System)65
otfInstall OpenType font versions1
pamAdd support for PAM (Pluggable Authentication Modules) - DANGEROUS to arbitrarily flip101
pchEnable precompiled header support for faster compilation at the expense of disk space and memory11
pcmciaAdd support for PCMCIA slots/devices found on laptop computers2
pcreAdd support for Perl Compatible Regular Expressions42
pdaAdd support for portable devices1
pdfAdd general support for PDF (Portable Document Format), this replaces the pdflib and cpdflib flags54
perlAdd optional support/bindings for the Perl language69
phpInclude support for the PHP language5
pieBuild programs as Position Independent Executables (a security hardening technique)3
plasmaBuild optional KDE plasma addons5
plotutilsAdd support for plotutils (library for 2-D vector graphics)3
pngAdd support for libpng (PNG images)110
policykitEnable PolicyKit (polkit) authentication support26
portaudioAdd support for the crossplatform portaudio audio API32
posixAdd support for POSIX-compatible functions1
postgresAdd support for the postgresql database123
postscriptEnable support for the PostScript language (often with ghostscript-gpl or libspectre)18
ppdsAdd support for automatically generated ppd (printing driver) files1
prefixDefines if a Gentoo Prefix offset installation is used4
profileAdd support for software performance analysis (will likely vary from ebuild to ebuild)17
pulseaudioAdd sound server support via media-libs/libpulse (may be PulseAudio or PipeWire)121
pythonAdd optional support/bindings for the Python language181
qdbmAdd support for the qdbm (Quick Database Manager) library3
qmail-sppAdd support for qmail SMTP plugins3
qt5Add support for the Qt 5 application and UI framework51
qt6Add support for the Qt 6 application and UI framework50
quicktimeAdd support for OpenQuickTime2
radiusAdd support for RADIUS authentication10
rawAdd support for raw image formats18
rdpEnables RDP/Remote Desktop support5
readlineEnable support for libreadline, a GNU line-editing library that almost everyone wants97
recodeEnable support for the GNU recode library1
rssEnable support for RSS feeds7
rubyAdd support/bindings for the Ruby language28
sambaAdd support for SAMBA (Windows File and Printer sharing)25
saslAdd support for the Simple Authentication and Security Layer51
savedconfigUse this to restore your config from /etc/portage/savedconfig ${CATEGORY}/${PN}. Make sure your USE flags allow for appropriate dependencies12
scannerAdd support for scanner hardware (e.g. build the sane frontend in kdegraphics)9
screencastEnable support for remote desktop and screen cast using PipeWire10
sctpSupport for Stream Control Transmission Protocol9
sdlAdd support for Simple Direct Layer (media library)65
seccompEnable seccomp (secure computing mode) to perform system call filtering at runtime to increase security of programs21
securebootAutomatically sign efi executables using user specified key0
selinux!!internal use only!! Security Enhanced Linux support, this must be set by the selinux profile or breakage will occur315
semantic-desktopCross-KDE support for semantic search and information retrieval5
sessionAdd persistent session support5
sidEnable SID (Commodore 64 audio) file support7
skeyEnable S/Key (Single use password) authentication support2
slangAdd support for the slang text display library (it's like ncurses, but different)9
smartcardEnable smartcard support14
smpEnable support for multiprocessors or multicore systems2
snappyEnable support for Snappy compression (as implemented in app-arch/snappy)5
sndfileAdd support for libsndfile21
snmpAdd support for the Simple Network Management Protocol if available30
soapAdd support for SOAP (Simple Object Access Protocol)1
socketsAdd support for tcp/ip sockets3
socks5Add support for the socks5 proxy9
soundEnable sound support17
sourceZip the sources and install them15
soxAdd support for Sound eXchange (SoX)7
speechEnable text-to-speech support23
speexAdd support for the speex audio codec (used for speech)16
spellAdd dictionary support28
split-usrEnable behavior to support maintaining /bin, /lib*, /sbin and /usr/sbin separately from /usr/bin and /usr/lib*20
sqliteAdd support for sqlite - embedded sql database81
sslAdd support for SSL/TLS connections (Secure Socket Layer / Transport Layer Security)218
startup-notificationEnable application startup event feedback mechanism11
static!!do not set this during bootstrap!! Causes binaries to be statically linked instead of dynamically112
static-libsBuild static versions of dynamic libraries as well628
stripAllow symbol stripping to be performed by the ebuild for special files0
subversionEnable subversion (version control system) support9
suidEnable setuid root program(s)22
svgAdd support for SVG (Scalable Vector Graphics)42
svgaAdd support for SVGAlib (graphics library)8
symlinkForce kernel ebuilds to automatically update the /usr/src/linux symlink7
syslogEnable support for syslog13
systemdEnable use of systemd-specific libraries and features like socket activation or session tracking242
szipUse the szip compression library6
taglibEnable tagging support with taglib16
tclAdd support the Tcl language29
tcmallocUse the dev-util/google-perftools libraries to replace the malloc() implementation with a possibly faster one15
tcpdAdd support for TCP wrappers45
telemetrySend anonymized usage information to upstream so they can better understand our users15
testEnable dependencies and/or preparations necessary to run tests (usually controlled by FEATURES=test but can be toggled independently)2567
test-installInstall testsuite for manual execution by the user2
test-rustEnable important test dependencies that require Rust toolchain18
theoraAdd support for the Theora Video Compression Codec11
threadsAdd threads support for various packages. Usually pthreads88
tidyAdd support for HTML Tidy1
tiffAdd support for the TIFF image format61
time64Use 64-bit time_t type instead of the regular 32-bit type. This flag is forced on time64 profiles, and masked elsewhere. It should be only used when detection of type width is not possible (e.g. for SRC_URI)0
timidityBuild with Timidity++ (MIDI sequencer) support8
tkAdd support for Tk GUI toolkit45
truetypeAdd support for FreeType and/or FreeType2 fonts49
ttfInstall TrueType font versions4
udevEnable virtual/udev integration (device discovery, power and storage device support, etc)44
udisksEnable storage management support (automounting, volume monitoring, etc)8
uefiEnable support for the Unified Extensible Firmware Interface8
unicodeAdd support for Unicode49
unwindAdd support for call stack unwinding and function name resolution22
upnpEnable UPnP port mapping support18
upnp-avEnable UPnP audio/video streaming support3
upowerEnable power management support9
usbAdd USB support to applications that have optional USB support (e.g. cups)36
v4lEnable support for video4linux (using linux-headers or userspace libv4l libraries)22
vaapiEnable Video Acceleration API for hardware decoding15
valaEnable bindings for dev-lang/vala53
valgrindEnable annotations for accuracy. May slow down runtime slightly. Safe to use even if not currently using dev-debug/valgrind48
vanillaDo not add extra patches which change default behaviour; DO NOT USE THIS ON A GLOBAL SCALE as the severity of the meaning changes drastically23
vcdVideo CD support4
vdpauEnable the Video Decode and Presentation API for Unix acceleration interface11
verify-sigVerify upstream signatures on distfiles92
vhostsAdd support for installing web-based applications into a virtual-hosting environment2
videosInstall optional video files (used in some games)5
vim-syntaxPulls in related vim syntax scripts22
vncEnable VNC (remote desktop viewer) support12
vorbisAdd support for the OggVorbis audio codec60
vpxAdd support for VP8/VP9 codecs (usually via media-libs/libvpx)11
vulkanAdd support for 3D graphics and computing via the Vulkan cross-platform API29
wavpackAdd support for wavpack audio compression tools19
waylandEnable dev-libs/wayland backend135
webkitAdd support for the WebKit HTML rendering/layout engine14
webpAdd support for the WebP image format39
wifiEnable wireless network functions7
wmfAdd support for the Windows Metafile vector image format4
wxwidgetsAdd support for wxWidgets/wxGTK GUI toolkit14
x264Enable h264 encoding using x26410
xattrAdd support for extended attributes (filesystem-stored metadata)28
xcbSupport the X C-language Binding, a replacement for Xlib2
xcompositeEnable support for the Xorg composite extension1
xemacsAdd support for XEmacs3
xfaceAdd xface support used to allow a small image of xface format to be included in an email via the header 'X-Face'4
xftBuild with support for XFT font renderer (x11-libs/libXft)14
xineAdd support for the XINE movie libraries1
xineramaAdd support for querying multi-monitor screen geometry through the Xinerama API43
xinetdAdd support for the xinetd super-server11
xmlAdd support for XML files42
xmlrpcSupport for xml-rpc library3
xmpEnable support for Extensible Metadata Platform (Adobe XMP)8
xmppEnable support for Extensible Messaging and Presence Protocol (XMPP) formerly known as Jabber3
xosdSends display using the X On Screen Display library2
xpmAdd support for XPM graphics format15
xscreensaverAdd support for XScreenSaver extension4
xvAdd in optional support for the Xvideo extension (an X API for video playback)10
xvidAdd support for xvid.org's open-source mpeg-4 codec2
zeroconfSupport for DNS Service Discovery (DNS-SD)39
zipEnable support for ZIP archives14
zlibAdd support for zlib compression119
zsh-completionEnable zsh completion support2
zstdEnable support for ZSTD compression54

back