1bpkg-common-options(1)      General Commands Manual     bpkg-common-options(1)
2
3
4

NAME

6       bpkg-common-options - details on common options
7

SYNOPSIS

9       bpkg [common-options] ...
10

DESCRIPTION

12       The  common  options  control behavior that is common to all or most of
13       the bpkg commands. They can be specified either before the  command  or
14       after, together with the command-specific options.
15

COMMON OPTIONS

17       -v     Print  essential  underlying  commands  being  executed. This is
18              equivalent to --verbose 2.
19
20       -V     Print all underlying commands being executed. This is equivalent
21              to --verbose 3.
22
23       --quiet|-q
24              Run quietly, only printing error messages. This is equivalent to
25              --verbose 0.
26
27       --verbose level
28              Set the diagnostics verbosity to level between 0 and 6. Level  0
29              disables  any  non-error messages while level 6 produces lots of
30              information, with level 1 being the default. The following addi‐
31              tional types of diagnostics are produced at each level:
32
33              1.  High-level information messages.
34
35              2.  Essential underlying commands being executed.
36
37              3.  All underlying commands being executed.
38
39              4.  Information that could be helpful to the user.
40
41              5.  Information that could be helpful to the developer.
42
43              6.  Even more detailed information.
44
45       --jobs|-j num
46              Number  of  jobs  to  perform in parallel. If this option is not
47              specified or specified with the 0  value,  then  the  number  of
48              available  hardware  threads is used. This option is also propa‐
49              gated when performing build system operations  such  as  update,
50              test, etc.
51
52       --no-result
53              Don't print informational messages about the outcome of perform‐
54              ing a command.
55
56       --no-progress
57              Suppress progress indicators for long-lasting  operations,  such
58              as network transfers, building, etc.
59
60       --build path
61              The  build  program to be used to build packages. This should be
62              the path to the build2 b executable. You can also specify  addi‐
63              tional  options  that should be passed to the build program with
64              --build-option.
65
66              If the build program is not explicitly specified, then bpkg will
67              by  default use b plus an executable suffix if one was specified
68              when building bpkg. So, for example, if bpkg  name  was  set  to
69              bpkg-1.0, then it will look for b-1.0.
70
71       --build-option opt
72              Additional option to be passed to the build program. See --build
73              for more information on the build program. Repeat this option to
74              specify multiple build options.
75
76       --fetch path
77              The  fetch  program to be used to download resources. Currently,
78              bpkg recognizes curl, wget, and fetch. Note that the last compo‐
79              nent  of  path must contain one of these names as a substring in
80              order for bpkg to recognize which program is being used. You can
81              also  specify  additional  options  that should be passed to the
82              fetch program with --fetch-option.
83
84              If the fetch program is not specified, then  bpkg  will  try  to
85              discover if one of the above programs is available and use that.
86              Currently, bpkg has the following preference order: wget 1.16 or
87              higher (supports --show-progress), curl, wget, and fetch.
88
89       --fetch-option opt
90              Additional option to be passed to the fetch program. See --fetch
91              for more information on the fetch program. Repeat this option to
92              specify multiple fetch options.
93
94       --fetch-timeout sec
95              The  fetch  and  fetch-like  (for example, git) program timeout.
96              While the exact semantics of the value depends  on  the  program
97              used, at a minimum it specifies in seconds the maximum time that
98              can be spent without any network activity.
99
100              Specifically, it is translated to the --max-time option for curl
101              and  to  the  --timeout  option for wget and fetch. For git over
102              HTTP/HTTPS   this    semantics    is    achieved    using    the
103              http.lowSpeedLimit=1  http.lowSpeedTime=sec configuration values
104              (the git:// and ssh:// protocols currently do not support  time‐
105              outs).
106
107              See  --fetch  and  --git  for more information on the fetch pro‐
108              grams.
109
110       --pkg-proxy url
111              HTTP proxy server to use when fetching package manifests and ar‐
112              chives from remote pkg repositories. If specified, the proxy url
113              must be in the http://host[:port] form. If port is  omitted,  80
114              is used by default.
115
116              Note  that  to allow caching, the proxied https:// URLs are con‐
117              verted to http:// in order to prevent  the  fetch  program  from
118              tunneling  (which  is the standard approach for proxying HTTPS).
119              If both HTTP and HTTPS repositories are used, it is assumed that
120              the  proxy server can figure out which URLs need to be converted
121              back to https:// based on the request information (for  example,
122              host  name).  For  security,  this mechanism should only be used
123              with signed repositories or when the proxy is located  inside  a
124              trusted network.
125
126       --git path
127              The  git  program  to be used to fetch git repositories. You can
128              also specify additional options that should be passed to the git
129              program with --git-option.
130
131              If  the  git program is not explicitly specified, then bpkg will
132              use git by default.
133
134       --git-option opt
135              Additional common option to be passed to the git  program.  Note
136              that  the  common options are the ones that precede the git com‐
137              mand. See --git for more information on the git program.  Repeat
138              this option to specify multiple git options.
139
140       --sha256 path
141              The  sha256  program  to  be used to calculate SHA256 sums. Cur‐
142              rently, bpkg recognizes sha256, sha256sum, and shasum. Note that
143              the  last component of path must contain one of these names as a
144              substring in order for bpkg to recognize which program is  being
145              used.  You  can  also  specify additional options that should be
146              passed to the sha256 program with --sha256-option.
147
148              If the sha256 program is not specified, then bpkg  will  try  to
149              discover if one of the above programs is available and use that.
150              Currently, bpkg has  the  following  preference  order:  sha256,
151              sha256sum, and shasum.
152
153       --sha256-option opt
154              Additional  option  to  be  passed  to  the  sha256 program. See
155              --sha256 for more information on the sha256 program. Repeat this
156              option to specify multiple sha256 options.
157
158       --tar path
159              The  tar  program  to  be  used to extract package archives. For
160              example, gtar or bsdtar. You can also specify additional options
161              that  should  be passed to the tar program with --tar-option. If
162              the tar program is not explicitly specified, then bpkg will  use
163              tar by default.
164
165       --tar-option opt
166              Additional option to be passed to the tar program. See --tar for
167              more information on the tar program. Repeat this option to spec‐
168              ify multiple tar options.
169
170       --openssl path
171              The  openssl  program  to be used for crypto operations. You can
172              also specify additional options that should  be  passed  to  the
173              openssl program with --openssl-option. If the openssl program is
174              not explicitly specified, then bpkg will use openssl by default.
175
176              The --openssl* values  can  be  optionally  qualified  with  the
177              openssl  command in the command:value form. This makes the value
178              only applicable to the specific command, for example:
179
180              bpkg rep-create                     \
181                --openssl rsautl:/path/to/openssl \
182                --openssl-option rsautl:-engine   \
183                --openssl-option rsautl:pkcs11    \
184                ...
185
186              An unqualified value that contains a colon can be  specified  as
187              qualified   with   an  empty  command,  for  example,  --openssl
188              :C:\bin\openssl. To see openssl commands executed by  bpkg,  use
189              the verbose mode (-v option).
190
191       --openssl-option opt
192              Additional  option  to  be  passed  to  the openssl program. See
193              --openssl for more information on the openssl program. The  val‐
194              ues  can  be  optionally  qualified with the openssl command, as
195              discussed in --openssl. Repeat this option to  specify  multiple
196              openssl options.
197
198       --auth type
199              Types  of  repositories  to  authenticate. Valid values for this
200              option are none, remote, all. By default only  remote  reposito‐
201              ries  are authenticated. You can request authentication of local
202              repositories by passing all or disable authentication completely
203              by passing none.
204
205       --trust fingerprint
206              Trust  repository  certificate with a SHA256 fingerprint. Such a
207              certificate is trusted automatically, without prompting the user
208              for  a  confirmation.  Repeat this option to trust multiple cer‐
209              tificates.
210
211              Note that by default openssl prints a SHA1  fingerprint  and  to
212              obtain  a  SHA256  one you will need to pass the -sha256 option,
213              for example:
214
215              openssl x509 -sha256 -fingerprint -noout -in cert.pem
216
217       --trust-yes
218              Assume the answer to all authentication prompts is yes.
219
220       --trust-no
221              Assume the answer to all authentication prompts is no.
222
223       --pager path
224              The pager program to be used to show long  text.  Commonly  used
225              pager  programs  are  less  and more. You can also specify addi‐
226              tional options that should be passed to the pager  program  with
227              --pager-option.  If  an  empty  string is specified as the pager
228              program, then no pager will be used. If the pager program is not
229              explicitly  specified,  then bpkg will try to use less. If it is
230              not available, then no pager will be used.
231
232       --pager-option opt
233              Additional option to be passed to the pager program. See --pager
234              for more information on the pager program. Repeat this option to
235              specify multiple pager options.
236
237       --options-file file
238              Read additional options from file. Each option should appear  on
239              a  separate  line optionally followed by space or equal sign (=)
240              and an option value. Empty lines and lines starting with  #  are
241              ignored.   Option values can be enclosed in double (") or single
242              (') quotes to preserve leading and trailing whitespaces as  well
243              as  to specify empty values. If the value itself contains trail‐
244              ing or leading quotes, enclose it with an extra pair of  quotes,
245              for  example  '"x"'.  Non-leading  and  non-trailing  quotes are
246              interpreted as being part of the option value.
247
248              The semantics of providing options in a file  is  equivalent  to
249              providing  the same set of options in the same order on the com‐
250              mand line at the point where the --options-file option is speci‐
251              fied except that the shell escaping and quoting is not required.
252              Repeat this option to specify more than one options file.
253
254       --default-options dir
255              The directory to load additional default options files from.
256
257       --no-default-options
258              Don't load default options files.
259

BUGS

261       Send bug reports to the users@build2.org mailing list.
262
264       Copyright (c) 2014-2020 the build2 authors.
265
266       Permission is granted to copy, distribute and/or modify  this  document
267       under the terms of the MIT License.
268
269
270
271bpkg 0.13.0                        July 2020            bpkg-common-options(1)
Impressum