volume_key(8)               System Manager's Manual              volume_key(8)



<?><?><?> (NAME)
       volume_key - <?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> (escrow packets)


<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       volume_key [OPTION]... OPERAND...


<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> volume_key <<<?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?>>> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> (<?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>)
       <?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?> <?><?>
       <?><?> <<<?><?><?><?><?><?><?><?> <?><?><?><?><?>>> (escrow packets)
       <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> (<?><?><?><?>
       <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?><?>)<?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?><?> <?> <?><?><?><?><?><?><?><?><?>
       volume_key <?><?> <?><?><?><?> <?><?><?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> --save<?> --restore<?> --setup-volume<?>
       --reencrypt<?> --dump <?><?> --secrets <?><?><?><?><?>
       <?><?><?><?><?><?><?>. <?><?><?><?> <?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>.


<?><?><?><?><?><?><?><?> (OPTIONS)
       <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> VOLUME
       <?><?> <?><?><?><?><?><?> LUKS <?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?>:
              blkid -s TYPE VOLUME
       <?><?><?><?> <?><?><?><?><?> TYPE="crypto_LUKS" <?><?> <?><?><?><?><?>
       <?><?><?>.

       <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?>
       volume_key <?><?> <?><?><?><?> <?><?><?><?><?><?><?>:


       --save <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> VOLUME [PACKET]
              <?><?> <?><?><?><?>.  VOLUME <?><?> <?><?><?>
              <?><?><?><?><?><?>. <?><?><?> PACKET <?><?><?><?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?> <?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>.
              <?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?> VOLUME <?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?> <?><?> <?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?>. <?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?>
              <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?>.


       --restore
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> VOLUME PACKET
              <?><?> <?><?><?><?>.  VOLUME <?><?> <?><?><?> <?><?><?><?> <?>
              <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              PACKET <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?> <?><?> VOLUME
              <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?> <?><?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?> (<?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?>).


       --setup-volume
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> VOLUME PACKET
              NAME <?><?> <?><?><?><?>.  VOLUME <?><?> <?><?><?> <?><?><?><?>
              <?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?> PACKET <?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              <?> <?><?><?><?><?><?><?><?> VOLUME <?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> NAME
              <?><?><?><?><?><?><?> <?><?><?><?><?><?>.

              <?><?> <?><?><?> <?><?><?><?> NAME <?><?><?> <?><?> <?><?><?>
              dm-crypt <?><?><?> <?> <?><?><?> <?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
              /dev/mapper/NAME <?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?>.

              <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> VOLUME <?><?>
              <?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?>
              (<?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?>)<?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?> <?><?> <?><?><?> <?><?><?> <?><?>
              <?><?><?> <?><?><?><?><?><?> <?><?><?> VOLUME <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?>.


       --reencrypt
              <?><?><?><?><?><?> <?><?><?><?><?><?> PACKET <?><?>
              <?><?><?><?>.  PACKET <?><?> <?><?><?> <?><?><?><?> (<?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?>) <?> <?><?><?><?><?><?><?> <?><?> <?><?>
              <?><?> <?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>.


       --dump <?><?><?><?><?><?> <?><?><?><?><?><?> PACKET <?><?>
              <?><?><?><?>.  PACKET <?><?> <?><?><?> <?><?><?><?> (<?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?>) <?> <?><?><?><?><?><?><?> PACKET <?><?>
              <?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>.
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?>.


       --secrets
              <?><?><?><?><?><?> <?><?><?><?><?><?> PACKET <?><?>
              <?><?><?><?>.  PACKET <?><?> <?><?><?> <?><?><?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> PACKET <?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.


       --help <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?>.


       --version
              <?><?><?><?><?> <?><?><?><?> volume_key.


       <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?>:


       -b, --batch
              <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              (<?><?><?><?><?><?><?><?><?>). <?><?><?><?><?><?><?><?><?><?>
              <?> <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?> NUL <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>.
              <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?> <?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?>.


       -d, --nss-dir DIR
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?><?> NSS <?><?> <?><?><?><?> DIR
              <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?>.


       -o, --output PACKET
              <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> PACKET.

              <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?> <?><?><?><?> <?><?><?><?>: <?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
              <?><?> <?><?> <?><?><?><?><?><?><?> <?><?> --restore
              <?><?><?><?>.


       --output-data-encryption-key PACKET
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> (<?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?>) <?><?> PACKET.


       --output-passphrase PACKET
              <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?><?><?><?> <?><?><?> <?><?> PACKET.


       --create-random-passphrase PACKET
              <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?>-<?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?> VOLUME (<?><?><?><?> <?><?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?>) <?> <?><?><?><?><?>
              <?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?>
              PACKET.


       -c, --certificate CERT
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> CERT <?>
              <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?>.
              <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>.

              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?> CERT
              <?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
              <?><?><?> <?><?><?><?><?><?> (nickname) <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?><?> NSS.


       --output-format FORMAT
              <?><?><?><?><?><?><?> <?><?> FORMAT <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?>.  FORMAT <?><?>
              <?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?> <?><?><?><?>: asymmetric
              (<?><?><?><?><?><?><?> <?><?> CMS <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>)<?>
              asymmetric_wrap_secret_only (<?><?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?>)<?> passphrase
              (<?><?><?><?><?><?><?> <?><?> GPG <?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?>).


       --unencrypted
              <?><?><?><?><?> <?><?> --dump <?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> (<?><?>
              <?><?><?><?> <?><?><?><?>) <?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>.


       --with-secrets
              <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> --dump.


<?><?><?><?><?> <?><?><?><?> (EXIT STATUS)
       <?><?><?><?><?> volume_key <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?><?> <?><?><?><?> <?> <?> <?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?> <?> <?><?><?><?> <?><?><?><?><?><?>.


<?><?><?><?> (NOTES)
       <?><?><?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> LUKS <?><?><?>.


<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> volume_key <?><?>
       <?><?><?><?> <?><?><?> <?><?><?>.  <?><?> <?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?>
       <?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?> <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.  <?><?> <?><?> <?><?>
       <?><?> <?><?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?>:
              volume_key --save VOLUME -c CERT -o PACKET_DEFAULT
              --create-random-passphrase PACKET_PASSPHRASE
       <?><?><?><?><?><?><?><?> PACKET_DEFAULT <?> PACKET_PASSPHRASE <?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>.

       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?> <?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?> PACKET_DEFAULT
       <?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?> (<?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?> <?><?><?> <?><?><?>):
              volume_key --reencrypt -d NSS_DB PACKET_DEFAULT -o
              PACKET_DEFAULT_PW
       <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?> (<?><?><?><?><?> <?><?> <?><?><?><?> "rescue mode")<?>
       <?><?><?><?> PACKET_DEFAULT_PW <?><?> <?><?><?> <?><?> <?><?><?>
       <?><?><?><?> <?> <?><?><?><?><?><?> <?><?> <?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?>:
              volume_key --restore VOLUME PACKET_DEFAULT_PW

       <?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?><?> <?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?>:
              volume_key --secrets PACKET_PASSPHRASE
       <?> <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>.  (<?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?>.)

volume_key                         Jun 2011                      volume_key(8)