filesha512 function reference

This topic provides reference information about the filesha512 function, which calculates the SHA-512 hash of a file's contents.

Introduction

The filesha512 is a variant of sha512 that hashes the contents of a given file rather than a literal string.

This is similar to sha512(file(filename)), but because file accepts only UTF-8 text it cannot be used to create hashes for binary files.

Syntax

Use the filesha512 function with the following syntax:

filesha512(path)

The path is the relative or absolute file path to the file whose SHA-512 hash you want to compute.

In the following example, the function returns the SHA-512 value of example.txt.

$ filesha512("example.txt")
861844d6704e8573fec34d967e20bcfe6e061b3348b3b0c7e9b7c6a482f6f15a48bffd0fb928fd8c9f9196f7a8596d5e32b45d5a25488a8499396a67442c1d76

Example use case

In the following example, the filesha512 function computes the SHA-512 hash of the file example.txt located in the current module's directory.

output "file_hash" {
  value = filesha512("example.txt")
}

Related functions

• sha512 computes the SHA-512 hash of a given string and encodes it with hexadecimal digits.
• filesha256 computes the SHA-1 hash of a given file and encodes it with hexadecimal digits.
• filesha1computes the SHA-1 hash of a given file and encodes it with hexadecimal digits.