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 616 (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.
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 create a 'gii' account and set up its password that will be used when connecting 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 them ready to accept queries. Here is an example of such a session.
(lpj@obelix: 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>
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.
The following command will display parameters related to the internal structure of gated:
The following command will display parameters related to the interfaces:
The following command will display parameters related to the routing table:
Some examples:
GateD> sh ip walkdown 0/0
100 Sta 0.0.0.0/0 192.231.253.2 IGP (Id 1)
100 Sta 127/8 127.0.0.1 IGP (Id 1)
100 RIP 141.211/16 192.231.253.2 IGP (Id 1)
100 RIP 141.212/16 192.231.253.2 IGP (Id 1)
100 RIP 141.213/16 192.231.253.2 IGP (Id 1)
100 RIP 141.214/16 192.231.253.2 IGP (Id 1)
100 Dir 192.231.253/24 192.231.253.50 IGP (Id 1)
100 Dir 198.108/24 198.108.0.9 IGP (Id 1)
100 RIP 198.108.60/24 192.231.253.2 IGP (Id 1)
GateD>
GateD> sh ip walkdown 141/8
100 RIP 141.211/16 192.231.253.2 IGP (Id 1)
100 RIP 141.212/16 192.231.253.2 IGP (Id 1)
100 RIP 141.213/16 192.231.253.2 IGP (Id 1)
100 RIP 141.214/16 192.231.253.2 IGP (Id 1)
GateD>
GateD> sh ip walkup 192.231.253/24
100 Dir 192.231.253/24 192.231.253.50 IGP (Id 1)
100 Sta 0.0.0.0/0 192.231.253.2 IGP (Id 1)
GateD>
GateD> sh ip ro 198.108.60/24
100 Route 198.108.60 - 255.255.255 entries 1 Announced 1 Depth 0 <>
100 * RIP 192.231.253.2 192.231.253.2 4/0 0 10:25:13 IGP (Id 1)
These commands are only available for the new OSPF shipped with gated version 3_6Alpha_2 and higher.