-
Cisco IOS XR IP Addresses and Services Command Reference, Release 3.7
-
Preface
-
Access List Commands on Cisco IOS XR Software
-
ARP Commands on Cisco IOS XR Software
-
Cisco Express Forwarding Commands on Cisco IOS XR Software
-
DHCP Commands on Cisco IOS XR Software
-
Host Services and Applications Commands on Cisco IOS XR Software
-
HSRP Commands on Cisco IOS XR Software
-
LPTS Commands on Cisco IOS XR Software
-
Network Stack IPv4 and IPv6 Commands on Cisco IOS XR Software
-
Prefix List Commands on Cisco IOS XR Software
-
Transport Stack Commands on Cisco IOS XR Software
-
VRRP Commands on Cisco IOS XR Software
-
Index
-
Table Of Contents
DHCP Commands on Cisco IOS XR Software
pd (prefix-delegation - DHCP IPv6 pool)
pd (prefix-delegation - DHCP IPv6 interface)
relay information option allow-untrusted
show dhcp ipv4 relay profile name
show dhcp ipv4 relay statistics
DHCP Commands on Cisco IOS XR Software
This chapter describes the Cisco IOS XR software commands used to configure and monitor the Dynamic Host Configuration Protocol (DHCP).
allow-hint
To allow the server to delegate a valid client-suggested prefix in the solicit and request messages, use the allow-hint command in Dynamic Host Configuration Protocol (DHCP) IPv6 interface server configuration mode. To disable the delegation of a valid client-suggested prefix, use the no form of the command.
allow-hint
no allow-hint
Syntax Description
This command has no arguments or keywords.
Defaults
DHCPv6 service on an interface is disabled.
Command Modes
DHCP IPv6 interface server configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The allow-hint command enables the server to delegate a client-suggested prefix in the solicit and request messages if the prefix in the associated local prefix pool is a valid prefix and it is not assigned to any other solicit and request messages. Otherwise, the hint is ignored, and a prefix is delegated from the free list in the pool.
Task ID
Examples
The following is an example of the allow-hint command:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# dhcp ipv6 interface pos 0/5/0/0 serverRP/0/RP0/CPU0:router(config-dhcpv6-if)# allow-hintbroadcast-flag policy check
To configure Dynamic Host Configuration Protocol (DHCP) IPv4 Relay to only broadcast BOOTREPLY packets, if the DHCP IPv4 broadacst flag is set in the DHCP IPv4 header, use the broadcast-flag policy check command in DHCP IPv4 relay profile configuration submode. By default, the DHCP IPv4 Relay always broadcasts BOOTREPLY packets. To restore the default, use the no form of this command.
broadcast-flag policy check
no broadcast-flag policy check
Syntax Description
This command has no arguments or keywords.
Defaults
Relay agent always broadcasts DHCP IPv4 packets to a client.
Command Modes
DHCP IPv4 relay profile configuration
Command History
Release 3.7.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following is an example of the broadcast-flag policy check command:
RP/0/RP0/CPU0:router# configRP/0/RP0/CPU0:router(config)# dhcp ipv4RP/0/RP0/CPU0:router(config-dhcpv4)# profile client relayRP/0/RP0/CPU0:router(config-dhcpv4-relay-profile)# broadcast-flag policy checkRelated Commands
clear dhcp ipv6 binding
To delete automatic client bindings from the Dynamic Host Configuration Protocol (DHCP) for IPv6 binding table, use the clear ipv6 dhcp binding command in EXEC mode.
clear dhcp ipv6 binding [ipv6-address]
Syntax Description
Command Default
No default behavior or values
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The clear ipv6 dhcp binding command is used as a server function.
A binding table entry on the DHCP for IPv6 server is automatically:
•
Created whenever a prefix is delegated to a client from the configuration information pool
•
•
If the clear ipv6 dhcp binding command is used with the optional ipv6-address argument specified, only the binding for the specified client is deleted. If the clear ipv6 dhcp binding command is used without the ipv6-address argument, then all automatic client bindings are deleted from the DHCP for IPv6 binding table.
Task ID
Examples
The following example specifies DHCP for IPv6 binding database agent parameters:
RP/0/RP0/CPU0:router# clear dhcp ipv6 bindingRelated Commands
database
To configure a Dynamic Host Configuration Protocol (DHCP) for IPv6 binding database agent, use the database command in DHCP IPv6 configuration mode. To delete the database agent, use the no form of this command.
database agent-URL [write-delay seconds] [timeout seconds]
no database agent-URL
Syntax Description
Defaults
Write-delay default is 300 seconds.
Timeout default is 300 secondsCommand Modes
DHCP IPv6 configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The database command specifies DHCP for IPv6 binding database agent parameters. The user may configure multiple database agents.
The write-delay keyword specifies how often, in seconds, that DHCP sends database updates. By default, DHCP for IPv6 server waits 300 seconds before sending any database changes.
The timeout keyword specifies how long, in seconds, the router waits for a database transfer. Infinity is defined as 0 seconds, and transfers that exceed the timeout period are aborted. By default, the DHCP for IPv6 server waits 300 seconds before aborting a database transfer. When the system is going to reload, there is no transfer timeout so that the binding table can be stored completely.
Task ID
Examples
The following example specifies DHCP for IPv6 binding database agent parameters:
RP/0/RP0/CPU0:router# configureRP/0/RP0/CPU0:router(config)# dhcp ipv6RP/0/RP0/CPU0:router(config-dhcpv6)# database tftp://10.0.0.1/dhcp-bindingRelated Commands
destination (DHCP IPv6)
To specify a destination address to which client messages are forwarded and to enable Dynamic Host Configuration Protocol (DHCP) for IPv6 relay service on the interface, use the destination command in DHCP IPv6 interface relay configuration mode. To remove a relay destination on the interface or delete an output interface for a destination, use the no form of this command.
destination {ipv6 address} interface
no destination {ipv6 address} interface
Syntax Description
Defaults
Relay function is disabled and there is no relay destination on the interface.
Command Modes
DHCP IPv6 interface relay configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The destination command specifies a destination address to which client messages are forwarded and enables DHCP for IPv6 relay service on the interface. When relay service is enabled on an interface, a DHCP for IPv6 message received on that interface is forwarded to all configured relay destinations. The incoming DHCP for IPv6 message may have come from a client on that interface, or it may have been relayed by another relay agent.
The relay destination can be a unicast address of a server or another relay agent, or it may be a multicast address. There are the following two types of relay destination addresses:
•
•
•
If no output interface is configured for a destination, the output interface is determined by routing tables. In this case, it is recommended that a unicast or multicast routing protocol be running on the router.
Multiple destinations can be configured on one interface, and multiple output interfaces can be configured for one destination. When the relay agent relays messages to a multicast address, it sets the hop limit field in the IPv6 packet header to 32.
Unspecified, loopback, and node-local multicast addresses are not acceptable as the relay destination. If any one of them is configured, the message "Invalid destination address" is displayed.
Note that it is not necessary to enable the relay function on an interface for it to accept and forward an incoming relay reply message from servers. By default, the relay function is disabled, and there is no relay destination on an interface. The no form of the command removes a relay destination on an interface or deletes an output interface for a destination. If all relay destinations are removed, the relay service is disabled on the interface.
The DHCP for IPv6 client, server, and relay functions is mutually exclusive on an interface. When one of these functions is already enabled and a user tries to configure a different function on the same interface, one of the following messages is displayed: "Interface is in DHCP client mode," "Interface is in DHCP server mode," or "Interface is in DHCP relay mode."
Task ID
Examples
The following is an example of the destination command on a Packet over Sonet/SDH (POS) interface:
RP/0/RP0/CPU0:router(config)# dhcp ipv6RP/0/RP0/CPU0:router(config-dhcpv6)# interface pos 0/5/0/0 relayRP/0/RP0/CPU0:router(config-dhcpv6-if)# destination 10:10::10Related Commands
dhcp ipv4
To enable Dynamic Host Configuration Protocol (DHCP) for IPv4 and to enter DHCP IPv4 configuration mode, use the dhcp ipv4 command in global configuration mode. To disable DHCP for IPv4 and exit the DHCP IPv4 configuration mode, use the no form of this command.
dhcp ipv4
no dhcp ipv4
Syntax Description
This command has no arguments or keywords.
Command Modes
Global configuration
Command History
Release 3.7.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the dhcp ipv4 command to enter DHCP IPv4 configuration mode.
Task ID
Examples
The following example shows how to enable DHCP for IPv4:
RP/0/RP0/CPU0:router(config)# dhcp ipv4RP/0/RP0/CPU0:router (config-dhcpv4)#Related Commands
Specifies a relay profile on an interface.
Configures a relay profile for the DHCP IPv4 component.
Specifies a relay profile on a VRF.
dhcp ipv6
To enable Dynamic Host Configuration Protocol (DHCP) for IPv6 and to enter DHCP IPv6 configuration mode, use the dhcp ipv6 command in global configuration mode. To disable, use the no form of this command.
dhcp ipv6
no dhcp ipv6
Syntax Description
This command has no arguments or keywords.
Command Modes
Global configuration
Command History
Release 3.6.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Release 3.7.0
No modification.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the dhcp ipv6 command to enter DHCP IPv6 configuration mode.
Task ID
Examples
The following example shows how to enable DHCP for IPv6:
RP/0/RP0/CPU0:router(config)# dhcp ipv6RP/0/RP0/CPU0:router (config-dhcpv6)#Related Commands
distance
To specify an administrative distance for Dynamic Host Configuration Protocol (DHCP) for IPv6 Prefix Delegation, use the distance command in DHCP IPv6 configuration mode. To delete an administrative distance, use the no form of this command.
distance administrative distance
no distance administrative distance
Syntax Description
Defaults
administrative distance: 1
Command Modes
DHCP IPv6 configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following is an example of setting the DHCP administrative distance to 200 using the distance command:
RP/0/RP0/CPU0:router(config)# dhcp ipv6RP/0/RP0/CPU0:router (config-dhcpv6)# distance 200Related Commands
Enables Dynamic Host Configuration Protocol (DHCP) for IPv6 and enters DHCP IPv6 configuration mode.
dns-server
To specify the Domain Name System (DNS) IPv6 servers available to a Dynamic Host Configuration Protocol (DHCP) for IPv6 client, use the dns-server command in DHCP IPv6 pool configuration mode. To remove the DNS server list, use the no form of this command.
dns-server ipv6-address
no dns-server ipv6-address
Syntax Description
ipv6-address
IPv6 address of a DNS server.
This argument must be in the form documented in RFC 2373, where the address is specified in hexadecimal using 16-bit values between colons.
Defaults
When a DHCP for IPv6 pool is first created, no DNS IPv6 servers are configured.
Command Modes
DHCP IPv6 pool configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Multiple Domain Name System (DNS) server addresses can be configured by issuing this command multiple times. New addresses do not overwrite old addresses.
Task ID
Examples
The following is an example of setting the DNS server name using the dns-server command:
RP/0/RP0/CPU0:router(config)# dhcp ipv6 pool pool1RP/0/RP0/CPU0:router(config-dhcpv6-pool)# dns-server 10:10::10Related Commands
Configures a Dynamic Host Configuration Protocol (DHCP) for the IPv6 server configuration information pool and enters DHCP for IPv6 pool configuration mode.
domain-name (DHCP IPv6 pool)
To configure a domain name for a Dynamic Host Configuration Protocol (DHCP) for IPv6 client, use the domain-name command in DHCP IPv6 pool configuration mode. To remove the domain name, use the no form of this command.
domain-name domain
no domain-name
Syntax Description
Defaults
When a DHCP for IPv6 pool is first created, no domain name for clients is configured.
Command Modes
DHCP IPv6 pool configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Multiple Domain Name System (DNS) domain names can be configured by issuing the domain-name command multiple times. The new domain name does not overwrite existing domain names.
Task ID
Examples
The following is an example of how to configure a DHCP IPv6 domain name using the domain-name command:
RP/0/RP0/CPU0:router(config)# dhcp ipv6 pool pool1RP/0/RP0/CPU0:router(config-dhcpv6-pool)# domain-name howie.comRelated Commands
Configures a Dynamic Host Configuration Protocol (DHCP) for the IPv6 server configuration information pool and enters DHCP for IPv6 pool configuration mode.
duid
To define the Dynamic Host Configuration Protocol (DHCP) the unique identification (DUID) on a specified device, use the duid command in DHCP IPv6 configuration mode. To delete an administrative distance, use the no form of this command.
duid duid name
no duid duid name
Syntax Description
Defaults
DUID-LL as defined in Section 9.4 of RFC3315
Command Modes
DHCP IPv6 configuration
Command History
Usage Guidelines
For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the duid command to configure the DHCP unique identifier on a specified device. Use the no form of this command to restore the default.
Task ID
Examples
The following is an example of how to create an IPv6 DHCP unique identifier (DUID) of 0002000000090CC084D303000912 using the duid command:
RP/0/RP0/CPU0:router(config)# dhcp ipv6RP/0/RP0/CPU0:router(config-dhcpv6)# duid 0002000000090CC084D303000912Related Commands
Enables Dynamic Host Configuration Protocol (DHCP) for IPv6 and enters DHCP IPv6 configuration mode.
giaddr policy
To configure how Dynamic Host Configuration Protocol (DHCP) IPv4 Relay processes BOOTREQUEST packets that already contain a nonzero giaddr attribute, use the giaddr policy command in DHCP IPv4 profile relay configuration submode. To restore the default giaddr policy, use the no form of this command.
giaddr policy {replace | drop}
no giaddr policy {replace | drop}
Syntax Description
replace
Replaces the existing giaddr value with a value that it generates.
drop
Drops the packet that has an existing nonzero giaddr value.
Defaults
DHCP IPv4 relay retains the existing nonzero giaddr value.
Command Modes
DHCP IPv4 profile relay configuration
Command History
Release 3.7.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The giaddr policy command affects only the packets that are received from a DHCP IPv4 client that have a non-zero giaddr attribute.
Task ID
Examples
The following example shows how to use the giaddr policy command:
RP/0/RP0/CPU0:router# configRP/0/RP0/CPU0:router(config)# dhcp ipv4RP/0/RP0/CPU0:router(config-dhcpv4)# profile client relayRP/0/RP0/CPU0:router(config-dhcpv4-relay-profile)# giaddr policy dropRelated Commands
helper-address
To configure the Dynamic Host Configuration Protocol (DHCP) IPv4 relay agent to relay BOOTREQUEST packets to a specific DHCP server, use the helper-address command in the DHCP IPv4 profile relay configuration submode. Use the no form of this command to clear the address. Up to eight helper addresses can be configured.
helper-address [vrf vrf name] address
no helper-address [vrf vrf name] address
Syntax Description
vrf vrf name
(Optional) Specifies a particular VRF.
address
IP address in four part, dotted decimal format.
Command Modes
DHCP IPv4 profile relay configuration
Command History
Release 3.7.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to set the helper-address for a VRF using the helper-address command:
RP/0/RP0/CPU0:router# configRP/0/RP0/CPU0:router(config)# dhcp ipv4RP/0/RP0/CPU0:router(config-dhcpv4)# profile client relayRRP/0/RP0/CPU0:router(config-dhcpv4-relay-profile)# helper-address vrf v1 10.10.10.1Related Commands
interface (DHCP)
To enable Dynamic Host Configuration Protocol (DHCP) for IPv6 on an interface, use the interface command in DHCP IPv6 configuration mode. To disable DHCPv6 on an interface, use the no form of the command.
interface interface-type interface-instance {server | relay}
Syntax Description
Defaults
No default behavior or values
Command Modes
DHCP IPv6 configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following is an example of enabling the DHCP interface mode on a Packet over Sonet/SDH (POS) interface using the interface command:
RP/0/RP0/CPU0:router(config)# dhcp ipv6RP/0/RP0/CPU0:router(config-dhcpv6)# interface POS 0/5/0/0 relayRelated Commands
Enables Dynamic Host Configuration Protocol (DHCP) for IPv6 and enters DHCP IPv6 configuration mode.
Displays DHCP for IPv6 interface information.
i
interface (relay profile)
To configure a relay profile on an interface, use the interface (relay profile) command in Dynamic Host Configuration Protocol (DHCP) IPv4 configuration mode. To disable this feature, use the no form of the command.
interface interface-type instance {none | relay}
no interface interface-type instance {none | relay}
Syntax Description
Command Modes
DHCP IPv4 configuration
Command History
Release 3.7.0
This command was introduced on the Cisco CRS-1 and Cisco XR 12000 Series Router.
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to configure a relay profile on an interface:
RP/0/RP0/CPU0:router# configRP/0/RP0/CPU0:router(config)# dhcp ipv4RP/0/RP0/CPU0:router(config-dhcpv4)# interface pos 0/1/4/1RP/0/RP0/CPU0:router(config-dhcpv4)# interface pos 0/1/4/1 relay profile clientRelated Commands