gentoo.LinuxHowtos.org
USE-FlagDescriptionused
3dfxEnable support for Voodoo chipsets, also called as 3DFX and TDFX3
XAdd support for X11304
Xaw3dAdd support for the 3d athena widget set9
a52Enable support for decoding ATSC A/52 streams used in DVD7
aacEnable support for MPEG-4 AAC Audio27
aalibAdd support for media-libs/aalib (ASCII-Graphics Library)13
accessibilityAdd support for accessibility (eg 'at-spi' library)7
aclAdd support for Access Control Lists48
acpiAdd support for Advanced Configuration and Power Interface4
adnsAdd support for asynchronous DNS resolution6
afsAdd OpenAFS support (distributed file system)7
aimEnable AIM IM protocol support0
alsaAdd support for media-libs/alsa-lib (Advanced Linux Sound Architecture)150
altivecAdd support for optimizations for G4 and G5/ppc970 processors22
aoUse libao audio output library for sound playback16
apache2Add Apache2 support12
apmAdd APM (Advanced Power Management) support3
aquaInclude support for the Mac OS X Aqua (Carbon/Cocoa) GUI18
atmEnable Asynchronous Transfer Mode protocol support7
audiofileAdd support for libaudiofile where applicable9
auditEnable support for Linux audit subsystem using sys-process/audit18
avahiAdd avahi/Zeroconf support5
ayatanaBuild in support for Ayatana notification using the libindicate or libappindicator plugin11
bash-completionEnable bash-completion support5
bcmathAdd support for libbcmath1
berkdbAdd support for sys-libs/db (Berkeley DB for MySQL)41
bidiEnable bidirectional language support14
big-endianBig-endian toolchain support2
bindistFlag to enable or disable options for prebuilt (GRP) packages (eg. due to licensing issues)20
blasAdd support for the virtual/blas numerical library8
bluetoothEnable Bluetooth Support33
bootstrap!!internal use only!! DO NOT SET THIS FLAG YOURSELF!, used during original system bootstrapping [make stage2]4
boundscheckingAdd the bounds checking patch by Haj Ten Brugge, this will DISABLE the hardened PIE+SSP patches0
brandingEnable Gentoo specific branding9
bsfEnable support for Apache Bean Scripting Framework (dev-java/bsf)0
build!!internal use only!! DO NOT SET THIS FLAG YOURSELF!, used for creating build images and the first half of bootstrapping [make stage1]12
bzip2Use the bzlib compression library55
cairoEnable support for the cairo graphics library35
calendarAdd support for calendars (not using mcal!)6
cannaAdd support for the Canna kana to kanji conversion engine5
capsUse Linux capabilities library to control privilege30
cdbAdd support for the CDB database engine from the author of qmail3
cddaAdd Compact Disk Digital Audio (Standard Audio CD) support14
cddbAccess cddb servers to retrieve and submit information about compact disks11
cdinstallCopy files from the CD rather than asking the user to copy them, mostly used with games13
cdparanoiaEnable cdparanoia (audio CD ripper) support4
cdrAdd support for CD writer hardware8
cgiAdd CGI script support11
cjkAdd support for Multi-byte character languages (Chinese, Japanese, Korean)20
clamavAdd support for Clam AntiVirus software (usually with a plugin)12
connmanAdd support for net-misc/connman5
coreaudioBuild the CoreAudio driver on Mac OS X systems7
cracklibSupport for cracklib strong password checking8
cryptAdd support for encryption -- using mcrypt or gpg where applicable60
cscopeEnable cscope interface -- in vim for example2
cssEnable reading of encrypted DVDs2
ctypeEnable ctype functions0
cupsAdd support for CUPS (Common Unix Printing System)36
curlAdd support for client-side URL transfer library60
custom-cflagsBuild with user-specified CFLAGS (unsupported)29
cvsEnable CVS (Concurrent Versions System) integration9
cxxBuild support for C++ (bindings, extra libraries, code generation, ...)32
dbiEnable dev-db/libdbi (database-independent abstraction layer) support7
dbmAdd support for generic DBM databases2
dbusEnable dbus support for anything that needs it (gpsd, gnomemeeting, etc)100
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/Backtraces1174
dedicatedAdd support for dedicated game servers (some packages do not provide clients and servers at the same time)74
dgaAdd DGA (Direct Graphic Access) support for X7
directfbAdd support for DirectFB layer (library for FB devices)12
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 globally1770
driEnable direct rendering: used for accelerated 3D and some 2D, like DMA6
dtsEnable DTS Coherent Acoustics decoder support6
dvEnable support for a codec used by many camcorders5
dvbAdd support for DVB (Digital Video Broadcasting)9
dvdAdd support for DVDs11
dvdrAdd support for DVD writer hardware (e.g. in xcdroast)4
edsEnable support for Evolution-Data-Server (EDS)8
emacsAdd support for GNU Emacs96
embossAdd support for the European Molecular Biology Open Software Suite6
encodeAdd support for encoding of audio or video files6
enscriptAdd enscript support to colourize code stored in the repository1
evoAdd support for mail-client/evolution1
examplesInstall examples, usually source code867
exifAdd support for reading EXIF headers from JPEG and TIFF images32
expatEnable the use of dev-libs/expat for XML parsing14
famEnable FAM (File Alteration Monitor) support12
fastcgiAdd support for the FastCGI interface8
fbconAdd framebuffer support for the console, via the kernel24
ffmpegEnable ffmpeg/libav-based audio/video codec support51
fftwUse FFTW library for computing Fourier transforms31
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 database8
flacAdd support for FLAC: Free Lossless Audio Codec61
flatfileAdd dbm support for flat files2
fltkAdd support for the Fast Light Toolkit gui interface9
fontconfigSupport for configuring and customizing font access via media-libs/fontconfig9
foomaticdbAdd support for the foomatic printing driver database1
fortranAdd support for fortran32
freetdsAdd support for the TDS protocol to connect to MSSQL/Sybase databases4
freewnnAdd support for FreeWnn kana to kanji conversion engine4
ftpAdd FTP (File Transfer Protocol) support6
gcjEnable building with gcj (The GNU Compiler for the Javatm Programming Language)0
gdAdd support for media-libs/gd (to generate graphics on the fly)15
gdbmAdd support for sys-libs/gdbm (GNU database libraries)29
geoipAdd geoip support for country and city lookup based on IPs28
geolocationEnable physical position determination4
ggiAdd support for media-libs/libggi (non-X video api/drivers)4
gifAdd GIF image support41
gimpBuild a plugin for the GIMP10
gitEnable git (version control system) support14
glutBuild an OpenGL plugin using the GLUT library6
gmpAdd support for dev-libs/gmp (GNU MP library)27
gnomeAdd GNOME support75
gnome-keyringEnable support for storing passwords via gnome-keyring29
gnuplotEnable support for gnuplot (data and function plotting)10
gnutlsAdd support for net-libs/gnutls (TLS 1.0 and SSL 3.0 support)70
gphoto2Add digital camera support10
gpmAdd support for sys-libs/gpm (Console-based mouse driver)29
gpsAdd support for Global Positioning System8
graphicsmagickBuild and link against GraphicsMagick instead of ImageMagick (might require USE=imagemagick if optional)11
graphvizAdd support for the Graphviz library13
gslUse the GNU scientific library for calculations17
gsmAdd support for the gsm lossy speech compression codec13
gstreamerAdd support for media-libs/gstreamer (Streaming media)44
gtkAdd support for x11-libs/gtk+ (The GIMP Toolkit)209
guileAdd support for the guile Scheme interpreter13
gzipCompress files with Lempel-Ziv coding (LZ77)5
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)6
hdf5Add support for the Hierarchical Data Format v522
hscolourInclude coloured haskell sources to generated documentation (dev-haskell/hscolour)0
ibmAdd support for IBM ppc64 specific systems4
iconvEnable support for the iconv character set conversion library27
icqEnable ICQ IM protocol support2
icuEnable ICU (Internationalization Components for Unicode) support, using dev-libs/icu19
idnEnable support for Internationalized Domain Names33
ieee1394Enable FireWire/iLink IEEE1394 support (dv, camera, ...)10
imagemagickEnable optional support for the ImageMagick or GraphicsMagick image converter36
imapAdd support for IMAP (Internet Mail Application Protocol)3
imlibAdd support for imlib, an image loading and rendering library11
infinibandEnable Infiniband RDMA transport support6
inifileAdd dbm support for .ini files1
inotifyEnable inotify filesystem monitoring support6
introspectionAdd support for GObject based introspection16
iodbcAdd support for iODBC library10
iosEnable support for Apple's iDevice with iOS operating system (iPad, iPhone, iPod, etc)5
ipodEnable support for iPod device access8
ipv6Add support for IP version 6245
iwmmxtAdd support for optimizations for ARM iwMMXt instructions1
jackAdd support for the JACK Audio Connection Kit79
javaAdd support for Java74
javascriptEnable javascript support13
jbigEnable jbig-kit support for tiff, Hylafax, ImageMagick, etc5
jingleEnable voice calls for jabber2
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 packages11
jpegAdd JPEG image support117
jpeg2kSupport for JPEG 2000, a wavelet-based image compression format35
kdeAdd support for KDE (K Desktop Environment)29
kerberosAdd kerberos support77
kontactEnable support for the KDE personal information manager (kde-apps/kdepim*)0
ladspaEnable the ability to support ladspa plugins8
lamePrefer using LAME libraries for MP3 encoding support11
lapackAdd support for the virtual/lapack numerical library20
lashAdd LASH Audio Session Handler support13
latexAdd support for LaTeX (typesetting package)23
lcmsAdd lcms support (color management engine)19
ldapAdd LDAP support (Lightweight Directory Access Protocol)108
libassSRT/SSA/ASS (SubRip / SubStation Alpha) subtitle support4
libavPrefer libav over ffmpeg whenever both are supported69
libcacaAdd support for colored ASCII-art graphics9
libeditUse the libedit library (replacement for readline)16
libffiEnable support for Foreign Function Interface library3
libnotifyEnable desktop notification support62
libresslUse dev-libs/libressl as SSL provider (might need ssl USE flag), packages should not depend on this USE flag326
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)26
livecd!!internal use only!! DO NOT SET THIS FLAG YOURSELF!, used during livecd building7
lm_sensorsAdd linux lm_sensors (hardware sensors) support8
luaEnable Lua scripting support55
lzmaSupport for LZMA (de)compression algorithm28
lzoEnable support for lzo compression19
m17n-libEnable m17n-lib support5
madAdd support for mad (high-quality mp3 decoder library and cli frontend)23
maildirAdd support for maildir (~/.maildir) style mail spools3
matroskaAdd support for the matroska container format (extensions .mkv, .mka and .mks)3
mboxAdd support for mbox (/var/spool/mail) style mail spools7
memcachedAdd support for memcached9
memlimitAdd memory usage limiting in supporting programs1
mhashAdd support for the mhash library4
migemoEnable migemo support for Japanese1
mikmodAdd libmikmod support to allow playing of SoundTracker-style music files10
milterAdd sendmail mail filter (milter) support2
mimeAdd MIME support1
minimalInstall a very minimal build (disables, for example, plugins, fonts, most drivers, non-critical features)180
mmapAdd mmap (memory map) support4
mmsSupport for Microsoft Media Server (MMS) streams9
mngAdd support for libmng (MNG images)12
modplugAdd libmodplug support for playing SoundTracker-style music files16
modulesBuild the kernel modules7
monoBuild Mono bindings to support dotnet type stuff13
motifAdd support for the Motif toolkit16
mozillaAdd support for the Mozilla web-browser1
mp3Add support for reading mp3 files56
mp4Support for MP4 container format11
mpegAdd libmpeg3 support to various packages8
mpiAdd MPI (Message Passing Interface) layer to the apps that support it61
mplayerEnable mplayer support for playback or encoding7
msnEnable MSN Messenger IM protocol support3
mssqlAdd support for Microsoft SQL Server database9
mtpEnable support for Media Transfer Protocol9
muleAdd multi-language support to XEmacs2
multilibOn 64bit systems, if you want to be able to compile 32bit and 64bit binaries13
musepackEnable support for the musepack audio codec15
musicbrainzLookup audio metadata using MusicBrainz community service (musicbrainz.org)5
mysqlAdd mySQL Database support165
mysqliAdd support for the improved mySQL libraries3
nasAdd support for network audio sound14
ncursesAdd ncurses support (console display library)91
neXtEnable neXt toolkit3
neonEnable optimization support for ARM NEON processors16
netbootEnable network booting1
netcdfEnable NetCDF data format support9
networkmanagerEnable net-misc/networkmanager support17
nisSupport for NIS/YP services12
nlsAdd Native Language Support (using gettext - GNU locale utilities)574
nntpAdd support for newsgroups (Network News Transfer Protocol)6
nocdInstall all files required to run the application without a CD mounted3
nptlEnable support for Native POSIX Threads Library, the new threading module (requires linux-2.6 or better usually)2
nspluginBuild plugin for browsers supporting the Netscape plugin architecture (that is almost any modern browser)17
ocamlAdd support/bindings for the Ocaml language7
ocamloptEnable ocamlopt support (ocaml native code compiler) -- Produces faster programs (Warning: you have to disable/enable it at a global scale)0
oci8Add Oracle 8 Database Support4
oci8-instant-clientUse dev-db/oracle-instantclient-basic as Oracle provider instead of requiring a full Oracle server install3
odbcAdd ODBC Support (Open DataBase Connectivity)41
offensiveEnable potentially offensive items in packages16
ofxEnable support for importing (and exporting) OFX (Open Financial eXchange) data files5
oggAdd support for the Ogg container format (commonly used by Vorbis, Theora and flac)20
openalAdd support for the Open Audio Library25
openexrSupport for the OpenEXR graphics file format21
openglAdd support for OpenGL (3D graphics)173
openmpBuild support for the OpenMP (support parallel computing), requires >=sys-devel/gcc-4.2 built with USE="openmp"83
oracleEnable Oracle Database support13
orcUse dev-lang/orc for just-in-time optimization of array operations0
oscEnable support for Open Sound Control8
oscarEnable Oscar (AIM/ICQ) IM protocol support4
ossAdd support for OSS (Open Sound System)92
pamAdd support for PAM (Pluggable Authentication Modules) - DANGEROUS to arbitrarily flip117
pchEnable precompiled header support for faster compilation at the expense of disk space and memory (>=sys-devel/gcc-3.4 only)14
pcmciaAdd support for PCMCIA slots/devices found on laptop computers2
pcntlAdd support for process creation functions1
pcreAdd support for Perl Compatible Regular Expressions38
pdaAdd support for portable devices3
pdfAdd general support for PDF (Portable Document Format), this replaces the pdflib and cpdflib flags38
perlAdd optional support/bindings for the Perl language90
phpInclude support for the PHP language13
pieBuild programs as Position Independent Executables (a security hardening technique)1
plasmaBuild optional KDE plasma addons3
plotutilsAdd support for plotutils (library for 2-D vector graphics)2
pngAdd support for libpng (PNG images)115
policykitEnable PolicyKit authentication support24
portaudioAdd support for the crossplatform portaudio audio API30
posixAdd support for POSIX-compatible functions2
postgresAdd support for the postgresql database157
postscriptEnable support for the PostScript language (often with ghostscript-gpl or libspectre)20
ppdsAdd support for automatically generated ppd (printing driver) files1
prefixDefines if a Gentoo Prefix offset installation is used6
preludeAdd support/bindings for the Prelude Intrusion Detection System2
profileAdd support for software performance analysis (will likely vary from ebuild to ebuild)17
pulseaudioAdd support for PulseAudio sound server114
pythonAdd optional support/bindings for the Python language232
qdbmAdd support for the qdbm (Quick Database Manager) library3
qmail-sppAdd support for qmail SMTP plugins3
qt4Add support for the Qt GUI/Application Toolkit version 4.x92
qt5Add support for the Qt 5 application and UI framework82
quicktimeAdd support for OpenQuickTime4
radiusAdd support for RADIUS authentication10
rawAdd support for raw image formats16
rdpEnables RDP/Remote Desktop support5
readlineEnable support for libreadline, a GNU line-editing library that almost everyone wants102
recodeEnable support for the GNU recode library2
rssEnable support for RSS feeds8
rubyAdd support/bindings for the Ruby language40
sambaAdd support for SAMBA (Windows File and Printer sharing)41
saslAdd support for the Simple Authentication and Security Layer58
savedconfigUse this to restore your config from /etc/portage/savedconfig ${CATEGORY}/${PN}. Make sure your USE flags allow for appropriate dependencies7
scannerAdd support for scanner hardware (e.g. build the sane frontend in kdegraphics)15
sctpSupport for Stream Control Transmission Protocol6
sdlAdd support for Simple Direct Layer (media library)78
seamonkeyAdd support for the Seamonkey web-browser1
seccompEnable seccomp (secure computing mode) to perform system call filtering at runtime to increase security of programs15
selinux!!internal use only!! Security Enhanced Linux support, this must be set by the selinux profile or breakage will occur225
semantic-desktopCross-KDE support for semantic search and information retrieval7
sessionAdd persistent session support9
sharedmemAdd support for shared memory use1
shortenAdd support for the shorten audio compressor1
simplexmlSupport for SimpleXML0
skeyEnable S/Key (Single use password) authentication support4
slangAdd support for the slang text display library (it's like ncurses, but different)12
slpAdd Service Locator Protocol support6
smartcardEnable smartcard support14
smpEnable support for multiprocessors or multicore systems6
sndfileAdd support for libsndfile27
snmpAdd support for the Simple Network Management Protocol if available35
soapAdd support for SOAP (Simple Object Access Protocol)5
socketsAdd support for tcp/ip sockets3
socks5Add support for the socks5 proxy12
soundEnable sound support17
sourceZip the sources and install them33
soxAdd support for Sound eXchange (SoX)7
speexAdd support for the speex audio codec (used for speech)21
spellAdd dictionary support50
sqliteAdd support for sqlite - embedded sql database114
sslAdd support for Secure Socket Layer connections290
startup-notificationEnable application startup event feedback mechanism14
static!!do not set this during bootstrap!! Causes binaries to be statically linked instead of dynamically163
static-libsBuild static versions of dynamic libraries as well1207
subversionEnable subversion (version control system) support18
suidEnable setuid root program, with potential security risks18
svgAdd support for SVG (Scalable Vector Graphics)47
svgaAdd support for SVGAlib (graphics library)14
sybaseAdd support for the Sybase SQL Database Server1
sybase-ctAdd support for Sybase-CT1
symlinkForce kernel ebuilds to automatically update the /usr/src/linux symlink8
syslogEnable support for syslog18
systemdEnable use of systemd-specific libraries and features like socket activation or session tracking106
sysvipcSupport for System V-compatible inter-process communication1
szipUse the szip compression library5
taglibEnable tagging support with taglib17
tclAdd support the Tcl language43
tcmallocUse the dev-util/google-perftools libraries to replace the malloc() implementation with a possibly faster one12
tcpdAdd support for TCP wrappers51
testWorkaround 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 anymore2938
theoraAdd support for the Theora Video Compression Codec21
threadsAdd threads support for various packages. Usually pthreads131
tidyAdd support for HTML Tidy5
tiffAdd support for the TIFF image format77
timidityBuild with Timidity++ (MIDI sequencer) support8
tkAdd support for Tk GUI toolkit65
tokenizerAdd support for the PHP file parser0
truetypeAdd support for FreeType and/or FreeType2 fonts69
uclibcEnable uclibc specific patches and build or link uclibc2
udevEnable virtual/udev integration (device discovery, power and storage device support, etc)35
udisksEnable storage management support (automounting, volume monitoring, etc)7
unicodeAdd support for Unicode81
unwindAdd support for call stack unwinding and function name resolution12
upnpEnable UPnP port mapping support23
upnp-avEnable UPnP audio/video streaming support4
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)36
vaapiEnable Video Acceleration API for hardware decoding18
valaEnable bindings for dev-lang/vala44
vanillaDo not add extra patches which change default behaviour; DO NOT USE THIS ON A GLOBAL SCALE as the severity of the meaning changes drastically22
vcdVideo CD support8
vdpauEnable the Video Decode and Presentation API for Unix acceleration interface17
vhostsAdd support for installing web-based applications into a virtual-hosting environment4
videosInstall optional video files (used in some games)8
vim-syntaxPulls in related vim syntax scripts45
vncEnable VNC (remote desktop viewer) support11
vorbisAdd support for the OggVorbis audio codec80
wavpackAdd support for wavpack audio compression tools20
waylandEnable dev-libs/wayland backend37
wddxAdd support for Web Distributed Data eXchange1
webkitAdd support for the WebKit HTML rendering/layout engine30
webpAdd support for the WebP image format27
wifiEnable wireless network functions6
wmfAdd support for the Windows Metafile vector image format6
wxwidgetsAdd support for wxWidgets/wxGTK GUI toolkit16
x264Enable h264 encoding using x26412
xattrAdd support for extended attributes (filesystem-stored metadata)28
xcbSupport the X C-language Binding, a replacement for Xlib3
xcompositeEnable support for the Xorg composite extension3
xemacsAdd support for XEmacs4
xfaceAdd xface support used to allow a small image of xface format to be included in an email via the header 'X-Face'6
xftBuild with support for XFT font renderer (x11-libs/libXft)15
xineAdd support for the XINE movie libraries7
xineramaAdd support for the xinerama X11 extension, which is mandatory if you work in multiple monitors setup54
xinetdAdd support for the xinetd super-server22
xmlAdd support for XML files61
xmlrpcSupport for xml-rpc library7
xmpEnable support for Extensible Metadata Platform (Adobe XMP)9
xmppEnable support for Extensible Messaging and Presence Protocol (XMPP) formerly known as Jabber11
xosdSends display using the X On Screen Display library5
xpmAdd support for XPM graphics format16
xscreensaverAdd support for XScreenSaver extension7
xvAdd in optional support for the Xvideo extension (an X API for video playback)13
xvidAdd support for xvid.org's open-source mpeg-4 codec9
yahooEnable Yahoo Messenger IM protocol support4
yazAdd in optional support for the Z39.50 Protocol for Information Retrieval (YAZ)1
zeroconfSupport for DNS Service Discovery (DNS-SD)45
zlibAdd support for zlib (de)compression138
zsh-completionEnable zsh completion support17

back