fmlgrep(1F)                                              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 limited
             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 (for example, $,
             `, ', ") 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
                   pattern.
             -i    Ignore upper/lower case distinction during comparisons.
             -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 unreadable
                   files.
             -v    Print all lines except those that contain the pattern.

       DIAGNOSTICS
             fmlgrep returns the following exit values:





                           Copyright 1994 Novell, Inc.               Page 1

      fmlgrep(1F)                                              fmlgrep(1F)


            0     if the pattern is found (that is, TRUE)

            1     if the pattern is not found (that is, FALSE)

            2     if an invalid expression was used or file is
                  inaccessible

      NOTICES
            Lines are limited to BUFSIZ characters; longer lines are
            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.

      REFERENCES
            ed(1), fgrep(1), fmlcut(1F), grep(1)































                          Copyright 1994 Novell, Inc.               Page 2