Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, June 13, 2019

gpgtar (1)


gpgtar - Encrypt or sign files into an archive


gpgtar  [options] filename1 [ filename2, ... ] directory1 [ directory2,
... ]


GPGTAR(1)                    GNU Privacy Guard 2.2                   GPGTAR(1)

       gpgtar - Encrypt or sign files into an archive

       gpgtar  [options] filename1 [ filename2, ... ] directory1 [ directory2,
       ... ]

       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.

       gpgtar understands these options:

              Put  given  files  and  directories into a vanilla ``ustar'' ar-

              Extract all files from a vanilla ``ustar'' archive.

       -e     Encrypt given files  and  directories  into  an  archive.   This
              option  may  be  combined with option --symmetric for an archive
              that may be decrypted via a secret key or a passphrase.

       -d     Extract all files from an encrypted archive.

       -s     Make a signed archive from  the  given  files  and  directories.
              Thsi  can  be  combined with option --encrypt to create a signed
              and then encrypted archive.

       -t     List the contents of the specified archive.

       -c     Encrypt with a symmetric cipher using a passphrase.  The default
              symmetric  cipher  used  is  AES-128, but may be chosen with the
              --cipher-algo option to gpg.

       --recipient user
       -r user
              Encrypt for user id user. For details see gpg.

       --local-user user
       -u user
              Use user as the key to sign with.  For details see gpg.

       --output file
       -o file
              Write the archive to the specified file file.

       -v     Enable extra informational output.

       -q     Try to be as quiet as possible.

              Skip  all  crypto  operations  and  create  or  extract  vanilla
              ``ustar'' archives.

              Do not actually output the extracted files.

       --directory dir
       -C dir 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.

       --files-from file
       -T file
              Take  the  file  names  to work from the file file; one file per

       --null Modify option --files-from to use a  binary  nul  instead  of  a
              linefeed to separate file names.

              This option has no effect becuase OpenPGP encryption and signing
              is the default.

       --cms  This option is reserved and shall not be used.  It will  eventu-
              ally be used to encrypt or sign using the CMS protocol; but that
              is not yet implemented.

       --set-filename file
              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.

       --gpg gpgcmd
              Use the specified command gpgcmd instead of gpg.

       --gpg-args args
              Pass the specified extra options to gpg.

       --tar-args args
              Assume  args  are  standard options of the command tar and 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.

              Print version of the program and exit.

       --help Display a brief help page and exit.

       Encrypt the contents  of  directory  `mydocs'  for  user  Bob  to  file

         gpgtar --encrypt --output test1 -r Bob mydocs

       List the contents of archive `test1':

         gpgtar --list-archive test1

       The program returns 0 if everything was fine, 1 otherwise.

       See attributes(7) for descriptions of the following attributes:

       |Availability   | crypto/gnupg          |
       |Stability      | Pass-through volatile |
       gpg(1), tar(1),

       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

         info gnupg

       should  give  you access to the complete manual including a menu struc-
       ture and an index.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source                was                downloaded                from

       Further information about this software can be found on the open source
       community website at http://www.gnupg.org/.

GnuPG 2.2.8                       2018-06-06                         GPGTAR(1)