bpkg-pkg-verify man page

bpkg-pkg-verify ā€” verify package archive

Synopsis

bpkg pkg-verify [options] file

Description

The pkg-verify command verifies that the specified archive file is a valid bpkg package. Specifically, it checks that the file's name and the top-level directory inside the archive match the canonical name-version form and that there is a valid manifest file in that top-level directory. Additionally, if the --deep option is specified, it also checks that the files referenced by the *-file manifest values are present in the archive and are not empty.

Pkg-Verify Options

--silent

Suppress the error messages about the reason why the package is invalid. Just return the error status.

--deep

Verify files referenced by the *-file manifest values.

--ignore-unknown

Ignore unknown manifest entries. By default, bpkg will refuse to declare such a package valid since it cannot be sure the unknown entries are valid.

--manifest

Instead of printing the successful verification result in the human-readable form, dump the package manifest to stdout. If the --deep option is specified, then in the resulting manifest the *-file values are replaced with the contents of the referenced files and the package dependency constraints are completed.

Common Options

The common options are summarized below with a more detailed description available in bpkg-common-options(1).

-v

Print essential underlying commands being executed.

-V

Print all underlying commands being executed.

--quiet|-q

Run quietly, only printing error messages.

--verbose level

Set the diagnostics verbosity to level between 0 and 6.

--jobs|-j num

Number of jobs to perform in parallel.

--no-result

Don't print informational messages about the outcome of performing a command.

--no-progress

Suppress progress indicators for long-lasting operations, such as network transfers, building, etc.

--build path

The build program to be used to build packages.

--build-option opt

Additional option to be passed to the build program.

--fetch path

The fetch program to be used to download resources.

--fetch-option opt

Additional option to be passed to the fetch program.

--fetch-timeout sec

The fetch and fetch-like (for example, git) program timeout.

--git path

The git program to be used to fetch git repositories.

--git-option opt

Additional common option to be passed to the git program.

--sha256 path

The sha256 program to be used to calculate SHA256 sums.

--sha256-option opt

Additional option to be passed to the sha256 program.

--tar path

The tar program to be used to extract package archives.

--tar-option opt

Additional option to be passed to the tar program.

--openssl path

The openssl program to be used for crypto operations.

--openssl-option opt

Additional option to be passed to the openssl program.

--auth type

Types of repositories to authenticate.

--trust fingerprint

Trust repository certificate with a SHA256 fingerprint.

--trust-yes

Assume the answer to all authentication prompts is yes.

--trust-no

Assume the answer to all authentication prompts is no.

--pager path

The pager program to be used to show long text.

--pager-option opt

Additional option to be passed to the pager program.

--options-file file

Read additional options from file.

Bugs

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

Referenced By

bpkg(1).

June 2019 bpkg 0.11.0