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       --jobs|-j num
75              Number of jobs to perform in parallel.
76
77       --no-result
78              Don't print informational messages about the outcome of perform‐
79              ing a command or some of its parts.
80
81       --no-progress
82              Suppress  progress  indicators for long-lasting operations, such
83              as network transfers, building, etc.
84
85       --build path
86              The build program to be used to build packages.
87
88       --build-option opt
89              Additional option to be passed to the build program.
90
91       --fetch path
92              The fetch program to be used to download resources.
93
94       --fetch-option opt
95              Additional option to be passed to the fetch program.
96
97       --fetch-timeout sec
98              The fetch and fetch-like (for example, git) program timeout.
99
100       --pkg-proxy url
101              HTTP proxy server to use when fetching package manifests and ar‐
102              chives from remote pkg repositories.
103
104       --git path
105              The git program to be used to fetch git repositories.
106
107       --git-option opt
108              Additional common option to be passed to the git program.
109
110       --sha256 path
111              The sha256 program to be used to calculate SHA256 sums.
112
113       --sha256-option opt
114              Additional option to be passed to the sha256 program.
115
116       --tar path
117              The tar program to be used to extract package archives.
118
119       --tar-option opt
120              Additional option to be passed to the tar program.
121
122       --openssl path
123              The openssl program to be used for crypto operations.
124
125       --openssl-option opt
126              Additional option to be passed to the openssl program.
127
128       --auth type
129              Types of repositories to authenticate.
130
131       --trust fingerprint
132              Trust repository certificate with a SHA256 fingerprint.
133
134       --trust-yes
135              Assume the answer to all authentication prompts is yes.
136
137       --trust-no
138              Assume the answer to all authentication prompts is no.
139
140       --pager path
141              The pager program to be used to show long text.
142
143       --pager-option opt
144              Additional option to be passed to the pager program.
145
146       --options-file file
147              Read additional options from file.
148
149       --default-options dir
150              The directory to load additional default options files from.
151
152       --no-default-options
153              Don't load default options files.
154

DEFAULT OPTIONS FILES

156       See  bpkg-default-options-files(1)  for  an overview of the default op‐
157       tions files. For the cfg-info command the search start directory is the
158       configuration  directory.  The following options files are searched for
159       in each directory and, if found, loaded in the order listed:
160
161       bpkg.options
162       bpkg-cfg-info.options
163
164       The following cfg-info command options cannot be specified in  the  de‐
165       fault options files:
166
167       --directory|-d
168

BUGS

170       Send bug reports to the users@build2.org mailing list.
171
173       Copyright (c) 2014-2021 the build2 authors.
174
175       Permission  is  granted to copy, distribute and/or modify this document
176       under the terms of the MIT License.
177
178
179
180bpkg 0.14.0                      October 2021                 bpkg-cfg-info(1)
Impressum