Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation
Guide That Contains This Content
[+] Expand All
[-] Collapse All

    Monitoring DHCP Binding Information

    Purpose

    Display information for specified DHCP client bindings, with results arranged in ascending order by binding ID.

    Note: The show dhcp binding command replaces the show ip dhcp-external binding, show ip dhcp-external binding-id, and show ip dhcp-local binding commands, which are deprecated and might be removed completely in a future release.

    Action

    To display information about all DHCP local server bindings:

    host1:vr1#show dhcp binding local
    BindingId      HwAddress      Type    IpSubnet   IpAddress   State
    ----------   --------------   -----   --------   ---------   -----
    2409734593   8000.0001.9365   local   0.0.0.0    81.3.0.2    bound
    2409734595   8000.0003.9365   local   0.0.0.0    81.3.0.3    bound
    2409734597   8000.0005.9365   local   0.0.0.0    81.3.0.4    bound
    2409734599   8000.0007.9365   local   0.0.0.0    81.3.0.5    bound
    2409734605   8000.000d.9365   local   0.0.0.0    81.3.0.8    bound
    2409734607   8000.000f.9365   local   0.0.0.0    81.3.0.9    bound
    2409734609   8000.0011.9365   local   0.0.0.0    81.3.0.10   bound
    2409734611   8000.0013.9365   local   0.0.0.0    81.3.0.11   bound
    2409734618   8000.000b.9365   local   0.0.0.0    81.3.0.7    bound
    2409734619   8000.0009.9365   local   0.0.0.0    81.3.0.6    bound

    The output of the show dhcp binding command is identical to the output of the show dhcp host command except for the order of the client bindings. The results of the show dhcp binding command are arranged in ascending order by binding ID, whereas the results of the show dhcp host command are arranged in ascending order by IP address.

    To display information about a specific DHCP binding ID:

    host1#show dhcp binding 3070230530
    BindingId:   3070230530
    HwAddress:   7000.0002.9365
    IpSubnet:    0.0.0.0
    IpAddress:   192.168.0.90
    State:       bound
    Type:        relay-p
    Server:      192.168.15.1
    Giaddr:      192.168.0.1
    Lease:       3600
    Remaining:   2079
    IpInterface: GigabitEthernet1/0/1.101
    ClientId:    45-41-48-00-01-70-00-00-02-93-65
    Interface:
    Relay Agent: 
    Agent Circuit Id: test circuit id
    Agent Remote Id:  test remote id
    Vendor Specific:  01-02-03-04-05-06-07-08-09-0a-0b-0c-0d-0e-0f-10
    Unrecognized:     11-12-13-14-15-16-17-18-19-1a-1b-1c-1d-1e-1f-20

    To display binding information for DHCP clients with a specified interface string:

    host1:vr2#show dhcp binding interface ip71.*4
    BindingId      HwAddress        Type     IpSubnet   IpAddress   State
    ----------   --------------   --------   --------   ---------   -----
    3053453315   7000.0002.9365   external   0.0.0.0    71.1.0.4    bound
    3053453325   7000.000c.9365   external   0.0.0.0    71.1.0.14   bound
    3053453353   7000.0016.9365   external   0.0.0.0    71.1.0.24   bound
    

    This show dhcp binding command uses the * (asterisk) regular expression metacharacter in the interface string to display information for DHCP client bindings on virtual router vr2 with an IP address beginning with 71 and ending with 4. The results of the show dhcp binding command are arranged in ascending order by binding ID.

    To display binding information for DHCP clients that match the specified circuit ID string:

    host1:vr3#show dhcp binding circuit-id \\xe3
    BindingId      HwAddress       Type     IpSubnet   IpAddress   State
    ----------   --------------   -------   --------   ---------   -----
    3070230529   7000.0000.9365   relay-p   0.0.0.0    71.1.0.2    bound
    3070230531   7000.0002.9365   relay-p   0.0.0.0    71.1.0.4    bound
    3070230535   7000.0006.9365   relay-p   0.0.0.0    71.1.0.8    bound
    3070230537   7000.0008.9365   relay-p   0.0.0.0    71.1.0.10   bound
    3070230539   7000.000a.9365   relay-p   0.0.0.0    71.1.0.12   bound
    3070230541   7000.000c.9365   relay-p   0.0.0.0    71.1.0.14   bound
    3070230543   7000.000e.9365   relay-p   0.0.0.0    71.1.0.16   bound
    3070230545   7000.0010.9365   relay-p   0.0.0.0    71.1.0.18   bound
    3070230547   7000.0012.9365   relay-p   0.0.0.0    71.1.0.20   bound
    3070230549   7000.0014.9365   relay-p   0.0.0.0    71.1.0.22   bound
    3070230553   7000.0018.9365   relay-p   0.0.0.0    71.1.0.26   bound
    3070230555   7000.001a.9365   relay-p   0.0.0.0    71.1.0.28   bound
    3070230557   7000.001c.9365   relay-p   0.0.0.0    71.1.0.30   bound
    3070230569   7000.0016.9365   relay-p   0.0.0.0    71.1.0.24   bound
    3070230572   7000.0004.9365   relay-p   0.0.0.0    71.1.0.6    bound
    

    To specify nonprintable byte codes in the circuit ID string or remote ID string, you can use the string \\xab, where ab is a hex code of the byte. This show dhcp binding command uses the string \\xe3 to represent byte E3 in the circuit ID string. This command displays information for the DHCP client bindings on virtual router vr3 with the specified circuit ID string, with results arranged in ascending order by binding ID.

    To display information about DHCP local server bindings with a specified subnet address:

    host1:vr1#show dhcp binding local 0.0.0.0
    

    To display information about DHCP bindings with a specified IP prefix:

    host1:vr1#show dhcp binding ip—prefix 10.1.0.0/28
    

    To display information about DHCP relay proxy bindings without a lower-layer interface:

    host1:vr1#show dhcp binding relay—proxy no-interface
    

    To display binding information for DHCP clients that match the specified remote ID string:

    host1:vr1#show dhcp binding remote-id “remote id.*even”
    

    Filtering the display of DHCP client bindings by the circuit ID string or remote ID string is not supported for the DHCP external server application. DHCP external server does not store information about the agent-circuit-id suboption or agent-remote-id suboption of option 82.

    Meaning

    Table 1 lists the show dhcp binding command output fields.

    Table 1: show dhcp binding Output Fields

    Field Name

    Field Description

    BindingId

    Client binding ID

    HwAddress

    MAC address of client

    Type

    Binding type; external (DHCP external server), local (DHCP local server), or relay-p (DHCP relay proxy)

    IpSubnet

    For DHCP local server bindings, the subnet of the IP address assigned to the client; 0.0.0.0 for DHCP external server and DHCP relay proxy bindings

    IpAddress

    IP address assigned to client

    State

    State of the DHCP client binding

    Server

    IP address of the DHCP server that allocated the client IP address

    Giaddr

    For DHCP relay proxy the IP address of the DHCP relay proxy; for DHCP local server bindings, the IP address of the DHCP relay that sent the packet or 0.0.0.0 if the packet comes from the client; for DHCP external server bindings, the giaddr from the DHCP packet

    Lease

    Total time for which the IP address is available, in seconds

    Remaining

    Time remaining on the current lease, in seconds

    IpInterface

    IP interface that is associated with the client

    ClientId

    DHCP Option 61 received from the client

    Interface

    Subinterface for DHCP local server bindings; does not apply to DHCP external server and DHCP relay proxy

    Relay Agent

    Indicates Relay Agent Information option (option 82)

    Agent Circuit Id

    Suboption 1 of the DHCP Relay Agent information option

    Agent Remote Id

    Suboption 2 of the DHCP relay agent information option

    Vendor Specific

    Suboption 9 of the DHCP relay agent information option

    Published: 2014-08-20