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 --jobs|-j num
60 Number of jobs to perform in parallel.
61 --no-result
63 Don't print informational messages about the outcome of perform‐
64 ing a command or some of its parts.
65 --no-progress
67 Suppress progress indicators for long-lasting operations, such
68 as network transfers, building, etc.
69 --build path
71 The build program to be used to build packages.
72 --build-option opt
74 Additional option to be passed to the build program.
75 --fetch path
77 The fetch program to be used to download resources.
78 --fetch-option opt
80 Additional option to be passed to the fetch program.
81 --fetch-timeout sec
83 The fetch and fetch-like (for example, git) program timeout.
84 --pkg-proxy url
86 HTTP proxy server to use when fetching package manifests and ar‐
87 chives from remote pkg repositories.
88 --git path
90 The git program to be used to fetch git repositories.
91 --git-option opt
93 Additional common option to be passed to the git program.
94 --sha256 path
96 The sha256 program to be used to calculate SHA256 sums.
97 --sha256-option opt
99 Additional option to be passed to the sha256 program.
100 --tar path
102 The tar program to be used to extract package archives.
103 --tar-option opt
105 Additional option to be passed to the tar program.
106 --openssl path
108 The openssl program to be used for crypto operations.
109 --openssl-option opt
111 Additional option to be passed to the openssl program.
112 --auth type
114 Types of repositories to authenticate.
115 --trust fingerprint
117 Trust repository certificate with a SHA256 fingerprint.
118 --trust-yes
120 Assume the answer to all authentication prompts is yes.
121 --trust-no
123 Assume the answer to all authentication prompts is no.
124 --pager path
126 The pager program to be used to show long text.
127 --pager-option opt
129 Additional option to be passed to the pager program.
130 --options-file file
132 Read additional options from file.
133 --default-options dir
135 The directory to load additional default options files from.
136 --no-default-options
138 Don't load default options files.
139
141 See bpkg-default-options-files(1) for an overview of the default op‐
142 tions files. For the pkg-fetch command the search start directory is
143 the configuration directory. The following options files are searched
144 for in each directory and, if found, loaded in the order listed:
145 bpkg.options
147 bpkg-pkg-fetch.options
148 The following pkg-fetch command options cannot be specified in the de‐
150 fault options files:
151 --directory|-d
153 --purge|-p
154
156 Send bug reports to the users@build2.org mailing list.
157
159 Copyright (c) 2014-2021 the build2 authors.
160 Permission is granted to copy, distribute and/or modify this document
162 under the terms of the MIT License.
163bpkg 0.14.0 October 2021 bpkg-pkg-fetch(1)