agrep man page on NetBSD

Man page or keyword search:  
man Server   9087 pages
apropos Keyword Search (all sections)
Output format
NetBSD logo
[printable version]

AGREP(1)		  BSD General Commands Manual		      AGREP(1)

NAME
     agrep — print lines approximately matching a pattern

SYNOPSIS
     agrep [options] pattern [files]

DESCRIPTION
     Searches for approximate matches of pattern in each FILE or standard
     input.

OPTIONS
   Regexp selection and interpretation
     -e pattern, --regexp=pattern
		 Use PATTERN as a regular expression; useful to protect pat‐
		 terns beginning with ‘-’.

     -i, --ignore-case
		 Ignore case distinctions (as defined by the current locale)
		 in pattern and input files.

     -k, --literal
		 Treat pattern as a literal string, that is, a fixed string
		 with no special characters.

     -w, --word-regexp
		 Force pattern to match only whole words.  A “whole word” is a
		 substring which either starts at the beginning or the record
		 or is preceded by a non-word constituent character.  Simi‐
		 larly, the substring must either end at the end of the record
		 or be followed by a non-word constituent character.  Word-
		 constituent characters are alphanumerics (as defined by the
		 current locale) and the underscore character.	Note that the
		 non-word constituent characters must surround the match; they
		 cannot be counted as errors.

   Approximate matching settings
     -D num, --delete-cost=num
		 Set cost of missing characters to num.

     -I num, --insert-cost=num
		 Set cost of extra characters to num.

     -S num, --substitue-cost=num
		 Set cost of incorrect characters to num.  Note that a dele‐
		 tion (a missing character) and an insertion (an extra charac‐
		 ter) together constitute a substituted character, but the
		 cost will be the that of a deletion and an insertion added
		 together.  Thus, if the const of a substitution is set to be
		 larger than the sum of the costs of deletion and insertion,
		 direct substitutions will never be done.

     -E -num, --max-errors=num
		 Select records that have at most num errors.

     -#		 Select records that have at most # errors (# is a digit
		 between 0 and 9).

   Miscellaneous
     -d -pattern, --delimiter=pattern
		 Set the record delimiter regular expression to pattern.  The
		 text between two delimiters, before the first delimiter, and
		 after the last delimiter is considered to be a record.	 The
		 default record delimiter is the regexp “\n”, so by default a
		 record is a line.  pattern can be any regular expression that
		 does not match the empty string.  For example, using -d
		 file ... defines mail messages as records in a Mailbox format
		 file.

     -v, --invert-match
		 Select non-matching records instead of matching records.

     -V, --version
		 Print version information and exit.

     -y, --nothing
		 Does nothing.	This options exists only for compatibility
		 with the non-free agrep program.

     --help	 Display a brief help message and exit.

   Output control
     -B, --best-match
		 Only output the best matching records, that is, the records
		 with the lowest cost.	This is currently implemented by mak‐
		 ing two passes over the input files and cannot be used when
		 reading from standard input.

     --color, --colour
		 Highlight the matching strings in the output with a color
		 marker.  The color string is taken from the GREP_COLOR envi‐
		 ronment variable.  The default color is red.

     -c, --count
		 Only print a count of matching records per each input file,
		 suppressing normal output.

     -h, --no-filename
		 Suppress the prefixing filename on output when multiple files
		 are searched.

     -H, --with-filename
		 Prefix each output record with the name of the input file
		 where the record was read from.

     -l, --files-with-matches
		 Only print the name of each input file which contains at
		 least one match, suppressing normal output.  The scanning for
		 each file will stop on the first match.

     -n, --record-number
		 Prefix each output record with its sequence number in the
		 input file.  The number of the first record is 1.

     -q, --quiet, --silent
		 Do not write anything to standard output.  Exit immediately
		 with zero exit status if a match is found.

     -s, --show-cost
		 Print match cost with output.

     --show-position
		 Prefix each output record with the start and end offset of
		 the first match within the record.  The offset of the first
		 character of the record is 0.	The end position is given as
		 the offset of the first character after the match.

     -M, --delimiter-after
		 By default, the record delimiter is the newline character and
		 is output after the matching record.  If -d is used, the
		 record delimiter will be output before the matching record.
		 This option causes the delimiter to be output after the
		 matching record.

     With no file, or when file is “-”, agrep reads standard input.  If less
     than two files are given -h is assumed, otherwise -H is the default.

EXAMPLES
	   agrep -2 optimize foo.txt
     outputs all lines in file foo.txt that match “optimize” within two
     errors.  E.g. lines which contain “optimise”, “optmise”, and “opitmize”
     all match.

DIAGNOSTICS
     Exit status is 0 if a match is found, 1 for no match, and 2 if there were
     errors.  If -E or -# is not specified, only exact matches are selected.

     pattern is a POSIX extended regular expression (ERE) with the TRE exten‐
     sions.

REPORTING BUGS
     Report bugs to the TRE mailing list ⟨tre-general@lists.laurikari.net⟩.

COPYRIGHT
     Copyright © 2002-2004 Ville Laurikari.

     This is free software, and comes with ABSOLUTELY NO WARRANTY.  You are
     welcome to redistribute this software under certain conditions; see the
     source for the full license text.

BSD			       November 21, 2004			   BSD
[top]
                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 
More information is available in HTML format for server NetBSD

List of man pages available for NetBSD

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net