man pages section 1: User Commands

digest(1)

Name

digest - calculate a message digest

Synopsis

/usr/bin/digest -l | [-v] -a algorithm [-t truncation] [file]...

Description

The digest utility calculates the message digest of the given files or stdin using the algorithm specified. If more than one file is given, each line of output is the digest of a single file.

Options

The following options are supported:

–a algorithm

Specifies the name of the algorithm to use during the encryption or decryption process. See USAGE, Algorithms, for details.

–l

Displays list of algorithms available on the system. This list can change depending on the configuration of the cryptographic framework.

–v

Verbose output. Includes the algorithm name and filename in the output. This produces output similar to the GNU coreutils digest utilities, md5sum(1), sha1sum(1), sha256sum(1), sha512sum(1), etc.

–t truncation

Specifies the digest truncation length, where t is any positive number less than 512. Valid only for algorithm sha512_t.

Usage

Algorithms

The supported algorithms are displayed by the –l option. These algorithms are provided by the Cryptographic Framework. These values are used with the –a option and are case-sensitive.

Examples

Example 1 Digesting a File

The following example generates the SHA256 digest of the file /etc/motd:

example$ digest -a sha256 /etc/motd
e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

The following example displays the SHA512/256 digest of the file /etc/motd:

example $ digest -a sha512_t -t 256 /etc/motd
1917c02fbf36970f354defef8c089adf5767cec93c3ca2b28fe29958c4361e69

Example 2 Generating a Directory Manifest

The following example generates a directory manifest with SHA-1:

example$ digest -v -a sha1 /usr/lib/inet/*
sha1 (/usr/lib/inet/certdb) = f6d43e6e395d50db24d34e4af4828598c8918b16
sha1 (/usr/lib/inet/certlocal) = 7f74ba4a019b809c7023212b4bda10d9485e071d
sha1 (/usr/lib/inet/certrldb) = 1f845d30b8d02066647de04311e74549049852ed
sha1 (/usr/lib/inet/dhcp) = e3db5e4ff40a69d13f2497254526c2015d2c37b3
sha1 (/usr/lib/inet/dsvclockd) = b61aad7ed6a0f82145c3c26aedc613ab4a1f032e
sha1 (/usr/lib/inet/in.dhcpd) = 382210180c826fbb2e747236c489062bac8cc30b
sha1 (/usr/lib/inet/in.iked) = be6061fad725d37256e773dc85f8bd5248649463
sha1 (/usr/lib/inet/in.mpathd) = 5bd6bf0340fd5c4cc0c53f2df158302a0e85f9d0
sha1 (/usr/lib/inet/in.ndpd) = fdb768aebe7e5eb4465e1c1bb5e679b496f5c5c6
sha1 (/usr/lib/inet/in.ripngd) = 4f56a0df2d4a252f581a73c2e84143b920d0b66b
sha1 (/usr/lib/inet/wanboot) = a8b8c51c389c774d0be2ae43cb85d1b1439484ae
sha1 (/usr/lib/inet/ntpd) = 5b4aff102372cea801e7d08acde9655fec81f07c

Example 3 Displaying a List of Available Algorithms

The following example displays a list of available algorithms to digest:

example $ digest -l
sha1
md5
sha224
sha256
sha384
sha512
sha512_t
sha3_224
sha3_256
sha3_384
sha3_512

Exit Status

The following exit values are returned:

0

Successful completion.

> 0

An error occurred.

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE Availability system/core-os Interface Stability Committed

See Also

cksum(1), encrypt(1), mac(1), libpkcs11(3LIB), attributes(7), pkcs11_softtoken(7), bart(8), cryptoadm(8)

History

The SHA-3 algorithms sha3_224, sha3_256, sha3_384, and sha3_512 were added in Oracle Solaris 11.4.0.

The –t option and sha512_t algorithm were added in Solaris 11.4.0.

The sha224 algorithm was added in Solaris 11.1.0.

The SHA-2 algorithms sha256, sha384, and sha512 were added in Solaris 10 6/06 (Update 2).

The digest command, and all other algorithms & options, were added in Solaris 10 3/05.