Scroll to navigation

CHECKMEDIA(1) User Commands CHECKMEDIA(1)

NAME

checkmedia - check installation or Live media.

SYNOPSIS

checkmedia [OPTIONS] IMAGE

DESCRIPTION

Installation/Live media carry some meta data stored in a reserved area in the ISO9660 file system.

checkmedia can use these data to verify the media integrity.

IMAGE is an installation or Live medium; either ISO image or disk image.

Meta data come in two flavors: SUSE (SLE, openSUSE) style and Red Hat (RHEL, Fedora, CentOS, AlmaLinux, Rocky, ...) style. Both variants are supported.

For a detailed technical view, see <file:///usr/share/doc/packages/libmediacheck6/README.html>

Options

--key-file FILE

Use public key in FILE for signature verification.

--version

Show checkmedia version.

-v, --verbose

Show more detailed info (repeat for more).

-h, --help

Write this help text.

NOTES

If the meta data block contains several digests - for example, a digest over the entire ISO and, in case there is a partition table, also a digest over a partition - all digests are checked.

If a signature block is present, the signature is verified.

The default setting is to use keys installed in /usr/lib/rpm/gnupg/keys. Pass an individual key file using the --key-file option if some other key was used to sign (for example, your own key).

To verify an image built in the Open Build Service, extract the public project key with osc signkey.

EXAMPLES

# check foo.iso
checkmedia foo.iso
# check foo.iso, verify signature using your personal key ring
checkmedia --key-file ~/.gnupg/pubring.gpg foo.iso
# check foo.iso, built in the OBS in Foo:Bar:Project using the OBS project key
osc signkey Foo:Bar:Project | sed -e 's/>-/>\n-/' | checkmedia --key-file - foo.iso

SEE ALSO

checkisomd5(1), gpg(1), implantisomd5(1), osc(1), tagmedia(1).

LINKS

•checkmedia web site: <https://github.com/openSUSE/checkmedia>

•Open Build Service: <https://openbuildservice.org>

•openSUSE Build Service: <https://build.opensuse.org>
2024-03-05 checkmedia 6.3