fgrep(1)




NAME

     fgrep - search a file for a fixed-character string


SYNOPSIS

     /usr/bin/fgrep [-bchilnsvx]  [-e pattern_list]  [-f pattern-
     file] [pattern] [file...]

     /usr/xpg4/bin/fgrep   [-bchilnsvx]   [-e pattern_list]    [-
     f pattern-file] [pattern] [file...]


DESCRIPTION

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

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

     If no files are specified,  fgrep  assumes  standard  input.
     Normally,  each line that is found is copied to the standard
     output. The file name is printed before each  line  that  is
     found if there is more than one input file.


OPTIONS

     The following options are supported:

     -b    Precedes each line by the block number  on  which  the
           line  was  found. This can be useful in locating block
           numbers by context. The first block is 0.

     -c    Prints only a count of the lines that contain the pat-
           tern.

     -e pattern_list
           Searches for a string in pattern-list. This is  useful
           when the string begins with a -.

     -f pattern-file
           Takes the list of patterns from pattern-file.

     -h    Suppresses printing of files when  searching  multiple
           files.

     -i    Ignores upper/lower case distinction during  comparis-
           ons.

     -l    Prints the names of files with  matching  lines  once,
           separated  by  new-lines. Does not repeat the names of
           files when the pattern is found more than once.

     -n    Precedes each line by its line number in the file. The
           first line is 1.

     -s    Works silently, that is, displays nothing except error
           messages.  This  is  useful  for  checking  the  error
           status.

     -v    Prints all lines except those that  contain  the  pat-
           tern.

     -x    Prints only lines that are matched entirely.


OPERANDS

     The following operands are supported:

     file  Specifies a path name of a file to be searched for the
           patterns. If no file operands are specified, the stan-
           dard input will be used.

  /usr/bin/fgrep
     pattern
           Specifies a pattern to be used during the  search  for
           input.

  /usr/xpg4/bin/fgrep
     pattern
           Specifies one or more patterns to be used  during  the
           search  for  input.  This  operand is treated as if it
           were specified as -e pattern_list.


USAGE

     See largefile(5) for the  description  of  the  behavior  of
     fgrep  when  encountering  files  greater than or equal to 2
     Gbyte ( 2**31 bytes).


ENVIRONMENT VARIABLES

     See environ(5) for descriptions of the following environment
     variables  that  affect  the execution of fgrep: LC_COLLATE,
     LC_CTYPE, LC_MESSAGES, and NLSPATH.


EXIT STATUS

     The following exit values are returned:

     0     If any matches are found

     1     If no matches are found

     2     For syntax  errors  or  inaccessible  files,  even  if
           matches were found.


ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

  /usr/bin/fgrep
     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|

  /usr/xpg4/bin/fgrep
     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWxcu4                    |
    |_____________________________|_____________________________|
    | CSI                         | Enabled                     |
    |_____________________________|_____________________________|


SEE ALSO

     ed(1),  egrep(1),  grep(1),  sed(1),  sh(1),  attributes(5),
     environ(5), largefile(5), XPG4(5)


NOTES

     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 only by the size of the available  virtual
     memory.

  /usr/xpg4/bin/fgrep
     The   /usr/xpg4/bin/fgrep   utility    is    identical    to
     /usr/xpg4/bin/grep  -F  (see grep(1)). Portable applications
     should use /usr/xpg4/bin/grep -F.


Man(1) output converted with man2html