net route

net route(1)		      BIG-IP TMSH Manual		  net route(1)



NAME
       route - Configures a route for traffic management.

MODULE
       net

SYNTAX
       Configure the route component within the net module using the syntax in
       the following sections.

   CREATE/MODIFY
	create route [name | ip address/netmask | default | default-inet6]
	modify route [name | ip address/netmask | default | default-inet6]
	  options:
	    blackhole
	    description [string]
	    gw [ip address]
	    interface [name]
	    mtu [integer]
	    network [ip address/netmask]
	    pool [name]

	edit route
	  [ [name | ip address/netmask | default | default-inet6] | [glob] | [regex] ] ... ]
	  options:
	    all-properties
	    non-default-properties

   DISPLAY
	list route
	list route
	  [ [name | ip address/netmask | default | default-inet6] | [glob] | [regex] ] ... ]
	show running-config route
	show running-config route
	  [ [name | ip address/netmask | default | default-inet6] | [glob] | [regex] ] ... ]
	  options:
	    all-properties
	    mtu
	    non-default-properties
	    one-line
	    partition

	show route
	show route
	  [ [name | ip address/netmask | default | default-inet6] | [glob] | [regex] ] ... ]
	  options:
	    connected
	    dynamic
	    field-fmt
	    lookup [ip address]
	    static

   DELETE
	delete route [name | ip address/netmask | default | default-inet6]

DESCRIPTION
       You can configure routes for the system, including default routes.

       Note that when you use the command edit to create a new route, by
       default the gw (gateway) option is set. If you do not want to use the
       gw option, remove that line of syntax in the editor.

EXAMPLES
       create route myRoute3 network 12.12.4.0/24 interface external

       Sets the route myRoute3 to the address 12.12.4.0/24 on the interface
       named external.

       create route 12.12.3.0/24 gw 10.10.10.254

       Sets the route to the subnet 12.12.3.0/24 whose gateway IP address is
       10.10.10.254.

       create route default gw 10.10.10.254

       Sets the default gateway IP address to 10.10.10.254.

       show route lookup myRoute

       Displays the route that the system uses to reach the IP address
       12.12.3.0.

OPTIONS
       Note: The options blackhole, gw, interface, and pool are mutually
       exclusive. You can use only one of these options at a time, and you
       must specify at least one of these options when configuring a route.

       blackhole
	    Specifies that the system drops traffic that is addressed to the
	    specified destination.

       connected
	    Displays connected routes.

       description
	    User defined description.

       dynamic
	    Displays dynamic routes.

       glob Displays the items that match the glob expression. See help glob
	    for a description of glob expression syntax.

       gw   Specifies a gateway address for the system.

       interface
	    Specifies the tunnel, VLAN or VLAN group to which the system sends
	    traffic.

       ip address/netmask
	    Specifies the destination subnet and mask using CIDR notation,
	    such as 12.12.3.0/24. You can also specify the keyword default or
	    default-inet6.

       lookup
	    Displays the route that the system uses to reach the specified IP
	    address. You can specify only a single IP address with the lookup
	    option.

       mtu  Sets a specific maximum transition unit (MTU). If you set this
	    option to 0 (zero), the system selects the appropriate MTU for the
	    route, and does not display the MTUs.

       network
	    Specifies the destination subnet and mask using CIDR notation,
	    such as 12.12.3.0/24. You can also specify the keyword default or
	    default-inet6.

       partition
	    Displays the administrative partition within which the route
	    resides.

       pool Specifies a pool to which the system sends traffic. This allows
	    the system to send traffic to multiple, load-balanced gateways.

       regex
	    Displays the items that match the regular expression. The regular
	    expression must be preceded by an at sign (@[regular expression])
	    to indicate that the identifier is a regular expression. See help
	    regex for a description of regular expression syntax.

       static
	    Displays static routes.

SEE ALSO
       create, delete, edit, glob, list, ltm pool, modify, net vlan, net vlan-
       group, regex, 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 2008-2010, 2013. All rights
       reserved.



BIG-IP				  2013-04-12			  net route(1)