euse
Enable or disable Gentoo USE flags
TLDR
List active global USE flags
List active local USE flags
Enable a global USE flag
Disable a global USE flag (put a '-' sign in front of the USE flag)
Remove a global USE flag
SYNOPSIS
euse [-D] [-E] [-f file] [-h] [-i] [-P] [-q] [-u] [-V]
PARAMETERS
-a
Shows flags matching flag.
-c
Clear cached USE flags.
-d
Shows description of the flag.
-e
Enables the flag.
-f file
Uses the specified file instead of /etc/portage/make.conf.
-h
Shows help message.
-i
Ignores case during flag search.
-l
Lists all USE flags.
-P
Shows package specific USE flags.
-q
Quiet mode.
-s
Searches for USE flags that match the given substring.
-S
Display status of all flags. (Enabled, Disabled, Unknown)
-U
Updates all USE flags.
-V
Verbose mode.
-Q
Output flag statuses in quiet mode.
DESCRIPTION
The euse command is a utility specific to the Gentoo Linux distribution. It's designed to provide a convenient way to manage and query USE flags. USE flags are a central concept in Gentoo, influencing how packages are compiled and which features are included. euse allows users to quickly determine if a particular USE flag is enabled or disabled, globally or locally, and modify them directly. It simplifies working with the make.conf and package.use files, where USE flags are defined.
Using euse, you can search for flags, view their descriptions, enable or disable them, and even merge flag settings across different configuration files. This tool is invaluable for Gentoo users who want fine-grained control over their system's software build process.
CAVEATS
euse is Gentoo-specific and won't be available on other Linux distributions. Also requires root privileges for certain operations, especially those that modify configuration files.
USAGE EXAMPLES
- Check if the 'X' USE flag is enabled: euse X
- Enable the 'opengl' USE flag: euse opengl + or euse -e opengl
- Disable the 'kde' USE flag: euse kde - or euse -d kde
- Search for USE flags containing 'gtk': euse -s gtk
- See the description of the 'alsa' USE flag: euse -d alsa
HISTORY
euse was developed as a part of the Gentoo Linux project to address the need for a more user-friendly way to manage USE flags. It provides a higher-level interface compared to directly editing configuration files, making it easier for users to understand and control the software build process.
SEE ALSO
make.conf(5), package.use(5)