Gentoo Development Guide
Profiles use.mask File
The use.mask file can be used to mark USE flags as unavailable on a
particular profile. This can be useful for various reasons:
-
Masking hardware-specific feature flags. For example,
mmxandsseare only available on x86,altivecis only available onppcandvisis only available on sparc v9. -
Disabling unavailable soft dependencies. A simple hypothetical example
—
say
fooappworks onmips, but has an optional dependency (controlled by thebarflag) uponlibbar, which doesn't work onmips. Then by adding thebarflag toprofiles/default-linux/mips/use.mask,fooappcould be made available tomipsusers with the unresolvable dependency forcibly disabled.
Note that use.mask is a per-flag thing, not per package's use of a given
flag. This is one of the reasons that USE flags must have a specific well
defined purpose.
Updates to use.mask should be handled via the relevant arch team.
See noblah USE Flags for more discussion.