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

Scroll to navigation

PVIMG(1) Pvimg Manual PVIMG(1)

NAME

pvimg - Create and inspect IBM Secure Execution images

SYNOPSIS



 pvimg [OPTIONS] <COMMAND>

DESCRIPTION

Use pvimg to create an IBM Secure Execution image, which can be loaded using zipl or QEMU. pvimg can also be used to inspect existing Secure Execution images.

PVIMG COMMANDS

pvimg-create(1)

Create an IBM Secure Execution image.

Create a new IBM Secure Execution image. Only create these images in a trusted environment, such as your workstation. The pvimg create command creates randomly generated keys to protect the image. The generated image can then be booted on an IBM Secure Execution system as a KVM guest.

pvimg-info(1)

Print information about the IBM Secure Execution image.

The info subcommand extracts and displays information about an existing IBM Secure Execution image, including information from the Secure Execution header. By default, the header is displayed without verifying its integrity and authenticity. Use --hdr-key to authenticate and verify the header integrity.

Output can be formatted as human-readable text or JSON. Use --format to control the output format and level of detail.

SECURITY NOTE: Without --hdr-key, the displayed information is NOT verified and should not be trusted.

pvimg-test(1)

Test different aspects of an existing IBM Secure Execution image

OPTIONS

-v, --verbose

Provide more detailed output.

-q, --quiet

Provide less output.

--version

Print version information and exit.

-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-create(1), pvimg-info(1), pvimg-test(1), zipl(8), qemu(1)

2026-08-11 s390-tools