NAME
brep-load – load repositories into brep package database
SYNOPSIS
brep-load --help
brep-load --version
brep-load [options] loadtab
DESCRIPTION
brep-load reads the list of repositories from the
specified loadtab configuration file, fetches their
manifest files, and loads the repository and package information into the
package database, suitable for consumption by the
brep web module.
Note that brep-load expects the
package database schema to have already been created
using brep-migrate(1).
Also note that brep-load requires bpkg(1) to fetch
repository information. See --bpkg for more information
on the package manager program.
OPTIONS
--ignore-unknown- Ignore unknown manifest entries.
--force- Reload package information regardless of the repository manifest file
timestamps.
--shallow- Don't load package information from prerequisite or complement
repositories, don't fail if unable to resolve a package dependency, and
don't detect package dependency cycles.
--ignore-unresolv-tests- Ignore tests, examples, and benchmarks package manifest entries which
cannot be resolved from the main package's complement repositories,
recursively. Note that in contrast to --shallow option, such entries will
be removed from the main package manifests outright.
--ignore-unresolv-cond pkg- Ignore conditional package dependencies which cannot be resolved. The
valid
pkg values are all and
tests. If all is specified, then
unresolved conditional dependencies are ignored in all packages. If
tests is specified, then unresolved conditional
dependencies are only ignored in external tests, examples, and benchmarks
packages.
--tenant id- Tenant the package and repository information should be loaded in. If
not specified, then the single-tenant mode is assumed.
--existing-tenant- Load the repository and package information into the already created
empty tenant rather than into the newly created one. Requires the
--tenant option to be specified.
--private- Display the tenant packages in the web interface only in the tenant
view mode.
--interactive bkp- Build the tenant packages interactively, stopping builds at the
specified breakpoint. Implies
--private.
--service-id id- Third party service information to associate with the being created
tenant. Requires the
--tenant and
--service-type options to be specified.
--service-type type- Type of the service to associate with the being created tenant.
Requires the
--service-id option to be specified.
--service-data data- Service data to associate with the being created tenant. Requires the
--service-id option to be specified.
--overrides-file file- Read package manifest overrides from the specified manifest fragment
file and apply them to packages being loaded.
--db-user|-u user- Database user name. If not specified, then operating system (login)
name is used.
--db-password pass- Database password. If not specified, then login without password is
expected to work.
--db-name|-n name- Database name. If not specified, then
brep_package
is used by default.
--db-host|-h host- Database host name, address, or socket. If not specified, then connect
to
localhost using the operating system-default
mechanism (Unix-domain socket, etc).
--db-port|-p port- Database port number. If not specified, the default port is used.
--bpkg path- The package manager program to be used to fetch repository
information. This should be the path to the
bpkg
executable. You can also specify additional options that should be passed
to the package manager program with --bpkg-option. If
the package manager program is not explicitly specified, then
brep-load will use bpkg by
default.
--bpkg-option opt- Additional option to be passed to the package manager program. See
--bpkg for more information on the package manager
program. Repeat this option to specify multiple package manager
options.
openssl path- The openssl program to be used for crypto operations. You can also
specify additional options that should be passed to the openssl program
with
openssl-option. If the openssl program is not
explicitly specified, then brep-load will use
openssl by default.
openssl-option opt- Additional option to be passed to the openssl program (see
openssl for details). Repeat this option to specify
multiple openssl options.
--pager path- The pager program to be used to show long text. Commonly used pager
programs are
less and more. You
can also specify additional options that should be passed to the pager
program with --pager-option. If an empty string is
specified as the pager program, then no pager will be used. If the pager
program is not explicitly specified, then brep-load
will try to use less. If it is not available, then no
pager will be used.
--pager-option opt- Additional option to be passed to the pager program. See
--pager for more information on the pager program.
Repeat this option to specify multiple pager options.
--help- Print usage information and exit.
--version- Print version and exit.
EXIT STATUS
0- Success.
1- Fatal error.
2- An instance of
brep-load or some other
brep utility is already running. Try again.
3- Recoverable database error. Try again.
BUGS
Send bug reports to the
users@build2.org mailing list.