libroot/posix/stdio: Remove unused portions.
[haiku.git] / src / bin / unzip / zipgrep.txt
blob46b968159027d039111ed3d0000f9b574db4e421
2 ZIPGREP(1L)                                           ZIPGREP(1L)
4 NAME
5        zipgrep - search files in a ZIP archive for lines matching
6        a pattern
8 SYNOPSIS
9        zipgrep [egrep_options] pattern  file[.zip]  [file(s) ...]
10        [-x xfile(s) ...]
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).
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.
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:
37               *      matches a sequence of 0 or more characters
39               ?      matches exactly 1 character
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).
51               (Be sure to quote any character that  might  other-
52               wise  be  interpreted  or modified by the operating
53               system.)
55        [-x xfile(s)]
56               An optional list of archive members to be  excluded
57               from  processing.   Since wildcard characters match
59 Info-ZIP                 17 February 2002                       1
61 ZIPGREP(1L)                                           ZIPGREP(1L)
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.
72 OPTIONS
73        All  options  prior to the ZIP archive filename are passed
74        to egrep(1).
76 SEE ALSO
77        egrep(1), unzip(1L),  zip(1L),  funzip(1L),  zipcloak(1L),
78        zipinfo(1L), zipnote(1L), zipsplit(1L)
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/ .
85 AUTHORS
86        zipgrep was written by Jean-loup Gailly.
88 Info-ZIP                 17 February 2002                       2