1bpkg-pkg-fetch(1) General Commands Manual bpkg-pkg-fetch(1)
2
6 bpkg-pkg-fetch - fetch package archive
7
9 bpkg pkg-fetch [options] (pkg/ver | --existing|-e file)
10
12 The pkg-fetch command fetches the archive for the specified package
13 name and version from one of the archive-based repositories (bpkg-rep-
14 add(1)). The resulting package state is fetched (bpkg-pkg-status(1)).
15 If the --replace|-r option is specified, then pkg-fetch will replace
17 the archive of a package that is already in the fetched or unpacked
18 state. Otherwise, pkg-fetch expects the package to not exist in the
19 configuration.
20 If the --existing|-e option is used, then instead of the name and ver‐
22 sion arguments, pkg-fetch expects a local path to an existing package
23 archive. In this case, bpkg will use the archive in place, without
24 copying it into the configuration directory. Also, unless the
25 --purge|-p option is specified, bpkg will not attempt to remove this
26 archive when the package is later purged with the bpkg-pkg-purge(1)
27 command.
28
30 --replace|-r
31 Replace the archive if the package is already fetched or un‐
32 packed.
33 --existing|-e
35 Treat the argument as an existing package archive path rather
36 than the package name/version to fetch.
37 --purge|-p
39 Remove the existing package archive when the package is purged.
40 --directory|-d dir
42 Assume configuration is in dir rather than in the current work‐
43 ing directory.
44
46 The common options are summarized below with a more detailed descrip‐
47 tion available in bpkg-common-options(1).
48 -v Print essential underlying commands being executed.
50 -V Print all underlying commands being executed.
52 --quiet|-q
54 Run quietly, only printing error messages.
55 --verbose level
57 Set the diagnostics verbosity to level between 0 and 6.
58 --stdout-format format
60 Representation format to use for printing to stdout.
61 --jobs|-j num
63 Number of jobs to perform in parallel.
64 --no-result
66 Don't print informational messages about the outcome of perform‐
67 ing a command or some of its parts.
68 --progress
70 Display progress indicators for long-lasting operations, such as
71 network transfers, building, etc.
72 --no-progress
74 Suppress progress indicators for long-lasting operations, such
75 as network transfers, building, etc.
76 --build path
78 The build program to be used to build packages.
79 --build-option opt
81 Additional option to be passed to the build program.
82 --fetch path
84 The fetch program to be used to download resources.
85 --fetch-option opt
87 Additional option to be passed to the fetch program.
88 --fetch-timeout sec
90 The fetch and fetch-like (for example, git) program timeout.
91 --pkg-proxy url
93 HTTP proxy server to use when fetching package manifests and ar‐
94 chives from remote pkg repositories.
95 --git path
97 The git program to be used to fetch git repositories.
98 --git-option opt
100 Additional common option to be passed to the git program.
101 --sha256 path
103 The sha256 program to be used to calculate SHA256 sums.
104 --sha256-option opt
106 Additional option to be passed to the sha256 program.
107 --tar path
109 The tar program to be used to extract package archives.
110 --tar-option opt
112 Additional option to be passed to the tar program.
113 --openssl path
115 The openssl program to be used for crypto operations.
116 --openssl-option opt
118 Additional option to be passed to the openssl program.
119 --auth type
121 Types of repositories to authenticate.
122 --trust fingerprint
124 Trust repository certificate with a SHA256 fingerprint.
125 --trust-yes
127 Assume the answer to all authentication prompts is yes.
128 --trust-no
130 Assume the answer to all authentication prompts is no.
131 --pager path
133 The pager program to be used to show long text.
134 --pager-option opt
136 Additional option to be passed to the pager program.
137 --options-file file
139 Read additional options from file.
140 --default-options dir
142 The directory to load additional default options files from.
143 --no-default-options
145 Don't load default options files.
146 --keep-tmp
148 Don't remove the bpkg's temporary directory at the end of the
149 command execution and print its path at the verbosity level 2 or
150 higher.
151
153 See bpkg-default-options-files(1) for an overview of the default op‐
154 tions files. For the pkg-fetch command the search start directory is
155 the configuration directory. The following options files are searched
156 for in each directory and, if found, loaded in the order listed:
157 bpkg.options
159 bpkg-pkg-fetch.options
160 The following pkg-fetch command options cannot be specified in the de‐
162 fault options files:
163 --directory|-d
165 --purge|-p
166
168 Send bug reports to the users@build2.org mailing list.
169
171 Copyright (c) 2014-2022 the build2 authors.
172 Permission is granted to copy, distribute and/or modify this document
174 under the terms of the MIT License.
175bpkg 0.15.0 July 2022 bpkg-pkg-fetch(1)