grepΒΆ

grep(1) 		      BIG-IP TMSH Manual		       grep(1)



NAME
       grep - Display lines matching a pattern

SYNTAX
	 list [component] "|" grep [ [option | pattern] ... ]
	 show [component] "|" grep [ [option | pattern] ... ]
	   options:
	     -A [integer]
	     -B [integer]
	     -C [integer]
	     -E
	     -G
	     -P
	     -c
	     -e [pattern]
	     -i
	     -m [integer]
	     -n
	     -o
	     -v
	     -w
	     -x Note: Each option must be followed by a space.

       Note: tmsh treats any argument that is not preceded by a supported
       option, and does not begin with a hyphen, as a search pattern preceded
       by -e.

DESCRIPTION
       You can use grep to filter the output generated by the commands list
       (configuration settings) and show (statistics and runtime status). You
       must type the character | before the grep specification. You can use
       multiple filters chained together.

EXAMPLES
       The following examples show how to use the grep utility in tmsh.

       list ltm node | grep "^10\.2"
       list ltm virtual | grep -i seattle
       list ltm virtual | grep -i abc | grep -i ab | grep -i a

OPTIONS
       -A   Display the specified number of lines of context after matching
	    lines.

       -B   Display the specified number of lines of context before matching
	    lines.

       -C   Display the specified number of lines of context before and after
	    matching lines.

       -E   Interpret patterns as extended regular expressions.

       -G   Interpret patterns as basic regular expressions.

       -P   Interpret patterns as Perl regular expressions.

       -c   Display a count of the lines that match. If -v is specified the
	    number of non-matching lines is displayed.

       -e   Specify a pattern. This is useful to protect against patterns
	    beginning with a hyphen.

       -i   Case insensitive search.

       -m   Stop reading input after the specified number of matching lines.
	    If -c is specified the count will not exceed the value specified
	    for -m. If -v is specified grep will stop after finding the
	    specified number of non-matching lines.

       -n   Prefix each line of output with the line number relative to the
	    input.

       -o   Show only the part of a matching line that matches the pattern.

       -v   Invert the sense of matching, to select non-matching lines.

       -w   Select only those  lines  containing  matches  that  form  whole
	    words.  The  test is that the matching substring must either be at
	    the beginning of the line, or preceded  by	a  non-word
	    constituent  character. Similarly, it must be either at the end of
	    the line or followed by a non-word constituent character.  Word-
	    constituent  characters are letters, digits, and the underscore.

       -x   Select only those matches that exactly match the whole line.

SEE ALSO
       list, show, tmsh

COPYRIGHT
       No part of this program may be reproduced or transmitted in any form or
       by any means, electronic or mechanical, including photocopying,
       recording, or information storage and retrieval systems, for any
       purpose other than the purchaser's personal use, without the express
       written permission of F5 Networks, Inc.

       F5 Networks and BIG-IP (c) Copyright 2009. All rights reserved.

POD ERRORS
       Hey! The above document had some coding errors, which are explained
       below:

       Around line 122:
	   You forgot a '=back' before '=head1'



BIG-IP				  2009-07-22			       grep(1)