Paludis Logo Introduction cave  
Bugs, Requests, Support    
Overview    
FAQ    
Clients    
Configuration    
API    

cave print-id-masks

Name

cave-print-id-masks — Prints ID masks.

Synopsis

cave print-id-masks [ --format format ] spec

DESCRIPTION

Prints ID masks. No formatting is used, making the output suitable for parsing by scripts.

OPTIONS

Global Options

Global options, used by every subcommand.

-h , --help
display help message

Spec Options

Alter how the supplied spec is used.

-a , --all (+a , --no-all)
If the spec matches multiple IDs, display all matches.
-b , --best (+b , --no-best)
If the spec matches multiple IDs, select the best ID rather than giving an error.

Filters

Filter the output.

--overridden (--no-overridden)
Show overridden masks
--no-active (--no-no-active)
No not show active (non-overridden) masks

Display Options

Controls the output format.

--format
Select the output format. Special tokens recognised are %k for mask key, %d for mask description, %r for associated key’s raw name, %= for an = sign if %r is not blank, %h for associated key’s human name, %v for associated key or id’s value or any additional explanation, %( and %) for ( and ) if the mask is overridden, %o for the reason a mask is overridden, \n for newline, \t for tab. Default is '%(%k %d %r%=%v%) %o\n'.