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 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

PKG-VERIFY OPTIONS

22       --silent
23              Suppress the error messages about the reason why the package  is
24              invalid. Just return the error status.
25
26       --deep Verify the presence of the required *-build values/files and the
27              validity of files referenced by the *-file manifest values.
28
29       --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
34       --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

COMMON OPTIONS

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

DEFAULT OPTIONS FILES

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
156       bpkg.options
157       bpkg-pkg-verify.options
158

BUGS

160       Send bug reports to the users@build2.org mailing list.
161
163       Copyright (c) 2014-2022 the build2 authors.
164
165       Permission is granted to copy, distribute and/or modify  this  document
166       under the terms of the MIT License.
167
168
169
170bpkg 0.15.0                        July 2022                bpkg-pkg-verify(1)
Impressum