1. Manuals
  2. Tumbleweed
  3. s390-tools
  4. pvimg-info(1)

Scroll to navigation

PVIMG-INFO(1) Pvimg Manual PVIMG-INFO(1)

NAME

pvimg-info - Print information about the IBM Secure Execution image

SYNOPSIS

pvimg info [OPTIONS] <INPUT|--print-schema <FORMAT>>

DESCRIPTION

Note that the API and output format is experimental and subject to change.

OPTIONS

<INPUT>

Use INPUT as the Secure Execution image.

--format <FORMAT>

Output format for the Secure Execution image information. If not specified, the format is automatically determined based on whether stdout is connected to a terminal.

Possible values:

- text: Human-readable, unstable text format (default if a terminal is available).

- text:full: Human-readable, full detail text format.

- json: Pretty-printed machine-readable JSON (default if no terminal available).

- json:pretty: Pretty-printed machine-readable JSON.

- json:minify: Minified machine-readable JSON.

--hdr-key <FILE>

Use the key in FILE to verify the Secure Execution header and optionally use --show-secrets to decrypt it. The key must be the same key that was specified with --hdr-key when the Secure Execution image was created. The key is used to:
1. Verify the integrity and authenticity of the header
2. Optionally decrypt secrets with --show-secrets

Without this option, the information is displayed, but NOT verified, and a warning is printed. The displayed data should not be trusted without verification.


--show-secrets

This option reveals sensitive information that is normally encrypted in the header, such as:
- Customer communication key (CCK)


- Image encryption key


- Other confidential data

SECURITY WARNING: Only use this option in secure, trusted environments. The decrypted secrets should never be exposed in untrusted systems.

This option requires --hdr-key to decrypt the header.


--print-schema <FORMAT>

Print the schema for the info subcommand and exit. This outputs the schema that describes the structure of the given output FORMAT produced by the info subcommand. The schema can be used for:


- Validating output


- Building tools that parse the output

Possible values:

- text: Human-readable, unstable text format.

- json: JSON format.

-h, --help

Print help (see a summary with -h).

EXIT STATUS

0 - Program finished successfully
The command was executed successfully.

1 - Generic error
Something went wrong during the operation. Refer to the error message.

2 - Usage error
The command was used incorrectly, for example: unsupported command line flag, or wrong number of arguments.

SEE ALSO

pvimg(1) zipl(8) qemu(1)

2026-02-13 s390-tools