PMAINT(1)

NAME
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] [-f {rst,man,html}] [-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

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

-r REPO, --repo REPO
    target repository

COPYRIGHT
2006-2019, pkgcore contributors