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

NAME

6       bpkg-cfg-unlink - unlink configuration
7

SYNOPSIS

9       bpkg cfg-unlink [options] [dir]
10       bpkg cfg-unlink [options] --dangling
11

DESCRIPTION

13       The  cfg-unlink  command  unlinks the specified bpkg configuration from
14       the current configuration (the first form) or removes dangling implicit
15       backlinks  (the  second form). See bpkg-cfg-create(1) for background on
16       linked configurations.
17
18       In the first form the configuration to unlink can be  specified  either
19       as  configuration  directory  (dir),  name (--name), id (--id), or UUID
20       (--uuid).
21

23       --name name
24              Name of the configuration to unlink.
25
26       --id id
27              Numeric id of the configuration to unlink.
28
29       --uuid uuid
30              UUID of the configuration to unlink.
31
32       --dangling
33              Remove dangling implicit backlinks.
34
35       --directory|-d dir
36              Assume configuration is in dir rather than in the current  work‐
37              ing directory.
38

COMMON OPTIONS

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

DEFAULT OPTIONS FILES

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

BUGS

173       Send bug reports to the users@build2.org mailing list.
174

176       Copyright (c) 2014-2023 the build2 authors.
177
178       Permission is granted to copy, distribute and/or modify  this  document
179       under the terms of the MIT License.
180
181
182
183bpkg 0.16.0                        June 2023                bpkg-cfg-unlink(1)
Impressum