gpgtar(1)
NAME
gpgtar – Encrypt or sign files into an archive
SYNOPSIS
gpgtar [options] filename1 [ filename2, … ] directory1 [ directory2, … ]
DESCRIPTION
gpgtar encrypts or signs files into an archive. It is an gpg-ized tar using the same format as used by PGP’s PGP Zip.
OPTIONS
gpgtar understands these options:
–create- Put given files and directories into a vanilla “ustar” archive.
–extract- Extract all files from a vanilla “ustar” archive.
–encrypt-eEncrypt given files and directories into an archive. This option may be combined with option–symmetricfor an archive that may be decrypted via a secret key or a passphrase.–decrypt-dExtract all files from an encrypted archive.–sign-sMake a signed archive from the given files and directories. This can be combined with option–encryptto create a signed and then encrypted archive.–list-archive-tList the contents of the specified archive.–symmetric-cEncrypt with a symmetric cipher using a passphrase. The default symmetric cipher used is AES-128, but may be chosen with the–cipher-algooption togpg.–recipientuser-ruser Encrypt for user id user. For details seegpg.–local-useruser-uuser Use user as the key to sign with. For details seegpg.–outputfile-ofile Write the archive to the specified file file.–verbose-vEnable extra informational output.–quiet-qTry to be as quiet as possible.–skip-crypto- Skip all crypto operations and create or extract vanilla “ustar” archives.
–dry-run- Do not actually output the extracted files.
–directorydir-Cdir Extract the files into the directory dir. The default is to take the directory name from the input filename. If no input filename is known a directory named ‘GPGARCH‘ is used. For tarball creation, switch to directory dir before performing any operations.–files-fromfile-Tfile Take the file names to work from the file file; one file per line.–null- Modify option
–files-fromto use a binary nul instead of a linefeed to separate file names. –utf8-strings- Assume that the file names read by
–files-fromare UTF-8 encoded. This option has an effect only on Windows where the active code page is otherwise assumed. –openpgp- This option has no effect because OpenPGP encryption and signing is the default.
–cms- This option is reserved and shall not be used. It will eventually be used to encrypt or sign using the CMS protocol; but that is not yet implemented.
–set-filenamefile- Use the last component of file as the output directory. The default is to take the directory name from the input filename. If no input filename is known a directory named ‘GPGARCH‘ is used. This option is deprecated in favor of option
–directory. –gpggpgcmd- Use the specified command gpgcmd instead of
gpg. –gpg-argsargs- Pass the specified extra options to
gpg. –tar-argsargs- Assume args are standard options of the command
tarand parse them. The only supported tar options are "–directory", "–files-from", and "–null" This is an obsolete options because those supported tar options can also be given directly. –version- Print version of the program and exit.
–help- Display a brief help page and exit.
EXAMPLES
Encrypt the contents of directory ‘mydocs‘ for user Bob to file ‘test1‘:
gpgtar --encrypt --output test1 -r Bob mydocs
List the contents of archive ‘test1‘:
gpgtar --list-archive test1
DIAGNOSTICS
The program returns 0 if everything was fine, 1 otherwise.
SEE ALSO
The full documentation for this tool is maintained as a Texinfo manual. If GnuPG and the info program are properly installed at your site, the command
info gnupg
should give you access to the complete manual including a menu structure and an index.