Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

header-navigation
keyboard_arrow_up
close
keyboard_arrow_left
Junos CLI Reference
Table of Contents Expand all
list Table of Contents
file_download PDF
{ "lLangCode": "en", "lName": "English", "lCountryCode": "us", "transcode": "en_US" }
English
keyboard_arrow_right

show dhcpv6 server binding

date_range 19-Nov-23

Syntax

content_copy zoom_out_map
show dhcpv6 server binding
<address>
<brief | detail | summary>
<interface interface-name>
<interface-tag interface-tag-name>
<interfaces-vlan>
<interfaces-wildcard>
<logical-system logical-system-name>
<routing-instance routing-instance-name>

Description

Display the address bindings in the client table on the extended Dynamic Host Configuration Protocol for IPv6 (DHCPv6) local server.

Options

address

(Optional) One of the following identifiers for the DHCPv6 client whose binding state you want to show:

  • CID—The specified Client ID (CID).

  • ipv6-prefix—The specified IPv6 prefix.

  • session-id—The specified session ID.

brief | detail | summary

(Optional) Display the specified level of output about active client bindings. The default is brief, which produces the same output as show dhcpv6 server binding.

interface interface-name

(Optional) Display information about active client bindings on the specified interface. You can optionally filter on VLAN ID and SVLAN ID.

interface-tag interface-tag-name

(Optional) Displays the binding information for the specified interface-tag.

interfaces-vlan

(Optional) Interface VLAN ID or S-VLAN ID interface on which to show binding state information.

interfaces-wildcard

(Optional) Set of interfaces on which to show binding state information. This option supports the use of the wildcard character (*).

logical-system logical-system-name

(Optional) Display information about active client bindings for DHCPv6 clients on the specified logical system.

routing-instance routing-instance-name

(Optional) Display information about active client bindings for DHCPv6 clients on the specified routing instance.

Required Privilege Level

view

Output Fields

Table 1 lists the output fields for the show dhcpv6 server binding command. Output fields are listed in the approximate order in which they appear.

Table 1: show dhcpv6 server binding Output Fields

Field Name

Field Description

Level of Output

number clients, (number init, number bound, number selecting, number requesting, number renewing, number releasing)

Summary counts of the total number of DHCPv6 clients and the number of DHCPv6 clients in each state.

summary

Prefix

Client’s DHCPv6 prefix, or prefix used to support multiple address assignment.

brief detail

Session Id

Session ID of the subscriber session.

brief detail

Expires

Number of seconds in which lease expires.

brief detail

State

State of the address binding table on the extended DHCPv6 local server:

  • BOUND—Client has active IP address lease.

  • INIT—Initial state.

  • RECONFIGURE—Server has sent reconfigure message to client.

  • RELEASE—Client is releasing IP address lease.

  • RENEWING—Client sending request to renew IP address lease.

  • REQUESTING—Client requesting a DHCPv6 server.

  • SELECTING—Client receiving offers from DHCPv6 servers.

brief detail

Interface

Interface on which the DHCPv6 request was received.

brief

Client IPv6 Address

Client’s IPv6 address.

detail

Client IPv6 Prefix

Client’s IPv6 prefix.

detail

Client IPv6 Excluded Prefix

IPv6 Prefix of the DHCP client excluded.

detail

Client DUID

Client’s DHCP Unique Identifier (DUID).

brief detail

Lease expires

Date and time at which the client’s IP address lease expires.

detail

Lease expires in

Number of seconds in which lease expires.

detail

Preferred Lease Expires

Date and UTC time at which the client’s IPv6 prefix expires.

detail

Preferred Lease Expires in

Number of seconds at which client’s IPv6 prefix expires.

detail

Lease Start

Date and time at which the client’s address lease was obtained.

detail

Lease time violated

Lease time violation has occurred.

detail

Incoming Client Interface

Client’s incoming interface.

detail

Server IP Address

IP address of DHCPv6 server.

detail

Interface tag

Name of the Interface tag.

detail

Server Interface

Interface of DHCPv6 server.

detail

Client Pool Name

Address pool used to assign IPv6 address.

detail

Client Prefix Pool Name

Address pool used to assign IPv6 prefix.

detail

Client Id length

Length of the DHCPv6 client ID, in bytes.

detail

Client Id

ID of the DHCPv6 client.

detail

Server Id

DHCP unique identifier (DUID) for the DHCPv6 server.

detail

Client Interface Svlan Id

S-VLAN ID of the client’s incoming interface.

detail

Client Interface Vlan Id

VLAN ID of the client’s incoming interface.

detail

Dual Stack Group

DHCPv6 server profile name.

detail

Dual Stack Peer Address

DHCPv6 Peer IP address.

detail

Sample Output

show dhcpv6 server binding

content_copy zoom_out_map
user@host> show dhcpv6 server binding
Prefix                  Session Id  Expires  State    Interface    Client DUID
2001:db8:1111:2222::/64 6           86321    BOUND    ge-1/0/0.0   LL_TIME0x1-0x2e159c0-00:10:94:00:00:01
2001:db8:1111:2222::/64 7           86321    BOUND    ge-1/0/0.0   LL_TIME0x1-0x2e159c0-00:10:94:00:00:02
2001:db8:1111:2222::/64 8           86321    BOUND    ge-1/0/0.0   LL_TIME0x1-0x2e159c0-00:10:94:00:00:03
2001:db8:1111:2222::/64 9           86321    BOUND    ge-1/0/0.0   LL_TIME0x1-0x2e159c1-00:10:94:00:00:04
2001:db8:1111:2222::/64 10          86321    BOUND    ge-1/0/0.0   LL_TIME0x1-0x2e159c1-00:10:94:00:00:05
2001:db8:2002::1/74 11              86321    BOUND    ge-1/0/0.0   LL_TIME0x1-0x2e159c1-00:10:94:00:00:06

show dhcpv6 server binding detail

content_copy zoom_out_map
user@host> show dhcpv6 server binding detail
Session Id:  2
     Client IPv6 Prefix:                    2001:db8:ffff:0:4::/64
     Client IPv6 Address:                   2001:db8:0:8003::1/128
     Client DUID:                           LL0x1-00:00:64:01:01:02
     State:                                 BOUND(DHCPV6_LOCAL_SERVER_STATE_BOUND)
     Lease Expires:                         2016-11-07 08:30:39 PST
     Lease Expires in:                      43706 seconds
     Preferred Lease Expires:               2016-11-07 08:30:39 PST
     Preferred Lease Expires in:            43706 seconds
     Lease Start:                           2016-11-04 11:00:37 PDT
     Last Packet Received:                  2016-11-06 09:00:39 PST
     Incoming Client Interface:             ae0.3221225472
     Interface tag:                         None
     Client Interface Svlan Id:             2000
     Client Interface Vlan Id:              1
     Server Ip Address:                     2001:db8::2 
     Server Interface:                      none 
     Client Profile Name:                   my-dual-stack
     Client Id Length:                      10
     Client Id:                             /0x00030001/0x00006401/0x0102
     Dual Stack Group:                      my-dual-stack
     Dual Stack Peer Address:               192.0.2.10

command-name

When DHCPv6 binding is configured with prefix exclude option, we get the following output:

content_copy zoom_out_map
user@host> show dhcpv6 server binding detail
Session Id:  5
     Client IPv6 Address:                   2001:db8:2:3::d/128
     Lease Expires:                         2017-12-11 07:45:15 IST
     Lease Expires in:                      9999995 seconds
     Preferred Lease Expires:               2017-12-11 07:45:15 IST
     Preferred Lease Expires in:            9999995 seconds
     Client IPv6 Prefix:                    2001:db8::1000:0:0/68
   	Client IPv6 Excluded Prefix:           2001:db8::1fff:ffff:ff00/120      
     Lease Expires:                         2017-12-11 07:45:15 IST
     Lease Expires in:                      9999995 seconds
     Preferred Lease Expires:               2017-12-11 07:45:15 IST
     Preferred Lease Expires in:            9999995 seconds
     Client DUID:                           LL_TIME0x1-0x599553b0-00:10:94:00:00:01
     State:                                 BOUND(DHCPV6_LOCAL_SERVER_STATE_BOUND)
     Lease Start:                           2017-08-17 13:58:32 IST
     Last Packet Received:                  2017-08-17 13:58:36 IST
     Incoming Client Interface:             ge-0/0/0.0
     Interface tag:                         None
     Client Interface Vlan Id:              100
     Client Pool Name:                      ia_na_pool
     Client Prefix Pool Name:               prefix_delegate_pool
     Client Id Length:                      14
     Client Id:                             /0x00010001/0x599553b0/0x00109400/0x0001
     Relay Id Length:                       31
     Relay Id:                              /0x00020000/0x05830130/0x303a3035/0x3a38363a
     Relay Id:                              /0x34343a65/0x323a6330/0x00000000/0x000000

show dhcpv6 server binding interface

content_copy zoom_out_map
user@host> show dhcpv6 server binding interface ge-1/0/0:10-101
Prefix                  Session Id  Expires  State    Interface    Client DUID
2001:db8:1111:2222::/64 1           86055    BOUND    ge-1/0/0.100 LL_TIME0x1-0x4b0a53b9-00:10:94:00:00:01

show dhcpv6 server binding interface detail

content_copy zoom_out_map
user@host> show dhcpv6 server binding interface ge-1/0/0:10-101 detail
Session Id:  7
     Client IPv6 Prefix:                    2001:db8:1111:2222::/64
     Client DUID:                           LL_TIME0x1-0x2e159c0-00:10:94:00:00:02
     State:                                 BOUND(bound)
     Lease Expires:                         2009-07-21 10:41:15 PDT
     Lease Expires in:                      86136 seconds
     Preferred Lease Expires:               2012-07-24 00:18:14 UTC
     Preferred Lease Expires in:            600 seconds
     Lease Start:                           2009-07-20 10:41:15 PDT
     Incoming Client Interface:             ge-1/0/0.0
     Interface tag:                         None
     Server Ip Address:                     0.0.0.0
     Server Interface:                      none
     Client Id Length:                      14
     Client Id:                             /0x00010001/0x02e159c0/0x00109400/0x0002

show dhcpv6 server binding (IPv6 Prefix)

content_copy zoom_out_map
user@host> show dhcpv6 server binding 14/0x00010001/0x02b3be8f/0x00109400/0x0005 detail
Session Id:  7
     Client IPv6 Prefix:                    2001:db8:1111:2222::/64
     Client DUID:                           LL_TIME0x1-0x2e159c0-00:10:94:00:00:02
     State:                                 BOUND(bound)
     Lease Expires:                         2009-07-21 10:41:15 PDT
     Lease Expires in:                      86136 seconds
     Preferred Lease Expires:               2012-07-24 00:18:14 UTC
     Preferred Lease Expires in:            600 seconds
     Lease Start:                           2009-07-20 10:41:15 PDT
     Incoming Client Interface:             ge-1/0/0.0
     Interface tag:                         None
     Server Ip Address:                     0.0.0.0
     Server Interface:                      none
     Client Id Length:                      14
     Client Id:                             /0x00010001/0x02e159c0/0x00109400/0x0002

show dhcpv6 server binding (Session ID)

content_copy zoom_out_map
user@host> show dhcpv6 server binding 8
Prefix           Session Id  Expires  State    Interface    Client DUID
2001:db8::/32    8           86235    BOUND    ge-1/0/0.0   LL_TIME0x1-0x2e159c0-00:10:94:00:00:03

show dhcpv6 server binding (Interfaces VLAN)

content_copy zoom_out_map
user@host> show dhcpv6 server binding ge-1/0/0:100-200
Prefix            Session Id  Expires  State    Interface             Client DUID
2001:db8::/32     11          87583    BOUND    ge-1/0/0.1073741827   LL_TIME0x1-0x4d5d009f-00:10:94:00:00:01
2001:db8:19::/32     12       87583    BOUND    ge-1/0/0.1073741827   LL_TIME0x1-0x4d5d009f-00:10:94:00:00:01

show dhcpv6 server binding (Interfaces Wildcard)

content_copy zoom_out_map
user@host> show dhcpv6 server binding demux0
Prefix            Session Id  Expires  State    Interface           Client DUID
2001:db8::/32     30          79681    BOUND    demux0.1073741824   LL_TIME0x1-0x4d5d009f-00:10:94:00:00:01
2001:db8:19::/32     31       79681    BOUND    demux0.1073741825   LL_TIME0x1-0x4d5d009f-00:10:94:00:00:01
2001:db8:C9::/32     32       79681    BOUND    demux0.1073741826   LL_TIME0x1-0x4d5d009f-00:10:94:00:00:01

show dhcpv6 server binding (Interfaces Wildcard)

content_copy zoom_out_map
user@host> show dhcpv6 server binding ge-1/3/*
Prefix            Session Id  Expires  State    Interface      Client DUID
2001:db8::/32     22          79681    BOUND    ge-1/3/0.110   LL_TIME0x1-0x4d5d009f-00:10:94:00:00:01
2001:db8:19::/32     33       79681    BOUND    ge-1/3/0.110   LL_TIME0x1-0x4d5d009f-00:10:94:00:00:01
2001:db8:C9::/32     24       79681    BOUND    ge-1/3/0.110   LL_TIME0x1-0x4d5d009f-00:10:94:00:00:01

show dhcpv6 server binding summary

content_copy zoom_out_map
user@host> show dhcpv6 server binding summary
5 clients, (0 init, 5 bound, 0 selecting, 0 requesting, 0 renewing, 0 releasing)

show dhcpv6 server binding interface-tag <interface-tag-name>

content_copy zoom_out_map
user@host> show dhcpv6 server binding interface-tag sample_tag
IP address Session Id Hardware address Expires State Interface
2001:db8:1001::1:a/128 00:10:94:00:00:01 740 BOUND ge-0/0/1.3221225472

Release Information

Command introduced in Junos OS Release 9.6.

Options interfaces-vlan and interfaces-wildcard added in Junos OS Release 12.1.

footer-navigation