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

NAME

6       bpkg-pkg-purge - purge package
7

SYNOPSIS

9       bpkg pkg-purge [options] pkg
10

DESCRIPTION

12       The  pkg-purge  command  removes the package directory and archive from
13       the filesystem and removes the package from  the  configuration.   Only
14       packages  in the fetched and unpacked state (bpkg-pkg-status(1)) can be
15       purged plus broken packages if the --force|-f option is specified  (see
16       the  option's  description  for details on purging broken packages). If
17       the --keep|-k option is specified, then  the  package  archive  is  not
18       removed (see the option's description for details on this mode).
19

PKG-PURGE OPTIONS

21       --keep|-k
22              Keep  the package archive. Note that in this mode the package is
23              still retained in the configuration's database  in  the  fetched
24              state.
25
26       --force|-f
27              Purge  a  broken package. In this mode bpkg will verify that the
28              package directory and archive no longer exist  and  then  remove
29              the package from the configuration.
30
31       --directory|-d dir
32              Assume  configuration is in dir rather than in the current work‐
33              ing directory.
34

COMMON OPTIONS

36       The common options are summarized below with a more  detailed  descrip‐
37       tion available in bpkg-common-options(1).
38
39       -v     Print essential underlying commands being executed.
40
41       -V     Print all underlying commands being executed.
42
43       --quiet|-q
44              Run quietly, only printing error messages.
45
46       --verbose level
47              Set the diagnostics verbosity to level between 0 and 6.
48
49       --jobs|-j num
50              Number of jobs to perform in parallel.
51
52       --no-result
53              Don't print informational messages about the outcome of perform‐
54              ing a command.
55
56       --no-progress
57              Suppress progress indicators for long-lasting  operations,  such
58              as network transfers, building, etc.
59
60       --build path
61              The build program to be used to build packages.
62
63       --build-option opt
64              Additional option to be passed to the build program.
65
66       --fetch path
67              The fetch program to be used to download resources.
68
69       --fetch-option opt
70              Additional option to be passed to the fetch program.
71
72       --fetch-timeout sec
73              The fetch and fetch-like (for example, git) program timeout.
74
75       --git path
76              The git program to be used to fetch git repositories.
77
78       --git-option opt
79              Additional common option to be passed to the git program.
80
81       --sha256 path
82              The sha256 program to be used to calculate SHA256 sums.
83
84       --sha256-option opt
85              Additional option to be passed to the sha256 program.
86
87       --tar path
88              The tar program to be used to extract package archives.
89
90       --tar-option opt
91              Additional option to be passed to the tar program.
92
93       --openssl path
94              The openssl program to be used for crypto operations.
95
96       --openssl-option opt
97              Additional option to be passed to the openssl program.
98
99       --auth type
100              Types of repositories to authenticate.
101
102       --trust fingerprint
103              Trust repository certificate with a SHA256 fingerprint.
104
105       --trust-yes
106              Assume the answer to all authentication prompts is yes.
107
108       --trust-no
109              Assume the answer to all authentication prompts is no.
110
111       --pager path
112              The pager program to be used to show long text.
113
114       --pager-option opt
115              Additional option to be passed to the pager program.
116
117       --options-file file
118              Read additional options from file.
119
120       --default-options dir
121              The directory to load additional default options files from.
122
123       --no-default-options
124              Don't load default options files.
125

DEFAULT OPTIONS FILES

127       See  bpkg-default-options-files(1)  for  an  overview  of  the  default
128       options files. For the pkg-purge command the search start directory  is
129       the  configuration  directory. The following options files are searched
130       for in each directory and, if found, loaded in the order listed:
131
132       bpkg.options
133       bpkg-pkg-purge.options
134
135       The following pkg-purge command options  cannot  be  specified  in  the
136       default options files:
137
138       --directory|-d
139

BUGS

141       Send bug reports to the users@build2.org mailing list.
142

144       Copyright (c) 2014-2019 Code Synthesis Ltd
145
146       Permission  is  granted to copy, distribute and/or modify this document
147       under the terms of the MIT License.
148
149
150
151bpkg 0.12.0                      November 2019               bpkg-pkg-purge(1)
Impressum