1bpkg-pkg-drop(1)            General Commands Manual           bpkg-pkg-drop(1)
2
3
4

NAME

6       bpkg-pkg-drop - drop package
7

SYNOPSIS

9       bpkg pkg-drop|drop [options] <pkg>...
10       bpkg pkg-drop|drop [options] --all|-a
11       bpkg pkg-drop|drop [options] (--all-pattern <pattern>)...
12

DESCRIPTION

14       The  pkg-drop  command drops from the configuration the specified pack‐
15       ages (the first form), all the held  packages  (the  second  form,  see
16       bpkg-pkg-status(1)),  or  all  the  held packages that match any of the
17       specified wildcard patterns (the third form).  If  the  packages  being
18       dropped  still  have  dependent  packages,  then  those will have to be
19       dropped as well and you will be prompted to confirm. And if  the  pack‐
20       ages  being  dropped  have  dependency packages that would otherwise no
21       longer be used, then they will be dropped as well unless the --keep-un‐
22       used|-K option is specified.
23
24       The  pkg-drop  command  also supports several options (described below)
25       that allow you to control the amount of work that will be done.
26

PKG-DROP OPTIONS

28       --all|-a
29              Drop all held packages.
30
31       --all-pattern pattern
32              Drop held packages that match the  specified  wildcard  pattern.
33              Repeat this option to match multiple patterns. Note that you may
34              need to quote the pattern to prevent expansion by your shell.
35
36       --yes|-y
37              Assume the answer to all prompts is yes. Note that  this  option
38              does  not apply to the dropping of dependents; use --drop-depen‐
39              dent for that.
40
41       --no|-n
42              Assume the answer to all prompts is no.  Only  makes  sense  to‐
43              gether with --print-only|-p.
44
45       --keep-unused|-K
46              Don't drop dependency packages that were automatically built but
47              will no longer be used.
48
49       --drop-dependent|-D
50              Don't warn about or ask for confirmation if  dropping  dependent
51              packages.
52
53       --keep-dependent
54              Issue an error if attempting to drop dependent packages.
55
56       --disfigure-only
57              Disfigure all the packages but don't purge.
58
59       --print-only|-p
60              Print  to  stdout what would be done without actually doing any‐
61              thing.
62
63       --plan header
64              Print the plan (even if --yes is specified) and  start  it  with
65              the header line (unless it is empty).
66
67       --directory|-d dir
68              Assume  configuration is in dir rather than in the current work‐
69              ing directory.
70

COMMON OPTIONS

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

DEFAULT OPTIONS FILES

179       See  bpkg-default-options-files(1)  for  an overview of the default op‐
180       tions files. For the pkg-drop command the search start directory is the
181       configuration  directory.  The following options files are searched for
182       in each directory and, if found, loaded in the order listed:
183
184       bpkg.options
185       bpkg-pkg-drop.options
186
187       The following pkg-drop command options cannot be specified in  the  de‐
188       fault options files:
189
190       --directory|-d
191

BUGS

193       Send bug reports to the users@build2.org mailing list.
194
196       Copyright (c) 2014-2022 the build2 authors.
197
198       Permission  is  granted to copy, distribute and/or modify this document
199       under the terms of the MIT License.
200
201
202
203bpkg 0.15.0                        July 2022                  bpkg-pkg-drop(1)
Impressum