1bdep-common-options(1) General Commands Manual bdep-common-options(1)
2
6 bdep-common-options - details on common options
7
9 bdep [common-options] ...
10
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
17 -v Print essential underlying commands being executed. This is
18 equivalent to --verbose 2.
19 -V Print all underlying commands being executed. This is equivalent
21 to --verbose 3.
22 --quiet|-q
24 Run quietly, only printing error messages. This is equivalent to
25 --verbose 0.
26 --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 1. High-level information messages.
34 2. Essential underlying commands being executed.
36 3. All underlying commands being executed.
38 4. Information that could be helpful to the user.
40 5. Information that could be helpful to the developer.
42 6. Even more detailed information.
44 --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 --no-progress
54 Suppress progress indicators for long-lasting operations, such
55 as network transfers, building, etc.
56 --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 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 --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 --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 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 --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 --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 If the curl program is not explicitly specified, then bdep will
95 use curl by default.
96 --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 --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 --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 --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 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 --default-options dir
134 The directory to load additional default options files from.
135 --no-default-options
137 Don't load default options files.
138
140 Send bug reports to the users@build2.org mailing list.
141
143 Copyright (c) 2014-2021 the build2 authors.
144 Permission is granted to copy, distribute and/or modify this document
146 under the terms of the MIT License.
147bdep 0.14.0 October 2021 bdep-common-options(1)