Chapter 4. The Command Line Pool Manager poolm

Table of Contents
4.1. Command Line Syntax
4.2. Expressions
4.3. Listing Pool Elements
4.4. Configuration
4.5. Pruning Pools
4.6. Displaying Pool Status
4.7. Applying Arbitrary Commands to Pools

4.1. Command Line Syntax

 
poolm <gopt><topt> ( -help | -h )
poolm <gopt><topt> [ -p pool ]* ( -list   | -ls )           [ -expr <expr> ]
poolm <gopt><topt> [ -p pool ]* ( -prune  | -remove | -rm ) [ -expr <expr> ]
poolm <gopt><topt> [ -p pool ]* ( -status | -stat )         [ -expr <expr> ] 
poolm <gopt><topt> [ -p pool ]* ( -apply  | -app ) <cmd>    [ -expr <expr> ] 

<gopt>  ::= <go>*
<go>    ::= -v | -q | -n | -shell <path>

<topt>  ::= <to>*
<to>    ::= -tpc-hosttype <val> | -tpc-ostype <val> | -tpc-variant <val> 
         |  -tpc-compiler <val> | -tpc-option <val> | -default  
         |  -pkg-kind <val>     | -kind <val>

<expr>  ::= <expr1> | <expr1> or <expr1>
<expr1> ::= <expr2> | <expr2> and <expr2>
<expr2> ::= <expr3> | ( <expr3> ) | not <expr3>
<expr3> ::= name is <string>
         |  name matches <regex>
         |  label is <string>
         |  label matches <regex>
         |  version =  <string>
         |  version <  <string> 
         |  version <= <string>
         |  version >  <string> 
         |  version >= <string> 
         |  outdated  |  fixed  |  hidden
       


The general options have their usual meaning:

-v

be verbose

-q

run quietly (suppress unnecessary messages)

-n

don't actually execute any actions

-k

keep going in case of errors (commands exiting with non-null result code)

-shell <path>

use the given shell to execute the actions



Matching of package labels is syntactically recognized, but currently not implemented.