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       --progress
64              Display progress indicators for long-lasting operations, such as
65              network transfers, building, etc.
66
67       --no-progress
68              Suppress progress indicators for long-lasting  operations,  such
69              as network transfers, building, etc.
70
71       --build path
72              The build program to be used to build packages.
73
74       --build-option opt
75              Additional option to be passed to the build program.
76
77       --fetch path
78              The fetch program to be used to download resources.
79
80       --fetch-option opt
81              Additional option to be passed to the fetch program.
82
83       --fetch-timeout sec
84              The fetch and fetch-like (for example, git) program timeout.
85
86       --pkg-proxy url
87              HTTP proxy server to use when fetching package manifests and ar‐
88              chives from remote pkg repositories.
89
90       --git path
91              The git program to be used to fetch git repositories.
92
93       --git-option opt
94              Additional common option to be passed to the git program.
95
96       --sha256 path
97              The sha256 program to be used to calculate SHA256 sums.
98
99       --sha256-option opt
100              Additional option to be passed to the sha256 program.
101
102       --tar path
103              The tar program to be used to extract package archives.
104
105       --tar-option opt
106              Additional option to be passed to the tar program.
107
108       --openssl path
109              The openssl program to be used for crypto operations.
110
111       --openssl-option opt
112              Additional option to be passed to the openssl program.
113
114       --auth type
115              Types of repositories to authenticate.
116
117       --trust fingerprint
118              Trust repository certificate with a SHA256 fingerprint.
119
120       --trust-yes
121              Assume the answer to all authentication prompts is yes.
122
123       --trust-no
124              Assume the answer to all authentication prompts is no.
125
126       --pager path
127              The pager program to be used to show long text.
128
129       --pager-option opt
130              Additional option to be passed to the pager program.
131
132       --options-file file
133              Read additional options from file.
134
135       --default-options dir
136              The directory to load additional default options files from.
137
138       --no-default-options
139              Don't load default options files.
140
141       --keep-tmp
142              Don't remove the bpkg's temporary directory at the  end  of  the
143              command execution and print its path at the verbosity level 2 or
144              higher.
145

DEFAULT OPTIONS FILES

147       See bpkg-default-options-files(1) for an overview of  the  default  op‐
148       tions  files.  For the cfg-unlink command the search start directory is
149       the configuration directory. The following options files  are  searched
150       for in each directory and, if found, loaded in the order listed:
151
152       bpkg.options
153       bpkg-cfg-unlink.options
154
155       The following cfg-unlink command options cannot be specified in the de‐
156       fault options files:
157
158       --directory|-d
159

BUGS

161       Send bug reports to the users@build2.org mailing list.
162

164       Copyright (c) 2014-2022 the build2 authors.
165
166       Permission is granted to copy, distribute and/or modify  this  document
167       under the terms of the MIT License.
168
169
170
171bpkg 0.15.0                        July 2022                bpkg-cfg-unlink(1)
Impressum