pkgdev mask - mask packages

Synopsis

pkgdev mask [-h] [–debug] [-q] [-v] [–color BOOLEAN] [–api-key TOKEN] [-r [DAYS]] [-b BUGS] [–email] [–file-bug] [TARGET …]

Positional Arguments

TARGET

Packages matching any of these restrictions will have a mask entry in profiles/package.mask added for them. If no target is specified a path restriction is created based on the current working directory. In other words, if pkgdev mask is run within an ebuild’s directory, all the ebuilds within that directory will be masked.

Options

--api-key TOKEN

The Bugzilla API key to use for authentication. WARNING: using this option will expose your API key to other users of the same system. Consider instead saving your API key in a file named ~/.bugzrc in an INI format like so:

[default]
key = <your API key>

Another supported option is to save your API key in a file named ~/.bugz_token.

Base Options

-h, --help

Show this help message and exit. To get more information see the related man page.

--debug

Enable debug checks and show verbose debug output.

-q, --quiet

Suppress non-error, informational messages.

-v, --verbose

Increase the verbosity of various output.

--color BOOLEAN

Toggle colored output support. This can be used to forcibly enable color support when piping output or other situations where stdout is not a tty.

Mask Options

-r [DAYS], --rites [DAYS]

Mark a mask entry for last rites. This defaults to 30 days until package removal but accepts an optional argument for the number of days.

-b BUGS, --bug BUGS, --bugs BUGS

Add a reference to a bug in the mask comment. May be specified multiple times to reference multiple bugs.

--email

Spawn user’s preferred email composer with a prepared email for sending a last rites message to Gentoo’s mailing list (gentoo-dev and gentoo-dev-announce). The user should manually set the Reply-to field for the message to be accepted by gentoo-dev-announce.

For spawning the preferred email composer, the xdg-email tool from x11-misc/xdg-utils package.

--file-bug

Files a last-rite bug for the masked package, which blocks listed reference bugs. PMASKED keyword is added all all referenced bugs.