Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

zipgrep (1)

Name

zipgrep - search files in a ZIP archive for lines matching a pattern

Synopsis

zipgrep     [egrep_options]     pattern     file[.zip]    [file(s) ...]
[-x xfile(s) ...]

Description

ZIPGREP(1)                  General Commands Manual                 ZIPGREP(1)



NAME
       zipgrep - search files in a ZIP archive for lines matching a pattern

SYNOPSIS
       zipgrep     [egrep_options]     pattern     file[.zip]    [file(s) ...]
       [-x xfile(s) ...]

DESCRIPTION
       zipgrep will search files within a ZIP archive for lines  matching  the
       given  string  or  pattern.   zipgrep  is  a  shell script and requires
       egrep(1) and unzip(1L) (and basename(1), grep(1), od(1), and sed(1)) to
       function.  Its output is generally similar to that of egrep(1).

ARGUMENTS
       pattern
              The  pattern  to be located within a ZIP archive.  Any string or
              regular expression accepted by egrep(1) may be used.  file[.zip]
              Path  of the ZIP archive.  (Wildcard expressions for the ZIP ar-
              chive name are not supported.)  If the specified filename is not
              found,  then  UnZip  (not the zipgrep script itself) appends the
              suffix .zip to the name,  and  tries  again.   Note  that  self-
              extracting  ZIP  files  are supported, as with any other ZIP ar-
              chive; just specify the .exe (or any other) suffix explicitly.

       [file(s)]
              An optional list of archive members to be  processed,  separated
              by  spaces.   If no member files are specified, then all members
              of the ZIP archive are  searched.   Regular  expressions  (wild-
              cards) may be used to match multiple members:

              *      matches a sequence of 0 or more characters

              ?      matches exactly 1 character

              [...]  matches  any  single character found inside the brackets;
                     ranges are specified by a beginning character, a  hyphen,
                     and  an  ending  character.  If an exclamation point or a
                     caret (`!' or `^') follows the  left  bracket,  then  the
                     range  of  characters within the brackets is complemented
                     (that is,  anything  except  the  characters  inside  the
                     brackets is considered a match).

              Be sure to quote any character(s) that might otherwise be inter-
              preted or modified by the operating system or shell.

       [-x xfile(s)]
              An optional list of archive members to be excluded from process-
              ing.   Because  wildcard  characters  match directory separators
              ("/"), this option may be used to exclude any files that are  in
              subdirectories.  For example, "zipgrep grumpy foo *.[ch] -x */*"
              would search for the string "grumpy" in all C  source  files  in
              the  main  directory of the "foo[.zip]" archive, but none in any
              subdirectories.  Without the -x option, all C source  files  (in
              all directories) within the archive would be searched.

OPTIONS
       All options prior to the ZIP archive filename are passed to egrep(1).


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


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | compress/unzip   |
       +---------------+------------------+
       |Stability      | Volatile         |
       +---------------+------------------+

SEE ALSO
       egrep(1),  unzip(1L),  zip(1L),  funzip(1L), zipcloak(1L), zipinfo(1L),
       zipnote(1L), zipsplit(1L)

URL
       The Info-ZIP main Web page is:
              http://www.info-zip.org/

       FTP access is available, too:
              ftp://ftp.info-zip.org/pub/infozip/

AUTHORS
       zipgrep was written by Jean-loup Gailly  and  others  in  the  Info-ZIP
       group.



NOTES
       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source     was    downloaded    from     http://antinode.info/ftp/info-
       zip/unzip610c25.zip.

       Further information about this software can be found on the open source
       community website at http://www.info-zip.org/UnZip.html.



Info-ZIP                        25 January 2013                     ZIPGREP(1)