dhcp-options - options du protocole de configuration dynamique des hôtes (DHCP)

Le protocole DHCP (Dynamic Host Configuration Protocol) permet aux clients de recevoir des options de configuration réseau et des divers services réseaux depuis le serveur DHCP. Lors de la configuration de dhcpd(8) ou de dhclient(8), des options sont souvent requises. La syntaxe de ces options est documentée ici.

Les déclarations optionnelles de DHCP commencent toujours par le mot-clé option, suivi de son nom puis de ses données. Les noms des options et les formats des données sont décrits ci-dessous. Il n'est pas obligatoire de spécifier exhaustivement toutes les options DHCP - seules les options nécessaires des clients doivent être spécifiées.
Les données des options existent dans plusieurs formats, qui sont définis ci-dessous~:
Le type ip-address représente une adresse IP et peut être spécifié aussi bien sous forme numérique (par ex. 239.254.19.10) que sous forme de nom (par ex. haagen.isc.org). Lorsque vous entrez un nom, soyez sûr que celui-ci se résoudra en une unique adresse IP.
Le type int32 (resp. uint32) spécifie un entier signé (resp. non-signé) codé sur 32 bits. Le type int16 (resp. uint16) spécifie un entier signé (resp. non-signé) codé sur 16 bits. Le type int8 (resp. uint8) spécifie un entier signé (resp. non-signé) codé sur 8 bits. Les entiers non-signés de 8 bits sont souvent appelés octets.
Le type string spécifie une chaîne de caractère NVT ASCII, délimitée par des guillemets - par exemple pour spécifier une option de nom de domaine, la syntaxe sera

        option domain-name "isc.org";

Le type flag spécifie une valeur booléenne. Les booléens peuvent être true (vrai) ou false (faux) (ou on/off, si ça a plus de sens pour vous).
Le type data-string spécifie une chaîne de caractère NVT ASCII entre guillemets ou une série d'octets en notation hexadécimale, séparés par des deux-points. Par exemple :

        option dhcp-client-identifier "CLIENT-TOTO";
ou
        option dhcp-client-identifier 43:4c:49:45:54:2d:54:4f:54:4f;

La documentation pour les options diverses mentionnées ci-dessous est issue de la dernière ébauche de document sur les options DHCP de l'IETF (Internet Engineer Task Force). Les options qui ne sont pas mentionnées par nom peuvent être définies par le nom option-nnn, où nnn est le code décimal de l'option. Ces options peuvent être suivis soit par une chaîne de caractère entre guillemets, soit par une série d'octets en notation hexadécimale, séparés par des deux-points. Par exemple~:

        option option-133 "my-option-133-text";
        option option-129 1:54:c9:2b:47;

Comme dhcpd ne connaît pas le format de ces codes d'options indéfinies, il ne peut pas vérifier la correction des données entrées.
Les options standards sont~:
option subnet-mask ip-address;

L'option subnet-mask spécifie le masque de sous-réseau du client tel que défini dans la RFC 950 (RFC = Request For Comments). Si aucune option subnet-mask n'est fournie dans la portée du bloc, dhcpd utilisera en dernier recours le masque de la déclaration de sous-réseau auquel appartient l'adresse en cours d'attribution. Cependant, toute déclaration d'option subnet-mask remplacera le masque de sous-réseau spécifié dans la déclaration de sous-réseau.

option time-offset int32;

L'option time-offset spécifie le décalage en secondes pour le client de sous-réseau par rapport aux coordonnées de temps universelles (UTC : Universal Time Coordinates).

option routers ip-address [, ip-address... ];

L'option routers spécifie une liste d'adresses IP de routeurs qui sont sur le sous-réseau du client. Les routeurs doivent être mentionnés par ordre de préférence.

option time-servers ip-address [, ip-address... ];

L'option time-server spécifie une liste de serveurs de temps de type RFC 868 disponibles pour le client. Les serveurs doivent être spécifiés par ordre de préférence.

option ien116-name-servers ip-address [, ip-address... ];

L'option ien116-name-servers spécifie une liste des serveurs de nom de type IEN 116 disponibles pour le client. Les serveurs doivent être spécifiés par ordre de préférence.

option domain-name-servers ip-address [, ip-address... ];

L'option domain-name-servers spécifie une liste de serveurs de noms de de domaines (DNS : Domain Name System) (STD 13, RFC 1035) disponibles pour les clients. Les serveurs doivent être spécifiés par ordre de préférence.

option log-servers ip-address [, ip-address... ];

L'option log-server spécifie une liste de serveurs MIT-LCS UDP d'enregistrement des logs disponibles pour le client. Les serveurs doivent être spécifiés par ordre de préférence.

option cookie-servers ip-address [, ip-address... ];

L'option cookie-servers spécifie une liste de serveurs de cookies de type RFC 865 disponibles pour le client. Les serveurs doivent être spécifiés par ordre de préférence.

option lpr-servers ip-address [, ip-address... ];

l'options lpr-servers spécifie une liste de serveurs d'impression de type RFC 1179 disponibles pour le client. Les serveurs doivent être spécifiés par ordre de préférence.

option impress-servers ip-address [, ip-address... ];

L'option impress-servers spécifie une liste de serveur Imagen Impress disponibles pour le client. Les serveurs doivent être spécifiés par ordre de préférence.

option resource-location-servers ip-address [, ip-address... ];

L'option resource-location-servers spécifie une liste de serveurs de localisation de ressource disponibles pour le client. Les serveurs doivent être spécifiés par ordre de préférence.

option host-name string;

Cette option spécifie le nom du client. Le nom peut être entièrement qualifié avec le nom de domaine local, mais il est préférable d'utiliser l'option domain-name pour spécifier le nom de domaine. Voir la RFC 1035 pour les restrictions sur le jeu de caractères.

option boot-size uint16;

Cette option spécifie la longueur en blocs de 512 octets de l'image de démarrage par défaut du client.

option merit-dump string;

Cette option spécifie le nom complet du fichier (avec le chemin) dans lequel le « core » (image mémoire) du client doit être enregistré dans le cas où ce dernier planterait. Le chemin est une chaîne de caractères NVT ASCII.

option domain-name string;

Cette option spécifie, le nom de domaine que le client doit utiliser lorsqu'il résout des noms d'hôte via les serveurs de noms DNS

option swap-server ip-address;

Cette option spécifie l'adresse IP du serveur de swap (pagination sur disque) du client.

option root-path string;

Cette option spécifie le nom complet de fichier (avec le chemin) qui contient le disque racine du client (root disk). Le nom de fichier est une chaîne de caractères NVT ASCII.

option ip-forwarding flag;

Cette option spécifie si le client doit configurer sa couche IP pour la propagation de paquets. La valeur 1 (resp. 0) active (resp. désactive) l'IP forwarding.

option non-local-source-routing flag;

Cette option spécifie si un client doit configurer sa couche IP pour autoriser la propagation des datagrammes avec une route source non-locale (voir la section 3.3.5 de [4] pour une discussion de ce sujet). La valeur 1 (resp. 0) active (resp. désactive) la propagation de tels datagrammes.

option policy-filter ip-address ip-address [, ip-address ip-address... ];

Cette option spécifie la politique de filtrage pour les routes sources non-locales. Les filtres consistent en une liste d'adresses IP et de masques qui spécifie les paires destination/masque pour le filtrage des entrées en fonction de la route source.
Tout datagramme source routé dont le prochain saut d'adresse ne correspond à aucun filtre sera rejeté par le client.
Voir STD 3 (RFC1122) pour plus d'informations.

option max-dgram-reassembly uint16;

Cette option spécifie la taille maximale des datagrammes que le client doit se préparer à réassembler. La valeur minimale légale est 576.

option default-ip-ttl uint8;

L'option spécifie la valeur par défaut du TTL (Time-To-Live, temps à vivre) que le client doit utiliser pour les datagrammes en sortie.

option path-mtu-aging-timeout uint32;

Cette option spécifie la durée d'expiration (timeout) à utiliser quand on vieillit l'unité de transfert maximal d'un chemin (Path Maximum Transfert Unit) découverte par le mécanisme défini dans la RFC 1191.

option path-mtu-plateau-table uint16 [, uint16... ];

L'option spécifie un tableau de MTU (Maximal Transfert Unit, unité maximale de transfert) à essayer lors de l'opération de découverte des MTU des chemins telle que définie dans la RFC 1191. La table est une liste d'entier non-signés de 16 bits, ordonnés du plus petit au plus grand. La valeur minimale de MTU est 68.

option interface-mtu uint16;

L'option spécifie la MTU à utiliser pour cette interface. La valeur minimum légale est 68.

option all-subnets-local flag;

Cette option spécifie si le client peut supposer que tous les sous-réseaux du réseau IP auquel il est connecté utilisent la même MTU que celui auquel il est directement connecté. La valeur 1 indique que tous les sous-réseaux partagent la même MTU. La valeur 0 indique que le client doit supposer que certains sous-réseaux du réseau ont des MTU plus petites.

option broadcast-address ip-address;

Cette option spécifie l'adresse de diffusion à utiliser pour le sous-réseau du client. Les valeurs légale sont spécifiées dans la section 3.2.1.3 du STD 3 (RFC 1122).

option perform-mask-discovery flag;

Cette option spécifie si le client doit découvrir le masque de sous-réseau en utilisant le protocole ICMP. La valeur 1 (resp. 0) indique que le client doit (resp. ne doit pas) faire la découverte de masque.

option mask-supplier flag;

Cette option spécifie si le client doit répondre aux requêtes de masque de sous-réseau en utilisant ICMP. La valeur 1 (resp. 0) indique que le client doit (resp. ne doit pas) répondre.

option router-discovery flag;

Cette option spécifie si le client doit solliciter les routeurs en utilisant le mécanisme de découverte des routeurs défini dans la RFC 1256. La valeur 1 (resp. 0) indique que le client doit (resp. ne doit pas) faire une découverte des routeurs.

option router-solicitation-address ip-address;

Cette option spécifie l'adresse à laquelle le client doit transmettre ses requêtes de sollicitations de routeurs.

option static-routes ip-address ip-address [, ip-address ip-address... ];

Cette option spécifie une liste de routes statiques que le client doit installer dans son cache de routage. Si plusieurs routes menant à la même destination sont spécifiées, elles doivent être mentionnées dans l'ordre décroissant des priorités.
Les routes consistent en une liste de paires d'adresse IP. La première adresse IP est l'adresse de destination et la seconde est l'adresse du routeur pour cette destination.
La route par défaut (0.0.0.0) est une destination illégale pour une route statique. Pour spécifier une route par défaut, utilisez l'option routers.

option trailer-encapsulation flag;

Cette option spécifie si le client doit négocier l'utilisation de trailers (RFC 893 [14]) lors de l'utilisation du protocole ARP (Address Resolution Protocol). La valeur 1 (resp. 0) indique que le client doit (resp. ne doit pas) essayer d'utiliser les trailers.

option arp-cache-timeout uint32;

Cette option spécifie la durée d'expiration en secondes des entrées dans le cache ARP.

option ieee802-3-encapsulation flag;

Cette option spécifie si le client doit utiliser l'encapsulation Ethernet Version 2 (RFC 894) ou IEEE 802.3 (RFC 1042) si son interface est de type Ehernet. La valeur 0 (resp. 1) indique que le client doit utiliser l'encapsulation RFC 894 (resp. 1042).

option default-tcp-ttl uint8;

Cette option spécifie la valeur par défaut pour le TTL (time-to-live) qu'un client doit utiliser lorsqu'il envoie des paquets TCP. La valeur minimale est 1.

option tcp-keepalive-interval uint32;

Cette option spécifie l'intervalle (en secondes) que le client TCP doit attendre avant d'envoyer un message « keepalive » sur une connexion TCP. Le temps est spécifié sous forme d'un entier non-signé de 32 bits. La valeur 0 indique que le client ne doit pas générer de message keepalive sur les connexions à moins que ce ne soit spécifiquement demandé par une application.

option tcp-keepalive-garbage flag;

Cette option spécifie si le client doit envoyer des messages TCP keepalive avec un octet de bourrage pour la compatibilité avec les vieilles implémentations. La valeur 1 (resp. 0) indique que l'octet de bourrage doit (resp. ne doit pas) être envoyé.

option nis-domain string;

Cette option spécifie le nom du domaine NIS (Sun Network Information Services) du client. Le domaine est une chaîne de caractères NVT ASCII.

option nis-servers ip-address [, ip-address... ];

Cette option spécifie une liste d'adresse IP de serveur NIS disponibles pour le client. Les serveurs doivent être mentionnés par ordre de préférence.

option ntp-servers ip-address [, ip-address... ];

Cette option spécifie une liste de d'adresse IP de serveurs NTP (RFC 1035) disponibles pour le client. Les serveurs doivent être mentionnés par ordre de préférence.

option netbios-name-servers ip-address [, ip-address... ];

L'option netbios-name-servers spécifie une liste de serveurs NetBIOS (NBNS : NetBIOS Name System) RFC 1001/1002 mentionnés par ordre préférence. Le service de nom NetBIOS est aussi communément appelé WINS. Les serveurs WINS peuvent être spécifiés en utilisant l'option netbios-name-servers.

option netbios-dd-server ip-address [, ip-address... ];

L'option netbios-dd-server spécifie une liste de serveur de distribution de datagramme NetBIOS (NBDD~: NetBIOS Datagram Distribution) RFC 1001/1002. Les serveurs doivent être mentionnés par ordre de préférence.

option netbios-node-type uint8;

L'option netbios-node-type autorise la configuration des clients NetBIOS sur TCP/IP comme décrit dans la RFC 1001/1002. La valeur est spécifiée sous forme d'un unique octet qui identifie le type de client.
Les type possibles de noeuds sont :

1

B-node: Broadcast - no WINS (diffusion - pas WINS)

2

P-node: Peer - WINS only (point-à-point - WINS seulement)

4

M-node: Mixed - broadcast, then WINS (mélangé - diffusion puis WINS)

8

H-node: Hybrid - WINS, then broadcast (hybride - WINS, puis diffusion)

option netbios-scope string;

L'option netbios-scope spécifie la portée des paramètres de NetBIOS sur TCP/IP pour les clients, comme indiquée dans la RFC 1001/1002. Voir la RFC1001, la RFC1002, et la RFC1035 pour les limitations du jeu de caractères.

option font-servers ip-address [, ip-address... ];

Cette option spécifie une liste de serveurs de polices X Window disponibles pour les clients. Les serveurs doivent être mentionnés par ordre de préférence.

option x-display-manager ip-address [, ip-address... ];

Cette option spécifie une liste de systèmes qui sont en train de faire fonctionner un gestionnaire de fenêtre X Window et qui sont disponibles pour le client. Les adresses doivent être spécifiées par ordre de préférence.

option dhcp-client-identifier data-string;

Cette option peut être utilisée pour spécifier l'identifiant DHCP du client dans une déclaration d'hôte, de telle sorte que dhcpd puisse trouver l'enregistrement d'hôte en le mettant en correspondance avec l'identifiant du client.

option nisplus-domain string;

Cette option spécifie le nom de domaine NIS+ du client. Le domaine est une chaîne de caractères NVT ASCII.

option nisplus-servers ip-address [, ip-address... ];

Cette option spécifie une liste d'adresse IP de serveurs NIS+ disponibles pour le client. Les serveurs doivent être mentionnés par ordre de préférence.

option tftp-server-name string;

Cette option est utilisée pour identifier un serveur TFTP et, si le client supporte cette option, elle devrait avoir le même effet que la déclaration server-name. Les clients BOOTP ne supportent probablement pas cette option. Certains clients DHCP la supporteront, et d'autres la voudront obligatoirement.

option bootfile-name string;

Cette option est utilisée pour identifier le fichier de démarrage. Si le client supporte cette option, elle devrait avoir le même effet que la déclaration filename. Les clients BOOTP ne supportent probablement pas cette option. Certains clients DHCP la supporteront, et d'autres la voudront obligatoirement.

option mobile-ip-home-agent ip-address [, ip-address... ];

Cette option spécifie une liste d'adresse IP d'agents mobiles. Les agents doivent être mentionnés par ordre de préférence, bien que normalement il n'y en aura qu'un seul.

option smtp-server ip-address [, ip-address... ];

Cette option spécifie une liste d'adresse de serveur SMTP disponibles pour le client. Les serveurs doivent être mentionnés par ordre de préférence.

option pop-server ip-address [, ip-address... ];

Cette option spécifie une liste de serveurs POP3 disponibles pour le client. Les serveurs doivent être mentionné par ordre de préférence.

option nntp-server ip-address [, ip-address... ];

Cette option spécifie une liste de serveurs NNTP disponibles pour le client. Les serveurs doivent être mentionné par ordre de préférence.

option www-server ip-address [, ip-address... ];

Cette option spécifie une liste de serveurs WWW (World Wide Web i.e. HTTP) disponibles pour le client. Les serveurs doivent être mentionnés par ordre de préférence.

option finger-server ip-address [, ip-address... ];

Cette option spécifie une liste de serveurs Finger disponibles pour le client. Les serveurs doivent être mentionnés par ordre de préférence.

option irc-server ip-address [, ip-address... ];

Cette option spécifie une liste de serveurs IRC disponibles pour le client. Les serveurs doivent être mentionnés par ordre de préférence.

option streettalk-server ip-address [, ip-address... ];

Cette option spécifie une liste de serveurs StreetTalk disponibles pour le client. Les serveurs doivent être mentionnés par ordre de préférence.

option streetalk-directory-assistance-server ip-address [, ip-address... ];

Cette option spécifie une liste de serveurs StreetTalk Directory Assistance (STDA) disponibles pour le client. Les serveurs doivent être mentionnés par ordre de préférence.

dhcpd.conf(5), dhcpd.leases(5), dhclient.conf(5), dhcpd(8), dhclient(8), RFC2132, RFC2131.

dhcpd(8) a été écrit par Ted Lemon <mellon@vix.com> dans le cadre d'un contrat avec Vixie Labs. Le financement de ce projet a été pris en charge par l'Internet Software Corporation. Pour en savoir plus sur l'Internet Software Consortium, rendez-vous sur http://www.isc.org/isc.

Sébastien Blanchet, 2001