Chapter 23

Dynamic Host Configuration Protocol

(DHCP)

Introduction ................................................................................................. 23-2

Configuring the DHCP Server ....................................................................... 23-2
BOOTP Relay Agent ..................................................................................... 23-3
DHCP Option 82 Relay ................................................................................. 23-5
Configuring the DHCP Client ....................................................................... 23-5
DHC Files ..................................................................................................... 23-5
Configuration Example ................................................................................ 23-6
Troubleshooting ........................................................................................... 23-7
Command Reference ................................................................................... 23-8
add bootp relay ..................................................................................... 23-8
add dhcp policy ..................................................................................... 23-9
add dhcp range ................................................................................... 23-14
create dhcp policy ............................................................................... 23-15
create dhcp range ............................................................................... 23-16
delete bootp relay ............................................................................... 23-17
delete dhcp policy ............................................................................... 23-18
delete dhcp range ............................................................................... 23-22
destroy dhcp policy ............................................................................. 23-22
destroy dhcp range ............................................................................. 23-23
disable bootp relay .............................................................................. 23-23
disable bootp relay option82 ............................................................... 23-24
disable dhcp ........................................................................................ 23-24
enable bootp relay .............................................................................. 23-25
enable bootp relay option82 ............................................................... 23-25
enable dhcp ........................................................................................ 23-26
purge bootp relay ................................................................................ 23-26
set bootp maxhops .............................................................................. 23-27
set bootp relay option82 ..................................................................... 23-27
set bootp relay option82 port .............................................................. 23-28
set dhcp .............................................................................................. 23-29
set dhcp policy .................................................................................... 23-30
set dhcp range .................................................................................... 23-35
show bootp relay ................................................................................ 23-36
show bootp relay port ......................................................................... 23-37
show dhcp .......................................................................................... 23-38
show dhcp client ................................................................................. 23-40
show dhcp policy ................................................................................ 23-42
show dhcp range ................................................................................ 23-43
23-2 Rapier i Switch Software Reference

Introduction
This chapter describes the Dynamic Host Configuration Protocol (DHCP)
support provided by the switch, and how to configure the switch to act as a
DHCP or BOOTP server. DHCP is defined in RFC 2131.

DHCP provides a method for passing configuration information to hosts on a

TCP/IP network. DHCP is based on its predecessor Bootstrap Protocol
(BOOTP), but adds automatic allocation of reusable network addresses and
additional configuration options.
When the switch is configured as a DHCP server, it allocates IP addresses and
other IP configuration parameters to clients (hosts), when the client requests
them. This lets you configure your IP network without manually configuring
every client. Note that each client must also be configured to receive its IP
address automatically.

As well as addresses, a DHCP server assigns a wide range of parameters to

clients, including subnet information and mask, domain and hostname, server
addresses, keepalive times, MTUs, boot settings, encapsulation settings, time
settings, and TCP settings.

Configuring the DHCP Server

DHCP is based on DHCP policies. Policies are predefined sets of configuration
information items. Each policy defines IP configuration information for the
clients that are attached to a single IP interface. Each policy has at least one IP
address range attached to it. A range is a list of consecutively numbered IP
addresses. When the DHCP server uses a policy to supply DHCP information
to a client, it assigns the client an unused IP address from the policy’s IP
address ranges.

The switch supports DHCP and its predecessor, BOOTP, but they are disabled
by default.

To configure the switch as a DHCP server:

1. Enable IP and give the desired interface an IP address and subnet mask.
This IP address needs to be in the subnet that you wish to assign to hosts
that are connected to that interface. Use the command:
enable ip
add ip interface
See Chapter 22, Internet Protocol (IP) for information about configuring IP
interfaces. If the interface is a VLAN, you may have to create it first.
2. Create a DHCP policy by using the command:
create dhcp policy=name leasetime={lease-time|infinity}
[inherit=name]

3. Assign an IP address range to the policy. This range must be in the same
subnet as the IP address that you assigned to the interface. Use the
command:
create dhcp range=name ip=ipadd number=number policy=name
[gateway=ipadd] [probe={arp|icmp}]

Software Release 2.7.5

C613-03110-00 REV A
Dynamic Host Configuration Protocol (DHCP) 23-3

4. Assign any other desired configuration settings to the policy by using the
command:
add dhcp policy=name [other-options]
The server uses that policy on that interface. Repeat this process with as
many interfaces and policies as required.
5. Enable the DHCP server by using the command:
enable dhcp

IP settings are assigned to hosts for specific times (the lease time). You can use
DHCP to allocate any of the following types of addresses:
■ A dynamic IP address, which is available to the host for a limited amount
of time (specified as the lease time) and is then reclaimed by the server. The
server can then allocate it to another device on request. This allows you to
share a limited number of IP addresses among devices and is useful when
devices do not need to access the Internet at all times.
To configure this, give the policy a lease time less than infinity when you
create it, using the command:
create dhcp policy=name leasetime=lease-time
■ A permanent IP address, which is made available to the client on request
and never reclaimed. This is referred to as “Automatic” allocation.
To configure this, give the policy a lease time of infinity when you create it,
using the command:
create dhcp policy=name leasetime=infinity
■ A manual or static IP address, which is allocated to a particular client. The
client is identified by its MAC address. This lets you use DHCP to manage
most of your network automatically, while having unchanging IP
addresses on key devices such as servers.
To configure this, add a static entry to the IP address range, using the
command:
add dhcp range=name address=macadd ip=ipadd

BOOTP requests can be satisfied by policies with leases set to infinity.

BOOTP Relay Agent

If the switch is acting as a DHCP server for clients on subnets that are not
directly connected to one of the switch's interfaces, the DHCP messages are
relayed through intermediate routers by a BOOTP relay agent. The BOOTP
relay agent must be configured on the intermediate routers by using the
commands:
add bootp relay
enable bootp relay

BOOTP is a UDP-based protocol that enables a booting host to dynamically

configure itself without external interventions. A BOOTP server responds to
requests from BOOTP clients for configuration information, such as the IP
address the client should use. BOOTP is defined in RFC 951, Bootstrap Protocol
(BOOTP).

Software Release 2.7.5

C613-03110-00 REV A
23-4 Rapier i Switch Software Reference

RFC 1542, Clarifications and Extensions for the Bootstrap Protocol, defines
extensions to the BOOTP protocol, including the behaviour of a BOOTP Relay
Agent.

The switch’s BOOTP Relay Agent relays BOOTREQUEST messages originating

from any of the switch’s interfaces to a user-defined destination, and relays
BOOTREPLY messages addressed to BOOTP clients on networks directly
connected to the switch. BOOTREPLY messages addressed to clients on
networks not directly connected to the switch are ignored by the relay agent
and treated as ordinary IP packets for forwarding.

A BOOTREQUEST message may be relayed via unicast, multicast or broadcast

methods. In the last case, the message does not re-broadcast to the interface
from which it was received. The relay destinations are configured
independently of other broadcast forwarders’ destinations (e.g. TFTP).

The hops field in a BOOTP message is used to record the number of hops
(routers) the message has been through. If the value of the hops field exceeds a
predefined threshold (normally 16), the message is discarded by the relay
agent. The threshold may be set to a value from 1 to 16.

To enable the BOOTP Relay Agent, use the enable bootp relay command on
page 23-25.

The agent must currently be disabled. To disable the agent, use the disable
bootp relay command on page 23-23.

To define a relay destination, use the add bootp relay command on page 23-8.

More than one relay destination may be defined, with successive commands.
Request messages are relayed to all defined relay destinations so messages
may be duplicated.

To delete a relay destination, use the delete bootp relay command on

page 23-17.

The destination must exactly match a destination previously defined with the
add bootp relay command on page 23-8.

To purge the BOOTP configuration (including the relay destination list), use
the purge bootp relay command on page 23-26. The BOOTP module is
disabled, all configuration data (including non-volatile storage) is purged, and
then BOOTP is re-enabled with default settings.

When the ‘hops’ field in a BOOTP message exceeds a predefined threshold the
BOOTP message is discarded. The default of the threshold is 4. To set the
threshold to any value from 1 to 16, use the set bootp maxhops command on
page 23-27.

To display the current configuration of the BOOTP Relay Agent, use the show
bootp relay command on page 23-36.

Software Release 2.7.5

C613-03110-00 REV A
Dynamic Host Configuration Protocol (DHCP) 23-5

DHCP Option 82 Relay

DHCP and BOOTP functionality includes the addition, removal and
monitoring of DHCP Option 82. Option 82 is also called the Relay Agent
Information option.

Option 82 is inserted by the DHCP relay agent into the DHCP options field
when forwarding client-originated BOOTP/DHCP packets to a DHCP server.
DHCP servers that are configured to recognise Option 82 may use the
information to implement IP addresses, or other parameter assignment
policies, based on the network location of the client device.

For more information about Option 82, see RFC 3046.

Option 82 can be:

■ added to packets relayed from the DHCP client to DHCP server
■ removed from packets relayed from DHCP server to DHCP client
■ checked from sources closer to the client

Configuring the DHCP Client

An interface on the switch can also be configured as a DHCP client by using
the command:
add ip interface=interface ipaddress=dhcp [other-options...]

and enable remote address assignment by using the command:

enable ip remoteassign

For more information, see “DHCP Client” on page 22-14 of Chapter 22,
Internet Protocol (IP).

DHC Files
Information about the state of the DHCP server is stored in NVS memory in a
binary file with the extension dhc. This information includes which IP
addresses are allocated and the remaining lease time for the addresses. If the
switch is restarted, the DHC file ensures that the server retains this information
for the clients it is currently serving.

Software Release 2.7.5

C613-03110-00 REV A
23-6 Rapier i Switch Software Reference

Configuration Example
The following example shows how to configure a switch to act as a DHCP
server in a small site. The site has a limited range of IP addresses and users use
IP for short periods of time. The dynamic DHCP mechanism is the most
appropriate for this situation. The switch on the LAN is configured to provide
DHCP services to the PCs on the local LAN.

1. Enable the DHCP server.

To enable DHCP, use the command:
enable dhcp

2. Create a policy.
Use the following commands to create a policy that sets the base
configuration information required by the client hosts:
create dhcp policy=base lease=7200
add dhcp policy=base subnet=255.255.255.0
add dhcp policy=base router=192.168.1.1
add dhcp policy=base dnsserver=192.168.1.254,
192.168.1.253

3. Create a range.

To create a range that defines a list of IP addresses where the policy

applies, use the command:
create dhcp range=office policy=base ip=192.168.1.16
number=32

4. Test the configuration.

To check that DHCP is functioning correctly, use the commands:
show dhcp
show dhcp policy
show dhcp range
show dhcp client

5. Configure a printer.

To configure a printer with the MAC address of 00-00-0c-00-28-73 that talks

BOOTP, use the commands:
enable dhcp bootp
create dhcp policy=prnt lease=infinity inherit=base
add dhcp range=office policy=prnt IP=192.168.1.31
address=00-00-0c-00-28-73

Software Release 2.7.5

C613-03110-00 REV A
Dynamic Host Configuration Protocol (DHCP) 23-7

Troubleshooting

Problem The switch is enabled as a DHCP server but has not assigned an IP address to a
host.

Solutions ■ Reboot the host machine, to force it to re-request IP settings.

■ Check the host’s TCP/IP settings to make sure that the host is set to obtain
its IP address dynamically:
In Windows 95/98, click Settings > Control Panel > Network. Select TCP/
IP and click Properties. Click Obtain an IP address automatically.
In Windows 2000, click Settings > Control Panel > Network and Dial-up
Connections > Local Area Connection > Properties. Select Internet
connection (TCP/IP) and click Properties. Click Obtain an IP address
automatically.
■ Check that the DHCP server has a large enough range of addresses.
■ Check that the switch’s link to the LAN is functioning by checking the
interface status, and verifying that the link LED is lit.

Software Release 2.7.5

C613-03110-00 REV A
23-8 add bootp relay Rapier i Switch Software Reference

Command Reference
This section describes the commands available to configure and manage the
Dynamic Host Configuration Protocol (DHCP) on the switch.

DHCP requires the IP module to be enabled and configured correctly. See

Chapter 22, Internet Protocol (IP) for detailed descriptions of commands that
enable and configure IP.

The shortest valid command is denoted by capital letters in the Syntax section.
See “Conventions” on page lxii of About this Software Reference in the front of
this manual for details of the conventions used to describe command syntax.
See Appendix A, Messages for a complete list of messages and their meanings.

add bootp relay

Syntax ADD BOOTp RELAy=ipadd

where ipadd is an IP address in dotted decimal notation

Description This command adds a BOOTP relay destination. The relay parameter specifies
the IP address of a BOOTP server in dotted decimal notation. Up to 50 relay
destinations can be defined, using successive commands. BOOTP request
messages are relayed to all defined relay destinations, so messages may be
duplicated.

Examples To add the BOOTP server with IP address 192.168.13.11, use:

add boot rela=192.168.13.11

Related Commands delete bootp relay

disable bootp relay
enable bootp relay
purge bootp relay
set bootp maxhops
show bootp relay

Software Release 2.7.5

C613-03110-00 REV A
Dynamic Host Configuration Protocol (DHCP) add dhcp policy 23-9

add dhcp policy

Syntax ADD DHCP POLIcy=name [ARPTImeout=seconds]

[BOOTFilesize=bootfilesize] [BROADcastaddress=ipadd]
[COOKIeserver=ipadd,ipadd...]
[DNSServer=ipadd,ipadd...] [DOmainname=string]
[ETHERENcap={ON|OFF}] [EXTENSIonpath=string]
[FIle=string] [HOSTname=string]
[IMPREssserver=ipadd,ipadd...] [INTMTu=68..65535]
[IPForwarding={ENAbled|DIsabled}] [IPMTU=576..65535]
[IPPLAteau=mtu,mtu...] [IPTIMeout=seconds] [IPTTL=ttl]
[LOGServer=ipadd,ipadd...] [LPRServer=ipadd,ipadd...]
[MASKDiscovery={ON|OFF}] [MASKSupplier={ON|OFF}]
[MERITdumpfile=longstring] [NAMEserver=ipadd,ipadd...]
[NBDDservers=ipadd,ipadd...]
[NBNAmeservers=ipadd,ipadd...] [NBNOdetype={B-node|
P-node|M-node|H-node}] [NBSCope=string]
[NISDomain=string] [NISErvers=ipadd,ipadd...]
[NTPServers=ipadd,ipadd...]
[POLICYFiltering=ipadd,ipadd...]
[RESOUrceserver=ipadd,ipadd...] [ROOTPath=longstring]
[ROUter=ipadd,ipadd...] [ROUTERDiscovery={ON|OFF}]
[ROUTERSolicit=ipadd] [SERVER=ipadd]
[SERVERNAme=server-name] [SOURcerouting={ENAbled|
DIsabled}] [STATicroute=ipadd,ipadd...] [SUBLOcal={ON|
OFF}] [SUBNetmask=ipadd] [SWAPServer=ipadd]
[T1TIme=seconds] [T2TIme=seconds] [TCPGarbage={ON|OFF}]
[TCPKeepalive=seconds] [TCPTtl=ttl]
[TIMEOffset=utc-offset] [TIMEServer=ipadd,ipadd...]
[TRAILerencap={ON|OFF}]
[XDISplayservers=ipadd,ipadd...]
[XFONtservers=ipadd,ipadd...]

where:
■ name is a character string 1 to 15 characters long. It may contain any
printable character.
■ seconds is a time, time offset or timeout value in seconds.
■ bootfilesize is the length in 512-octet blocks of the default boot image for the
client.
■ ipadd is an IP address in dotted decimal notation.
■ string is a character string 1 to 99 characters long. It may contain any
printable character.
■ longstring is a character string 1 to 254 characters long. It may contain any
printable character.
■ ttl is a number from 1 and 255.
■ server-name is a character string 1 to 63 characters long. It may contain any
printable character.
■ utc-offset is a time offset in seconds from Coordinated Universal Time
(UTC).

Description This command adds an option to an existing DHCP policy. The policy
parameter specifies the name of the policy where the option is to be added.

Software Release 2.7.5

C613-03110-00 REV A
23-10 add dhcp policy Rapier i Switch Software Reference

The arptimeout parameter specifies the timeout in seconds for ARP cache
entries.

The bootfilesize parameter specifies the length in 512-octet blocks of the

default boot image for the client.

The broadcastaddress parameter specifies the broadcast address in use on the

client’s subnet.

The cookieserver parameter specifies a list of RFC 865 cookie servers available
to the client. Cookie servers are specified by IP address. A maximum of up to
32 IP addresses can be specified in a comma separated list. Servers should be
listed in order of preference.

The dnsserver parameter specifies a list of Domain Name System (RFC 1035)
name servers available to the client. Domain Name System name servers are
specified by IP address. A maximum of up to 32 IP addresses can be specified
in a comma separated list. Servers should be listed in order of preference.

The domainname parameter specifies the domain name that the client should
use when resolving host names via the Domain Name System.

The etherencap parameter specifies whether the client should use Ethernet
Version 2 (RFC 894) or IEEE Standard 802.3 (RFC 1042) encapsulation for
Ethernet interfaces (vlan). A value of off indicates that the client should use
RFC 894 encapsulation. A value of on means that the client should use
RFC 1042 encapsulation.

The extensionpath parameter specifies a string to specify a file, retrievable via

TFTP, which contains information that can be interpreted in the same way as
the 64-octet vendor extension field within the BOOTP response.

The file parameter specifies the boot file name for the client.

The hostname parameter specifies the name of the client. The name may or
may not be qualified with the local domain name. See RFC 1035 for character
set restrictions.

The impressserver parameter specifies a list of Imagen Impress servers

available to the client. Imagen Impress servers are specified by IP address. A
maximum of up to 32 IP addresses can be specified in a comma separated list.
Servers should be listed in order of preference.

The intmtu parameter specifies the interface’s Maximum Transmission Unit

(MTU), in bytes. This is the maximum packet size that the client can transmit
over this interface at the physical layer (for example, Ethernet). Higher-layer
packets (for example, IP datagrams) that are bigger than this is fragmented by
the client and reassembled at the receiving end.

The ipforwarding parameter specifies whether the client should configure its
IP layer for packet forwarding. A value of disable disables IP forwarding, and
a value of enable enables IP forwarding.

The ipmtu parameter specifies the size, in bytes, of the largest IP packet the
client should be prepared to reassemble from packets that were fragmented at
the physical layer. The client discards IP packets that are larger than this value.

The ipplateau parameter specifies a table of MTU sizes to use when

performing Path MTU Discovery as defined in RFC 1191. The table is

Software Release 2.7.5

C613-03110-00 REV A
Dynamic Host Configuration Protocol (DHCP) add dhcp policy 23-11

formatted as a list of 16-bit unsigned integers, ordered from smallest to largest.

The minimum MTU value cannot be smaller than 68.

The iptimeout parameter specifies the timeout (in seconds) to use when aging
Path MTU values discovered by the mechanism defined in RFC 1191

The ipttl parameter specifies the default time-to-live that the client should use
on outgoing datagrams. The TTL is specified as an octet with a value between 1
and 255.

The logserver parameter specifies a list of MIT-LCS UDP log servers available
to the client. Log servers are specified by IP address. A maximum of up to 32 IP
addresses can be specified in a comma separated list. Servers should be listed
in order of preference.

The lprserver parameter specifies a list of RFC 1179 line printer servers
available to the client. Line printer servers are specified by IP address. A
maximum of up to 32 IP addresses can be specified in a comma separated list.
Servers should be listed in order of preference.

The maskdiscovery parameter specifies whether the client should perform

subnet mask discovery using ICMP. A value of OFF indicates that the client
should not perform mask discovery. A value of ON means that the client
should perform mask discovery.

The masksupplier parameter specifies whether the client should respond to

subnet mask requests using ICMP. A value of OFF indicates that the client
should not respond. A value of ON means that the client should respond.

The meritdumpfile parameter specifies the path name of a file where the
client’s core image should be dumped in the event the client crashes. The path
name is formatted as a character string consisting of characters from the NVT
ASCII character set.

The nameserver parameter specifies a list of IEN116 name servers available to

the client. IEN116 servers are specified by IP address. A maximum of up to 32
IP addresses can be specified in a comma separated list. Servers should be
listed in order of preference.

The nbddservers parameter specifies a list of RFC 1001/1002 NetBIOS

datagram distribution servers (NBDD) listed in order of preference. NetBIOS
datagram distribution servers are specified by IP address. A maximum of up to
32 IP addresses can be specified in a comma separated list.

The nbnameservers parameter specifies a list of RFC 1001/1002 NetBIOS name

servers (NBNS) listed in order of preference. NetBIOS name servers are
specified by IP address. A maximum of up to 32 IP addresses can be specified
in a comma separated list.

The nbnodetype parameter specifies the NetBIOS node type that allows
NetBIOS over TCP/IP clients to be configured as described in RFC 1001/1002.

The nbscope parameter specifies the NetBIOS over TCP/IP scope parameter
for the client as specified in RFC 1001/1002.

The nisdomain parameter specifies the name of the client’s NIS domain. The
domain is formatted as a character string consisting of characters from the NVT
ASCII character set.

Software Release 2.7.5

C613-03110-00 REV A
23-12 add dhcp policy Rapier i Switch Software Reference

The niservers parameter specifies a list of IP addresses indicating NIS servers

available to the client. NIS servers are specified by IP address. A maximum of
up to 32 IP addresses can be specified in a comma separated list. Servers
should be listed in order of preference.

The ntpservers parameter specifies a list of IP addresses indicating NTP

servers available to the client. NTP servers are specified by IP address. A
maximum of up to 32 IP addresses can be specified in a comma separated list.
Servers should be listed in order of preference.

The policyfiltering parameter specifies policy filters for non-local source

routing. The filters consist of a list of IP addresses and masks that specify
destination/mask pairs with which to filter incoming source routes. Any
source-routed datagram whose next hop address does not match one of the
filters should be discarded by the client. Policy filters are specified by IP
address. A maximum of up to 32 IP addresses can be specified in a comma
separated list.

The resourceserver parameter specifies a list of RFC 887 Resource Location

servers available to the client. Resource Location servers are specified by IP
address. A maximum of up to 32 IP addresses can be specified in a comma
separated list. Servers should be listed in order of preference.

The rootpath parameter specifies the path name that contains the client’s root
disk. The path name is formatted as a character string consisting of characters
from the NVT ASCII character set.

The router parameter specifies a list of IP addresses for routers on the client’s
subnet. Routers are specified by IP address. A maximum of up to 32 IP
addresses can be specified in a comma separated list. Routers should be listed
in order of preference.

The routerdiscovery parameter specifies whether the client should solicit

routers using the Router Discovery mechanism defined in RFC 1256. A value of
off indicates that the client should not perform router discovery. A value of on
means that the client should perform router discovery.

The routersolicit parameter specifies the address where the client should
transmit router solicitation requests.

The server parameter specifies the address of the server to use in the next step
of the client’s bootstrap process. As the switch is not capable of providing an
operating system executable this option allows the IP address of an
appropriate TFTP server to be set.

The servername parameter specifies the name of the server host. This is passed
to the client.

The sourcerouting parameter specifies whether the client should configure its
IP layer to allow forwarding of datagrams with non-local source routes. A
value of disable disallows forwarding of such datagrams, and a value of
enable allows forwarding.

The staticroute parameter specifies a list of static routes that the client should
install in its routing cache. If multiple routes to the same destination are
specified, they are listed in descending order of priority. The routes consist of a
list of IP address pairs. The first address is the destination address, and the
second address is the router for the destination. A maximum of up to 32 IP

Software Release 2.7.5

C613-03110-00 REV A
Dynamic Host Configuration Protocol (DHCP) add dhcp policy 23-13

addresses can be specified in a comma separated list. The default route (0.0.0.0)
is an illegal destination for a static route.

The sublocal parameter specifies whether the client may assume that all
subnets of the IP network where the client is connected use the same MTU as
the subnet of that network where the client is directly connected. A value of on
indicates that all subnets share the same MTU. A value of off means that the
client should assume that some subnets of the directly connected network may
have smaller MTUs.

The subnetmask parameter specifies the client’s subnet mask as defined in

RFC 950. If you intend to use subnet or supernet addressing when you create
DHCP ranges, you should include this option in the policy before you create
the range.

The swapserver parameter specifies the IP address of the client’s swap server.

The t1time parameter specifies the time interval, in seconds, from address
assignment until the client transitions to the renewing state.

The t2time parameter specifies the time interval, in seconds, from address
assignment until the client transitions to the rebinding state.

The tcpgarbage parameter specifies whether the client should send TCP
keepalive messages with a octet of garbage for compatibility with older
implementations. A value of off indicates that a garbage octet should not be
sent. A value of on indicates that a garbage octet should be sent.

The tcpkeepalive parameter specifies the interval (in seconds) that the client
TCP should wait before sending a keepalive message on a TCP connection. A
value of zero indicates that the client should not generate keepalive messages
on connections unless specifically requested by an application.

The tcpttl parameter specifies the default time-to-live value that the client
should use when sending TCP segments.

The timeoffset parameter specifies the offset of the client’s subnet in seconds
from Coordinated Universal Time (UTC).

The timeserver parameter specifies a list of RFC 868 time servers available to
the client. Time servers are specified by IP address. A maximum of up to 32 IP
addresses can be specified in a comma separated list. Servers should be listed
in order of preference.

The trailerencap parameter specifies whether the client should negotiate the
use of trailers (RFC 893) when using the ARP protocol. A value of off indicates
that the client should not attempt to use trailers. A value of on means that the
client should attempt to use trailers.

The xdisplayservers parameter specifies a list of IP addresses of systems that

are running the X Window System Display Manager and are available to the
client. A maximum of up to 32 IP addresses can be specified in a comma
separated list. Addresses should be listed in order of preference.

The xfontservers parameter specifies a list of X Window System Font servers

available to the client. X Window System Font servers are specified by IP
address. A maximum of up to 32 IP addresses can be specified in a comma
separated list. Servers should be listed in order of preference.

Software Release 2.7.5

C613-03110-00 REV A
23-14 add dhcp range Rapier i Switch Software Reference

Examples To create a policy called “base” with subnet mask, router and DNS server
options, use the command:
add dhcp poli=base subn=255.255.255.0 rou=202.36.163.21
dnss=192.168.100.50,192.168.100.33

Related Commands create dhcp policy

delete dhcp policy
destroy dhcp policy
set dhcp policy
show dhcp policy

add dhcp range

Syntax ADD DHCP RANge=name Address=macadd IP=ipadd [POLIcy=name]

where:
■ name is a character string 1 to 15 characters long. It may contain any
printable character.
■ ipadd is an IP address in dotted decimal notation.
■ macadd is a hardware address of the form xx-xx-xx-xx-xx-xx, where xx is a
2-digit hexadecimal number with leading zeros if necessary.

Description This command adds a static entry to an existing DHCP range. The range
parameter specifies the name of an existing DHCP range.

The ip parameter specifies the IP address of the host to add to the range. The
address parameter defines the MAC address for the static host entry. The
policy parameter specifies the name of a policy to give the host entry.

Examples To add a static entry to the range “remote” for the device with MAC address
00-00-0c-00-28-73, use the command:
add dhcp ran=remote ip=192.168.1.31 a=00-00-0c-00-28-73

Related Commands create dhcp range

delete dhcp range
destroy dhcp range
set dhcp range
show dhcp range

Software Release 2.7.5

C613-03110-00 REV A
Dynamic Host Configuration Protocol (DHCP) create dhcp policy 23-15

create dhcp policy

Syntax CREate DHCP POLIcy=name LEASEtime={lease-time|INFinity}

[INHerit=name]

where:
■ name is a character string 1 to 15 characters long. It may contain any
printable character.
■ lease-time is a time in seconds from 1 to 4294967295.

Description This command creates a DHCP policy. Policies define the configuration
information that are given to the requesting IP host. The policy parameter
specifies the name of the policy to create. This name is used in other commands
to identify the policy.

The leasetime parameter specifies the time period for which the IP address is
leased to the requesting IP client. For BOOTP requests, leasetime must be set to
infinity. If dynamic IP address allocation is not required, then set leasetime to
infinity.

Switches that comply with RFC 1541 but not with RFC 2131 may not be able to
accept a lease time of less than 3600 seconds (1 hour).

The inherit parameter specifies the name of an existing policy whose settings
are inherited by the new policy. This parameter allows the building of
hierarchical policies and reduces the number of commands to create similar
policies.

Examples To create a DHCP policy called “base” with a default lease time of two hours,
use the command:
cre dhcp poli=base lease=7200

Related Commands add dhcp policy

delete dhcp policy
destroy dhcp policy
set dhcp policy
show dhcp policy

Software Release 2.7.5

C613-03110-00 REV A
23-16 create dhcp range Rapier i Switch Software Reference

create dhcp range

Syntax CREate DHCP RANge=name IP=ipadd NUMber=number POLIcy=name

[GATEway=ipadd] [PRObe={ARP|ICMP}]

where:
■ name is a character string 1 to 15 characters long. It may contain any
printable character.
■ ipadd is an IP address in dotted decimal notation.
■ number is a number from 1 to 255.

Description This command creates a DHCP range. The server tries to fulfil BOOTP or
DHCP requests from hosts with IP addresses in the defined ranges. The range
parameter specifies the name of the range to create.

The policy parameter specifies the name of a default policy to give the range.
Individual host entries in the range can later be set to other defined policies.

The ip parameter defines the IP address of the start of the range.

If the range you specify includes network or broadcast addresses, these are not
added to the pool of available addresses.

The number parameter defines how many host entries from the start IP
address are to be included in the range.

The gateway parameter specifies the IP address of a remote BOOTP relay

agent. This parameter is needed if the range of IP addresses specified are not
on a local interface.

The probe parameter specifies how the DHCP server checks whether an IP
address is being used by other hosts. If arp is specified, the server sends ARP
requests to determine if an address is in use. If icmp is specified, the server
sends ICMP Echo Requests (pings). arp cannot be specified if the gateway
parameter is specified or if the network uses Proxy ARP. The default is icmp.

Examples To create a range called “office”, which uses the policy “base”, with 32 IP
addresses starting at 192.168.1.16, use the command:
cre dhcp ran=office poli=base ip=192.168.1.16 num=32

Related Commands add dhcp range

delete dhcp range
destroy dhcp range
set dhcp range
show dhcp range

Software Release 2.7.5

C613-03110-00 REV A
Dynamic Host Configuration Protocol (DHCP) delete bootp relay 23-17

delete bootp relay

Syntax DELete BOOTp RELAy=ipadd

where ipadd is an IP address in dotted decimal notation

Description This command deletes a BOOTP relay destination. The RELAY parameter
specifies the IP address of a BOOTP server in dotted decimal notation.

Examples To delete the BOOTP server with IP address 192.168.13.11, use:

del boot rela=192.168.13.11

Related Commands add bootp relay

disable bootp relay
enable bootp relay
purge bootp relay
set bootp maxhops
show bootp relay

Software Release 2.7.5

C613-03110-00 REV A
23-18 delete dhcp policy Rapier i Switch Software Reference

delete dhcp policy

Syntax DELete DHCP POLIcy=name [ARPTImeout] [BOOTFilesize]

[BROADcastaddress] [COOKIeserver] [DNSServer]
[DOmainname] [ETHERENcap] [EXTENSIonpath] [FIle]
[HOSTname] [IMPREssserver] [INTMTu] [IPForwarding]
[IPMTU] [IPPLAteau] [IPTIMeout] [IPTTL] [LOGServer]
[LPRServer] [MASKDiscovery] [MASKSupplier]
[MERITdumpfile] [NAMEserver] [NBDDservers]
[NBNAmeservers] [NBNOdetype] [NBSCope] [NISDomain]
[NISErvers] [NTPServers] [POLICYFiltering]
[RESOUrceserver] [ROOTPath] [ROUter] [ROUTERDiscovery]
[ROUTERSolicit] [SERVER] [SERVERNAme] [SOURcerouting]
[STATicroute] [SUBLOcal] [SUBNetmask] [SWAPServer]
[T1TIme] [T2TIme] [TCPGarbage] [TCPKeepalive] [TCPTtl]
[TIMEOffset] [TIMEServer] [TRAILerencap]
[XDISplayservers] [XFONtservers]

where name is a character string 1 to 15 characters long. It may contain any

printable character.

Description This command deletes an existing option from a DHCP policy. The policy
parameter specifies the name of the policy from which the option is to be
deleted.

The arptimeout parameter specifies the timeout in seconds for ARP cache
entries.

The bootfilesize parameter specifies the length in 512-octet blocks of the

default boot image for the client.

The broadcastaddress parameter specifies the broadcast address in use on the

client’s subnet.

The cookieserver parameter specifies a list of RFC 865 cookie servers available
to the client. Servers should be listed in order of preference.

The dnsserver parameter specifies a list of Domain Name System (RFC 1035)
name servers available to the client. Servers should be listed in order of
preference.

The domainname parameter specifies the domain name that the client should
use when resolving hostnames via the Domain Name System.

The etherencap parameter specifies whether the client should use Ethernet
Version 2 (RFC 894) or IEEE Standard 802.3 (RFC 1042) encapsulation for
Ethernet interfaces (vlan). A value of off indicates that the client should use
RFC 894 encapsulation. A value of on means that the client should use
RFC 1042 encapsulation.

The extensionpath parameter specifies a string to specify a file, retrievable via

TFTP, which contains information that can be interpreted in the same way as
the 64-octet vendor -extension field within the BOOTP response.

The file parameter specifies the boot file name for the client.

Software Release 2.7.5

C613-03110-00 REV A
Dynamic Host Configuration Protocol (DHCP) delete dhcp policy 23-19

The hostname parameter specifies the name of the client. The name may or
may not be qualified with the local domain name. See RFC 1035 for character
set restrictions.

The impressserver parameter specifies a list of Imagen Impress servers

available to the client. Servers should be listed in order of preference.

The intmtu parameter specifies the MTU to use on this interface. The MTU is
specified as a 16-bit unsigned integer. The minimum legal value for the MTU is
68.

The ipforwarding parameter specifies whether the client should configure its
IP layer for packet forwarding. A value of disable disables IP forwarding, and
a value of enable enables IP forwarding.

The ipmtu parameter specifies the maximum size datagram that the client
should be prepared to reassemble. The minimum value legal value is 576.

The ipplateau parameter specifies a table of MTU sizes to use when

performing Path MTU Discovery as defined in RFC 1191. The table is
formatted as a list of 16-bit unsigned integers, ordered from smallest to largest.
The minimum MTU value cannot be smaller than 68.

The iptimeout parameter specifies the timeout (in seconds) to use when aging
Path MTU values discovered by the mechanism defined in RFC 1191

The ipttl parameter specifies the default time-to-live that the client should use
on outgoing datagrams. The TTL is specified as an octet with a value between 1
and 255.

The logserver parameter specifies a list of MIT-LCS UDP log servers available
to the client. Servers should be listed in order of preference.

The lprserver parameter specifies a list of RFC 1179 line printer servers
available to the client. Servers should be listed in order of preference.

The maskdiscovery parameter specifies whether the client should perform

subnet mask discovery using ICMP. A value of off indicates that the client
should not perform mask discovery. A value of on means that the client should
perform mask discovery.

The masksupplier parameter specifies whether the client should respond to

subnet mask requests using ICMP. A value of off indicates that the client
should not respond. A value of on means that the client should respond.

The meritdumpfile parameter specifies the path name of a file where the
client’s core image should be dumped if the client crashes. The path name is
formatted as a character string consisting of characters from the NVT ASCII
character set.

The nameserver parameter specifies a list of IEN116 name servers available to

the client. Servers should be listed in order of preference.

The nbddservers parameter specifies a list of RFC 1001/1002 NetBIOS

datagram distribution servers (NBDD) listed in order of preference.

The nbnameservers parameter specifies a list of RFC 1001/1002 NetBIOS name

servers (NBNS) listed in order of preference.

Software Release 2.7.5

C613-03110-00 REV A
23-20 delete dhcp policy Rapier i Switch Software Reference

The nbnodetype parameter specifies the NetBIOS node type that allows
NetBIOS over TCP/IP clients to be configured as described in RFC 1001/1002.

The nbscope parameter specifies the NetBIOS over TCP/IP scope parameter
for the client as specified in RFC 1001/1002.

The nisdomain parameter specifies the name of the client’s NIS domain. The
domain is formatted as a character string consisting of characters from the NVT
ASCII character set.

The niservers parameter specifies a list of IP addresses indicating NIS servers

available to the client. Servers should be listed in order of preference.

The ntpservers parameter specifies a list of IP addresses indicating NTP

servers available to the client. Servers should be listed in order of preference.

The policyfiltering parameter specifies policy filters for non-local source

routing. The filters consist of a list of IP addresses and masks that specify
destination/mask pairs with which to filter incoming source routes. Any
source-routed datagram whose next hop address does not match one of the
filters should be discarded by the client.

The resourceserver parameter specifies a list of RFC 887 Resource Location

servers available to the client. Servers should be listed in order of preference.

The rootpath parameter specifies the path name that contains the client’s root
disk. The path name is formatted as a character string consisting of characters
from the NVT ASCII character set.

The router parameter specifies a list of IP addresses for routers on the client’s
subnet. Routers should be listed in order of preference.

The routerdiscovery parameter specifies whether the client should solicit

routers using the Router Discovery mechanism defined in RFC 1256. A value of
off indicates that the client should not perform router discovery. A value of on
means that the client should perform router discovery.

The routersolicit parameter specifies the address where the client should
transmit router solicitation requests.

The server parameter specifies the address of the server to use in the next step
of the client’s bootstrap process. As the switch is not capable of providing an
operating system executable this option allows the IP address of an
appropriate TFTP server to be set.

The servername parameter specifies the name of the server host. This is passed
to the client.

The sourcerouting parameter specifies whether the client should configure its
IP layer to allow forwarding of datagrams with non-local source routes. A
value of disable disallows forwarding of such datagrams, and a value of
enable allows forwarding.

Software Release 2.7.5

C613-03110-00 REV A
Dynamic Host Configuration Protocol (DHCP) delete dhcp policy 23-21

The staticroute parameter specifies a list of static routes that the client should
install in its routing cache. If multiple routes to the same destination are
specified, they are listed in descending order of priority. The routes consist of a
list of IP address pairs. The first address is the destination address, and the
second address is the router for the destination. The default route (0.0.0.0) is an
illegal destination for a static route.

The sublocal parameter specifies whether the client may assume that all
subnets of the IP network where the client is connected use the same MTU as
the subnet of that network where the client is directly connected. A value of on
indicates that all subnets share the same MTU. A value of off means that the
client should assume that some subnets of the directly connected network may
have smaller MTUs.

The subnetmask parameter specifies the client’s subnet mask as defined in

RFC 950.

The swapserver parameter specifies the IP address of the client’s swap server.

The t1time parameter specifies the time interval, in seconds, from address
assignment until the client transitions to the renewing state.

The t2time parameter specifies the time interval, in seconds, from address
assignment until the client transitions to the rebinding state.

The tcpgarbage parameter specifies whether the client should send TCP
keepalive messages with a octet of garbage for compatibility with older
implementations. A value of off indicates that a garbage octet should not be
sent. A value of on indicates that a garbage octet should be sent.

The tcpkeepalive parameter specifies the interval (in seconds) that the client
TCP should wait before sending a keepalive message on a TCP connection. A
value of zero indicates that the client should not generate keepalive messages
on connections unless specifically requested by an application.

The tcpttl parameter specifies the default time-to-live value that the client
should use when sending TCP segments.

The timeoffset parameter specifies the offset of the client’s subnet in seconds
from Coordinated Universal Time (UTC).

The timeserver parameter specifies a list of RFC 868 time servers available to
the client. Servers should be listed in order of preference.

The trailerencap parameter specifies whether the client should negotiate the
use of trailers (RFC 893) when using the ARP protocol. A value of off indicates
that the client should not attempt to use trailers. A value of on means that the
client should attempt to use trailers.

The xdisplayservers parameter specifies a list of IP addresses of systems that

are running the X Window System Display Manager and are available to the
client. Addresses should be listed in order of preference.

The xfontservers parameter specifies a list of X Window System Font servers

available to the client. Servers should be listed in order of preference.

Examples To remove the LPRSERVER option from the policy “base”, use the command:
del dhcp poli=base lprs

Software Release 2.7.5

C613-03110-00 REV A
23-22 delete dhcp range Rapier i Switch Software Reference

Related Commands add dhcp policy

create dhcp policy
destroy dhcp policy
set dhcp policy
show dhcp policy

delete dhcp range

Syntax DELete DHCP RANge=name IP=ipadd

where:
■ name is a character string 1 to 15 characters long. It may contain any
printable character.
■ ipadd is an IP address in dotted decimal notation.

Description This command deletes an existing static host entry from a DHCP range. The IP
host entry reverts to the default settings for the range.

The range parameter specifies the name of the range. The ip address parameter
specifies the host entry to return to the default range settings.

Examples To delete the static entry 192.168.1.31 from the range “remote”, use the
command:
del dhcp ran=remote ip=192.168.1.31

Related Commands add dhcp range

create dhcp range
destroy dhcp range
show dhcp range

destroy dhcp policy

Syntax DESTroy DHCP POLIcy=name

where name is a character string 1 to 15 characters long. It may contain any

printable character.

Description This command destroys an existing policy. The policy parameter specifies the
name of the policy to destroy. If the policy is currently being used by any host
entry, then an error message is displayed and the command fails.

Examples To destroy policy “admin”, use the command:

dest dhcp poli=admin

Related Commands add dhcp policy

create dhcp policy
delete dhcp policy
set dhcp policy
show dhcp policy

Software Release 2.7.5

C613-03110-00 REV A
Dynamic Host Configuration Protocol (DHCP) disable bootp relay 23-23

destroy dhcp range

Syntax DESTroy DHCP RANge=name

where name is a character string 1 to 15 characters long. It may contain any

printable character.

Description This command destroys an existing DHCP range. The range parameter
specifies the name of the range to destroy.

Examples To destroy the range “remote”, use the command:

dest dhcp ran=remote

Related Commands add dhcp range

create dhcp range
delete dhcp range
show dhcp range

disable bootp relay

Syntax DISable BOOTp RELAy

Description This command disables the BOOTP Relay Agent. The BOOTP Relay Agent
relays BOOTREQUEST messages originating from any of the switch’s
interfaces to a user-defined destination, and relays BOOTREPLY messages
addressed to BOOTP clients on networks directly connected to the switch.
BOOTREPLY messages addressed to clients on networks not directly
connected to the switch are ignored by the relay agent and treated as ordinary
IP packets for forwarding. The BOOTP Relay Agent is disabled by default.

Examples To disable the BOOTP relay agent, use the command:

dis boot rela

Related Commands add bootp relay

delete bootp relay
enable bootp relay
purge bootp relay
set bootp maxhops
show bootp relay

Software Release 2.7.5

C613-03110-00 REV A
23-24 disable bootp relay option82 Rapier i Switch Software Reference

disable bootp relay option82

Syntax DISable BOOTp RELAy OPTion82 [DEBug]

Description This command disables the insertion of DHCP Option 82 into the DHCP
options field when forwarding client-originated BOOTP/DHCP packets to a
DHCP server.

Use the debug parameter to disable Option 82 related debug.

Example To disable the insertion of Option 82, use the command:

dis boot rela opt

Related commands enable bootp relay option82

set bootp relay option82
set bootp relay option82 port
show bootp relay port
disable bootp relay

disable dhcp

Syntax DISable DHCP [BOOTp] [DEBug]

Description This command disables the DHCP module. All BOOTP or DHCP requests
received while the module is disabled are ignored.

If the optional parameter bootp is specified, then the reception of BOOTP

requests is disabled.

The optional debug parameter disables debugging of the DHCP module.

Examples To disable BOOTP serving, use the command:

dis dhcp boot

Related Commands enable dhcp

show dhcp

Software Release 2.7.5

C613-03110-00 REV A
Dynamic Host Configuration Protocol (DHCP) enable bootp relay option82 23-25

enable bootp relay

Syntax ENAble BOOTp RELAy

Description This command enables the BOOTP Relay Agent. The BOOTP Relay Agent
relays BOOTREQUEST messages originating from any of the switch’s
interfaces to a user-defined destination, and relays BOOTREPLY messages
addressed to BOOTP clients on networks directly connected to the switch.
BOOTREPLY messages addressed to clients on networks not directly
connected to the switch are ignored by the relay agent and treated as ordinary
IP packets for forwarding. The BOOTP Relay Agent is disabled by default.

Related Commands add bootp relay

delete bootp relay
disable bootp relay
purge bootp relay
set bootp maxhops
show bootp relay

enable bootp relay option82

Syntax ENAble BOOTp RELAy OPTion82 [DEBug]

Description This command enables the DHCP relay agent to insert DHCP Option 82 into
the DHCP options field when forwarding client-originated BOOTP/DHCP
packets to a DHCP server.

Use the debug parameter to enable Option 82 related debug.

Example To enable the insertion of Option 82, use the command:

ena boot rela opt

Related Commands disable bootp relay option82

set bootp relay option82
set bootp relay option82 port
enable bootp relay
show bootp relay port

Software Release 2.7.5

C613-03110-00 REV A
23-26 enable dhcp Rapier i Switch Software Reference

enable dhcp

Syntax ENAble DHCP [BOOTp] [DEBug]

Description This command enables the DHCP module. All BOOTP or DHCP requests
received while the module is disabled are ignored.

If the optional parameter bootp is specified, then the reception of BOOTP

requests is enabled.

The optional debug parameter enables debugging of the DHCP module.

Debugging information is sent to the port or Telnet session where the
command was entered.

Examples To enable the DHCP server, use the command:

ena dhcp

Related Commands disable dhcp

show dhcp

purge bootp relay

Syntax PURge BOOTp RELAy

Description This command purges the BOOTP relay configuration. The BOOTP module is
disabled and all configuration data is purged.

Related Commands add bootp relay

delete bootp relay
disable bootp relay
enable bootp relay
set bootp maxhops
show bootp relay

Software Release 2.7.5

C613-03110-00 REV A
Dynamic Host Configuration Protocol (DHCP) set bootp relay option82 23-27

set bootp maxhops

Syntax SET BOOTp MAXHops=1..16

Description This command sets the hop count threshold for discarding BOOTP messages.
When the hops field in a BOOTP message exceeds the threshold, the BOOTP
message is discarded. The hop count in a BOOTP message is incremented each
time a switch forwards the message. The default is 4.

Related Commands add bootp relay

delete bootp relay
disable bootp relay
enable bootp relay
purge bootp relay
show bootp relay

set bootp relay option82

Syntax SET BOOTp RELAy OPTion82 [CHEck={YES|NO|ON|OFF|True|

False}] [POLIcy={DROP|KEEP|REPLACE}]

Description This command defines the checking and re-forwarding settings used by DHCP
Option 82. When Option 82 is enabled, the DHCP relay agent inserts Option 82
information into the DHCP options field when forwarding client-originated
BOOTP/DHCP packets to a DHCP server. Option 82 must be enabled with the
enable bootprelay option 82 command for the settings you specify to take
effect.

Use the check parameter to specify whether the Option 82 information that is
returned from the DHCP server is to be checked or not. When checking is
enabled, server DHCP packets that contain valid Option 82 information are
forwarded to the client, and packets that do not contain valid Option 82
information are dropped. If yes is specified, checking is enabled. The values
yes, on, and true are equivalent. If no is specified, Option 82 information
returned from the DHCP server is not checked. The values no, off, and false
are equivalent. The default is yes.

Use the policy parameter to specify the re-forwarding policy of client DHCP
packets that contain Option 82 information. If drop is specified, client DHCP
packets that contain Option 82 information are dropped. If keep is specified,
the packet keeps its existing Option 82 information. If replace is specified, the
existing Option 82 information is replaced with that of the local device. The
default is replace.

Example To set the re-forwarding policy to drop client DHCP packets with Option 82
information, use the command:
set boot rela opt poli=drop

Related commands disable bootp relay option82

enable bootp relay option82
set bootp relay option82 port
show bootp relay port

Software Release 2.7.5

C613-03110-00 REV A
23-28 set bootp relay option82 port Rapier i Switch Software Reference

set bootp relay option82 port

Syntax SET BOOTp RELAy OPTion82 POrt={port-list|ALL}

[SUBScriberid=subscriber-id] [TRusted={YES|NO|ON|OFF|
True|False}]

where:
■ port-list is a port number, a range of port numbers (specified as n-m), or a
comma-separated list of port numbers and/or ranges. Port numbers start
at 1 and end at m, where m is the highest numbered Ethernet switch port,
including uplink ports.
■ subscriber-id is a character string from 0 to 50 characters long. Valid
characters are any alphanumeric characters. If string contains spaces, it
must be in double quotes. Wildcards are not allowed.

Description This command defines the DHCP Relay Agent port settings for DHCP Option
82. When Option 82 is enabled, the Relay Agent inserts Option 82 information
into the DHCP options field when forwarding client-originated BOOTP/
DHCP packets to a DHCP server. Option 82 must be enabled with the enable
bootprelay option 82 command for the port settings you specify to take effect.

Use the port parameter to specify the port to use for this command. If all is
specified, this command is applied to all ports on the device.

Use the subscriberid parameter to specify the subscriber-ID for the port
defined with port. If specified, the subscriber-ID sub-option is included in the
Option 82 field of client DHCP packets received on the specified port. The
default is no subscriber-ID.

If you specify an empty string in the subscriberid parameter, then the

subscriber-ID sub-option is not included in the Option 82 field of client DHCP
packets forwarded from the specified port. Use this method to delete a
subscriber-ID from a port.

Use the trusted parameter to specify how the switch handles client DHCP
packets that contain Option 82 information, but which have the giaddr field set
to 0. If you specify yes, the defined port is considered to be a trusted source of
Option 82 information, and packets with Option 82 information and a giaddr
of 0 are forwarded according to normal BOOTP Relay operation. The values
yes, on, and true are equivalent. If you specify no, packets are dropped that
contain DHCP Option 82 information and with the giaddr field set to 0. The
values no, off, and false are equivalent. The default is no.

Example To set all ports as trusted, use the command:

set boot rela opt po=all tr=yes

Related Commands disable bootp relay option82

enable bootp relay option82
show bootp relay port
set bootp relay option82

Software Release 2.7.5

C613-03110-00 REV A
Dynamic Host Configuration Protocol (DHCP) set dhcp 23-29

set dhcp

Syntax SET DHCP EXTendid={ON|OFF}

Description This command sets the DHCP extended identification option. An extended
client ID is used when connecting multiple switch interfaces to the same DHCP
server.

This command affects new DHCP clients only. If extended DHCP identification
is needed, then dhcp extendid must be on before DHCP clients are created.
DHCP clients with this option set to on are incompatible with static DHCP
server entries because they do not match the extended ID. To set DHCP clients
see the add ip interface command on page 22-74 of Chapter 22, Internet
Protocol (IP).

The extendid parameter specifies whether DHCP clients use an extended client
ID when communicating with a DHCP server. If off is specified, the client ID
value is the hardware address of the client interface. If on is specified, the client
ID value is extended to include an internal interface identifier, uniquely
distinguishing different interfaces on a device. The default is off.

Examples To enable the use of extended client ID values when connecting a multiple
switch interfaces to the same DHCP server, use the command:
set dhcp ext=on

Related Commands show dhcp

Software Release 2.7.5

C613-03110-00 REV A
23-30 set dhcp policy Rapier i Switch Software Reference

set dhcp policy

Syntax SET DHCP POLICY=name [ARPTImeout=seconds]

[BOOTFilesize=bootfilesize] [BROADcastaddress=ipadd]
[COOKIeserver=ipadd,ipadd...]
[DNSServer=ipadd,ipadd...] [DOmainname=string]
[ETHERENcap={ON|OFF}] [EXTENSIonpath=string]
[FIle=string] [HOSTname=string]
[IMPREssserver=ipadd,ipadd...] [INTMTu=68..65535]
[IPForwarding={ENAbled|DIsabled}] [IPMTU=576..65535]
[IPPLAteau=mtu,mtu...] [IPTIMeout=seconds] [IPTTL=ttl]
[LEASETIME={lease-time|INFINITY}]
[LOGServer=ipadd,ipadd...] [LPRServer=ipadd,ipadd...]
[MASKDiscovery={ON|OFF}] [MASKSupplier={ON|OFF}]
[MERITdumpfile=longstring] [NAMEserver=ipadd,ipadd...]
[NBDDservers=ipadd,ipadd...]
[NBNAmeservers=ipadd,ipadd...] [NBNOdetype={B-node|
P-node|M-node|H-node}] [NBSCope=string]
[NISDomain=string] [NISErvers=ipadd,ipadd...]
[NTPServers=ipadd,ipadd...]
[POLICYFiltering=ipadd,ipadd...]
[RESOUrceserver=ipadd,ipadd...] [ROOTPath=longstring]
[ROUter=ipadd,ipadd...] [ROUTERDiscovery={ON|OFF}]
[ROUTERSolicit=ipadd] [SERVER=ipadd]
[SERVERNAme=server-name] [SOURcerouting={ENAbled|
DIsabled}] [STATicroute=ipadd,ipadd...] [SUBLOcal={ON|
OFF}] [SUBNetmask=ipadd] [SWAPServer=ipadd]
[T1TIme=seconds] [T2TIME=seconds] [TCPGarbage={ON|OFF}]
[TCPKeepalive=seconds] [TCPTtl=ttl]
[TIMEOffset=utc-offset] [TIMEServer=ipadd,ipadd...]
[TRAILerencap={ON|OFF}]
[XDISplayservers=ipadd,ipadd...]
[XFONtservers=ipadd,ipadd...]

where:
■ name is a character string 1 to 15 characters long. It may contain any
printable character.
■ seconds is a time, time offset, or timeout value in seconds.
■ bootfilesize is the length in 512-octet blocks of the default boot image for the
client.
■ ipadd is an IP address in dotted decimal notation.
■ string is a character string 1 to 99 characters long. It may contain any
printable character.
■ lease-time is a time in seconds from 1 to 4294967295.
■ longstring is a character string 1 to 254 characters long. It may contain any
printable character.
■ ttl is a number from 1 and 255.
■ server-name is a character string 1 to 63 characters long. It may contain any
printable character.
■ utc-offset is a time offset in seconds from Coordinated Universal Time
(UTC).

Software Release 2.7.5

C613-03110-00 REV A
Dynamic Host Configuration Protocol (DHCP) set dhcp policy 23-31

Description This command modifies an existing option in a DHCP policy. The policy
parameter specifies the name of the policy containing the option to be
modified.

The arptimeout parameter specifies the timeout in seconds for ARP cache
entries.

The bootfilesize parameter specifies the length in 512-octet blocks of the

default boot image for the client.

The broadcastaddress parameter specifies the broadcast address in use on the

client’s subnet.

The cookieserver parameter specifies a list of RFC 865 cookie servers available
to the client. Cookie servers are specified by IP address. A maximum of up to
32 IP addresses can be specified in a comma separated list. Servers should be
listed in order of preference.

The dnsserver parameter specifies a list of Domain Name System (RFC 1035)
name servers available to the client. Domain Name System name servers are
specified by IP address. A maximum of up to 32 IP addresses can be specified
in a comma separated list. Servers should be listed in order of preference.

The domainname parameter specifies the domain name that the client should
use when resolving hostnames via the Domain Name System.

The etherencap parameter specifies whether the client should use Ethernet
Version 2 (RFC 894) or IEEE Standard 802.3 (RFC 1042) encapsulation for
Ethernet interfaces (vlan). A value of off indicates that the client should use
RFC 894 encapsulation. A value of on means that the client should use
RFC 1042 encapsulation.

The extensionpath parameter specifies a string to specify a file, retrievable via

TFTP, which contains information that can be interpreted in the same way as
the 64-octet vendor extension field within the BOOTP response.

The file parameter specifies the boot file name for the client.

The hostname parameter specifies the name of the client. The name may or
may not be qualified with the local domain name. See RFC 1035 for character
set restrictions.

The impressserver parameter specifies a list of Imagen Impress servers

available to the client. Imagen Impress servers are specified by IP address. A
maximum of up to 32 IP addresses can be specified in a comma separated list.
Servers should be listed in order of preference.

The intmtu parameter specifies the interface’s Maximum Transmission Unit

(MTU), in bytes. This is the maximum packet size that the client can transmit
over this interface at the physical layer (for example, Ethernet). Higher-layer
packets (for example, IP datagrams) that are bigger than this is fragmented by
the client and reassembled at the receiving end.

The ipforwarding parameter specifies whether the client should configure its
IP layer for packet forwarding. A value of disable disables IP forwarding, and
a value of enable enables IP forwarding.

Software Release 2.7.5

C613-03110-00 REV A
23-32 set dhcp policy Rapier i Switch Software Reference

The ipmtu parameter specifies the size, in bytes, of the largest IP packet the
client should be prepared to reassemble from packets that were fragmented at
the physical layer. The client discards IP packets that are larger than this value.

The ipplateau parameter specifies a table of MTU sizes to use when

performing Path MTU Discovery as defined in RFC 1191. The table is
formatted as a list of 16-bit unsigned integers, ordered from smallest to largest.
The minimum MTU value cannot be smaller than 68.

The iptimeout parameter specifies the timeout (in seconds) to use when aging
Path MTU values discovered by the mechanism defined in RFC 1191

The ipttl parameter specifies the default time-to-live that the client should use
on outgoing datagrams. The TTL is specified as an octet with a value between 1
and 255.

The leasetime parameter specifies the time period for which the IP address is
leased to the requesting IP client. For BOOTP requests, leasetime must be set to
infinity. If dynamic IP address allocation is not required, then set leasetime to
infinity.

Switches that comply with RFC 1541 but not with RFC 2131 may not be able to
accept a lease time of less than 3600 seconds (1 hour).

The logserver parameter specifies a list of MIT-LCS UDP log servers available
to the client. Log servers are specified by IP address. A maximum of up to 32 IP
addresses can be specified in a comma separated list. Servers should be listed
in order of preference.

The lprserver parameter specifies a list of RFC 1179 line printer servers
available to the client. Line printer servers are specified by IP address. A
maximum of up to 32 IP addresses can be specified in a comma separated list.
Servers should be listed in order of preference.

The maskdiscovery parameter specifies whether the client should perform

subnet mask discovery using ICMP. A value of off indicates that the client
should not perform mask discovery. A value of on means that the client should
perform mask discovery.

The masksupplier parameter specifies whether the client should respond to

subnet mask requests using ICMP. A value of off indicates that the client
should not respond. A value of on means that the client should respond.

The meritdumpfile parameter specifies the path name of a file where the
client’s core image should be dumped in the event the client crashes. The path
name is formatted as a character string consisting of characters from the NVT
ASCII character set.

The nameserver parameter specifies a list of IEN116 name servers available to

the client. IEN116 servers are specified by IP address. A maximum of up to 32
IP addresses can be specified in a comma separated list. Servers should be
listed in order of preference.

The nbddservers parameter specifies a list of RFC 1001/1002 NetBIOS

datagram distribution servers (NBDD) listed in order of preference. NetBIOS
datagram distribution servers are specified by IP address. A maximum of up to
32 IP addresses can be specified in a comma separated list.

Software Release 2.7.5

C613-03110-00 REV A
Dynamic Host Configuration Protocol (DHCP) set dhcp policy 23-33

The nbnameservers parameter specifies a list of RFC 1001/1002 NetBIOS name

servers (NBNS) listed in order of preference. NetBIOS name servers are
specified by IP address. A maximum of up to 32 IP addresses can be specified
in a comma separated list.

The nbnodetype parameter specifies the NetBIOS node type that allows
NetBIOS over TCP/IP clients to be configured as described in RFC 1001/1002.

The nbscope parameter specifies the NetBIOS over TCP/IP scope parameter
for the client as specified in RFC 1001/1002.

The nisdomain parameter specifies the name of the client’s NIS domain. The
domain is formatted as a character string consisting of characters from the NVT
ASCII character set.

The niservers parameter specifies a list of IP addresses indicating NIS servers

available to the client. NIS servers are specified by IP address. A maximum of
up to 32 IP addresses can be specified in a comma separated list. Servers
should be listed in order of preference.

The ntpservers parameter specifies a list of IP addresses indicating NTP

servers available to the client. NTP servers are specified by IP address. A
maximum of up to 32 IP addresses can be specified in a comma separated list.
Servers should be listed in order of preference.

The policyfiltering parameter specifies policy filters for non-local source

routing. The filters consist of a list of IP addresses and masks that specify
destination/mask pairs with which to filter incoming source routes. Any
source-routed datagram whose next hop address does not match one of the
filters should be discarded by the client. Policy filters are specified by IP
address. A maximum of up to 32 IP addresses can be specified in a comma
separated list.

The resourceserver parameter specifies a list of RFC 887 Resource Location

servers available to the client. Resource Location servers are specified by IP
address. A maximum of up to 32 IP addresses can be specified in a comma
separated list. Servers should be listed in order of preference.

The rootpath parameter specifies the path name that contains the client’s root
disk. The path name is formatted as a character string consisting of characters
from the NVT ASCII character set.

The router parameter specifies a list of IP addresses for routers on the client’s
subnet. Routers are specified by IP address. A maximum of up to 32 IP
addresses can be specified in a comma separated list. Routers should be listed
in order of preference.

The routerdiscovery parameter specifies whether the client should solicit

routers using the Router Discovery mechanism defined in RFC 1256. A value of
off indicates that the client should not perform router discovery. A value of on
means that the client should perform router discovery.

The routersolicit parameter specifies the address where the client should
transmit router solicitation requests.

The server parameter specifies the address of the server to use in the next step
of the client’s bootstrap process. As the switch is not capable of providing an
operating system executable, this option allows the IP address of an
appropriate TFTP server to be set.

Software Release 2.7.5

C613-03110-00 REV A
23-34 set dhcp policy Rapier i Switch Software Reference

The servername parameter specifies the name of the server host. This is passed
to the client.

The sourcerouting parameter specifies whether the client should configure its
IP layer to allow forwarding of datagrams with non-local source routes. A
value of disable disallows forwarding of such datagrams, and a value of
enable allows forwarding.

The staticroute parameter specifies a list of static routes that the client should
install in its routing cache. If multiple routes to the same destination are
specified, they are listed in descending order of priority. The routes consist of a
list of IP address pairs. The first address is the destination address, and the
second address is the router for the destination. A maximum of up to 32 IP
addresses can be specified in a comma separated list. The default route (0.0.0.0)
is an illegal destination for a static route.

The sublocal parameter specifies whether the client may assume that all
subnets of the IP network where the client is connected use the same MTU as
the subnet of that network where the client is directly connected. A value of on
indicates that all subnets share the same MTU. A value of off means that the
client should assume that some subnets of the directly connected network may
have smaller MTUs.

The subnetmask parameter specifies the client’s subnet mask as defined in

RFC 950. If you intend to use subnet or supernet addressing when you create
DHCP ranges, you should include this option in the policy before you create
the range.

The swapserver parameter specifies the IP address of the client’s swap server.

The t1time parameter specifies the time interval, in seconds, from address
assignment until the client transitions to the renewing state.

The t2time parameter specifies the time interval, in seconds, from address
assignment until the client transitions to the rebinding state.

The tcpgarbage parameter specifies whether the client should send TCP
keepalive messages with a octet of garbage for compatibility with older
implementations. A value of off indicates that a garbage octet should not be
sent. A value of on indicates that a garbage octet should be sent.

The tcpkeepalive parameter specifies the interval (in seconds) that the client
TCP should wait before sending a keepalive message on a TCP connection. A
value of zero indicates that the client should not generate keepalive messages
on connections unless specifically requested by an application.

The tcpttl parameter specifies the default time-to-live value that the client
should use when sending TCP segments.

The timeoffset parameter specifies the offset of the client’s subnet in seconds
from Coordinated Universal Time (UTC).

The timeserver parameter specifies a list of RFC 868 time servers available to
the client. Time servers are specified by IP address. A maximum of up to 32 IP
addresses can be specified in a comma separated list. Servers should be listed
in order of preference.

The trailerencap parameter specifies whether the client should negotiate the
use of trailers (RFC 893) when using the ARP protocol. A value of off indicates

Software Release 2.7.5

C613-03110-00 REV A
Dynamic Host Configuration Protocol (DHCP) set dhcp range 23-35

that the client should not attempt to use trailers. A value of on means that the
client should attempt to use trailers.

The xdisplayservers parameter specifies a list of IP addresses of systems that

are running the X Window System Display Manager and are available to the
client. A maximum of up to 32 IP addresses can be specified in a comma
separated list. Addresses should be listed in order of preference.

The xfontservers parameter specifies a list of X Window System Font servers

available to the client. X Window System Font servers are specified by IP
address. A maximum of up to 32 IP addresses can be specified in a comma
separated list. Servers should be listed in order of preference.

Examples To change the DN server for policy “base”, use the command:
set dhcp poli=base dnss=192.168.100.51

Related Commands add dhcp policy

create dhcp policy
delete dhcp policy
destroy dhcp policy
show dhcp policy

set dhcp range

Syntax SET DHCP RANge=name PRObe={ARP|ICMP}

where name is a character string 1 to 15 characters long. It may contain any

printable character.

Description This command modifies the server’s method for probing IP addresses in the
specified range.

The probe parameter specifies how the DHCP server checks whether an IP
address is being used by other hosts. If arp is specified, the server sends ARP
requests to determine if an address is in use. If icmp is specified, the server
sends ICMP Echo Requests (pings). The default is icmp.

Note that arp cannot be specified if the range includes a gateway (by specifying
the gateway parameter when it was created), or if the network uses Proxy ARP.

Examples To set the range "office" to use ARP packets to probe IP addresses, use the
command:
set dhcp ran=office pro=arp

Related Commands add dhcp range

create dhcp range
delete dhcp range
destroy dhcp range
show dhcp range

Software Release 2.7.5

C613-03110-00 REV A
23-36 show bootp relay Rapier i Switch Software Reference

show bootp relay

Syntax SHow BOOTp RELAy

Description This command displays the current configuration of the BOOTP Relay Agent
(Figure 23-1, Table 23-1).

Figure 23-1: Example output from the show bootp relay command

BOOTP Relaying Agent Configuration.

Status : ENABLED
Maximum Hops : 4

DHCP Option 82:

Insertion status .......... Enabled
Check ..................... Yes
Reforwarding policy ....... Replace
Debugging ................. Disabled

BOOTP Relay Destinations

------------------------
192.231.35.29
------------------------

BOOTP Counter
---------------
InPackets OutPackets InRejects InRequests InReplies
0000000000 0000000000 0000000000 0000000000 0000000000

Table 23-1: Parameters in output of the show bootp relay command

Parameter Meaning
Status Whether the BOOTP Relay Agent is enabled.
Maximum Hops Maximum value allowed for the hops field in a BOOTP
message before the message is discarded.
Insertion Status The status of DHCP Option 82 insertion, either Enabled or
Disabled.
Check Whether DHCP Option 82 information returned from the
DHCP server is being checked, either Yes or No.
Reforwarding policy The re-forwarding policy of client DHCP packets, either
Replace, Keep, or Drop.
Debugging The status of DHCP Option 82 debugging, either Enabled or
Disabled.
BOOTP Relay Destinations List of IP addresses where BOOTREQUEST messages are
forwarded.
InPackets Total number of BOOTP packets received.
OutPackets Total number of BOOTP packets transmitted.
InRejects Number of incoming BOOTP packets rejected because of an
error in the packet.
InRequests Number of BOOTP requests received.
InReplies Number of BOOTP replies received.

Software Release 2.7.5

C613-03110-00 REV A
Dynamic Host Configuration Protocol (DHCP) show bootp relay port 23-37

Related Commands add bootp relay

delete bootp relay
disable bootp relay
enable bootp relay
purge bootp relay
set bootp maxhops
show bootp relay port

show bootp relay port

Syntax SHow BOOTp RELAy POrt[={port-list|ALL}]

where port-list is a port number, a range of port numbers (specified as n-m), or a

comma-separated list of port numbers and/or ranges. Port numbers start at 1
and end at m, where m is the highest numbered Ethernet switch port, including
uplink ports.

Description This command displays port-related information about the BOOTP Relay port
settings.

Use the port parameter to specify the port to display BOOTP Relay information
for. If all is specified, information about all ports on the device is displayed.

Figure 1: Example output from the show bootp relay port command

BOOTP Relay Port Information:

----------------------------------------
Port .................... 1
Trusted .................... No
Subscriber-ID .............. user12332

Port .................... 2
Trusted ....................Yes
Subscriber-ID .............. -------------------------------
---------

Table 1: Parameters in output of the show bootp relay port command

Parameter Meaning
Port The number of the switch port
Trusted Whether the port is trusted, either Yes or No.
Subscriber-ID The subscriber-ID assigned to the port.

Related commands disable bootp relay option82

enable bootp relay option82
set bootp relay option82
set bootp relay option82 port
show bootp relay

Software Release 2.7.5

C613-03110-00 REV A
23-38 show dhcp Rapier i Switch Software Reference

show dhcp

Syntax SHow DHCP

Description This command displays the state of the DHCP module (Figure 23-2,
Table 23-2).

Figure 23-2: Example output from the show dhcp command

DHCP Server

State .............. enabled

BOOTP Status ....... enabled
DEBUG Status ....... enabled
Extended Client ID . enabled
Policies ........... poll
prnt
Ranges ...........,. develop (202.36.163.6 - 202.36.163.22)
remote (192.168.100.92 - 192.168.100.124)
In Messages ........ 3
Out Messages ....... 3
In DHCP Messages ... 3
Out DHCP Messages .. 3
In BOOTP Messages .. 0
Out BOOTP Messages . 0

DHCP Client

Interface .......... vlan1

Client Identifier .. 00-00-cd-03-b3-4c-00-80-00-01
State .............. bound
Server ............. 10.194.0.10
Assigned Domain ....
Assigned IP ........ 10.194.0.1
Assigned Mask ...... 255.255.255.255
Assigned Gateway ... 0.0.0.0
Assigned DNS ....... 0.0.0.0

Table 23-2: Parameters in output of the show dhcp command

Parameter Meaning
State Whether the status of the DHCP server is enabled or disabled.
BOOTP Status Whether the status of BOOTP serving is enabled or disabled.
Extended Client ID Whether extended client IDs are transmitted by this device;
either Enabled or Disabled.
BOOTP Status Whether the status of BOOTP serving is enabled or disabled.
Policies A list of the policies that have been defined.
Ranges A list of the ranges that have been defined.
In Messages Total number of DHCP or BOOTP messages received by the
switch.
Out Messages Total number of DHCP or BOOTP messages transmitted by the
switch.
In DHCP Messages Number of DHCP messages received by the switch.
Out DHCP Messages Number of DHCP messages transmitted by the switch.

Software Release 2.7.5

C613-03110-00 REV A
Dynamic Host Configuration Protocol (DHCP) show dhcp 23-39

Table 23-2: Parameters in output of the show dhcp command (Continued)

Parameter Meaning
In BOOTP Messages Number of BOOTP messages received by the switch.
Out BOOTP Messages Number of BOOTP messages transmitted by the switch.
Interface Interface(s) on which this client is active.
Client Identifier Identifying token used in DHCP messages for this client.
State Current state of the DHCP client; either Renewing, Rebinding,
Selecting, Requesting, Bound, or Init.
Server DHCP server this client is connected to.
Assigned Domain Domain name provided for this client by the DHCP server.
Assigned IP IP address assigned to this client by the DHCP server.
Assigned Mask IP address mask matching the address assigned to this client.
Assigned Gateway Network gateway IP address provided by the DHCP server.
Assigned DNS Domain Name Server IP address provided by the DHCP server.

Examples To display the current configuration of the DHCP server, use the command:
sh dhcp

Related Commands disable dhcp

enable dhcp
set dhcp
show dhcp client
show dhcp policy
show dhcp range

Software Release 2.7.5

C613-03110-00 REV A
23-40 show dhcp client Rapier i Switch Software Reference

show dhcp client

Syntax SHow DHCP CLIEnt[=ipaddress] [RANge=name] [PRObeconflicts]

Description This command displays information about the currently defined range client
entries (Figure 23-3, Table 23-3 on page 23-41). If the range parameter is
specified, then the clients in the specified range are displayed. If an IP address
is specified on the client parameter, then information for that IP address is
displayed.

If the probeconflicts parameter is specified, only clients that have replied to

probes sent by the server to reclaim an IP address are displayed. This indicates
a conflict between the IP addresses that these clients are currently using and
the server's current client database.

Figure 23-3: Example output from the show dhcp client command

DHCP Client Entries

IP Address ClientId State Type Expiry

-------------------------------------------------------------------------------
202.36.163.14 00-00-c0-00-00-01 unused static never
202.36.163.15 00-00-c0-00-00-02 unused static never
202.36.163.16 00-00-c0-00-00-03 unused static never
202.36.163.17 00-00-c0-00-00-04 unused static never
202.36.163.18 00-00-c0-00-00-05 unused static never
202.36.163.19 00-00-c0-00-00-06 unused static never
202.36.163.20 08-00-5a-a1-02-3f inuse auto never
202.36.163.21 00-00-c0-c9-c6-7b inuse auto never
202.36.163.22 08-00-09-0d-16-e7 inuse auto never
202.36.163.23 unused auto never
202.36.163.24 unused auto never
202.36.163.25 unused auto never
202.36.163.26 unused auto never
202.36.163.27 unused auto never
202.36.163.28 00-40-10-02-e8-a3 inuse auto never

192.168.100.92 00-00-c0-c9-c6-21 inuse dyn 19-Jun-1997 12:30:51

192.168.100.93 unused dyn
192.168.100.94 unused dyn
192.168.100.95 unused dyn
192.168.100.96 unused dyn
192.168.100.97 unused dyn
192.168.100.98 unused dyn
192.168.100.99 unused dyn
192.168.100.110 unused dyn
192.168.100.111 unused dyn
192.168.100.112 unused dyn
192.168.100.113 unused dyn
192.168.100.114 unused dyn
192.168.100.115 reclaim dyn
192.168.100.116 reclaim dyn
192.168.100.117 reclaim dyn
192.168.100.118 reclaim dyn

Software Release 2.7.5

C613-03110-00 REV A
Dynamic Host Configuration Protocol (DHCP) show dhcp client 23-41

Table 23-3: Parameters in output of the show dhcp client command

Parameter Meaning
IP Address IP address from the range of available IP addresses.
ClientId Hardware address of the client, if any, that has been assigned the IP
address.
State State of the IP address:
Unused - not currently in use and is available for assignment
Inuse - currently assigned to a client
Reclaim - currently being reclaimed
Type Type of allocation mechanism applied to the IP address:
Static - manual allocation
Auto - automatic allocation
Dyn - dynamic allocation
Expiry Expiry date for dynamically allocated IP addresses.

Examples To display information about the clients in a range named “remote”, use the
command:
sh dhcp clie ran=remote

Related Commands show dhcp

show dhcp policy
show dhcp range

Software Release 2.7.5

C613-03110-00 REV A
23-42 show dhcp policy Rapier i Switch Software Reference

show dhcp policy

Syntax SHow DHCP POLIcy[=name]

Description This command displays information about the currently defined policies
(Figure 23-4, Table 23-4). If a policy name is specified, then information about
the specified policy is displayed.

Figure 23-4: Example output from the show dhcp policy command

DHCP Policies

Name: pol1
Base Policy: none
01 subnetmask .... 255.255.255.0
03 router ........ 202.36.163.21
06 dnsserver ..... 192.168.100.50 192.168.100.33
51 leasetime ..... 3600

Name: prnt
Base Policy: pol1
01 subnetmask .... (pol1) 255.255.255.0
03 router ........ (pol1) 202.36.163.21
06 dnsserver ..... (pol1) 192.168.100.50 192.168.100.33
51 leasetime ..... (prnt) infinity

Table 23-4: Parameters in output of the show dhcp policy command

Parameter Meaning
Name Name of the policy.
Base Policy Base policy inherited by this policy.
options... A list of options configured for the policy. Each entry includes the DHCP
option identifier, the parameter keyword, and the current value(s) of
the option.

Examples To display information about the policy “base”, use the command:
sh dhcp poli=base

Related Commands add dhcp policy

create dhcp policy
delete dhcp policy
destroy dhcp policy
set dhcp policy
show dhcp
show dhcp client
show dhcp range

Software Release 2.7.5

C613-03110-00 REV A
Dynamic Host Configuration Protocol (DHCP) show dhcp range 23-43

show dhcp range

Syntax SHow DHCP RANge[=name]

where name is a character string 1 to 15 characters long. It may contain any

printable character.

Description This command displays information about currently defined ranges

(Figure 23-5, Table 23-5 on page 23-44). If a range name is specified, then
information about it is displayed.

This command also displays counters for DHCP and BOOTP. BOOTP is used
to transport DHCP messages. If the switch is acting as a DHCP server for
clients on subnets that are not directly connected to one of the switch’s
interfaces, the DHCP messages are relayed through intermediate routers acting
as BOOTP relay agents.

Figure 23-5: Example output from the show dhcp range command

DHCP Ranges

Name: remote
Policy ..................... pol1
Probe Type ................. ICMP
Start Address .............. 192.168.100.92
End Address ................ 192.168.100.124
Reclaim Status ............. Deferred
Next reclaim in ............ 5 seconds
Used Address(es) ........... 192.168.100.92 192.168.100.94 192.168.100.95
192.168.100.96
Free Address(es) ........... 192.168.100.93 192.168.100.97 192.168.100.98
192.168.100.99 192.168.100.100 192.168.100.101
192.168.100.102
Reclaiming Address(es) ..... 192.168.100.103 192.168.100.104 192.168.100.105
192.168.100.106 192.168.100.107 192.168.100.108
192.168.100.109 192.168.100.110 192.168.100.111
192.168.100.112 192.168.100.113 192.168.100.114
192.168.100.115 192.168.100.116 192.168.100.117
192.168.100.118 192.168.100.119 192.168.100.120
192.168.100.121 192.168.100.122 192.168.100.123
In DHCP Messages ........... 0
In Discover Messages ....... 0
In Request Messages ........ 0
In Decline Messages ........ 0
In Release Messages ........ 0
Out DHCP Messages .......... 0
Out Offer Messages ......... 0
Out Ack Messages ........... 0
Out Nak Messages ........... 0
In BOOTP Messages .......... 0
Out BOOTP Messages ......... 0

Total probe replies ........ 0

Probe reply no details ... 0
Probed entry static ...... 0
Probed client new ........ 0
Client has multiple IPs .. 0

Software Release 2.7.5

C613-03110-00 REV A
23-44 show dhcp range Rapier i Switch Software Reference

Table 23-5: Parameters in output of the show dhcp range command

Parameter Meaning
Name Name of the range.
Policy Policy that is applied to entries in the range.
Probe Type Whether the DHCP server’s method for probing IP addresses is
ICMP or ARP.
Start Address First IP address in the range.
End Address Last IP address in the range.
Reclaim Status Whether IP addresses are currently being reclaimed for clients:
In progress Yes
Stopped No
Deferred No available route to the IP address being reclaimed
Next reclaim in For ranges with deferred status, the time until the next reclaim is
attempted.
Used Address(es) List of IP addresses currently assigned to clients.
Free Address(es) List of IP addresses currently available for assignment.
Reclaiming Address(es) List of IP addresses currently being reclaimed from clients.
In DHCP Messages Total number of DHCP messages the server received for this range.
In Discover Messages Number of DHCP Discover messages the server received for this
range. A client broadcasts these messages to initiate a DHCP
session.
In Request Messages Number of DHCP Request messages the server received for this
range. A client uses this message to request parameters from a
server that has offered them, to check that a previously allocated
address is still correct (for example, after the client has rebooted)
and to extend its lease of an address.
In Decline Messages Number of DHCP Decline messages the server received for this
range. When a client is offered an address, it may use ARP to check
the address. The client sends a Decline message if it discovers that
the IP address the server has offered it is already being used by
another device.
In Release Messages Number of DHCP Release messages the server received for this
range. A client sends this message to relinquish an address when
it no longer requires it. This makes the address available to another
client.
Out DHCP Messages Total number of DHCP messages the server transmitted for this
range.
Out Offer Messages Number of DHCP Offer messages the server sent for this range.
The server sends this message in response to a client Discover
message to offer configuration parameters to the client.
Out Ack Messages Number of DHCP Acknowledgment messages the server sent for
this range. The server sends this message in response to a client
Request message, to supply the client with configuration
parameters.
Out Nak Messages Number of DHCP Negative Acknowledgment messages the server
sent for this range. The server sends this message in response to a
client Request message to tell the client that the IP address the
client believes it has is wrong, the IP address the server offered is
no longer available, or the client’s lease has expired.

Software Release 2.7.5

C613-03110-00 REV A
Dynamic Host Configuration Protocol (DHCP) show dhcp range 23-45

Table 23-5: Parameters in output of the show dhcp range command (Continued)

Parameter Meaning
In BOOTP Messages Number of BOOTP messages the server received for this range.
Out BOOTP Messages Number of BOOTP messages the server transmitted for this range.
Total probe replies The total number of probe replies received for IP addresses in this
range. The server probes an IP address to determine if another host
is using the address. The probe is either an ARP request or an ICMP
Echo Request (ping). A probe reply indicates a conflict between the
IP address that the client is currently using and the server's current
client database.
Probe reply no details The number of probe replies received where the server was unable
to determine the client ID details of the responder. This results in
the DHCP client entry appearing as 'inuse', but with no ClientId.
Probed entry static The number of probe replies received when reclaiming static client
entries after start-up.
Probed client new The number of probe replies received from clients that are not
already in the server's client database. This can indicate either that
a statically configured client is setup within the DHCP range, or the
DHCP file was deleted or out of date when the server was
restarted. This can also occur if a client is moved from a dynamic
lease to a static lease.
Client has multiple IPs The number of times a client has replied to probes for more than
one IP address. This can happen if the server is using ARP probes
and a device in the network is configured for Proxy ARP.

Examples To display information about a range named “remote”, use the command:
sh dhcp rang=remote

Related Commands add dhcp range

create dhcp range
delete dhcp range
destroy dhcp range
set dhcp range
show dhcp
show dhcp client
show dhcp policy

Software Release 2.7.5

C613-03110-00 REV A