man pages section 1: User Commands

Exit Print View

Updated: July 2014
 
 

7z (1)

Name

7z - A file archiver with highest compression ratio

Synopsis

7z [adeltux] [-] [SWITCH] <ARCHIVE_NAME> <ARGUMENTS>...

Description




User Commands                                               7z(1)



NAME
     7z - A file archiver with highest compression ratio

SYNOPSIS
     7z [adeltux] [-] [SWITCH] <ARCHIVE_NAME> <ARGUMENTS>...

DESCRIPTION
     7-Zip is a file archiver with the highest compression ratio.
     The program supports 7z (that  implements  LZMA  compression
     algorithm),  ZIP,  CAB, ARJ, GZIP, BZIP2, TAR, CPIO, RPM and
     DEB formats. Compression ratio  in  the  new  7z  format  is
     30-50% better than ratio in ZIP format.

     7z uses plugins to handle archives.

FUNCTION LETTERS
     a    Add

     d    Delete

     e    Extract

     l    List

     t    Test

     u    Update

     x    eXtract with full paths

SWITCHES
     -ai[r[-|0]]{@listfile|!wildcard}
          Include archives

     -ax[r[-|0]]{@listfile|!wildcard}
          eXclude archives

     -bd  Disable percentage indicator

     -i[r[-|0]]{@listfile|!wildcard}
          Include filenames

     -l   don't  store symlinks; store the files/directories they
          point to (CAUTION : the scanning stage  can  never  end
          because of recursive symlinks like 'ln -s .. ldir')

     -m{Parameters}
          Set           Compression          Method          (see
          /usr/share/doc/p7zip/DOCS/MANUAL/switches/method.htm
          for a list of methods)

     -mhe=on|off



Mohammed Adnene TrLasttchange: September 1 2006                 1






User Commands                                               7z(1)



          7z  format  only  :  enables or disables archive header
          encryption (Default : off)

     -o{Directory}
          Set Output directory

     -p{Password}
          Set Password

     -r[-|0]
          Recurse subdirectories (CAUTION: this flag does not  do
          what you think, avoid using it)

     -sfx[{name}]
          Create SFX archive

     -si  Read data from StdIn (eg: tar cf - directory | 7z a -si
          directory.tar.7z)

     -so  Write data to StdOut (eg: %  echo  foo  |  7z  a  dummy
          -tgzip -si -so > /dev/null)

     -slt Sets technical mode for l (list) command

     -t{Type}
          Type of archive (7z, zip, gzip, bzip2 or tar. 7z format
          is default)

     -v{Size}[b|k|m|g]
          Create volumes

     -u[-][p#][q#][r#][x#][y#][z#][!newArchiveName]
          Update options

     -w[path]
          Set Working directory

     -x[r[-|0]]]{@listfile|!wildcard}
          Exclude filenames

     -y   Assume Yes on all queries

DIAGNOSTICS
     7-Zip returns the following exit codes:

          0    Normal (no errors or warnings detected)

          1    Warning (Non fatal error(s)).  For  example,  some
               files  cannot  be read during compressing. So they
               were not compressed

          2    Fatal error



Mohammed Adnene TrLasttchange: September 1 2006                 2






User Commands                                               7z(1)



          7    Bad command line parameters

          8    Not enough memory for operation

          255  User stopped the process with control-C (or  simi-
               lar)

Backup and limitations
     DO NOT USE the 7-zip format for backup purpose on Linux/Unix
     because :
      - 7-zip does not store the owner/group of the file.


     On Linux/Unix, in order to backup directories you  must  use
     tar :
      -  to  backup a directory  : tar cf - directory | 7za a -si
     directory.tar.7z
      - to restore your backup : 7za x -so directory.tar.7z | tar
     xf -

     If  you want to send files and directories (not the owner of
     file) to others Unix/MacOS/Windows users, you  can  use  the
     7-zip format.

       example : 7za a directory.7z  directory


     Do  not  use  "-r"  because  this  flag does not do what you
     think.

     Do not use directory/* because  of  ".*"  files  (example  :
     "directory/*" does not match "directory/.profile")

EXAMPLE 1
     7z a -t7z -m0=lzma -mx=9 -mfb=64
          adds  all  files  from  directory "dir1" to archive ar-
          chive.7z using "ultra settings"

     -t7z 7z archive

     -m0=lzma
          lzma method

     -mx=9
          level of compression = 9 (Ultra)

     -mfb=64
          number of fast bytes for LZMA = 64

     -md=32m
          dictionary size = 32 megabytes




Mohammed Adnene TrLasttchange: September 1 2006                 3






User Commands                                               7z(1)



     -ms=on
          solid archive = on

EXAMPLE 2
     7z a -sfx archive.exe dir1
          add all files from directory "dir1" to SFX archive  ar-
          chive.exe (Remark : SFX archive MUST end with ".exe")

EXAMPLE 3
     7z a -mhe=on -pmy_password archive.7z a_directory
          add  all  files from directory "a_directory" to the ar-
          chive  "archive.7z"  (with  data  and  header   archive
          encryption on)


ATTRIBUTES
     See   attributes(5)   for   descriptions  of  the  following
     attributes:

     +---------------+------------------+
     |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
     +---------------+------------------+
     |Availability   | compress/p7zip   |
     +---------------+------------------+
     |Stability      | Committed        |
     +---------------+------------------+
SEE ALSO
     7za(1), 7zr(1), bzip2(1), gzip(1), zip(1)

HTML Documentation
     /usr/share/doc/p7zip/DOCS/MANUAL/index.htm

AUTHOR
     Written for Debian by Mohammed Adnene Trojette.



NOTES
     This  software  was   built   from   source   available   at
     https://java.net/projects/solaris-userland.    The  original
     community   source   was   downloaded   from    http://down-
     loads.source-
     forge.net/project/p7zip/p7zip/9.20.1/p7zip_9.20.1_src_all.tar.bz2

     Further  information about this software can be found on the
     open  source  community  website   at   http://p7zip.source-
     forge.net/.








Mohammed Adnene TrLasttchange: September 1 2006                 4