fgrep(1)                                                    fgrep(1)


       NAME
             fgrep - search a file for a character string

       SYNOPSIS
             fgrep [options] string [file . . . ]

       DESCRIPTION
             fgrep (fixed string grep) searches files for a character
             string and prints all lines that contain that string.  fgrep
             is different from grep and egrep because it searches for a
             string instead of searching for a pattern that matches an
             expression.  It uses a fast and compact algorithm.

             fgrep processes supplementary code set characters according to
             the locale specified in the LC_CTYPE environment variable [see
             LANG on environ(5)], except as noted under the -i option
             below.  Pattern searches are performed on characters, not
             bytes.

             The characters $, *, [, ^, |, (, ), and \ are interpreted
             literally by fgrep, that is, fgrep does not recognize full
             regular expressions as does egrep.  Because these characters
             have special meaning to the shell, it is safest to enclose the
             entire string in single quotes ' . . . '.

             If no files are specified, fgrep assumes standard input.
             Normally, each line found is copied to the standard output.
             The filename is printed before each line found 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.

             -h   Suppress printing of filenames when searching multiple
                  files.

             -i   Ignore uppercase/lowercase distinction during
                  comparisons; valid for single-byte characters only.





                           Copyright 1994 Novell, Inc.               Page 1

      fgrep(1)                                                    fgrep(1)


            -l   Print the names of files with matching lines once,
                 separated by newlines.  Does not repeat the names of
                 files when the pattern is found more than once.  If the
                 input file is stdin, then a message such as ``(standard
                 input)'' will be written, depending upon the message
                 locale.

            -n   Precede each line by its line number in the file (first
                 line is 1).

            -v   Print all lines except those that contain the pattern.

            -x   Print only lines matched entirely.

            -e special_string
                 Search for a special_string (string begins with a -).

            -f file
                 Take the list of strings from file.

      FILES
            /usr/lib/locale/locale/LC_MESSAGES/uxcore
                  language-specific message file [See LANG on environ(5).]

      REFERENCES
            ed(1), grep(1), sed(1), sh(1)

      DIAGNOSTICS
            Exit status is 0 if any matches are found, 1 if none, 2 for
            syntax errors or inaccessible files (even if matches were
            found).

      NOTICES
            Ideally there should be only one grep command, but there is
            not a single algorithm that spans a wide enough range of
            space-time tradeoffs.  Lines are limited to BUFSIZ bytes;
            longer lines are truncated.  BUFSIZ is defined in
            /usr/include/stdio.h.










                          Copyright 1994 Novell, Inc.               Page 2