numgrep(1) [debian man page]
NUMGREP(1) User Contributed Perl Documentation NUMGREP(1) NAME
numgrep - This program is the numeric equivilent of the grep utility. SYNOPSIS
numgrep [-dhlV] <FILE> | numgrep [-dhlV] (Input on STDIN from pipeline.) numgrep [-dhlV] (Input on STDIN. Use Ctrl-D to stop.) DESCRIPTION
numgrep searches for different occurances of numbers through the use of numeric expressions. OPTIONS
-l Print the matching numbers out one per line instead of printing the entire line they are on. -h Help: You're looking at it. -V Increase verbosity. -d Debug mode. For developers EXPRESSIONS
numgrep uses a special numeric expression matching system. Basically, it searches for ranges, factors and sequences of numbers. Here is a list of the syntax characters and some sample expressions that will get you going: /<expression>/ Put your expression or set of expressions between these two forward slashes. .. Range expression. A number must be used on the left and/or right of this expression to specify that numbers between, greater than or less than the numbers specified should be matched. , Expression sepeartor. The comma sepearates one complete expression from another in a set enclosed by //. m<n> Multiples of <n>. This operator, followed by a number <n> will match any number <x> that is an integer multiple of <n>. Meaning that <x> = <n> times <y>, where <y> is any integer. f<n> Factors of <n>. This operator, followed by a number <n> will match any number <x> that is an integer factor of <n>. Meaning that <x> = <n> divided by <y>, where <y> is any integer. NOTE: Checking for factors and multiples is very fast because it is checked by doing a single modulus operation on two numbers. Examples: /2..10/ Match any number between 2 and 10. /2..10,20..30/ Match any number between 2 and 10 or between 20 and 30. /56,34,512,45,67/ Match any of the numbers 56, 34, 512, 45 or 67. /m3/ Match any integer that is a multiple of 3. /f1024/ Match any integer that is a factor of 1024. $ numrange -N /1..1000/ | numgrep /f1024/ 1 2 4 8 16 32 64 128 256 512 $ BUGS
numgrep can't handle certain situations properly. Such as if it encounters a number with leading zeros, it will treat it as an octal number and thus might not match the way you would expect. numgrep does not yet allow you to mix numbers and text in the matching expression. So you can not do something like 'numgrep /port=0..1023/ firewall.log'. But this will be changed in the future. SEE ALSO
numaverage(1), numbound(1), numinterval(1), numnormalize(1), numprocess(1), numsum(1), numrandom(1), numrange(1), numround(1) COPYRIGHT
numgrep is part of the num-utils package, which is copyrighted by Suso Banderas and released under the GPL license. Please read the COPYING and LICENSE files that came with the num-utils package Developers can read the GOALS file and contact me about providing submitions or help for the project. BUGS
numgrep will round decimal numbers with more than 15 digits of accuracy. This is mostly due to limit's in the way programming languages deal directly with numbers. MORE INFO
More info on numgrep can be found at: http://suso.suso.org/programs/num-utils/ perl v5.10.1 2009-10-31 NUMGREP(1)
Check Out this Related Man Page
GREP(1) General Commands Manual GREP(1) NAME
grep, egrep, fgrep - search a file for a pattern SYNOPSIS
grep [ option ] ... expression [ file ] ... egrep [ option ] ... [ expression ] [ file ] ... fgrep [ option ] ... [ strings ] [ file ] DESCRIPTION
Commands of the grep family search the input files (standard input default) for lines matching a pattern. Normally, each line found is copied to the standard output; unless the -h flag is used, the file name is shown if there is more than one input file. Grep patterns are limited regular expressions in the style of ed(1); it uses a compact nondeterministic algorithm. Egrep patterns are full regular expressions; it uses a fast deterministic algorithm that sometimes needs exponential space. Fgrep patterns are fixed strings; it is fast and compact. The following options are recognized. -v All lines but those matching are printed. -c Only a count of matching lines is printed. -l The names of files with matching lines are listed (once) separated by newlines. -n Each line is preceded by its line number in the file. -b Each line is preceded by the block number on which it was found. This is sometimes useful in locating disk block numbers by con- text. -s No output is produced, only status. -h Do not print filename headers with output lines. -y Lower case letters in the pattern will also match upper case letters in the input (grep only). -e expression Same as a simple expression argument, but useful when the expression begins with a -. -f file The regular expression (egrep) or string list (fgrep) is taken from the file. -x (Exact) only lines matched in their entirety are printed (fgrep only). Care should be taken when using the characters $ * [ ^ | ? ' " ( ) and in the expression as they are also meaningful to the Shell. It is safest to enclose the entire expression argument in single quotes ' '. Fgrep searches for lines that contain one of the (newline-separated) strings. Egrep accepts extended regular expressions. In the following description `character' excludes newline: A followed by a single character matches that character. The character ^ ($) matches the beginning (end) of a line. A . matches any character. A single character not otherwise endowed with special meaning matches that character. A string enclosed in brackets [] matches any single character from the string. Ranges of ASCII character codes may be abbreviated as in `a-z0-9'. A ] may occur only as the first character of the string. A literal - must be placed where it can't be mistaken as a range indicator. A regular expression followed by * (+, ?) matches a sequence of 0 or more (1 or more, 0 or 1) matches of the regular expression. Two regular expressions concatenated match a match of the first followed by a match of the second. Two regular expressions separated by | or newline match either a match for the first or a match for the second. A regular expression enclosed in parentheses matches a match for the regular expression. The order of precedence of operators at the same parenthesis level is [] then *+? then concatenation then | and newline. SEE ALSO
ed(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. BUGS
Ideally there should be only one grep, but we don't know a single algorithm that spans a wide enough range of space-time tradeoffs. Lines are limited to 256 characters; longer lines are truncated. GREP(1)