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 system services dhcp pool

date_range 19-Nov-23

Syntax

content_copy zoom_out_map
show system services dhcp pool
<detail>
<subnet-address> 

Description

(J Series routers and EX Series switches only) Display Dynamic Host Configuration Protocol (DHCP) server IP address pools.

Options

none

Display brief information about all IP address pools.

detail

(Optional) Display detailed information.

subnet-address

(Optional) Display information for the specified subnet address.

Required Privilege Level

view and system

Output Fields

Table 1 describes the output fields for the show system services dhcp pool command. Output fields are listed in the approximate order in which they appear.

Table 1: show system services dhcp pool Output Fields

Field Name

Field Description

Level of Output

Pool name

Subnet on which the IP address pool is defined.

None specified

Low address

Lowest address in the IP address pool.

None specified

High address

Highest address in the IP address pool.

None specified

Excluded addresses

Addresses excluded from the address pool.

None specified

Subnet

(subnet-address option only) Subnet to which the specified address pool belongs.

None specified

Address range

(subnet-address option only) Range of IP addresses in the address pool.

None specified

Addresses assigned

Number of IP addresses in the pool that are assigned to DHCP clients and the total number of IP addresses in the pool.

detail

Active

Number of assigned IP addresses in the pool that are active.

detail

Excluded

Number of assigned IP addresses in the pool that are excluded.

detail

Default lease time

Lease time assigned to clients that do not request a specific lease time.

detail

Minimum lease time

Minimum time a client can retain an IP address lease on the server.

detail

Maximum lease time

Maximum time a client can retain an IP address lease on the server.

detail

DHCP options

User-defined options created for the DHCP server. If no options have been defined, this field is blank.

detail

Sample Output

show system services dhcp pool

content_copy zoom_out_map
user@host> show system services dhcp pool             

Pool name    Low address   High address   Excluded addresses 
192.0.2.0/24 192.0.2.2     192.0.2.254     192.0.2.1 

show system services dhcp pool subnet-address

content_copy zoom_out_map
user@host> show system services dhcp pool 192.0.2.0/24             

Pool information:
    Subnet                     192.0.2.0/24
    Address range              192.0.2.2 - 192.0.2.254
    Addresses assigned         2/253

show system services dhcp pool subnet-address detail

content_copy zoom_out_map
user@host> show system services dhcp pool 192.0.2.0/24 detail             

Pool information:
    Subnet                     192.0.2.0/24
    Address range              192.0.2.2 - 192.0.2.254
    Addresses assigned         2/253
      Active: 1, Excluded: 1

DHCP lease times:
    Default lease time         1 hour
    Minimum lease time         2 hours
    Maximum lease time         infinite

DHCP options:
    Name: name-server, Value: { 6.6.6.6, 6.6.6.7 }
    Name: domain-name, Value: mydomain.tld
    Name: router, Value: { 192.0.2.1 }
    Name: server-identifier, Value: 192.0.2.1
    Code: 19, Type: flag, Value: off
    Code: 40, Type: string, Value: domain.tld
    Code: 32, Type: ip-address, Value: 192.0.2.1 

Release Information

Command introduced before Junos OS Release 7.4.

footer-navigation