BOOTPTAB(5) Formats de fichiers de FreeBSD
bootptab - Base de données du serveur Internet Bootstrap Protocol (bootp)
Le fichier bootptab est la base de données de configuration de bootpd(8), le serveur du protocol de démarrage par internet. Son format est similaire à celui de termcap(5) où deux lettres (majuscule et minuscule sont différentes) sont utilisées pour représenter les paramètres de l'hôte. Les déclarations sont séparées par deux points (:) et sont généralement de la forme :
nom_de_l_hôte:sb=valeur... :sb= valeur... :sb= valeur...
Le nom_de_l_hôte est celui du client bootp (ou un nom non significatif) et sb le symbole de deux caractères. Les entrées fictives ne sont pas des vrais noms d'hôtes (une commençant par un point, par exemple) et sont utilisées pour fournir les valeurs par défaut des autres entrées en utilisant tc=.fictif. La plupart des symboles doivent être suivis du signe égal et d'une valeur, comme ci-dessus, et d'autres sous la forme d'un bouléeen sans valeur (par exemple :sb:). Les symboles actuellement reconnus sont :
bf Fichier de démarrage
bs Taille de ce fichier en blocs de 512 octets
cs Liste d'adresses de serveurs de cookies
df Merit dump file
dn Nom de domaine
ds Liste d'adresses de serveurs de noms de domaines
ef Fichier d'extension
gw Liste d'adresses de passerelles
ha Adresse physique de l'hôte
hd Répertoire personnel du fichier de démarrage
hn Envoie le nom du client au client
ht Type de matériel de l'hôte (voir la doc des Numéros assignés)
im Liste d'adresses de serveurs d'impression
ip Adresse IP de l'hôte
lg Liste d'adresses de serveurs d'enregistrements (Log)
lp Liste d'adresses de serveurs LPR
ns Liste d'adresses de serveurs de noms IEN-116
nt Serveur NTP (heure) (RFC 1129)
ra Nouvelle adresse de réponse
rl Liste d'adresses de serveurs de protocole de localisation de ressources
rp Chemin d'accès de root pour le montage
sa Adresse du serveur TFTP que le client doit utiliser
sm Masque sous réseau de l'hôte
sw Adresse du serveur de mémoire virtuelle (Swap)
tc Suite de table (même format que les entrées de l'hôte)
td Répertoire root TFTP utilisé par les serveurs TFPT sécurisés
to Décalage horaire en secondes par rapport à UTC
ts Liste d'adresses de serveurs d'heure
vm Sélecteur de cookie magique du revendeur
yd Nom de domaine YP (NIS)
ys Adresse du serveur YP (NIS)
Il existe aussi un symbole générique Tn, où n est un numéro RFC1084 de revendeur. Il est ainsi possible d'immédiatement tirer avantage de futures extensions de RFC1084 sans être obligé de modifier bootpd. Les données génériques peuvent être représentées soit par une vague de nombres hexadécimaux soit par une suite de chaine cotées de caractère ASCII. La taille est automatiquement déterminée et insérée dans le champ idoine de la réponse bootp aux normes RFC1084.
Les symboles cs, ds, gw, im, lg, lp, ns, nt, ra, rl et ts sont suivis d'une liste d'adresses IP séparées par un blanc. Les symboles ip, sa, sw, sm et ys ne sont suivis que d'une seule adresse IP. Toutes les adresses IP sont écrites dans leur notation standard sur internet (avec des "points") en décimal, octal (en commençant par un 0) ou hexadécimal (en commençant par "0x" ou "0X"). Elles peuvent aussi être remplacées par le nom de machine associé, dans ce cas bootpd recherche l'adresse IP en utilisant gethostbyname(3). Si le symbole ip n'est pas spécifié, bootpd trouve l'adresse en utilisant l'entrée nom comme nom d'hôte. (les noms non-sygnificatifs sont invalides pour éviter des recherche IP automatiques).
Le symbole ht indique le code type du matériel soit sous forme d'un entier non-signé décimal, octal ou hexadécimal soit sous un des noms : ethernet ou ether pour l'Ethernet 10 Mo, ethernet3 ou ether3 pour l'Ethernet expérimental 3 Mo, ieee802, tr ou token-ring pour les réseaux IEEE 802, pronet pour Token Ring Proteon ProNET et chaos, arcnet ou ax.25 pour les réseaux radio amateur Chaos, ARCNET et AX.25. Le symbole ha prend une adresse matérielle qui doit être spécifiée sous forme d'un nom d'hôte ou sous forme numérique. Cette dernière doit être obligatoirement en hexadécimal et les points et le "0x" au début sont optionnels mais facilitent la lecture. Le symbole ha doit être précédé par ht (soit explicitement, soit implicitement, voir tc plus loin). Si l'adresse matérielle n'est pas spécifiée et que le type est soit " ethernet" soit "ieee802", bootpd essaie de la déterminer avec ether_hostton(3).
Le nom d'hôte, répertoire personnel et fichier de démarrage sont des chaines ASCII optionnellement mises entre guillemets (""). La requète client et les valeurs de hd et bf déterminent la façon dont le serveur remplit le champ "fichier de démarrage" dans sa réponse.
Si le client fournit un nom de fichier, il est utilisé. Sinon, si l'option bf est spécifiée, sa valeur est retournée dans la réponse. Si l'option hd est aussi spécifiée, sa valeur prend le pas sur celle copiée dans la réponse. L'existance de ce fichier n'est vérifiée que si bs=auto est demandé (pour avoir la taille du fichier). Une réponse peut-être envoyée, que le fichier existe ou non.
Certaines récentes versions de tftpd(8) ont une sécurité qui permet de changer le répertoire racine en utilisant l'appel système chroot(2). Le symbole td peut être utilisé pour informer bootpd de ce répertoire spécial utilisé par tftpd (il est aussi possible d'utiliser bootpd -c rep). Le symbole hd est donné par rapport au répertoire racine de td. Par exemple, si le chemin absolu du répertoire personnel du client bootp est /tftpboot/bootfiles/bootimage et que tftpd utilise /tftpdboot comme répertoire "sécurisé", alors inscrivez ceci dans bootptab :
:td=/tftpboot:hd=/bootfiles:bf=bootimage:
Si vos fichiers de démarrage sont dans /tftpboot, utilisez :
:td=/tftpboot:hd=/:bf=bootimage:
L'option sa peut être utilisée pour indiquer l'adresse IP d'un serveur TFTP particulier que le client doit utiliser. Sans lui, bootpd dit au client d'utiliser TFTP sur la même machine que celle qui fait tourner bootpd.
Le décalage horaire to est soit un entier décimal signé déterminant le fuseau en secondes par rapport à UTC soit le mot auto qui détermine le même fuseau que celui du serveur. Donner une valeur bouléenne à to a le même effet qu'indiquer auto.
La taille bs du fichier de démarrage est un entier décimal, octal ou hexadécimal donnant le nombre de blocs de 512 octets ou bien le mot auto qui demande au serveur de calculer cette taille à chaque requète. Comme pour le fuseau horaire, donner une valeur bouléenne équivaut à auto.
Le sélecteur de cookie magique du revendeur (option vm) prend une des valeurs suivantes : auto (indique que les informations sont déterminées à partir de la requète du client), rfc1048 ou rfc1084 (qui force une réponse conforme à RFC1084) ou cmu ( qui force une réponse conforme à CMU).
L'option hn est strictement un bouléen, elle ne prend pas le signe égal suivi d'une valeur. Sa présence indique que le nom d'hôte doit être envoyé aux clients RFC1084. Bootpd envoie ce nom tel qu'il est défini dans le fichier de configuration. S'il est trop long, il est coupé à juste le nom d'hôte (jusqu'au premier point s'il y en a un) et retesté. Si ça ne marche toujours pas, il est coupé arbitrairement (si rien ne correspond, rien n'est envoyé).
Certaines options ont souvent les mêmes valeurs (comme le serveur de noms par exemple). Plutôt que de les répèter à chaque fois, une spécification complète peut être établie pour un hôte et partagée avec les autres grâce à l'option tc (table continuation : suite de la table). La façon de faire la plus courrante est de déclarer un hôte fictif, comme dans l'option tc de termcap(5). Notez que bootpd permet à tc d'apparaitre n'importe où dans les données de l'hôte contrairement à termcap qui impose qu'il soit le dernier. Les informations spécifiques à un hôte remplacent celles de tc indépendament de sa position sur la ligne. La valeur de l'option tc peut être le nom d'hôte ou l'adresse IP de n'importe quelle entrée précédament listée dans le fichier de configuration.
Il est parfois nécessaire d'effacer une certaine option après qu'elle ait été déduite par tc. Cela peut être fait en utilisant le symbole tag@ qui supprime l'effet de tag comme avec termcap(5). Par exemple, pour annuler complètement un serveur de nom IEN-116, utilisez :ns@: à la bonne place dans la ligne de configuration. Une fois effacé par @, une option peut de nouveau être paramètrée par le mécanisme tc.
Les lignes blanches et celles qui commencent par "#", dans le fichier de configuration, sont ignorées. Chaque entrée d'un hôte est séparée de la suivante par un saut de ligne mais peut aussi s'étendre sur plusieurs lignes si celles-ci se finissent par un anti-slash "\". Il est aussi possible que les lignes dépassent 80 caratères. Les options peuvent apparaitre dans n'importe quel ordre avec les exceptions suivantes : le nom d'hôte doit être la toute première information et le type de matériel doit précéder l'adresse matérielle.
Voici un exemple de fichier /etc/bootptab :
# Extrait de fichier bootptab (domaine=andrew.cmu.edu)
.defaut:\:hd=/usr/boot:bf=null:\ :ds=netserveur, lentine:\ :ns=pcs2, pcs1:\ :ts=pcs2, pcs1:\ :sm=255.255.255.0:\ :gw=gw.cs.cmu.edu:\ :hn:to=-18000:
calicelle:ht=6:ha=7FF8100000AF:tc=.defaut: fistuline:ht=1:ha=0800200159C3:tc=.defaut: amadouvier:ht=1:ha=00DD00CADF00:tc=.defaut: armilaire:ht=1:ha=0800200102AD:tc=.defaut: edulis:ht=1:ha=08002B02A2F9:tc=.defaut: paxille:ht=1:ha=08002B0287C8:tc=.defaut:
# Serveur de noms de domaines spécial et options # pour les hôtes suivantsgolmote:ha=08002001560D:ds=128.2.13.42:\:T37=0x12345927AD3BCF:\ :T99="Special ASCII string":\ :tc=.defaut:
pholiote:ht=6:ha=7FFF81000A47:tc=.defaut: collybie:ht=6:ha=7FFF81000434:tc=.defaut: inocybe:ht=6:ha=7FFF810001BA:tc=.defaut: clathre:ht=1:ha=00DD00CAF000:tc=.defaut: clavaire:ht=1:ha=00DD00FE1600:tc=.defaut:
/etc/bootptab
DARPA Internet Request For Comments RFC951, RFC1048, RFC1084, Assigned Numbers
Carnegie Mellon University, 31 octobre 1991
Version française par Guillain Seuillot <Guillain@lycosmail.com> le 06 juin 2000