show ip helper-address

Description                                                    Display DHCP relay information.

Syntax                                                                  show ip helper-address [detail]

Mode                                                                   All

Example                                                            The following command shows summary DHCP relay information:

ACOS(config)#show ip helper-address 

Interface  Helper-Address            RX            TX      No-Relay         Drops

---------  --------------  ------------  ------------  ------------  ------------

eth1       100.100.100.1              0             0             0             0

ve5        100.100.100.1           1669          1668             0             1

ve7                                1668          1668             0             0

ve8        100.100.100.1              0             0             0             0

ve9        20.20.20.102               0             0             0             0

 

The following table describes the fields in the command output.

Field

Description

Interface

ACOS interface. Interfaces appear in the output in either of the fol­lowing cases:

  A helper address is configured on the interface.

  DHCP packets are sent or received on the interface.

Helper-Address

Helper address configured on the interface.

RX

Number of DHCP packets received on the interface.

TX

Number of DHCP packets sent on the interface.

No-Relay

Number of packets that were examined for DHCP relay but were not relayed, and instead received regular Layer 2/3 processing.

Generally, this counter increments in the following cases:

  DHCP packets are received on an interface that does not have a helper address and the packets are not destined to the relay.

  DHCP packets are received on an interface that does have a helper address, but the packets are unicast directly from the client to the server and do not need relay intervention.

Drops

Number of packets that were ineligible for relay and were dropped.

Example                                                            The following command shows detailed DHCP relay information:

ACOS#show ip helper-address detail

IP Interface: eth1

------------

 Helper-Address: 100.100.100.1

  Packets:  

           RX: 0

              BootRequest Packets : 0

              BootReply Packets   : 0

           TX: 0

              BootRequest Packets : 0

              BootReply Packets   : 0

 No-Relay: 0

 Drops:

           Invalid BOOTP Port  : 0

           Invalid IP/UDP Len  : 0

           Invalid DHCP Oper   : 0

           Exceeded DHCP Hops  : 0

           Invalid Dest IP     : 0

           Exceeded TTL        : 0

           No Route to Dest    : 0

           Dest Processing Err : 0

 

IP Interface: ve5

------------

 Helper-Address: 100.100.100.1

  Packets:  

           RX: 16

              BootRequest Packets : 16

              BootReply Packets   : 0

           TX: 14

              BootRequest Packets : 0

              BootReply Packets   : 14

 No-Relay: 0

 Drops:

           Invalid BOOTP Port  : 0

           Invalid IP/UDP Len  : 0

           Invalid DHCP Oper   : 0

           Exceeded DHCP Hops  : 0

           Invalid Dest IP     : 0

           Exceeded TTL        : 0

           No Route to Dest    : 2

           Dest Processing Err : 0

 

IP Interface: ve7

------------

 Helper-Address: None

  Packets:  

           RX: 14

              BootRequest Packets : 0

               BootReply Packets   : 14

           TX: 14

              BootRequest Packets : 14

              BootReply Packets   : 0

 No-Relay: 0

 Drops:

           Invalid BOOTP Port  : 0

           Invalid IP/UDP Len  : 0

           Invalid DHCP Oper   : 0

           Exceeded DHCP Hops  : 0

           Invalid Dest IP     : 0

           Exceeded TTL        : 0

           No Route to Dest    : 0

           Dest Processing Err : 0

The following table describes the fields in the command output.

Field

Description

IP Interface

ACOS interface.

Helper-Address

IP address configured on the ACOS interface as the DHCP helper address.

Packets

DHCP packet statistics:

  RX – Total number of DHCP packets received on the interface.

  BootRequest Packets – Number of DHCP boot request packets (Op = BOOTREQUEST) received on the interface.

  BootReply Packets – Number of DHCP boot reply packets (Op = BOOTREPLY) received on the interface.

  TX – Total number of DHCP packets sent on the interface.

  BootRequest Packets – Number of DHCP boot request packets (Op = BOOTREQUEST) sent on the interface.

  BootReply Packets – Number of DHCP boot reply packets (Op = BOOTREPLY) sent on the interface.

No-Relay

Number of packets that were examined for DHCP relay but were not relayed, and instead received regular Layer 2/3 processing.

Generally, this counter increments in the following cases:

  DHCP packets are received on an interface that does not have a helper address and the packets are not destined to the relay.

  DHCP packets are received on an interface that does have a helper address, but the packets are unicast directly from the client to the server and do not need relay intervention.

Drops

Lists the following counters for packets dropped on the interface:

  Invalid BOOTP Port – Number of packets dropped because they had UDP destination port 68 (BOOTPC).

  Invalid IP/UDP Len – Number of packets dropped because the IP or UDP length of the packet was shorter than the minimum required length for DHCP headers.

  Invalid DHCP Oper – Number of packets dropped because the Op field in the packet header did not contain BOOTREQUEST or BOOT­REPLY.

  Exceeded DHCP Hops – Number of packets dropped because the number in the Hops field was higher than 16.

  Invalid Dest IP – Number of packets dropped because the destina­tion was invalid for relay.

  Exceeded TTL – Number of packets dropped because the TTL value was too low (less than or equal to 1).

  No Route to Dest – Number of packets dropped because the relay agent (ACOS device) did not have a valid forwarding entry towards the destination.

  Dest Processing Err – Number of packets dropped because the relay agent experienced an error in sending the packet towards the desti­nation.

 

Table of Contents

Index

Glossary

-Search-

Back