1bpkg-pkg-fetch(1)           General Commands Manual          bpkg-pkg-fetch(1)
2
3
4

NAME

6       bpkg-pkg-fetch - fetch package archive
7

SYNOPSIS

9       bpkg pkg-fetch [options] (pkg/ver | --existing|-e file)
10

DESCRIPTION

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
16       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
21       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

PKG-FETCH OPTIONS

30       --replace|-r
31              Replace the  archive  if  the  package  is  already  fetched  or
32              unpacked.
33
34       --existing|-e
35              Treat  the  argument  as an existing package archive path rather
36              than the package name/version to fetch.
37
38       --purge|-p
39              Remove the existing package archive when the package is purged.
40
41       --directory|-d dir
42              Assume configuration is in dir rather than in the current  work‐
43              ing directory.
44

COMMON OPTIONS

46       The  common  options are summarized below with a more detailed descrip‐
47       tion available in bpkg-common-options(1).
48
49       -v     Print essential underlying commands being executed.
50
51       -V     Print all underlying commands being executed.
52
53       --quiet|-q
54              Run quietly, only printing error messages.
55
56       --verbose level
57              Set the diagnostics verbosity to level between 0 and 6.
58
59       --jobs|-j num
60              Number of jobs to perform in parallel.
61
62       --no-result
63              Don't print informational messages about the outcome of perform‐
64              ing a command.
65
66       --no-progress
67              Suppress  progress  indicators for long-lasting operations, such
68              as network transfers, building, etc.
69
70       --build path
71              The build program to be used to build packages.
72
73       --build-option opt
74              Additional option to be passed to the build program.
75
76       --fetch path
77              The fetch program to be used to download resources.
78
79       --fetch-option opt
80              Additional option to be passed to the fetch program.
81
82       --fetch-timeout sec
83              The fetch and fetch-like (for example, git) program timeout.
84
85       --pkg-proxy url
86              HTTP proxy server to use when fetching package manifests and ar‐
87              chives from remote pkg repositories.
88
89       --git path
90              The git program to be used to fetch git repositories.
91
92       --git-option opt
93              Additional common option to be passed to the git program.
94
95       --sha256 path
96              The sha256 program to be used to calculate SHA256 sums.
97
98       --sha256-option opt
99              Additional option to be passed to the sha256 program.
100
101       --tar path
102              The tar program to be used to extract package archives.
103
104       --tar-option opt
105              Additional option to be passed to the tar program.
106
107       --openssl path
108              The openssl program to be used for crypto operations.
109
110       --openssl-option opt
111              Additional option to be passed to the openssl program.
112
113       --auth type
114              Types of repositories to authenticate.
115
116       --trust fingerprint
117              Trust repository certificate with a SHA256 fingerprint.
118
119       --trust-yes
120              Assume the answer to all authentication prompts is yes.
121
122       --trust-no
123              Assume the answer to all authentication prompts is no.
124
125       --pager path
126              The pager program to be used to show long text.
127
128       --pager-option opt
129              Additional option to be passed to the pager program.
130
131       --options-file file
132              Read additional options from file.
133
134       --default-options dir
135              The directory to load additional default options files from.
136
137       --no-default-options
138              Don't load default options files.
139

DEFAULT OPTIONS FILES

141       See  bpkg-default-options-files(1)  for  an  overview  of  the  default
142       options 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
146       bpkg.options
147       bpkg-pkg-fetch.options
148
149       The following pkg-fetch command options  cannot  be  specified  in  the
150       default options files:
151
152       --directory|-d
153       --purge|-p
154

BUGS

156       Send bug reports to the users@build2.org mailing list.
157
159       Copyright (c) 2014-2020 the build2 authors.
160
161       Permission  is  granted to copy, distribute and/or modify this document
162       under the terms of the MIT License.
163
164
165
166bpkg 0.13.0                        July 2020                 bpkg-pkg-fetch(1)
Impressum