zfsa-key-load(1)

NAME

zfsa-key-load - Unlock: load the key

SYNOPSIS

zfsa key load [GLOBAL OPTIONS] [--mount] [--passphrase-file] [--passphrase-fd] [-h|--help] <DATASET>

DESCRIPTION

Unlock: load the key.

The key of the dataset's encryption root is loaded, which unlocks every dataset that shares it. On a terminal a wrong passphrase is asked for again, three times in all.

OPTIONS

--mount

Mount what the key unlocks

--passphrase-file <FILE>

Read the passphrase from the first line of this file

--passphrase-fd <N>

Read the passphrase from this open descriptor (3<file, <(...))

-h, --help

Print help (see a summary with '-h')

<DATASET>

A dataset whose encryption root is unlocked

EXAMPLES

Unlock tank/private and mount it, typing the passphrase:

zfsa key load tank/private --mount

Unlock it with the passphrase from a root-only file:

zfsa key load tank/private --passphrase-file /root/private.key

SEE ALSO

zfsa(1) for the global options, authorization, confirmations and exit status, zfsa-key(1).