1bpkg-pkg-clean(1) General Commands Manual bpkg-pkg-clean(1)
2
3
4
6 bpkg-pkg-clean - clean package
7
9 bpkg pkg-clean|clean [options] [vars] pkg...
10 bpkg pkg-clean|clean [options] [vars] --all|-a
11
13 The pkg-clean command cleans the specified packages (the first form) or
14 all the held packages (the second form, see bpkg-pkg-status(1)).
15 Underneath, this command doesn't do much more than run b clean. In the
16 first form the specified packages must have been previously configured
17 with bpkg-pkg-build(1) or bpkg-pkg-configure(1).
18
19 Additional command line variables (vars, normally config.*) can be
20 passed to the build system. Such variables apply to all the specified
21 packages but can also be specified to only apply to specific packages
22 using the argument grouping mechanism (see bpkg-argument-grouping(1)
23 for details).
24
26 --all|-a
27 Clean all held packages.
28
29 --directory|-d dir
30 Assume configuration is in dir rather than in the current work‐
31 ing directory.
32
34 The common options are summarized below with a more detailed descrip‐
35 tion available in bpkg-common-options(1).
36
37 -v Print essential underlying commands being executed.
38
39 -V Print all underlying commands being executed.
40
41 --quiet|-q
42 Run quietly, only printing error messages.
43
44 --verbose level
45 Set the diagnostics verbosity to level between 0 and 6.
46
47 --jobs|-j num
48 Number of jobs to perform in parallel.
49
50 --no-result
51 Don't print informational messages about the outcome of perform‐
52 ing a command.
53
54 --no-progress
55 Suppress progress indicators for long-lasting operations, such
56 as network transfers, building, etc.
57
58 --build path
59 The build program to be used to build packages.
60
61 --build-option opt
62 Additional option to be passed to the build program.
63
64 --fetch path
65 The fetch program to be used to download resources.
66
67 --fetch-option opt
68 Additional option to be passed to the fetch program.
69
70 --fetch-timeout sec
71 The fetch and fetch-like (for example, git) program timeout.
72
73 --pkg-proxy url
74 HTTP proxy server to use when fetching package manifests and ar‐
75 chives from remote pkg repositories.
76
77 --git path
78 The git program to be used to fetch git repositories.
79
80 --git-option opt
81 Additional common option to be passed to the git program.
82
83 --sha256 path
84 The sha256 program to be used to calculate SHA256 sums.
85
86 --sha256-option opt
87 Additional option to be passed to the sha256 program.
88
89 --tar path
90 The tar program to be used to extract package archives.
91
92 --tar-option opt
93 Additional option to be passed to the tar program.
94
95 --openssl path
96 The openssl program to be used for crypto operations.
97
98 --openssl-option opt
99 Additional option to be passed to the openssl program.
100
101 --auth type
102 Types of repositories to authenticate.
103
104 --trust fingerprint
105 Trust repository certificate with a SHA256 fingerprint.
106
107 --trust-yes
108 Assume the answer to all authentication prompts is yes.
109
110 --trust-no
111 Assume the answer to all authentication prompts is no.
112
113 --pager path
114 The pager program to be used to show long text.
115
116 --pager-option opt
117 Additional option to be passed to the pager program.
118
119 --options-file file
120 Read additional options from file.
121
122 --default-options dir
123 The directory to load additional default options files from.
124
125 --no-default-options
126 Don't load default options files.
127
129 See bpkg-default-options-files(1) for an overview of the default
130 options files. For the pkg-clean command the search start directory is
131 the configuration directory. The following options files are searched
132 for in each directory and, if found, loaded in the order listed:
133
134 bpkg.options
135 bpkg-pkg-clean.options
136
137 The following pkg-clean command options cannot be specified in the
138 default options files:
139
140 --directory|-d
141
143 Send bug reports to the users@build2.org mailing list.
144
146 Copyright (c) 2014-2020 the build2 authors.
147
148 Permission is granted to copy, distribute and/or modify this document
149 under the terms of the MIT License.
150
151
152
153bpkg 0.13.0 July 2020 bpkg-pkg-clean(1)