Skip to main content

network route active-entry show

Contributors
Suggest changes
PDFs

Display active routes

Availability: This command is available to cluster and Vserver administrators at the advanced privilege level.

Description

The network route active-entry show command displays installed routes on one or more nodes. You can view routes within specified nodes, within specified Vservers, routes in specified subnet groups, and routes with specified destinations.

Parameters

[-fields <fieldname>,…​]

If you specify the -fields <fieldname>, …​ parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.

| [-verbose ] (privilege: advanced)

Use this parameter to display the reference count, use, interface, and Path MTU fields.

| [-instance ] (privilege: advanced) }

If you specify the -instance parameter, the command displays detailed information about all fields.

[-vserver <vserver>] - Vserver Name (privilege: advanced)

Displays the routes that have the specified Vserver as their origin.

[-node {<nodename>|local}] - Node (privilege: advanced)

Displays the routes from the specified node.

[-address-type {ipv4|ipv6|ipv6z}] - Address Family (privilege: advanced)

Displays the routes that have the specified IP address type.

[-subnet-group <IP Address/Mask>] - Subnet Group (privilege: advanced)

Displays the group of routes that belong to the specified subnet. Routes within the specified subnet group are used first before the default set. The "default" subnet group is a system-provided set of default routes.

[-destination <text>] - Destination (privilege: advanced)

Displays the routes that have the specified IP address or subnet as their destination. The format for the subnet is: <address>/<mask>. IPv6 address includes the scope value after percentage ("%"). 0.0.0.0/0, 169.254.4.60, ff02::%e0a/32 and fe80::250:56ff:fea6:db7c%e0b are valid values for this parameter.

[-interface <text>] - Interface Name (privilege: advanced)

Displays the routes that use the specified interface to transmit packets to the destination. A valid interface has the format of {<netport>|<ifgrp>}, such as "e0a", "e0a-1" and "a0a", or it can be a loopback interface, such as "lo" and "losk".

[-route-interface-address <text>] - Route Interface Address (privilege: advanced)

Displays the routes that use the specified IP address on the transmit interface.

[-gateway <text>] - Route gateway (privilege: advanced)

Displays the routes that have the specified gateway. The gateway can be an IP address, such as "10.10.2.1" and "fe80::1%lo", MAC address, such as "0:5:73:a0:1:7" or refer to a local link, such as "link#3".

[-metric <integer>] - Metric (privilege: advanced)

Displays the routes that have the specified metric.

[-flags <text>] - Flags (privilege: advanced)

Displays the routes that have the specified flags. The type string for "-flags" needs to be one or more of the following {U|G|H|R|D|S|1|2|L|C} in the order shown.

  • U - Usable

  • G - Gateway

  • H - Host

  • R - Reject

  • D - Dynamic

  • S - Static

  • 1 - Protocol1

  • 2 - Protocol2

  • L - Llinfo

  • C - Clone

Multiple values can be specified (for example: UHL).

[-reference-count <integer>] - Reference Count (privilege: advanced)

Displays the routes that have the specified reference count in the system.

[-lookup-count <integer>] - Lookup Count (privilege: advanced)

Displays the routes that have the specified use count (the count of lookups for the route).

[-path-mtu <integer>] - Path MTU (privilege: advanced)

Displays the routes that have the specified path maximum transmission unit.

Examples

The following example displays active routes on all nodes in Vserver vs0 with subnet-group 10.10.10.0/24.

cluster1::*> network route active-entry show -vserver vs0 -subnet-group 10.10.10.0/24
  (network route active-entry show)

Vserver: vs0
Node: node1
Subnet Group: 10.10.10.0/24
Destination             Gateway              Interface   Metric  Flags
----------------------  -------------------  ---------   ------  -----
default                 10.10.10.1           e0c              0  UGS

Vserver: vs0
Node: node2
Subnet Group: 10.10.10.0/24
Destination             Gateway              Interface   Metric  Flags
----------------------  -------------------  ---------   ------  -----
default                 10.10.10.1           e0c              0  UGS
2 entries were displayed.