4.512 rtrv-ip-host

Use this command to retrieve the IP Host table. The IP Host table defines local host names for IP addresses.

Parameters

display (optional)

This parameter displays the provisioned local or remote IP Host entries.

Range:
all
displays all provisioned local and remote IP Host entries.
detail
displays the IP host and realm of all the provisioned local and remote IP Host entries.
host (optional)
Host name. The logical name of the device associated with the indicated IP address.
Range:
zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz

Any string of characters beginning with a letter and comprising up to 60 characters in length. Valid characters are a–z, A–Z, 0–9, - (dash), . (period)

ipaddr (optional)
The IP address associated with the hostname. This is a TCP/IP address expressed in standard dot notation. IP addresses consist of the system’s network number and the machine’s unique host number. An example IP address is 192.126.100.5, where 192.126.100 is the network number and 5 is the machine’s host number.
Range:
4 numbers separated by dots, with each number in the range of 0-255.
num (optional)
The number of IP Host entries displayed in the command output.
Range:
1 - 4096
System Default:
50
realm (optional)
Domain name from which the message can be sent or received for a particular IP Host.
Range:
zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz
A string of characters, beginning with a letter and comprising up to 60 characters in length. Valid values are a..z, A..Z, 0..9, -(dash), .(period).
type (optional)
This parameter specifies whether to retrieve entries for local or remote IPs.
Range:
local
host name and address of the IP card for the local system
remote
host name and address of the IP card for a remote system

Example

rtrv-ip-host:host=gw100-nc.tekelec.com:ipaddr=150.1.1.1

rtrv-ip-host:host=gw100.nc.tekelec.com

rtrv-ip-host:ipaddr=150.1.1.1

rtrv-ip-host

rtrv-ip-host:display=all

rtrv-ip-host:num=10

rtrv-ip-host:type=local:num=3

rtrv-ip-host:display=detail

rtrv-ip-host:realm=abc.com

Dependencies

A valid value must be specified for the host parameter. If the host name contains a hyphen, then the host name must be enclosed within quotation marks.

A valid value must be specified for the realm parameter. If the realm contains a hyphen, then the host name must be enclosed within quotation marks.

Display=all and realm parameter must not be specified together.

Notes

If optional parameters are specified, only the entries that match the entered parameters are retrieved.

Realm is mandatory for all the IP hosts associated with diameter connections.

Output

If this command is entered without any parameters, then the command displays up to a maximum of 50 entries. The display=all parameter must be specified to display all entries in the IP Host table.

This example displays output when no other parameter is specified:

rtrv-ip-host 
    tekelecstp 12-07-24 10:22:08 EST  EAGLE 45.0.0
    LOCAL IPADDR     LOCAL HOST
    192.168.63.51    tekelecdmz11.com
    192.168.63.115   tekelecdmz5.com
    192.168.73.116   tekelecdmz7.com
    192.168.63.52    tekelecdmz13.com
    192.168.63.54    tekelecdmz14.com
    192.168.63.55    hss4
    
    REMOTE IPADDR    REMOTE HOST
    192.168.63.235   tekelecdmz21.com
    127.1.1.1        tekelec0.com
    192.168.63.245   client
    192.168.63.57    tekelec1.com
    192.168.63.58    tekelec2.com
    192.168.63.59    tekelec3.com
    192.168.63.60    tekelec4.com
    192.168.63.61    tekelec5.com
    192.168.63.62    tekelec6.com
    192.168.63.63    tekelec7.com
    192.168.63.64    tekelec8.com
    192.168.63.65    tekelec9.com
    192.168.63.66    tekelec10.com
    192.168.63.67    tekelec11.com
    192.168.63.68    tekelec12.com
    192.168.63.69    tekelec13.com
    192.168.63.70    tekelec14.com
    192.168.63.71    tekelec15.com
    192.168.63.72    tekelec16.com
    192.168.63.73    tekelec17.com
    192.168.63.74    tekelec18.com
    192.168.63.75    tekelec19.com
    192.168.63.76    tekelec20.com
    192.168.63.77    tekelec21.com
    192.168.63.78    tekelec22.com
    192.168.63.79    tekelec23.com
    192.168.63.80    tekelec24.com
    192.168.63.81    tekelec25.com
    192.168.63.82    tekelec26.com
    192.168.63.83    tekelec27.com
    192.168.63.84    tekelec28.com
    192.168.63.85    tekelec29.com
    192.168.63.86    tekelec30.com
    192.168.63.87    tekelec31.com
    192.168.63.88    tekelec32.com
    192.168.63.89    tekelec33.com
    192.168.63.90    tekelec34.com
    192.168.63.91    tekelec35.com
    192.168.63.92    tekelec36.com
    192.168.63.93    tekelec37.com
    192.168.63.94    tekelec38.com
    192.168.63.95    tekelec39.com
    192.168.63.96    tekelec40.com
    192.168.63.97    tekelec41.com
      
    IP-HOST  table is (68 of 4096) 2% full.
    
;

This example displays the output when the output is filtered:

rtrv-ip-host:type=local:num=3 
    tekelecstp 12-07-24 10:22:09 EST  EAGLE 45.0.0 
    LOCAL IPADDR     LOCAL HOST
    192.168.63.51    tekelecdmz11.com
    192.168.63.115   tekelecdmz5.com
    192.168.73.116   tekelecdmz7.com
        
    IP-HOST  table is (68 of 4096) 2% full.
     
;

This example displays the output when all entries are requested:

rtrv-ip-host:display=all 
tekelecstp 12-07-24 10:22:09 EST  EAGLE 45.0.0
    LOCAL IPADDR     LOCAL HOST
    192.168.63.51    tekelecdmz11.com
    192.168.63.115   tekelecdmz5.com
    192.168.73.116   tekelecdmz7.com
    192.168.63.52    tekelecdmz13.com
    192.168.63.54    tekelecdmz14.com
    192.168.63.55    hss4
    
    REMOTE IPADDR    REMOTE HOST
    192.168.63.235   tekelecdmz21.com
    127.1.1.1        tekelec0.com
    192.168.63.245   client
    192.168.63.57    tekelec1.com
    192.168.63.58    tekelec2.com
    192.168.63.59    tekelec3.com
    192.168.63.60    tekelec4.com
    192.168.63.61    tekelec5.com
    192.168.63.62    tekelec6.com
    192.168.63.63    tekelec7.com
    192.168.63.64    tekelec8.com
    192.168.63.65    tekelec9.com
    192.168.63.66    tekelec10.com
    192.168.63.67    tekelec11.com
    192.168.63.68    tekelec12.com
    192.168.63.69    tekelec13.com
    192.168.63.70    tekelec14.com
    192.168.63.71    tekelec15.com
    192.168.63.72    tekelec16.com
    192.168.63.73    tekelec17.com
    192.168.63.74    tekelec18.com
    192.168.63.75    tekelec19.com
    192.168.63.76    tekelec20.com
    192.168.63.77    tekelec21.com
    192.168.63.78    tekelec22.com
    192.168.63.79    tekelec23.com
    192.168.63.80    tekelec24.com
    192.168.63.81    tekelec25.com
    192.168.63.82    tekelec26.com
    192.168.63.83    tekelec27.com
    192.168.63.84    tekelec28.com
    192.168.63.85    tekelec29.com
    192.168.63.86    tekelec30.com
    192.168.63.87    tekelec31.com
    192.168.63.88    tekelec32.com
    192.168.63.89    tekelec33.com
    192.168.63.90    tekelec34.com
    192.168.63.91    tekelec35.com
    192.168.63.92    tekelec36.com
    192.168.63.93    tekelec37.com
    192.168.63.94    tekelec38.com
    192.168.63.95    tekelec39.com
    192.168.63.96    tekelec40.com
    192.168.63.97    tekelec41.com
    192.168.63.98    tekelec42.com
    192.168.63.99    tekelec43.com
    192.168.63.20    tekelec44.com
    192.168.63.21    tekelec45.com
    192.168.63.22    tekelec46.com
    192.168.63.23    tekelec47.com
    192.168.63.24    tekelec48.com
    192.168.63.25    tekelec49.com
    192.168.63.26    tekelec50.com
    192.168.63.27    tekelec51.com
    192.168.63.28    tekelec52.com
    192.168.63.29    tekelec53.com
    192.168.63.30    tekelec54.com
    192.168.63.31    tekelec55.com
    192.168.63.32    tekelec56.com
    192.168.63.33    tekelec57.com
    192.168.63.34    tekelec58.com
    192.168.63.35    tekelec59.com
        
    IP-HOST  table is (68 of 4096) 2% full. 
;

This example displays the output when the display=detail parameter is specified:

rtrv-ip-host:display=detail 
tekelecstp 13-03-12 10:22:09 EST  EAGLE 45.1

REMOTE IPADDR     REMOTE HOST
                  REALM
1.1.1.13          a13
                  abc.com

1.1.1.12          a12

1.1.1.14          a14
               abc.com


LOCAL IPADDR      LOCAL HOST
                  REALM
10.248.141.165    local11
               xyz.com

IP-HOST table is (68 of 2048) 3% full.

;

This example displays the output when the realm parameter is specified:

rtrv-ip-host:realm=abc.com 
tekelecstp 13-03-12 10:22:09 EST  EAGLE 45.1

REMOTE IPADDR    REMOTE HOST
1.1.1.13         a13
1.1.1.14         a14

IP-HOST   table is (68 of 2048) 3% full.
;

This example displays the output when the ipaddr parameter is specified:

rtrv-ip-host:ipaddr=1.1.1.13 
tekelecstp 13-03-12 10:22:09 EST  EAGLE 45.1

REMOTE IPADDR    REMOTE HOST
                 REALM
1.1.1.13         a13
             abc.com
            
IP-HOST table is (68 of 2048) 3% full.
;

This example displays the output when the host parameter is specified:

rtrv-ip-host:host=a13 
tekelecstp 13-03-12 10:22:09 EST  EAGLE 45.1

REMOTE IPADDR    REMOTE HOST
                 REALM
1.1.1.13         a13
             abc.aricent.com

IP-HOST   table is (68 of 2048) 3% full.
;

This example displays the output when the output is filtered:

rtrv-ip-host:type=local:num=3 
tekelecstp 13-03-25 10:22:09 EST  EAGLE 45.1.0 
LOCAL IPADDR     LOCAL HOST
                 REALM
192.168.63.51    tekelecdmz11.com

192.168.63.115   tekelecdmz5.com
                 test.com
   
192.168.73.116   tekelecdmz7.com
        
IP-HOST  table is (68 of 2048) 3% full.
     
;

Related Topics