← All commands
THE COMMAND REFERENCE

sha512sum

Compute or verify SHA-512 checksums of files.

Last updated

GNU

Implementation-level reference; examples are not certified for every installed version.

Overview

sha512sum reads a file, or standard input, and prints a 512-bit digest of its contents as hexadecimal, followed by the file name. Two files with the same digest are, for practical purposes, identical; a single changed byte changes the digest completely. With -c it reads a list of digests made earlier and checks each file against it. It is the longest of the common SHA-2 digests, and is often faster than SHA-256 on 64-bit machines.

Background

The macOS manual for its checksum tools says the -sum forms, including sha512sum, have command-line options and an output format that match those of the similarly named GNU utilities, which is why the three implementations here are interchangeable for the common uses. Today the name covers GNU sha512sum, the one macOS ships, and the applet in BusyBox.

Examples

Print the digest of some text; printf is used because echo adds a newline that changes the digest:

printf abc | sha512sum

Print only the first eight characters of the digest:

printf abc | sha512sum | cut -c1-8

Print the digest of a file; the file name follows the digest:

printf abc > f.txt && sha512sum f.txt

Save digests to a file and check them later with -c; each file reports OK:

printf abc > f.txt && sha512sum f.txt > SUMS && sha512sum -c SUMS

Detect a changed file; -c prints FAILED and exits with a non-zero status, so the echo runs:

printf abc > f.txt && sha512sum f.txt > SUMS && printf x >> f.txt && sha512sum -c SUMS 2> /dev/null || echo changed

Options

-c
Read digests and file names from a file, and check that each file still matches.

--tag
Print BSD-style lines such as SHA256 (file) = digest instead of the default.

--quiet
With -c, do not print OK for files that match.

Common mistakes

Hashing echo text and printf text gives different digests, because echo adds a newline; make sure you hash what you mean to. A digest proves a file is unchanged only if the digest itself came from a source you trust, for example over a different channel than the file. The text mode and binary mode markers (-t and -b) make no difference on Linux and macOS. Checking with -c needs the file names in the list to be reachable from where you run it.

Portability

Only the plain form and -c are in the Common examples; the output line digest file (two spaces) is the same on all the implementations here. GNU adds --tag, --quiet and --ignore-missing, which are also in the macOS tools, and --zero. The Common examples were executed on GNU coreutils 9.11, macOS system tools, and BusyBox 1.37.0 (see the development guide for the exact check).

About GNU sha512sum

GNU sha512sum is part of GNU coreutils, and this page's checks ran coreutils 9.11.

References

Original explanations, with upstream documentation for further reading. FreeBSD references are comparison material, not a claim of Apple version equivalence.