fmlgrep(1F)       MISC. REFERENCE MANUAL PAGES        fmlgrep(1F)



NAME
     fmlgrep - search a file for a pattern

SYNOPSIS
     fmlgrep [options] limited_regular_expression [file ...]

DESCRIPTION
     fmlgrep searches file for a pattern  and  prints  all  lines
     that  contain  that pattern.  The fmlgrep function uses lim-
     ited  regular  expressions  (expressions  that  have  string
     values  that  use  a subset of the possible alphanumeric and
     special characters) like those used with ed(1) to match  the
     patterns.  It uses a compact non-deterministic algorithm.

     Be careful when using FMLI special characters (e.g.,  $,  `,
     ',  ")  in  limited_regular_expression.   It  is  safest  to
     enclose  the  entire  limited_regular_expression  in  single
     quotes ' ... ' .

     If file is not specified, fmlgrep  assumes  standard  input.
     Normally,  each  line  matched is copied to standard output.
     The file name is printed before each line matched  if  there
     is more than one input file.

     Command line options are:

     -b    Precede each line by the block number on which it  was
           found.   This  can be useful in locating block numbers
           by context (first block is 0).
     -c    Print only a count of the lines that contain the  pat-
           tern.
     -i    Ignore upper/lower case distinction  during  comparis-
           ons.
     -l    Print only the names of  files  with  matching  lines,
           separated  by new-lines.  Does not repeat the names of
           files when the pattern is found more than once.
     -n    Precede each line by  its  line  number  in  the  file
           (first line is 1).
     -s    Suppress error messages about nonexistent  or  unread-
           able files.
     -v    Print all lines except those that contain the pattern.

DIAGNOSTICS
     fmlgrep returns the following exit values:

     0  if the pattern is found (i.e., TRUE)
     1  if the pattern is not found (i.e., FALSE)
     2  if an invalid expression was used or file is inaccessible


NOTES
     Lines are limited to BUFSIZ  characters;  longer  lines  are



                          Last change:                          1

fmlgrep(1F)       MISC. REFERENCE MANUAL PAGES        fmlgrep(1F)



     truncated.  BUFSIZ is defined in /usr/include/stdio.h.

     If there is a line with embedded nulls,  fmlgrep  will  only
     match up to the first null; if it matches, it will print the
     entire line.

SEE ALSO
     fmlcut(1F).
     ed(1), egrep(1), fgrep(1), grep(1)  in  the  UNIX  System  V
     Programmer's Reference Manual.













































                          Last change:                          2