logo

oasis-root

Compiled tree of Oasis Linux based on own branch at <https://hacktivis.me/git/oasis/> git clone https://anongit.hacktivis.me/git/oasis-root.git

grep.1 (2406B)


  1. .Dd 2015-10-08
  2. .Dt GREP 1
  3. .Os sbase
  4. .Sh NAME
  5. .Nm grep
  6. .Nd search files for patterns
  7. .Sh SYNOPSIS
  8. .Nm
  9. .Op Fl EFHchilnqsvx
  10. .Op Fl e Ar pattern
  11. .Op Fl f Ar file
  12. .Op Ar pattern
  13. .Op Ar file ...
  14. .Sh DESCRIPTION
  15. .Nm
  16. searches the input files for lines that match the
  17. .Ar pattern ,
  18. a regular expression as defined in
  19. .Xr regex 7 or
  20. .Xr re_format 7 .
  21. By default each matching line is printed to stdout.
  22. If no
  23. .Ar file
  24. is given
  25. .Nm
  26. reads from stdin.
  27. .Sh OPTIONS
  28. .Bl -tag -width Ds
  29. .It Fl E
  30. Match using extended regex.
  31. .It Fl F
  32. Match using fixed strings.
  33. Treat each pattern specified as a string instead of a regular
  34. expression.
  35. .It Fl H
  36. Prefix each matching line with its filename in the output.
  37. This is the default when there is more than one file specified.
  38. .It Fl c
  39. Print only a count of matching lines.
  40. .It Fl e Ar pattern
  41. Specify a pattern used during the search of the input: an input
  42. line is selected if it matches any of the specified patterns.
  43. This option is most useful when multiple -e options are used to
  44. specify multiple patterns, or when a pattern begins with a dash.
  45. .It Fl f Ar file
  46. Read one or more patterns from the file named by the pathname file.
  47. Patterns in file shall be terminated by a <newline>.
  48. A null pattern can be specified by an empty line in pattern_file.
  49. Unless the -E or -F option is also specified, each pattern shall be
  50. treated as a BRE.
  51. (`-').
  52. .It Fl h
  53. Do not prefix each line with 'filename:' prefix.
  54. .It Fl i
  55. Match lines case insensitively.
  56. .It Fl l
  57. Print only the names of files with matching lines.
  58. .It Fl n
  59. Prefix each matching line with its line number in the input.
  60. .It Fl q
  61. Print nothing, only return status.
  62. .It Fl s
  63. Suppress the error messages ordinarily written for nonexistent or unreadable
  64. files.
  65. .It Fl v
  66. Select lines which do
  67. .Sy not
  68. match the pattern.
  69. .It Fl w
  70. The expression is searched for as a word (as if surrounded by '\\<' and '\\>').
  71. .It Fl x
  72. Consider only input lines that use all characters in the line excluding the
  73. terminating <newline> to match an entire fixed string or regular expression to
  74. be matching lines.
  75. .El
  76. .Sh EXIT STATUS
  77. .Bl -tag -width Ds
  78. .It 0
  79. One or more lines were matched.
  80. .It 1
  81. No lines were matched.
  82. .It > 1
  83. An error occurred.
  84. .El
  85. .Sh SEE ALSO
  86. .Xr sed 1 ,
  87. .Xr regex 7 ,
  88. .Xr re_format 7
  89. .Sh STANDARDS
  90. The
  91. .Nm
  92. utility is compliant with the
  93. .St -p1003.1-2013
  94. specification.
  95. .Pp
  96. The
  97. .Op Fl Hhw
  98. flags are an extension to that specification.