NAME
bdep-fetch
– fetch list of available project dependencies
SYNOPSIS
bdep fetch [options]
[--full|-F] [prj-spec] [cfg-spec]
cfg-spec = (@cfg-name |
--config|-c cfg-dir)... | --all|-a
prj-spec = --directory|-d prj-dir
DESCRIPTION
The fetch
command fetches the list of packages
available in the project's prerequisite/complement repositories in one or
more build configurations.
If no project or package directory is specified, then the current working
directory is assumed. If no configuration is specified, then the default
configurations are assumed. See bdep-projects-configs(1)
for details on specifying projects and configurations.
If the --full|-F
option is specified, then instead
fetch
performs a full re-fetch of all the repositories
added to the configuration. This mode is primarily useful when a
configuration (and some of the prerequisite/complement repositories) are
shared between several projects. In this situation an incremental fetch may
result in an inconsistent repository state.
FETCH OPTIONS
--full
|-F
- Perform a full re-fetch of all the repositories.
--all
|-a
- Use all build configurations.
--config
|-c
dir
- Specify the build configuration as a directory.
--directory
|-d
dir
- Assume project/package is in the specified directory rather than in
the current working directory.
--config-name
|-n
name
- Specify the build configuration as a name.
--config-id
num
- Specify the build configuration as an id.
COMMON OPTIONS
The common options are summarized below with a more detailed description
available in bdep-common-options(1)
.
-v
- Print essential underlying commands being executed.
-V
- Print all underlying commands being executed.
--quiet
|-q
- Run quietly, only printing error messages.
--verbose
level
- Set the diagnostics verbosity to
level
between 0
and 6.
--stdout-format
format
- Representation format to use for printing to
stdout
.
--jobs
|-j
num
- Number of jobs to perform in parallel.
--progress
- Display progress indicators for long-lasting operations, such as
network transfers, building, etc.
--no-progress
- Suppress progress indicators for long-lasting operations, such as
network transfers, building, etc.
--diag-color
- Use color in diagnostics.
--no-diag-color
- Don't use color in diagnostics.
--bpkg
path
- The package manager program to be used for build configuration
management.
--bpkg-option
opt
- Additional option to be passed to the package manager program.
--build
path
- The build program to be used to build packages.
--build-option
opt
- Additional option to be passed to the build program.
--curl
path
- The curl program to be used for network operations.
--curl-option
opt
- Additional option to be passed to the curl program.
--pager
path
- The pager program to be used to show long text.
--pager-option
opt
- Additional option to be passed to the pager program.
--options-file
file
- Read additional options from
file
.
--default-options
dir
- The directory to load additional default options files from.
--no-default-options
- Don't load default options files.
DEFAULT OPTIONS FILES
See bdep-default-options-files(1)
for an overview of the default options files. For the
fetch
command the search start directory is the project
directory. The following options files are searched for in each directory
and, if found, loaded in the order listed:
bdep.options
bdep-fetch.options
The following fetch
command options cannot be
specified in the default options files:
--directory|-d
BUGS
Send bug reports to the
users@build2.org mailing list.