gentoo.LinuxHowtos.org
USE-FlagDescriptionused
XAdd support for X11374
Xaw3dAdd support for the 3d athena widget set8
a52Enable support for decoding ATSC A/52 streams used in DVD6
aacEnable support for MPEG-4 AAC Audio20
aalibAdd support for media-libs/aalib (ASCII-Graphics Library)10
accessibilityAdd support for accessibility (eg 'at-spi' library)13
aclAdd support for Access Control Lists36
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)134
aoUse libao audio output library for sound playback14
apache2Add Apache2 support9
aquaInclude support for the Mac OS X Aqua (Carbon/Cocoa) GUI17
asmEnable using assembly for optimization1
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 applicable7
auditEnable support for Linux audit subsystem using sys-process/audit21
avifAdd AV1 Image Format (AVIF) support8
bash-completionEnable bash-completion support3
berkdbAdd support for sys-libs/db (Berkeley DB for MySQL)37
bidiEnable bidirectional language support11
big-endianBig-endian toolchain support10
bindistFlag to enable or disable options for prebuilt (GRP) packages (eg. due to licensing issues)7
blasAdd support for the virtual/blas numerical library7
bluetoothEnable Bluetooth Support35
brandingEnable Gentoo specific branding8
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 support52
cairoEnable support for the cairo graphics library22
calendarAdd support for calendars (not using mcal!)7
capsUse Linux capabilities library to control privilege37
cdbAdd support for the CDB database engine from the author of qmail4
cddaAdd Compact Disk Digital Audio (Standard Audio CD) support14
cddbAccess cddb servers to retrieve and submit information about compact disks6
cdinstallCopy files from the CD rather than asking the user to copy them, mostly used with games6
cdrAdd support for CD writer hardware9
cgiAdd CGI script support10
cjkAdd support for Multi-byte character languages (Chinese, Japanese, Korean)17
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 systems9
cracklibSupport for cracklib strong password checking7
cryptAdd support for encryption -- using mcrypt or gpg where applicable41
cssEnable reading of encrypted DVDs0
cudaEnable NVIDIA CUDA support (computation on GPU)39
cupsAdd support for CUPS (Common Unix Printing System)34
curlAdd support for client-side URL transfer library60
custom-cflagsBuild with user-specified CFLAGS (unsupported)22
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/Backtraces841
dedicatedAdd support for dedicated game servers (some packages do not provide clients and servers at the same time)22
dgaAdd DGA (Direct Graphic Access) support for X2
dist-kernelEnable subslot rebuilds on Distribution Kernel upgrades1
djvuSupport DjVu, a PDF-like document format esp. suited for scanned documents10
docAdd extra documentation (API, Javadoc, etc). It is recommended to enable per package instead of globally1199
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)10
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/elogind41
emacsAdd support for GNU Emacs88
embossAdd support for the European Molecular Biology Open Software Suite5
encodeAdd support for encoding of audio or video files4
examplesInstall examples, usually source code593
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) support9
fastcgiAdd support for the FastCGI interface6
fbconAdd framebuffer support for the console, via the kernel15
ffmpegEnable ffmpeg/libav-based audio/video codec support52
fftwUse FFTW library for computing Fourier transforms23
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 database7
flacAdd support for FLAC: Free Lossless Audio Codec52
fltkAdd support for the Fast Light Toolkit gui interface7
fontconfigSupport for configuring and customizing font access via media-libs/fontconfig9
fortranAdd support for fortran30
freetdsAdd support for the TDS protocol to connect to MSSQL/Sybase databases2
freewnnAdd support for FreeWnn kana to kanji conversion engine2
ftpAdd FTP (File Transfer Protocol) support4
gdAdd support for media-libs/gd (to generate graphics on the fly)15
gdbmAdd support for sys-libs/gdbm (GNU database libraries)26
geoipAdd geoip support for country and city lookup based on IPs23
geolocationEnable physical position determination8
ggiAdd support for media-libs/libggi (non-X video api/drivers)2
gifAdd GIF image support35
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)13
gles2-onlyUse GLES 2.0 (OpenGL for Embedded Systems) or later instead of full OpenGL (see also: gles2)28
glutBuild an OpenGL plugin using the GLUT library6
gmpAdd support for dev-libs/gmp (GNU MP library)19
gnomeAdd GNOME support25
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)76
gphoto2Add digital camera support7
gpmAdd support for sys-libs/gpm (Console-based mouse driver)24
gpsAdd support for Global Positioning System6
graphicsmagickBuild and link against GraphicsMagick instead of ImageMagick (requires USE=imagemagick if optional)13
graphvizAdd support for the Graphviz library11
gslUse the GNU scientific library for calculations15
gsmAdd support for the gsm lossy speech compression codec2
gstreamerAdd support for media-libs/gstreamer (Streaming media)34
gtkAdd support for x11-libs/gtk+ (The GIMP Toolkit)135
gtk-docBuild and install gtk-doc based developer documentation for dev-util/devhelp, IDE and offline use121
guiEnable support for a graphical user interface73
guileAdd support for the guile Scheme interpreter11
gzipCompress files with Lempel-Ziv coding (LZ77)3
handbookEnable handbooks generation for packages by KDE0
hardenedActivate default security enhancements for toolchain (gcc, glibc, binutils)37
hddtempEnable monitoring of hdd temperature (app-admin/hddtemp)5
hdf5Add support for the Hierarchical Data Format v524
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 format17
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 Names32
ieee1394Enable FireWire/iLink IEEE1394 support (dv, camera, ...)7
imagemagickEnable optional support for the ImageMagick or GraphicsMagick image converter23
imapAdd support for IMAP (Internet Mail Application Protocol)1
imlibAdd support for imlib, an image loading and rendering library7
infinibandEnable Infiniband RDMA transport support3
inotifyEnable inotify filesystem monitoring support2
introspectionAdd support for GObject based introspection22
iodbcAdd support for iODBC library10
iosEnable support for Apple's iDevice with iOS operating system (iPad, iPhone, iPod, etc)7
ipodEnable support for iPod device access3
ipv6Add support for IP version 6113
jackAdd support for the JACK Audio Connection Kit85
javaAdd support for Java54
javascriptEnable javascript support6
jbigEnable jbig-kit support for tiff, Hylafax, ImageMagick, etc6
jemallocUse dev-libs/jemalloc for memory management19
jitEnable just-in-time compilation for improved performance. May prevent use of some PaX memory protection features in Gentoo Hardened.7
joystickAdd support for joysticks in all packages6
jpegAdd JPEG image support99
jpeg2kSupport for JPEG 2000, a wavelet-based image compression format17
jpegxlAdd JPEG XL image support15
kdeAdd support for software made by KDE, a free software community26
kerberosAdd kerberos support69
keyringEnable support for freedesktop.org Secret Service API password store30
ladspaEnable the ability to support ladspa plugins10
lamePrefer using LAME libraries for MP3 encoding support10
lapackAdd support for the virtual/lapack numerical library16
lashAdd LASH Audio Session Handler support11
latexAdd support for LaTeX (typesetting package)14
lcmsAdd lcms support (color management engine)22
ldapAdd LDAP support (Lightweight Directory Access Protocol)81
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 libsamplerate19
libwwwAdd libwww support (General purpose WEB API)2
lircAdd support for lirc (Linux's Infra-Red Remote Control)15
livecd!!internal use only!! DO NOT SET THIS FLAG YOURSELF!, used during livecd building7
llvm-libunwindUse sys-libs/llvm-libunwind instead of sys-libs/libunwind15
lm-sensorsAdd linux lm-sensors (hardware sensors) support11
ltoEnable Link-Time Optimization (LTO) to optimize the build11
luaEnable Lua scripting support51
lz4Enable support for lz4 compression (as implemented in app-arch/lz4)28
lzipEnable support for lzip compression6
lzmaSupport for LZMA compression algorithm37
lzoEnable support for lzo compression20
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)6
maildirAdd support for maildir (~/.maildir) style mail spools3
manBuild and install man pages32
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)171
mmapAdd mmap (memory map) support4
mmsSupport for Microsoft Media Server (MMS) streams6
mngAdd support for libmng (MNG images)7
modplugAdd libmodplug support for playing SoundTracker-style music files15
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 stuff6
motifAdd support for the Motif toolkit12
mp3Add support for reading mp3 files40
mp4Support for MP4 container format7
mpegAdd libmpeg3 support to various packages3
mpiAdd MPI (Message Passing Interface) layer to the apps that support it60
mplayerEnable mplayer support for playback or encoding3
mssqlAdd support for Microsoft SQL Server database6
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 codec14
musicbrainzLookup audio metadata using MusicBrainz community service (musicbrainz.org)3
mysqlAdd mySQL Database support132
mysqliAdd support for the improved mySQL libraries3
nasAdd support for network audio sound14
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)81
neXtEnable neXt toolkit2
netcdfEnable NetCDF data format support9
networkmanagerEnable net-misc/networkmanager support21
nisSupport for NIS/YP services6
nlsAdd Native Language Support (using gettext - GNU locale utilities)464
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)5
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)5
oci8Add Oracle 8 Database Support4
oci8-instant-clientUse dev-db/oracle-instantclient-basic as Oracle provider instead of requiring a full Oracle server install2
odbcAdd ODBC Support (Open DataBase Connectivity)33
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)18
openalAdd support for the Open Audio Library21
openclEnable OpenCL support (computation on GPU)27
openexrSupport for the OpenEXR graphics file format19
openglAdd support for OpenGL (3D graphics)109
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 support27
oracleEnable Oracle Database support10
orcUse dev-lang/orc for just-in-time optimization of array operations2
oscEnable support for Open Sound Control11
ossAdd support for OSS (Open Sound System)71
otfInstall OpenType font versions1
pamAdd support for PAM (Pluggable Authentication Modules) - DANGEROUS to arbitrarily flip100
pchEnable precompiled header support for faster compilation at the expense of disk space and memory10
pcmciaAdd support for PCMCIA slots/devices found on laptop computers2
pcreAdd support for Perl Compatible Regular Expressions43
pdaAdd support for portable devices1
pdfAdd general support for PDF (Portable Document Format), this replaces the pdflib and cpdflib flags52
perlAdd optional support/bindings for the Perl language71
phpInclude support for the PHP language7
pieBuild programs as Position Independent Executables (a security hardening technique)4
plasmaBuild optional KDE plasma addons6
plotutilsAdd support for plotutils (library for 2-D vector graphics)3
pngAdd support for libpng (PNG images)111
policykitEnable PolicyKit (polkit) authentication support24
portaudioAdd support for the crossplatform portaudio audio API32
posixAdd support for POSIX-compatible functions1
postgresAdd support for the postgresql database129
postscriptEnable support for the PostScript language (often with ghostscript-gpl or libspectre)17
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)19
pulseaudioAdd sound server support via media-libs/libpulse (may be PulseAudio or PipeWire)126
pythonAdd optional support/bindings for the Python language185
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 framework92
qt6Add support for the Qt 6 application and UI framework83
quicktimeAdd support for OpenQuickTime2
radiusAdd support for RADIUS authentication11
rawAdd support for raw image formats18
rdpEnables RDP/Remote Desktop support4
readlineEnable support for libreadline, a GNU line-editing library that almost everyone wants94
recodeEnable support for the GNU recode library1
rssEnable support for RSS feeds6
rubyAdd support/bindings for the Ruby language28
sambaAdd support for SAMBA (Windows File and Printer sharing)26
saslAdd support for the Simple Authentication and Security Layer50
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 PipeWire8
sctpSupport for Stream Control Transmission Protocol9
sdlAdd support for Simple Direct Layer (media library)64
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 occur311
semantic-desktopCross-KDE support for semantic search and information retrieval6
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)10
smartcardEnable smartcard support13
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 available31
soapAdd support for SOAP (Simple Object Access Protocol)1
socketsAdd support for tcp/ip sockets4
socks5Add support for the socks5 proxy10
soundEnable sound support14
sourceZip the sources and install them16
soxAdd support for Sound eXchange (SoX)7
speechEnable text-to-speech support27
speexAdd support for the speex audio codec (used for speech)17
spellAdd dictionary support30
split-usrEnable behavior to support maintaining /bin, /lib*, /sbin and /usr/sbin separately from /usr/bin and /usr/lib*24
sqliteAdd support for sqlite - embedded sql database87
sslAdd support for SSL/TLS connections (Secure Socket Layer / Transport Layer Security)223
startup-notificationEnable application startup event feedback mechanism11
static!!do not set this during bootstrap!! Causes binaries to be statically linked instead of dynamically113
static-libsBuild static versions of dynamic libraries as well646
stripAllow symbol stripping to be performed by the ebuild for special files0
subversionEnable subversion (version control system) support8
suidEnable setuid root program(s)23
svgAdd support for SVG (Scalable Vector Graphics)45
svgaAdd support for SVGAlib (graphics library)9
symlinkForce kernel ebuilds to automatically update the /usr/src/linux symlink4
syslogEnable support for syslog14
systemdEnable use of systemd-specific libraries and features like socket activation or session tracking233
szipUse the szip compression library5
taglibEnable tagging support with taglib18
tclAdd support the Tcl language30
tcmallocUse the dev-util/google-perftools libraries to replace the malloc() implementation with a possibly faster one14
tcpdAdd support for TCP wrappers43
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)2378
test-rustEnable important test dependencies that require Rust toolchain14
theoraAdd support for the Theora Video Compression Codec11
threadsAdd threads support for various packages. Usually pthreads95
tidyAdd support for HTML Tidy1
tiffAdd support for the TIFF image format63
timidityBuild with Timidity++ (MIDI sequencer) support8
tkAdd support for Tk GUI toolkit49
truetypeAdd support for FreeType and/or FreeType2 fonts53
ttfInstall TrueType font versions4
udevEnable virtual/udev integration (device discovery, power and storage device support, etc)43
udisksEnable storage management support (automounting, volume monitoring, etc)12
uefiEnable support for the Unified Extensible Firmware Interface8
unicodeAdd support for Unicode53
unwindAdd support for call stack unwinding and function name resolution21
upnpEnable UPnP port mapping support22
upnp-avEnable UPnP audio/video streaming support3
upowerEnable power management support10
usbAdd USB support to applications that have optional USB support (e.g. cups)35
v4lEnable support for video4linux (using linux-headers or userspace libv4l libraries)25
vaapiEnable Video Acceleration API for hardware decoding17
valaEnable bindings for dev-lang/vala49
valgrindEnable annotations for accuracy. May slow down runtime slightly. Safe to use even if not currently using dev-debug/valgrind47
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 interface12
verify-sigVerify upstream signatures on distfiles72
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 scripts24
vncEnable VNC (remote desktop viewer) support12
vorbisAdd support for the OggVorbis audio codec62
vulkanAdd support for 3D graphics and computing via the Vulkan cross-platform API28
wavpackAdd support for wavpack audio compression tools19
waylandEnable dev-libs/wayland backend114
webkitAdd support for the WebKit HTML rendering/layout engine14
webpAdd support for the WebP image format37
wifiEnable wireless network functions7
wmfAdd support for the Windows Metafile vector image format4
wxwidgetsAdd support for wxWidgets/wxGTK GUI toolkit14
x264Enable h264 encoding using x2648
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 libraries2
xineramaAdd support for querying multi-monitor screen geometry through the Xinerama API44
xinetdAdd support for the xinetd super-server12
xmlAdd support for XML files44
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 Jabber5
xosdSends display using the X On Screen Display library2
xpmAdd support for XPM graphics format15
xscreensaverAdd support for XScreenSaver extension5
xvAdd in optional support for the Xvideo extension (an X API for video playback)11
xvidAdd support for xvid.org's open-source mpeg-4 codec2
zeroconfSupport for DNS Service Discovery (DNS-SD)42
zipEnable support for ZIP archives14
zlibAdd support for zlib compression122
zsh-completionEnable zsh completion support1
zstdEnable support for ZSTD compression48

back