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

NAME

6       bdep-common-options - details on common options
7

SYNOPSIS

9       bdep [common-options] ...
10

DESCRIPTION

12       The  common  options  control behavior that is common to all or most of
13       the bdep 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 executing package manager commands such as  bpkg-pkg-
50              update(1), bpkg-pkg-test(1), etc., which in turn propagate it to
51              the build system.
52
53       --no-progress
54              Suppress progress indicators for long-lasting  operations,  such
55              as network transfers, building, etc.
56
57       --bpkg path
58              The  package  manager program to be used for build configuration
59              management.  This should be the path to the bpkg executable. You
60              can also specify additional options that should be passed to the
61              package manager program with --bpkg-option.
62
63              If the package manager program is not explicitly specified, then
64              bdep  will  by default use bpkg plus an executable suffix if one
65              was specified when building bdep. So, for example, if bdep  name
66              was set to bdep-1.0, then it will look for bpkg-1.0.
67
68       --bpkg-option opt
69              Additional  option  to be passed to the package manager program.
70              See --bpkg for more information on the package manager  program.
71              Repeat this option to specify multiple package manager options.
72
73       --build path
74              The  build  program to be used to build packages. This should be
75              the path to the build2 b executable. You can also specify  addi‐
76              tional  options  that should be passed to the build program with
77              --build-option.
78
79              If the build program is not explicitly specified, then bdep will
80              by  default use b plus an executable suffix if one was specified
81              when building bdep. So, for example, if bdep  name  was  set  to
82              bdep-1.0, then it will look for b-1.0.
83
84       --build-option opt
85              Additional option to be passed to the build program. See --build
86              for more information on the build program. Repeat this option to
87              specify multiple build options.
88
89       --curl path
90              The curl program to be used for network operations. You can also
91              specify additional options that should be  passed  to  the  curl
92              program with --curl-option.
93
94              If  the curl program is not explicitly specified, then bdep will
95              use curl by default.
96
97       --curl-option opt
98              Additional option to be passed to the curl program.  See  --curl
99              for  more information on the curl program. Repeat this option to
100              specify multiple curl options.
101
102       --pager path
103              The pager program to be used to show long  text.  Commonly  used
104              pager  programs  are  less  and more. You can also specify addi‐
105              tional options that should be passed to the pager  program  with
106              --pager-option.  If  an  empty  string is specified as the pager
107              program, then no pager will be used. If the pager program is not
108              explicitly  specified,  then bdep will try to use less. If it is
109              not available, then no pager will be used.
110
111       --pager-option opt
112              Additional option to be passed to the pager program. See --pager
113              for more information on the pager program. Repeat this option to
114              specify multiple pager options.
115
116       --options-file file
117              Read additional options from file. Each option should appear  on
118              a  separate  line optionally followed by space or equal sign (=)
119              and an option value. Empty lines and lines starting with  #  are
120              ignored.   Option values can be enclosed in double (") or single
121              (') quotes to preserve leading and trailing whitespaces as  well
122              as  to specify empty values. If the value itself contains trail‐
123              ing or leading quotes, enclose it with an extra pair of  quotes,
124              for  example  '"x"'. Non-leading and non-trailing quotes are in‐
125              terpreted as being part of the option value.
126
127              The semantics of providing options in a file  is  equivalent  to
128              providing  the same set of options in the same order on the com‐
129              mand line at the point where the --options-file option is speci‐
130              fied except that the shell escaping and quoting is not required.
131              Repeat this option to specify more than one options 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

BUGS

140       Send bug reports to the users@build2.org mailing list.
141
143       Copyright (c) 2014-2021 the build2 authors.
144
145       Permission is granted to copy, distribute and/or modify  this  document
146       under the terms of the MIT License.
147
148
149
150bdep 0.14.0                      October 2021           bdep-common-options(1)
Impressum