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

NAME

6       bpkg-rep-fetch - fetch list of available packages
7

SYNOPSIS

9       bpkg rep-fetch|fetch [options] [(rep-name | rep-loc)...]
10

DESCRIPTION

12       The  rep-fetch  command  fetches the list of available packages for the
13       specified repositories as well as all their complement and prerequisite
14       repositories,  recursively. If no repositories were specified, then all
15       the repositories previously added (bpkg-rep-add(1)) to  the  configura‐
16       tion are fetched.
17
18       The repository to fetch can be specified either as a repository name or
19       as a repository location (URL or a directory path; see  bpkg-rep-add(1)
20       for  details). In the latter case, the repository location is added/re‐
21       placed as if by first executing the rep-add command.
22
23       Note that fetching only a specific repository that happens to be a pre‐
24       requisite  or  complete of another repository not being fetched may re‐
25       sult in an inconsistent repository state.
26

REP-FETCH OPTIONS

28       --shallow
29              Do not re-fetch complement and prerequisite repositories of  the
30              specified repositories unless the set of complements and/or pre‐
31              requisites has changed.
32
33       --directory|-d dir
34              Assume configuration is in dir rather than in the current  work‐
35              ing directory.
36

COMMON OPTIONS

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

DEFAULT OPTIONS FILES

145       See bpkg-default-options-files(1) for an overview of  the  default  op‐
146       tions  files.  For  the rep-fetch command the search start directory is
147       the configuration directory. The following options files  are  searched
148       for in each directory and, if found, loaded in the order listed:
149
150       bpkg.options
151       bpkg-rep-fetch.options
152
153       The  following rep-fetch command options cannot be specified in the de‐
154       fault options files:
155
156       --directory|-d
157

BUGS

159       Send bug reports to the users@build2.org mailing list.
160

162       Copyright (c) 2014-2022 the build2 authors.
163
164       Permission is granted to copy, distribute and/or modify  this  document
165       under the terms of the MIT License.
166
167
168
169bpkg 0.15.0                        July 2022                 bpkg-rep-fetch(1)
Impressum