1bpkg-pkg-verify(1) General Commands Manual bpkg-pkg-verify(1)
2
6 bpkg-pkg-verify - verify package archive
7
9 bpkg pkg-verify [options] file
10
12 The pkg-verify command verifies that the specified archive file is a
13 valid bpkg package. Specifically, it checks that the file's name and
14 the top-level directory inside the archive match the canonical name-
15 version form and that there is a valid manifest file in that top-level
16 directory. Additionally, if the --deep option is specified, it also
17 checks that the required *-build values/files are present in the mani‐
18 fest/archive and the files referenced by the *-file manifest values are
19 present in the archive and are not empty.
20
22 --silent
23 Suppress the error messages about the reason why the package is
24 invalid. Just return the error status.
25 --deep Verify the presence of the required *-build values/files and the
27 validity of files referenced by the *-file manifest values.
28 --ignore-unknown
30 Ignore unknown manifest entries. By default, bpkg will refuse to
31 declare such a package valid since it cannot be sure the unknown
32 entries are valid.
33 --manifest
35 Instead of printing the successful verification result in the
36 human-readable form, dump the package manifest to stdout. If the
37 --deep option is specified, then in the resulting manifest the
38 *-file values are replaced with the contents of the referenced
39 files, the *-build values are automatically added (unless the
40 corresponding files are absent), and the package dependency con‐
41 straints are completed.
42
44 The common options are summarized below with a more detailed descrip‐
45 tion available in bpkg-common-options(1).
46 -v Print essential underlying commands being executed.
48 -V Print all underlying commands being executed.
50 --quiet|-q
52 Run quietly, only printing error messages.
53 --verbose level
55 Set the diagnostics verbosity to level between 0 and 6.
56 --stdout-format format
58 Representation format to use for printing to stdout.
59 --jobs|-j num
61 Number of jobs to perform in parallel.
62 --no-result
64 Don't print informational messages about the outcome of perform‐
65 ing a command or some of its parts.
66 --progress
68 Display progress indicators for long-lasting operations, such as
69 network transfers, building, etc.
70 --no-progress
72 Suppress progress indicators for long-lasting operations, such
73 as network transfers, building, etc.
74 --build path
76 The build program to be used to build packages.
77 --build-option opt
79 Additional option to be passed to the build program.
80 --fetch path
82 The fetch program to be used to download resources.
83 --fetch-option opt
85 Additional option to be passed to the fetch program.
86 --fetch-timeout sec
88 The fetch and fetch-like (for example, git) program timeout.
89 --pkg-proxy url
91 HTTP proxy server to use when fetching package manifests and ar‐
92 chives from remote pkg repositories.
93 --git path
95 The git program to be used to fetch git repositories.
96 --git-option opt
98 Additional common option to be passed to the git program.
99 --sha256 path
101 The sha256 program to be used to calculate SHA256 sums.
102 --sha256-option opt
104 Additional option to be passed to the sha256 program.
105 --tar path
107 The tar program to be used to extract package archives.
108 --tar-option opt
110 Additional option to be passed to the tar program.
111 --openssl path
113 The openssl program to be used for crypto operations.
114 --openssl-option opt
116 Additional option to be passed to the openssl program.
117 --auth type
119 Types of repositories to authenticate.
120 --trust fingerprint
122 Trust repository certificate with a SHA256 fingerprint.
123 --trust-yes
125 Assume the answer to all authentication prompts is yes.
126 --trust-no
128 Assume the answer to all authentication prompts is no.
129 --pager path
131 The pager program to be used to show long text.
132 --pager-option opt
134 Additional option to be passed to the pager program.
135 --options-file file
137 Read additional options from file.
138 --default-options dir
140 The directory to load additional default options files from.
141 --no-default-options
143 Don't load default options files.
144 --keep-tmp
146 Don't remove the bpkg's temporary directory at the end of the
147 command execution and print its path at the verbosity level 2 or
148 higher.
149
151 See bpkg-default-options-files(1) for an overview of the default op‐
152 tions files. For the pkg-verify command the following options files are
153 searched for in the predefined directories (system, etc) and, if found,
154 loaded in the order listed:
155 bpkg.options
157 bpkg-pkg-verify.options
158
160 Send bug reports to the users@build2.org mailing list.
161
163 Copyright (c) 2014-2022 the build2 authors.
164 Permission is granted to copy, distribute and/or modify this document
166 under the terms of the MIT License.
167bpkg 0.15.0 July 2022 bpkg-pkg-verify(1)