Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation

show system services dhcp pool

Syntax

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

Release Information

Command introduced before Junos OS Release 7.4.

Command introduced in Junos OS Release 9.0 for EX Series switches.

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

List of Sample Output

show system services dhcp pool
show system services dhcp pool subnet-address
show system services dhcp pool subnet-address detail

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

user@host> show system services dhcp pool
Pool name    Low address   High address   Excluded addresses 
3.3.3.0/24   3.3.3.2       3.3.3.254      3.3.3.1 

show system services dhcp pool subnet-address

user@host> show system services dhcp pool 3.3.3.0/24
Pool information:
    Subnet                     3.3.3.0/24
    Address range              3.3.3.2 - 3.3.3.254
    Addresses assigned         2/253

show system services dhcp pool subnet-address detail

user@host> show system services dhcp pool 3.3.3.0/24 detail
Pool information:
    Subnet                     3.3.3.0/24
    Address range              3.3.3.2 - 3.3.3.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: { 3.3.3.1 }
    Name: server-identifier, Value: 3.3.3.1
    Code: 19, Type: flag, Value: off
    Code: 40, Type: string, Value: domain.tld
    Code: 32, Type: ip-address, Value: 3.3.3.333.3.3.254 3.3.3.1 

Published: 2013-03-14

Supported Platforms

Published: 2013-03-14