pmaint - system/repository maintenance utility

Synopsis

pmaint [-h] [–version] [–debug] [-q] [-v] [–color BOOLEAN] [–config CONFIG_PATH] {sync,copy,regen,env-update,eclass} …

Base Options

-h, --help

show this help message and exit

--version

show this program’s version info and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

Config Options

--config CONFIG_PATH

use custom config or skip loading system config

Subcommands

general system maintenance

pmaint sync - synchronize a local repository with its defined remote

Synopsis

pmaint sync [-h] [–debug] [-q] [-v] [–color BOOLEAN] [-f] [repo …]

Positional Arguments

repo

repo(s) to sync

Options

-f, --force

force syncing to occur regardless of staleness checks

Base Options

-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

pmaint copy - copy binpkgs between repos; primarily useful for quickpkging a livefs pkg

Synopsis

pmaint copy [–domain DOMAIN] [-h] [–debug] [-q] [-v] [–color BOOLEAN] [-s SOURCE_REPO] [-i] target_repo query [query …]

Positional Arguments

target_repo

repository to add packages to

query

packages matching any of these restrictions will be selected for copying

Config Options

--domain DOMAIN

custom pkgcore domain to use for this operation

Base Options

-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

Subcommand Options

-s SOURCE_REPO, --source-repo SOURCE_REPO

copy strictly from the supplied repository; else it copies from wherever a match is found

-i, --ignore-existing

if a matching pkg already exists in the target, don’t update it

pmaint regen - regenerate repository caches

Synopsis

pmaint regen [–domain DOMAIN] [-h] [–debug] [-q] [-v] [–color BOOLEAN] [–disable-eclass-caching] [-t THREADS] [–force] [–dir CACHE_DIR] [–rsync] [–use-local-desc] [–pkg-desc-index] [repo …]

Positional Arguments

repo

repo(s) to regenerate caches for

Config Options

--domain DOMAIN

custom pkgcore domain to use for this operation

Base Options

-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

Subcommand Options

--disable-eclass-caching

For regen operation, pkgcore internally turns on an optimization that

caches eclasses into individual functions thus parsing the eclass only twice max per EBD processor. Disabling this optimization via this option results in ~2x slower regeneration. Disable it only if you suspect the optimization is somehow causing issues.

-t THREADS, --threads THREADS

number of threads to use

--force

force regeneration to occur regardless of staleness checks or repo settings

--dir CACHE_DIR

use separate directory to store repository caches

--rsync

perform actions necessary for rsync repos (update metadata/timestamp.chk)

--use-local-desc

update local USE flag description cache (profiles/use.local.desc)

--pkg-desc-index

update package description cache (metadata/pkg_desc_index)

pmaint env-update - update env.d and ldconfig

Synopsis

pmaint env-update [–domain DOMAIN] [-h] [–debug] [-q] [-v] [–color BOOLEAN] [–skip-ldconfig]

Config Options

--domain DOMAIN

custom pkgcore domain to use for this operation

Base Options

-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

Subcommand Options

--skip-ldconfig

do not update etc/ldso.conf and ld.so.cache

pmaint eclass - generate eclass docs

Synopsis

pmaint eclass [–domain DOMAIN] [-h] [–debug] [-q] [-v] [–color BOOLEAN] [–dir OUTPUT_DIR] [-o OUTPUT_FORMAT] [-f {rst,man,html,devbook}] [-r REPO] [eclasses …]

Positional Arguments

eclasses

eclasses to target

Config Options

--domain DOMAIN

custom pkgcore domain to use for this operation

Base Options

-h, --help

show this help message and exit

--debug

enable debugging checks

-q, --quiet

suppress non-error messages

-v, --verbose

show verbose output

--color BOOLEAN

enable/disable color support

Subcommand Options

--dir OUTPUT_DIR

output directory

-o OUTPUT_FORMAT, --output OUTPUT_FORMAT

output file name format

-f {rst,man,html,devbook}, --format {rst,man,html,devbook}

output format

-r REPO, --repo REPO

target repository