unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

fgrep(1)                         User Commands                        fgrep(1)



NAME
       fgrep - search a file for a fixed-character string

SYNOPSIS
       /usr/bin/fgrep  [-bchilnsvx]  [-e pattern_list] [-f pattern-file] [pat-
       tern] [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. There-
       fore, 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  compar-
                       isons.



       -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 pattern.



       -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 attributes:

   /usr/bin/fgrep
       tab()    allbox;    cw(2.750000i)|     cw(2.750000i)     lw(2.750000i)|
       lw(2.750000i).  ATTRIBUTE TYPEATTRIBUTE VALUE AvailabilitySUNWcsu


   /usr/xpg4/bin/fgrep
       tab()     allbox;     cw(2.750000i)|    cw(2.750000i)    lw(2.750000i)|
       lw(2.750000i).  ATTRIBUTE TYPEATTRIBUTE VALUE  T{  Availability  T}SUN-
       Wxcu4 CSIEnabled


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 sin-
       gle 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.



SunOS 5.10                        4 Oct 2002                          fgrep(1)