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

NAME

6       bpkg-pkg-verify - verify package archive
7

SYNOPSIS

9       bpkg pkg-verify [options] file
10

DESCRIPTION

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 files referenced by  the  *-file  manifest  values  are
18       present in the archive and are not empty.
19

PKG-VERIFY OPTIONS

21       --silent
22              Suppress  the error messages about the reason why the package is
23              invalid. Just return the error status.
24
25       --deep Verify files referenced by the *-file manifest values.
26
27       --ignore-unknown
28              Ignore unknown manifest entries. By default, bpkg will refuse to
29              declare such a package valid since it cannot be sure the unknown
30              entries are valid.
31
32       --manifest
33              Instead of printing the successful verification  result  in  the
34              human-readable form, dump the package manifest to stdout. If the
35              --deep option is specified, then in the resulting  manifest  the
36              *-file  values  are replaced with the contents of the referenced
37              files and the package dependency constraints are completed.
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       --jobs|-j num
54              Number of jobs to perform in parallel.
55
56       --no-result
57              Don't print informational messages about the outcome of perform‐
58              ing a command or some of its parts.
59
60       --no-progress
61              Suppress progress indicators for long-lasting  operations,  such
62              as network transfers, building, etc.
63
64       --build path
65              The build program to be used to build packages.
66
67       --build-option opt
68              Additional option to be passed to the build program.
69
70       --fetch path
71              The fetch program to be used to download resources.
72
73       --fetch-option opt
74              Additional option to be passed to the fetch program.
75
76       --fetch-timeout sec
77              The fetch and fetch-like (for example, git) program timeout.
78
79       --pkg-proxy url
80              HTTP proxy server to use when fetching package manifests and ar‐
81              chives from remote pkg repositories.
82
83       --git path
84              The git program to be used to fetch git repositories.
85
86       --git-option opt
87              Additional common option to be passed to the git program.
88
89       --sha256 path
90              The sha256 program to be used to calculate SHA256 sums.
91
92       --sha256-option opt
93              Additional option to be passed to the sha256 program.
94
95       --tar path
96              The tar program to be used to extract package archives.
97
98       --tar-option opt
99              Additional option to be passed to the tar program.
100
101       --openssl path
102              The openssl program to be used for crypto operations.
103
104       --openssl-option opt
105              Additional option to be passed to the openssl program.
106
107       --auth type
108              Types of repositories to authenticate.
109
110       --trust fingerprint
111              Trust repository certificate with a SHA256 fingerprint.
112
113       --trust-yes
114              Assume the answer to all authentication prompts is yes.
115
116       --trust-no
117              Assume the answer to all authentication prompts is no.
118
119       --pager path
120              The pager program to be used to show long text.
121
122       --pager-option opt
123              Additional option to be passed to the pager program.
124
125       --options-file file
126              Read additional options from file.
127
128       --default-options dir
129              The directory to load additional default options files from.
130
131       --no-default-options
132              Don't load default options files.
133

DEFAULT OPTIONS FILES

135       See bpkg-default-options-files(1) for an overview of  the  default  op‐
136       tions files. For the pkg-verify command the following options files are
137       searched for in the predefined directories (system, etc) and, if found,
138       loaded in the order listed:
139
140       bpkg.options
141       bpkg-pkg-verify.options
142

BUGS

144       Send bug reports to the users@build2.org mailing list.
145

147       Copyright (c) 2014-2021 the build2 authors.
148
149       Permission  is  granted to copy, distribute and/or modify this document
150       under the terms of the MIT License.
151
152
153
154bpkg 0.14.0                      October 2021               bpkg-pkg-verify(1)
Impressum