1bpkg-cfg-info(1)            General Commands Manual           bpkg-cfg-info(1)
2
3
4

NAME

6       bpkg-cfg-info - print configuration information
7

SYNOPSIS

9       bpkg cfg-info [options]
10

DESCRIPTION

12       The  cfg-info command prints the current configuration's absolute path,
13       id, type, and name. If the --link and/or --backlink options are  speci‐
14       fied,  then this information is also printed for each linked and/or im‐
15       plicitly backlinked configuration, if any. Note that the  dangling  im‐
16       plicit  backlinks are silently skipped, unless --dangling is specified,
17       in which case this information is also printed for them. Note that  the
18       information is written to stdout, not stderr.
19
20       If  the  --recursive  option  is  specified together with --link and/or
21       --backlink, then this information is printed for linked and/or  implic‐
22       itly backlinked configuration, recursively.
23
24       The output format is regular with each value printed on a separate line
25       and prefixed with the value name. If  the  --link,  --backlink,  and/or
26       --dangling options are specified, then information blocks corresponding
27       to linked configurations are separated with blank lines. For example:
28
29       path: /path/to/cfg/
30       uuid: 8d439f03-7342-4502-8b1c-74b173869478
31       type: target
32       name: foo
33
34       path: /path/to/host-cfg/
35       uuid: 7ee4dab3-07d9-4163-81c0-3779166a7213
36       type: host
37       name: tools
38
39       path: /path/to/build2-cfg/
40       uuid: d453aa2a-92c4-4066-87e4-c8672eed06e1
41       type: build2
42       name: modules
43

CFG-INFO OPTIONS

45       --link Print linked configurations.
46
47       --backlink
48              Print implicitly backlinked configurations.
49
50       --dangling
51              Print dangling implicit backlinks.
52
53       --recursive
54              Print linked configurations recursively.
55
56       --directory|-d dir
57              Assume configuration is in dir rather than in the current  work‐
58              ing directory.
59

COMMON OPTIONS

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

DEFAULT OPTIONS FILES

168       See bpkg-default-options-files(1) for an overview of  the  default  op‐
169       tions files. For the cfg-info command the search start directory is the
170       configuration directory. The following options files are  searched  for
171       in each directory and, if found, loaded in the order listed:
172
173       bpkg.options
174       bpkg-cfg-info.options
175
176       The  following  cfg-info command options cannot be specified in the de‐
177       fault options files:
178
179       --directory|-d
180

BUGS

182       Send bug reports to the users@build2.org mailing list.
183
185       Copyright (c) 2014-2022 the build2 authors.
186
187       Permission is granted to copy, distribute and/or modify  this  document
188       under the terms of the MIT License.
189
190
191
192bpkg 0.15.0                        July 2022                  bpkg-cfg-info(1)
Impressum