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
21       added/replaced 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
25       result 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       --jobs|-j num
52              Number of jobs to perform in parallel.
53
54       --no-result
55              Don't print informational messages about the outcome of perform‐
56              ing a command.
57
58       --no-progress
59              Suppress  progress  indicators for long-lasting operations, such
60              as network transfers, building, etc.
61
62       --build path
63              The build program to be used to build packages.
64
65       --build-option opt
66              Additional option to be passed to the build program.
67
68       --fetch path
69              The fetch program to be used to download resources.
70
71       --fetch-option opt
72              Additional option to be passed to the fetch program.
73
74       --fetch-timeout sec
75              The fetch and fetch-like (for example, git) program timeout.
76
77       --pkg-proxy url
78              HTTP proxy server to use when fetching package manifests and ar‐
79              chives from remote pkg repositories.
80
81       --git path
82              The git program to be used to fetch git repositories.
83
84       --git-option opt
85              Additional common option to be passed to the git program.
86
87       --sha256 path
88              The sha256 program to be used to calculate SHA256 sums.
89
90       --sha256-option opt
91              Additional option to be passed to the sha256 program.
92
93       --tar path
94              The tar program to be used to extract package archives.
95
96       --tar-option opt
97              Additional option to be passed to the tar program.
98
99       --openssl path
100              The openssl program to be used for crypto operations.
101
102       --openssl-option opt
103              Additional option to be passed to the openssl program.
104
105       --auth type
106              Types of repositories to authenticate.
107
108       --trust fingerprint
109              Trust repository certificate with a SHA256 fingerprint.
110
111       --trust-yes
112              Assume the answer to all authentication prompts is yes.
113
114       --trust-no
115              Assume the answer to all authentication prompts is no.
116
117       --pager path
118              The pager program to be used to show long text.
119
120       --pager-option opt
121              Additional option to be passed to the pager program.
122
123       --options-file file
124              Read additional options from file.
125
126       --default-options dir
127              The directory to load additional default options files from.
128
129       --no-default-options
130              Don't load default options files.
131

DEFAULT OPTIONS FILES

133       See  bpkg-default-options-files(1)  for  an  overview  of  the  default
134       options files. For the rep-fetch command the search start directory  is
135       the  configuration  directory. The following options files are searched
136       for in each directory and, if found, loaded in the order listed:
137
138       bpkg.options
139       bpkg-rep-fetch.options
140
141       The following rep-fetch command options  cannot  be  specified  in  the
142       default options files:
143
144       --directory|-d
145

BUGS

147       Send bug reports to the users@build2.org mailing list.
148

150       Copyright (c) 2014-2020 the build2 authors.
151
152       Permission  is  granted to copy, distribute and/or modify this document
153       under the terms of the MIT License.
154
155
156
157bpkg 0.13.0                        July 2020                 bpkg-rep-fetch(1)
Impressum