Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation

use-interface-description

Syntax

use-interface-description (logical | device);

Hierarchy Level

[edit forwarding-options dhcp-relay dhcpv6 relay-agent-interface-id],[edit forwarding-options dhcp-relay dhcpv6 group group-name relay-agent-interface-id],[edit forwarding-options dhcp-relay relay-option-82 circuit-id],[edit forwarding-options dhcp-relay group group-name relay-option-82 circuit-id],[edit logical-systems logical-system-name forwarding-options dhcp-relay dhcpv6 relay-agent-interface-id],[edit logical-systems logical-system-name forwarding-options dhcp-relay dhcpv6 group group-name relay-agent-interface-id],[edit logical-systems logical-system-name forwarding-options dhcp-relay relay-option-82 circuit-id],[edit logical-systems logical-system-name forwarding-options dhcp-relay group group-name relay-option-82 circuit-id],[edit logical-systems logical-system-name routing-instances routing-instance-name forwarding-options dhcp-relay dhcpv6 relay-agent-interface-id],[edit logical-systems logical-system-name routing-instances routing-instance-name forwarding-options dhcp-relay dhcpv6 group group-name relay-agent-interface-id],[edit logical-systems logical-system-name routing-instances routing-instance-name forwarding-options dhcp-relay relay-option-82 circuit-id],[edit logical-systems logical-system-name routing-instances routing-instance-name forwarding-options dhcp-relay group group-name relay-option-82 circuit-id],[edit routing-instances routing-instance-name forwarding-options dhcp-relay dhcpv6 relay-agent-interface-id],[edit routing-instances routing-instance-name forwarding-options dhcp-relay dhcpv6 group group-name relay-agent-interface-id],[edit routing-instances routing-instance-name forwarding-options dhcp-relay relay-option-82 circuit-id],[edit routing-instances routing-instance-name forwarding-options dhcp-relay group group-name relay-option-82 circuit-id]

Release Information

Statement introduced in Junos OS Release 9.6.

Support at the [edit ... dhcpv6] hierarchy levels introduced in Junos OS Release 11.4.

Statement introduced in Junos OS Release 12.3 for EX Series switches.

Description

Use the textual interface description instead of the interface identifier when creating the agent-circuit-id suboption of the DHCP relay agent option 82. Use the statement at the [edit ... dhcpv6] hierarchy levels to configure DHCPv6 support.

If you specify that the textual description is used and no description is configured for the interface, DHCP relay defaults to using the interface identifier. The textual description is configured using the description statement at the [edit interfaces interface-name] hierarchy level.

Note: By default, DHCP relay accepts a maximum of 253 ASCII characters. If the textual interface description is longer than 253 characters, DHCP relay drops the packet, which results in the DHCP client failing to bind.

Options

logical—Use the textual description that is configured for the logical interface.

device—Use the textual description that is configured for the device interface.

Required Privilege Level

interface—To view this statement in the configuration.

interface-control—To add this statement to the configuration.

Published: 2013-07-05