DHCP

DHCP (Dynamic Host Configuration Protocol) is a network management protocol used to automatically assign IP addresses, subnet masks, gateways, DNS servers, and other network configuration parameters to devices on a network. Beyond basic IP allocation, DHCP services include relay functionality to forward DHCP requests across network segments, snooping capabilities to monitor and validate DHCP transactions for security purposes, and option 82 support for enhanced network visibility and control. These features enable centralized IP address management, prevent rogue DHCP servers, and provide detailed tracking of device network access patterns.

Diagram

Diagram

Classes

configuration (iosxe.devices)

Name	Type	Constraint	Mandatory	Default Value
dhcp	Class	[dhcp]	No

dhcp (iosxe.devices.configuration)

Name	Type	Constraint	Mandatory	Default Value
compatibility_suboption_link_selection	Choice	cisco, standard	No
compatibility_suboption_server_override	Choice	cisco, standard	No
relay_information_trust_all	Boolean	true, false	No
relay_information_option_default	Boolean	true, false	No
relay_information_option_vpn	Boolean	true, false	No
relay_bootp_ignore	Boolean	true, false	No
snooping	Boolean	true, false	No
snooping_information_option	Boolean	true, false	No
snooping_information_option_allow_untrusted	Boolean	true, false	No
snooping_information_option_format_remote_id_hostname	Boolean	true, false	No
snooping_information_option_format_remote_id_string	String		No
snooping_vlans	Class	[snooping_vlans]	No

dhcp (iosxe.devices.configuration)

Name	Type	Constraint	Mandatory	Default Value
compatibility_suboption_link_selection	Choice	cisco, standard	No
compatibility_suboption_server_override	Choice	cisco, standard	No
relay_information_trust_all	Boolean	true, false	No
relay_information_option_default	Boolean	true, false	No
relay_information_option_vpn	Boolean	true, false	No
snooping	Boolean	true, false	No
snooping_information_option	Boolean	true, false	No
snooping_information_option_allow_untrusted	Boolean	true, false	No
snooping_information_option_format_remote_id_hostname	Boolean	true, false	No
snooping_information_option_format_remote_id_string	String		No
snooping_vlans	Class	[snooping_vlans]	No

snooping_vlans (iosxe.devices.configuration.dhcp)

Name	Type	Constraint	Mandatory	Default Value
ids	List	Integer[min: 1, max: 4094]	No
ranges	List	[ranges]	No

ranges (iosxe.devices.configuration.dhcp.snooping_vlans)

Name	Type	Constraint	Mandatory	Default Value
from	Integer	min: 1, max: 4094	Yes
to	Integer	min: 1, max: 4094	Yes

Examples

iosxe:
  devices:
    - name: Device1
      configuration:
        dhcp:
          compatibility_suboption_link_selection: cisco
          compatibility_suboption_server_override: standard
          relay_information_trust_all: true
          relay_information_option_default: true
          relay_information_option_vpn: true
          relay_bootp_ignore: true
          snooping: true
          snooping_information_option: true
          snooping_information_option_allow_untrusted: true
          snooping_information_option_format_remote_id_hostname: true
          snooping_information_option_format_remote_id_string: "custom-remote-id"
          snooping_vlans:
            ids: [10, 20, 100]
            ranges:
              - from: 200
                to: 210

Examples

iosxe:
  devices:
    - name: Device1
      configuration:
        dhcp:
          compatibility_suboption_link_selection: cisco
          compatibility_suboption_server_override: standard
          relay_information_trust_all: true
          relay_information_option_default: true
          relay_information_option_vpn: true
          snooping: true
          snooping_information_option: true
          snooping_information_option_allow_untrusted: true
          snooping_information_option_format_remote_id_hostname: true
          snooping_information_option_format_remote_id_string: "custom-remote-id"
          snooping_vlans:
            ids: [10, 20, 100]
            ranges:
              - from: 200
                to: 210