## 7.6 GateD Interactive Interface

The GateD Interactive Interface (GII) provides an interactive interface to a running GateD daemon which can be used to query internal gated variables. This interface, which is implemented like any other protocol in GateD, accepts telnet connections to port 6116 (C.f. [RFC 854] for a description of the telnet protocol), and after user identification, answers any query sent as ascii commands. The commands include querying about the memory, routing table, interface list, and other internal parameters.

### 7.6.1 Configuration

### 7.6.2 Connection to the gii

### 7.6.3 Getting help

### 7.6.4 Show Commands

### 7.6.5 GateD Internals

### 7.6.6 Interfaces

### 7.6.7 Routing tables

### 7.6.8 ospf

### 7.6.9 bgp

### 7.6.10 igmp

### 7.6.11 DVMRP

### 7.6.12 PIM-SM

### 7.6.13 Other

### 7.6.1 Configuration

GII will identify the user by using the Unix password of the gii ID of the system. In other words, when using the GII interface, one must creat a 'gii'account and set up its password that will be used when connecting to the GII.

### 7.6.2 Connection to the GII

Users open a telnet connection to the machine running GateD, on TCP port 616. They identify themselves using a simple password scheme, and get the GateD prompt. The GII is then ready to accept queries. Here is an example of such a session:

(lpj@belix: 53) telnet radb2.ra.net 616

Trying 198.108.0.9...

Connected to radb2.ra.net.

Escape character is '~]'.

Password?

100 GateD Interactive Interface. Version R3_5Alpha_10

GateD> sh ip

100 HELP: The possible subcommands are:

100 route [x.x.x/len]: Show info about IP routes

100 walkup x.x.x/len: Show less specific routes

100 walkdown x.x.x/len: Show more specific routes

GateD>

### 7.6.3 Getting Help

The top level command help provides a list of available commands. Commands may be followed by subcommands. To get help about the subcommand, just type the main command without subcommand. GII will display a list of available subcommands. Commands may be abbreviated when no confusion is possible.

### 7.6.4 Show Command Parameters

kernel

> show the kernel support.

interface [name | address]

> show interface status.

memory

> show the memory allocation.

ip [pimsm | igmp]

> show info about ip protocol The options to show under IP protocol include the pim-sm commands and the igmp commands:

> ip pimsm [bsr | crp | routeall | rpset | timeout | [interface address]]

> > ip igmp groups

task

> show list of active tasks.

dvmrp [mfc | targets]

> show info about dvmrp protocol.

ospf [global | [ interface address] | [area [id]]

> show info about ospf protocol.

timer

> show list of timers.

bgp [summary | [peeras as_no] | [aspath regexp]]

### 7.6.5 GateD Internals

The following command will display parameters related to the internal structure of GateD:

show version

> shows the version of the running GateD.

show kernel

> shows the type of kernel of the host, including what features are support (Reject routes, Multicast, UDP chechsums, etc...).

show memory

> shows the memory usage, divided by memory block structures.

show task

> shows the running tasks in GateD.

show timers

> shows list of timers.

### 7.6.6 Interfaces

The following command will display parameters related to the interfaces:

show interface [name|index]

> Without parameter, this command lists all the interfaces of the system. If one interface name or index is given as an argument, all the parameters concerning this interface are displayed.

### 7.6.7 Routing tables

The following command will display parameters related to the routing table:

show ip route [x.x.x/len]

> Without parameter, this command prints the size of the IP routing table. With an argument, which must be a prefix number and mask length, it displays complete information about the given route, like number of announcements, next hop, AS path, active route, etc...

show ip walkup x.x.x/len

> Lists all the routes that are less specific than x.x.x/len, i.e. all the components of the aggregate x.x.x/len. show ip walkdown 0/0 will display the whole routing table. ^C can be used to stop the listing.

show ip rpf <source-address>

> Displays how IP multicast routing does Reverse Path Forwarding. Since GateD can RPF from multiple routing tables (i.e. unicast routing table, DVMRP routing table, or static mroutes), this command tells you where the information is retrieved from

### 7.6.8 ospf

global

> shows general ospf options

interface address

> shows IP interface status

area [=0]

> shows area information

### 7.6.9 bgp

show bgp summary

show bgp peeras [AS number]

show bgp aspath [AS path regexp]

### 7.6.10 igmp

show ip igmp groups

> Displays directly connected groups learned via IGMP.

### 7.6.11 DVMRP

show dvmrp mfc

> List all Multicast forwarding cache defined.

show dvmrp targets

> Lists all the DVMRP targets (interfaces).

### 7.6.12 PIM-SM

show ip pimsm bsr

> Displays BSR status.

show ip pimsm crp

> Displays Candidate Rp status.

show ip pimsm interface

> Displays PIM-SM interface information.

show ip pimsm neighbor

> Displays PIM-SM neighbors discovered.

show ip pimsm routeall

> Shows PIM-SM Routing table.

show ip pimsm rpset

> Dump RP-SET.

show ip pimsm timeout

> Dump all components, timeouts.

### 7.6.13 Other

quit

> to close the GII session.

#### Basic Facts

- GII listening on port 616. Telnet to this port.
- User name and password required.

- User name GII_USER defined in gii.h. Default is "gii"
- Password protected off of/etc/passwd file.
- Main commands:

> help - show help screen.

> show - queries GateD for current status. See below for parameters.

> quit - end your telnet session.

Show is the working command. Syntax: show <parameter> [optional parameters

Last updated April 28, 1997

gated@gated.merit.edu