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       --git path
86              The git program to be used to fetch git repositories.
87
88       --git-option opt
89              Additional common option to be passed to the git program.
90
91       --sha256 path
92              The sha256 program to be used to calculate SHA256 sums.
93
94       --sha256-option opt
95              Additional option to be passed to the sha256 program.
96
97       --tar path
98              The tar program to be used to extract package archives.
99
100       --tar-option opt
101              Additional option to be passed to the tar program.
102
103       --openssl path
104              The openssl program to be used for crypto operations.
105
106       --openssl-option opt
107              Additional option to be passed to the openssl program.
108
109       --auth type
110              Types of repositories to authenticate.
111
112       --trust fingerprint
113              Trust repository certificate with a SHA256 fingerprint.
114
115       --trust-yes
116              Assume the answer to all authentication prompts is yes.
117
118       --trust-no
119              Assume the answer to all authentication prompts is no.
120
121       --pager path
122              The pager program to be used to show long text.
123
124       --pager-option opt
125              Additional option to be passed to the pager program.
126
127       --options-file file
128              Read additional options from file.
129
130       --default-options dir
131              The directory to load additional default options files from.
132
133       --no-default-options
134              Don't load default options files.
135

DEFAULT OPTIONS FILES

137       See  bpkg-default-options-files(1)  for  an  overview  of  the  default
138       options  files. For the pkg-fetch command the search start directory is
139       the configuration directory. The following options files  are  searched
140       for in each directory and, if found, loaded in the order listed:
141
142       bpkg.options
143       bpkg-pkg-fetch.options
144
145       The  following  pkg-fetch  command  options  cannot be specified in the
146       default options files:
147
148       --directory|-d
149       --purge|-p
150

BUGS

152       Send bug reports to the users@build2.org mailing list.
153

155       Copyright (c) 2014-2019 Code Synthesis Ltd
156
157       Permission is granted to copy, distribute and/or modify  this  document
158       under the terms of the MIT License.
159
160
161
162bpkg 0.12.0                      November 2019               bpkg-pkg-fetch(1)
Impressum