# GPGTAR - Encrypt or sign files into an archive - man - [phpMan]

[_GPGTAR_(1)](https://www.chedong.com/phpMan.php/man/GPGTAR/1/markdown)                               GNU Privacy Guard 2.4                              [_GPGTAR_(1)](https://www.chedong.com/phpMan.php/man/GPGTAR/1/markdown)

## 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.  If no file name is given  (or  it
              is "-") the archive is taken from stdin.


### --encrypt
### -e     
              option  **--symmetric  **for  an  archive  that  may  be  decrypted  via a secret key or a
              passphrase.


### --decrypt
### -d     
              the archive is taken from stdin.


### --sign
### -s     
              option **--encrypt **to create a signed and then encrypted archive.


### --list-archive
### -t     
              the archive is taken from stdin.


### --symmetric
### -c     
              is AES-128, but may be chosen with the **--cipher-algo **option to **gpg**.


       **--recipient _**user_
### -r _
              Encrypt for user id _user_. For details see **gpg**.


       **--local-user _**user_
### -u _
              Use _user_ as the key to sign with.  For details see **gpg**.


       **--output _**file_
### -o _
              Write the archive to the specified file _file_.


### --verbose
### -v     


### --quiet
### -q     


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


### --dry-run
              Do not actually output the extracted files.


       **--directory _**dir_
### -C _
              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-from _**file_
### -T _
              Take the file names to work from the file _file_; one file per line.


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


### --utf8-strings
              Assume that the file names read by **--files-from **are 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.


### --batch
              Use batch mode.  Never ask but use the default action.  This option is passed directly
              to **gpg**.


       **--yes  **Assume "yes" on most questions.  Often used together with **--batch **to overwrite  exist‐
              ing files.  This option is passed directly to **gpg**.


       **--no   **Assume "no" on most questions.  This option is passed directly to **gpg**.


### --require-compliance
              This option is passed directly to **gpg**.


       **--status-fd _**n_
              Write  special  status  strings to the file descriptor _n_.  See the file DETAILS in the
              documentation for a listing of them.


### --with-log
              When extracting an encrypted tarball also write a log file with the gpg  output  to  a
              file named after the extraction directory with the suffix ".log".


       **--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**.


### --no-compress
              This  option  tells  gpg to disable compression (i.e. using option -z0).  It is useful
              for archiving only large files which  are  are  already  compressed  (e.g.  a  set  of
              videos).


       **--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 sup‐
              ported tar options are "--directory", "--files-from", and "--null" This is an obsolete
              options because those supported tar options can also be given directly.


       **--tar _**command_
              This is a dummy option for backward compatibility.


### --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
       [**gpg**(1)](https://www.chedong.com/phpMan.php/man/gpg/1/markdown), [**tar**(1)](https://www.chedong.com/phpMan.php/man/tar/1/markdown),

       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.



GnuPG 2.4.4                                  2024-01-25                                    [_GPGTAR_(1)](https://www.chedong.com/phpMan.php/man/GPGTAR/1/markdown)