src/bin/unzip/zipgrep.txt

   1
   2 ZIPGREP(1L)                                           ZIPGREP(1L)
   3
   4 NAME
   5        zipgrep - search files in a ZIP archive for lines matching
   6        a pattern
   7
   8 SYNOPSIS
   9        zipgrep [egrep_options] pattern  file[.zip]  [file(s) ...]
  10        [-x xfile(s) ...]
  11
  12 DESCRIPTION
  13        zipgrep  will  search files within a ZIP archive for lines
  14        matching the given string or pattern.  zipgrep is a  shell
  15        script  and  requires  egrep(1) and unzip(1L) to function.
  16        Its output is identical to that of egrep(1).
  17
  18 ARGUMENTS
  19        pattern
  20               The pattern to be located  within  a  ZIP  archive.
  21               Any   string  or  regular  expression  accepted  by
  22               egrep(1) may be used.  file[.zip] Path of  the  ZIP
  23               archive.  (Wildcard expressions for the ZIP archive
  24               name are not supported.)  If the  literal  filename
  25               is  not  found,  the suffix .zip is appended.  Note
  26               that self-extracting ZIP files  are  supported,  as
  27               with  any  other ZIP archive; just specify the .exe
  28               suffix (if any) explicitly.
  29
  30        [file(s)]
  31               An optional list of  archive  members  to  be  pro-
  32               cessed,  separated  by  spaces.  If no member files
  33               are specified, all members of the ZIP  archive  are
  34               searched.   Regular  expressions (wildcards) may be
  35               used to match multiple members:
  36
  37               *      matches a sequence of 0 or more characters
  38
  39               ?      matches exactly 1 character
  40
  41               [...]  matches any single  character  found  inside
  42                      the  brackets;  ranges  are  specified  by a
  43                      beginning character, a hyphen, and an ending
  44                      character.   If  an  exclamation  point or a
  45                      caret (`!' or `^') follows the left bracket,
  46                      then  the  range  of  characters  within the
  47                      brackets is complemented (that is,  anything
  48                      except the characters inside the brackets is
  49                      considered a match).
  50
  51               (Be sure to quote any character that  might  other-
  52               wise  be  interpreted  or modified by the operating
  53               system.)
  54
  55        [-x xfile(s)]
  56               An optional list of archive members to be  excluded
  57               from  processing.   Since wildcard characters match
  58
  59 Info-ZIP                 17 February 2002                       1
  60
  61 ZIPGREP(1L)                                           ZIPGREP(1L)
  62
  63               directory separators (`/'), this option may be used
  64               to  exclude  any  files that are in subdirectories.
  65               For example, ``zipgrep grumpy foo *.[ch]  -x  */*''
  66               would  search  for  the  string ``grumpy'' in all C
  67               source files in the main directory of  the  ``foo''
  68               archive,  but  none in any subdirectories.  Without
  69               the -x option, all C source files in  all  directo-
  70               ries within the zipfile would be searched.
  71
  72 OPTIONS
  73        All  options  prior to the ZIP archive filename are passed
  74        to egrep(1).
  75
  76 SEE ALSO
  77        egrep(1), unzip(1L),  zip(1L),  funzip(1L),  zipcloak(1L),
  78        zipinfo(1L), zipnote(1L), zipsplit(1L)
  79
  80 URL
  81        The  Info-ZIP  home  page is currently at http://www.info-
  82        zip.org/pub/infozip/          or           ftp://ftp.info-
  83        zip.org/pub/infozip/ .
  84
  85 AUTHORS
  86        zipgrep was written by Jean-loup Gailly.
  87
  88 Info-ZIP                 17 February 2002                       2
  89