Annotation of embedaddon/dnsmasq/man/fr/dnsmasq.8, revision 1.1
1.1 ! misho 1: .TH DNSMASQ 8
! 2: .SH NAME
! 3: Dnsmasq \- Un serveur DHCP et cache DNS poids-plume.
! 4: .SH SYNOPSIS
! 5: .B dnsmasq
! 6: .I [OPTION]...
! 7: .SH "DESCRIPTION"
! 8: .BR dnsmasq
! 9: est un serveur à faible empreinte mémoire faisant DNS, TFTP, PXE, annonces de
! 10: routeurs et DHCP. Il offre à la fois les services DNS et DHCP pour un réseau
! 11: local (LAN).
! 12: .PP
! 13: Dnsmasq accepte les requêtes DNS et y réponds soit en utilisant un petit cache
! 14: local, soit en effectuant une requête à un serveur DNS récursif externe (par
! 15: exemple celui de votre fournisseur d'accès internet). Il charge le contenu du
! 16: fichier /etc/hosts afin que les noms locaux n'apparaissant pas dans les DNS
! 17: globaux soient tout de même résolus, et assure également la résolution de nom
! 18: pour les hôtes présents dans le service DHCP. Il peut aussi agir en temps que
! 19: serveur DNS faisant autorité pour un ou plusieurs domaines, permettant à des
! 20: noms locaux d'apparaitre dans le DNS global.
! 21: .PP
! 22: Le serveur DHCP Dnsmasq DHCP supporte les définitions d'adresses statiques et les
! 23: réseaux multiples. Il fournit par défaut un jeu raisonnable de paramètres DHCP,
! 24: et peut être configuré pour fournir n'importe quelle option DHCP.
! 25: Il inclut un serveur TFTP sécurisé en lecture seule permettant le démarrage via
! 26: le réseau/PXE de clients DHCP et supporte également le protocole BOOTP. Le
! 27: support PXE est complet, et comprend un mode proxy permettant de fournir des
! 28: informations PXE aux clients alors que l'allocation DHCP est effectuée par un
! 29: autre serveur.
! 30: .PP
! 31: Le serveur DHCPv6 de dnsmasq possède non seulement les mêmes fonctionalités
! 32: que le serveur DHCPv4, mais aussi le support des annonces de routeurs ainsi
! 33: qu'une fonctionalité permettant l'addition de ressources AAAA pour des
! 34: clients utilisant DHCPv4 et la configuration IPv6 sans état (stateless
! 35: autoconfiguration).
! 36: Il inclut le support d'allocations d'adresses (à la fois en DHCPv6 et en
! 37: annonces de routeurs - RA) pour des sous-réseaux dynamiquement délégués via
! 38: une délégation de préfixe DHCPv6.
! 39: .PP
! 40: Dnsmasq est developpé pour de petits systèmes embarqués. It tends à avoir
! 41: l'empreinte mémoire la plus faible possible pour les fonctions supportées,
! 42: et permet d'exclure les fonctions inutiles du binaire compilé.
! 43: .SH OPTIONS
! 44: Notes : Il est possible d'utiliser des options sans leur donner de paramètre.
! 45: Dans ce cas, la fonction correspondante sera désactivée. Par exemple
! 46: .B --pid-file=
! 47: (sans paramètre après le =) désactive l'écriture du fichier PID.
! 48: Sur BSD, à moins que le logiciel ne soit compilé avec la bibliothèque GNU
! 49: getopt, la forme longue des options ne fonctionne pas en ligne de commande; Elle
! 50: est toujours supportée dans le fichier de configuration.
! 51: .TP
! 52: .B --test
! 53: Vérifie la syntaxe du ou des fichiers de configurations. Se termine avec le
! 54: code de retour 0 si tout est OK, ou un code différent de 0 dans le cas
! 55: contraire. Ne démarre pas Dnsmasq.
! 56: .TP
! 57: .B \-h, --no-hosts
! 58: Ne pas charger les noms du fichier /etc/hosts.
! 59: .TP
! 60: .B \-H, --addn-hosts=<fichier>
! 61: Fichiers d'hôtes additionnels. Lire le fichier spécifié en plus de /etc/hosts.
! 62: Si
! 63: .B -h
! 64: est spécifié, lire uniquement le fichier spécifié. Cette option peut être
! 65: répétée afin d'ajouter d'autres fichiers. Si un répertoire est donné, lis les
! 66: fichiers contenus dans ce répertoire.
! 67: .TP
! 68: .B \-E, --expand-hosts
! 69: Ajoute le nom de domaine aux noms simples (ne contenant pas de point dans le
! 70: nom) contenus dans le fichier /etc/hosts, de la même façon que pour le service
! 71: DHCP. Notez que cela ne s'applique pas au nom de domaine dans les CNAME, les
! 72: enregistrements PTR, TXT, etc...
! 73: .TP
! 74: .B \-T, --local-ttl=<durée>
! 75: Lorsque Dnsmasq répond avec une information provenant du fichier /etc/hosts ou
! 76: avec un bail DHCP, il donne un temps de vie (time-to-live) positionné à zéro,
! 77: afin d'indiquer à la machine faisant la requête que celle-ci ne doit pas être
! 78: mise dans un cache. Ceci est le comportement correct dans presque toutes les
! 79: situations.
! 80: Cette option permet de spécifier la valeur de time-to-live à retourner (en
! 81: secondes). Cela permet de réduire la charge sur le serveur, mais les clients
! 82: risquent d'utiliser des données périmées dans certains cas.
! 83: .TP
! 84: .B --neg-ttl=<durée>
! 85: Les réponses négatives provenant des serveurs amonts contiennent normalement
! 86: une information de durée de vie (time-to-live) dans les enregistrements SOA,
! 87: information dont dnsmasq se sert pour mettre la réponse en cache. Si la réponse
! 88: du serveur amont omet cette information, dnsmasq ne cache pas la réponse. Cette
! 89: option permet de doner une valeur de durée de vie par défaut (en secondes) que
! 90: dnsmasq utilise pour mettre les réponses négatives dans son cache, même en
! 91: l'absence d'enregistrement SOA.
! 92: .TP
! 93: .B --max-ttl=<durée>
! 94: Définie la valeur de TTL maximum qui sera fournie aux clients. La valeur maximum
! 95: de TTL spécifiée sera fournie aux clients en remplacement de la vraie valeur de
! 96: TTL si cette dernière est supérieure. La valeur réelle de TTL est cependant
! 97: conservée dans le cache afin d'éviter de saturer les serveurs DNS en amont.
! 98: .TP
! 99: .B --max-cache-ttl=<durée>
! 100: Définie la valeur de TTL maximum pour les entrées dans le cache
! 101: .TP
! 102: .B --auth-ttl=<durée>
! 103: Définie la valeur de TTL retournée pour les réponses du serveur faisant
! 104: autorité.
! 105: .TP
! 106: .B \-k, --keep-in-foreground
! 107: Ne pas aller en tâche de fond au lancement, mais en dehors de cela, fonctionner
! 108: normalement. Ce mode est prévu pour les cas où Dnsmasq est lancé par daemontools
! 109: ou launchd.
! 110: .TP
! 111: .B \-d, --no-daemon
! 112: Mode debug (déverminage) : ne pas aller en tâche de fond, ne pas écrire de
! 113: fichier pid, ne pas changer d'identifiant utilisateur, générer un état complet
! 114: du cache lors de la réception d'un signal SIGUSR1, envoyer les logs sur la
! 115: sortie standard d'erreur ("stderr") de même que dans le syslog, ne pas créer de
! 116: processus fils pour traiter les requêtes TCP. A noter que cette option est à
! 117: user pour du déverminage seulement : pour empêcher dnsmasq se fonctionner en
! 118: mode démon en production, utiliser
! 119: .B -k.
! 120: .TP
! 121: .B \-q, --log-queries
! 122: Enregistrer les résultats des requêtes DNS traitées par Dnsmasq dans un fichier
! 123: de traces ("logs"). Active la génération d'un état complet du cache lors de la
! 124: réception d'un signal SIGUSR1.
! 125: .TP
! 126: .B \-8, --log-facility=<facility>
! 127: Définit la "facility" dans laquelle Dnsmasq enverra ses entrées syslog, par
! 128: défaut DAEMON ou LOCAL0 si le mode debug est activé. Si la "facility" contient
! 129: au moins un caractère "/", alors Dnsmasq considère qu'il s'agit d'un fichier et
! 130: enverra les logs dans le fichier correspondant à la place du syslog. Si la
! 131: "facility" est '-', alors dnsmasq envoie les logs sur la sortie d'erreur
! 132: standard stderr. (Les erreurs lors de la lecture de la configuration vont
! 133: toujours vers le syslog, mais tous les messages postérieurs à un démarrage
! 134: réussi seront exclusivement envoyés vers le fichier de logs).
! 135: Lorsque Dnsmasq est configuré pour envoyer
! 136: ses traces vers un fichier, la réception d'un signal SIGUSR2 entraine la
! 137: fermeture et réouverture du fichier. Cela permet la rotation de fichiers de
! 138: traces sans nécessiter l'arrêt de Dnsmasq.
! 139: .TP
! 140: .B --log-async[=<lignes>]
! 141: Permet l'envoi de traces de manière asynchrone, et de manière optionnelle, le
! 142: nombre de lignes devant être mises dans la file d'attente par Dnsmasq lorsque
! 143: l'écriture vers le syslog est lente.
! 144: Dnsmasq peut envoyer ses logs de manière asynchrone : cela lui permet de
! 145: continuer à fonctionner sans être bloqué par le syslog, et permet à syslog
! 146: d'utiliser Dnsmasq pour les résolutions DNS sans risque d'interblocage.
! 147: Si la file d'attente devient pleine, Dnsmasq loggera le dépassement de file et
! 148: le nombre de messages perdus. La longueur par défaut de la file d'attente est de
! 149: 5 et une valeur saine sera comprise entre 5 et 25, avec une limite maximum
! 150: imposée de 100.
! 151: .TP
! 152: .B \-x, --pid-file=<chemin>
! 153: Spécifie un fichier dans lequel stocker le numéro de processus (pid). La valeur
! 154: par défaut est /var/run/dnsmasq.pid.
! 155: .TP
! 156: .B \-u, --user=<nom d'utilisateur>
! 157: Spécifie l'identité (nom d'utilisateur) prise par Dnsmasq après le démarrage.
! 158: Dnsmasq doit normalement être démarré en temps que root ("super-utilisateur"),
! 159: mais abandonne ses privilèges après le démarrage en changeant d'identité.
! 160: Normalement cet utilisateur est l'utilisateur nobody ("personne"), mais il est
! 161: possible d'en définir un autre par le biais de ce paramètre.
! 162: .TP
! 163: .B \-g, --group=<nom de groupe>
! 164: Spécifie le groupe sous lequel Dnsmasq s'exécute. Par défaut, il s'agit du
! 165: groupe "dip", afin de faciliter l'accès au fichier /etc/ppp/resolv.conf qui
! 166: n'est en général pas en lecture par tout le monde.
! 167: .TP
! 168: .B \-v, --version
! 169: Imprime le numéro de version.
! 170: .TP
! 171: .B \-p, --port=<port>
! 172: Ecoute sur le port numéro <port> au lieu du port DNS standard (53). Paramétrer
! 173: cette valeur à zéro désactive complètement la fonction DNS pour ne laisser actif
! 174: que le DHCP ou le TFTP.
! 175: .TP
! 176: .B \-P, --edns-packet-max=<taille>
! 177: Spécifie la taille maximum de paquet UDP EDNS.0 supporté par le relai DNS. Le
! 178: défaut est de 4096, qui est la valeur recommandée dans la RFC5625.
! 179: .TP
! 180: .B \-Q, --query-port=<numéro de port>
! 181: Envoie et écoute les requêtes DNS sortantes depuis le port UDP spécifié par
! 182: <numéro de port>, et non sur un port aléatoire. NOTE : Cette option rends
! 183: dnsmasq moins sûr contre les attaques par usurpation DNS ("DNS spoofing"), mais
! 184: cela peut permettre d'utiliser moins de ressources et d'être plus rapide. Donner
! 185: une valeur de zéro à cette option restaure le comportement par défaut présent dans
! 186: les versions de dnsmasq inférieures à 2.43 qui consiste à n'allouer qu'un seul port
! 187: alloué par le système d'exploitation.
! 188: .TP
! 189: .B --min-port=<port>
! 190: Ne pas utiliser de port dont le numéro est inférieur à la valeur donnée en paramètre
! 191: pour les requêtes DNS sortantes. Dnsmasq choisis un port source aléatoire pour les
! 192: requêtes sortantes : lorsque cette option est fournie, les ports utilisés seront toujours
! 193: au dessus de la valeur spécifiée. Utile pour des systèmes derrière des dispositifs
! 194: garde-barrières ("firewalls").
! 195: .TP
! 196: .B \-i, --interface=<nom d'interface>
! 197: N'écouter que sur l'interface réseau spécifiée. Dnsmasq aujoute automatiquement
! 198: l'interface locale ("loopback") à la liste des interfaces lorsque l'option
! 199: .B --interface
! 200: est utilisée.
! 201: Si aucune option
! 202: .B --interface
! 203: ou
! 204: .B --listen-address
! 205: n'est donnée, Dnsmasq écoutera sur toutes les interfaces disponibles sauf
! 206: celle(s) spécifiée(s) par l'option
! 207: .B --except-interface.
! 208: Les alias d'interfaces IP (e-g "eth1:0") ne peuvent être utilisés ni avec
! 209: .B --interface
! 210: ni
! 211: .B \--except-interface.
! 212: Utiliser l'option
! 213: .B --listen-address
! 214: à la place. Un simple joker, consistant d'un '*' final, peut-être utilisé dans
! 215: les options
! 216: .B \--interface
! 217: et
! 218: .B \--except-interface
! 219: .TP
! 220: .B \-I, --except-interface=<interface name>
! 221: Ne pas écouter sur l'interface spécifiée. Notez que l'ordre dans lesquelles les
! 222: options
! 223: .B \--listen-address
! 224: ,
! 225: .B --interface
! 226: et
! 227: .B --except-interface
! 228: sont fournies n'importe pas, et que l'option
! 229: .B --except-interface
! 230: l'emporte toujours sur les autres.
! 231: .TP
! 232: .B --auth-server=<domaine>,<interface>|<addresse IP>
! 233: Active le mode DNS faisant autorité pour les requêtes arrivant sur cette
! 234: interface ou sur cette adresse. Noter que l'interface ou l'adresse n'ont
! 235: pas besoin d'être mentionées ni dans
! 236: .B --interface
! 237: ni dans
! 238: .B --listen-address
! 239: En effet,
! 240: .B --auth-server
! 241: va passer outre ceux-ci et fournir un service DNS différent sur l'interface
! 242: spécifiée. La valeur de <domaine> est l'enregistrement de type "colle"
! 243: ("glue record"). Il doit correspondre dans le service DNS global avec un
! 244: enregistrement de type A et/ou AAAA pointant sur l'adresse sur laquelle dnsmasq
! 245: écoute pour le mode DNS faisant autorité.
! 246: .TP
! 247: .B \-2, --no-dhcp-interface=<nom d'interface>
! 248: Ne pas fournir de service DHCP sur l'interface spécifiée, mais fournir tout de
! 249: même le service DNS.
! 250: .TP
! 251: .B \-a, --listen-address=<adresse IP>
! 252: Ecouter sur la ou les adresse(s) IP spécifiée(s). Les options
! 253: .B \--interface
! 254: et
! 255: .B \--listen-address
! 256: peuvent-être spécifiées simultanément, auquel cas un jeu d'interfaces et
! 257: d'adresses seront utilisées. Notez que si
! 258: aucune option
! 259: .B \--interface
! 260: n'est donnée alors qu'une option
! 261: .B \--listen-address
! 262: l'est, Dnsmasq n'écoutera pas automatiquement sur l'interface locale
! 263: ("loopback"). Pour activer l'écoute sur l'interface locale, il est alors
! 264: nécessaire de fournir explicitement son adresse IP, 127.0.0.1 via l'option
! 265: .B \--listen-address.
! 266: .TP
! 267: .B \-z, --bind-interfaces
! 268: Sur les systèmes qui le supporte, Dnsmasq s'associe avec l'interface joker
! 269: ("wildcard"), même lorsqu'il ne doit écouter que sur certaines interfaces. Par
! 270: la suite, il rejette les requêtes auxquelles il ne doit pas répondre. Cette
! 271: situation présente l'avantage de fonctionner même lorsque les interfaces vont
! 272: et viennent ou changent d'adresses. L'option
! 273: .B --bind-interfaces
! 274: force Dnsmasq à ne réellement s'associer qu'avec les interfaces sur lesquelles
! 275: il doit écouter. L'un des seuls cas où cette option est utile est celui où un
! 276: autre serveur de nom (ou une autre instance de Dnsmasq) tourne sur la même
! 277: machine. Utiliser cette option permet également d'avoir plusieurs instances de
! 278: Dnsmasq fournissant un service DHCP sur la même machine.
! 279: .TP
! 280: .B --bind-dynamic
! 281: Autorise un mode réseau intermédiaire entre
! 282: .B --bind-interfaces
! 283: et le mode par défaut. Dnsmasq s'associe à une seule interface, ce qui permet
! 284: plusieurs instances de dnsmasq, mais si une interface ou adresse apparaissent,
! 285: il se mettra automatiquement à écouter sur celles-ci (les règles de contrôle
! 286: d'accès s'appliquent).
! 287: De fait, les interfaces créées dynamiquement fonctionnent de la même façon que
! 288: dans le comportement par défaut. Ce fonctionnement nécessite des APIs réseau
! 289: non standard et n'est disponible que sous Linux. Sur les autres plateformes,
! 290: le fonctionnement est celui du mode --bind-interfaces.
! 291: .TP
! 292: .B \-y, --localise-queries
! 293: Retourne des réponses aux requêtes DNS dépendantes de l'interface sur laquelle
! 294: la requête a été reçue, à partir du fichier /etc/hosts. Si un nom dans
! 295: /etc/hosts a plus d'une adresse associée avec lui, et qu'une des adresses au
! 296: moins est dans le même sous-réseau que l'interface sur laquelle la requête a été
! 297: reçue, alors ne retourne que la(les) adresse(s) du sous-réseau considéré. Cela
! 298: permet d'avoir dans /etc/hosts un serveur avec de multiples adresses, une pour
! 299: chacune de ses interfaces, et de fournir aux hôtes l'adresse correcte (basée sur
! 300: le réseau auquel ils sont attachés). Cette possibilité est actuellement limitée
! 301: à IPv4.
! 302: .TP
! 303: .B \-b, --bogus-priv
! 304: Fausse résolution inverse pour les réseaux privés. Toutes les requêtes DNS
! 305: inverses pour des adresses IP privées (ie 192.168.x.x, etc...) qui ne sont pas
! 306: trouvées dans /etc/hosts ou dans le fichier de baux DHCP se voient retournées
! 307: une réponse "pas de tel domaine" ("no such domain") au lieu d'être transmises
! 308: aux serveurs de nom amont ("upstream server").
! 309: .TP
! 310: .B \-V, --alias=[<ancienne IP>]|[<IP de début>-<IP de fin>],<nouvelle IP>[,<masque>]
! 311: Modifie les adresses IPv4 retournées par les serveurs de nom amont;
! 312: <ancienne IP> est remplacée par <nouvelle IP>. Si le <masque> optionnel est
! 313: fourni, alors toute adresse correspondant à l'adresse <ancienne IP>/<masque>
! 314: sera réécrite. Ainsi par exemple
! 315: .B --alias=1.2.3.0,6.7.8.0,255.255.255.0
! 316: modifiera 1.2.3.56 en 6.7.8.56 et 1.2.3.67 en 6.7.8.67.
! 317: Cette fonctionnalité correspond à ce que les routeurs Cisco PIX appellent
! 318: "bidouillage DNS" ("DNS doctoring"). Si l'ancienne IP est donnée sous la forme
! 319: d'une gamme d'adresses, alors seules les adresses dans cette gamme seront
! 320: réecrites, et non le sous-réseau dans son ensemble. Ainsi,
! 321: .B --alias=192.168.0.10-192.168.0.40,10.0.0.0,255.255.255.0
! 322: fait correspondre 192.168.0.10->192.168.0.40 à 10.0.0.10->10.0.0.40
! 323: .TP
! 324: .B \-B, --bogus-nxdomain=<adresse IP>
! 325: Transforme les réponses contenant l'adresse IP fournie en réponses "pas de tel
! 326: domaine" ("no such domain"). Ceci a pour but de neutraliser la modification
! 327: sournoise mise en place par Verisign en septembre 2003, lorsqu'ils ont commencé
! 328: à retourner l'adresse d'un serveur web publicitaire en réponse aux requêtes pour
! 329: les noms de domaines non enregistrés, au lieu de la réponse correcte "NXDOMAIN".
! 330: Cette option demande à Dnsmasq de retourner la réponse correcte lorsqu'il
! 331: constate ce comportement. L'adresse retournée par Verisign en septembre 2003
! 332: est 64.94.110.11.
! 333: .TP
! 334: .B \-f, --filterwin2k
! 335: Les dernières versions de windows font des requêtes DNS périodiques auxquelles
! 336: non seulement les serveurs DNS publics ne peuvent donner de réponse, mais qui,
! 337: de surcroît, peuvent poser des problèmes en déclenchant des connexions
! 338: intempestives pour des liens réseaux avec des connexions "à la demande". Fournir
! 339: cette option active le filtrage des requêtes de ce type. Les requêtes bloquées
! 340: sont les requêtes pour les entrées de type SOA ou SRV, ainsi que les requêtes de
! 341: type ANY avec des noms possédant des caractères sous-lignés (requêtes pour des
! 342: serveurs LDAP).
! 343: .TP
! 344: .B \-r, --resolv-file=<fichier>
! 345: Lis les adresses des serveurs de nom amont dans le fichier de nom <fichier>,
! 346: au lieu du fichier /etc/resolv.conf. Pour le format de ce fichier, voir dans le
! 347: manuel pour
! 348: .BR resolv.conf (5)
! 349: les entrées correspondant aux serveurs de noms (nameserver). Dnsmasq peut lire
! 350: plusieurs fichiers de type resolv.conf, le premier fichier spécifié remplace le
! 351: fichier par défaut, le contenu des suivants est rajouté dans la liste des
! 352: fichiers à consulter. Seul le fichier ayant la dernière date de modification
! 353: sera chargé en mémoire.
! 354: .TP
! 355: .B \-R, --no-resolv
! 356: Ne pas lire le contenu du fichier /etc/resolv.conf. N'obtenir l'adresse des
! 357: serveurs de nom amont que depuis la ligne de commande ou le fichier de
! 358: configuration de Dnsmasq.
! 359: .TP
! 360: .B \-1, --enable-dbus[=<nom de service>]
! 361: Autoriser la mise à jour de la configuration de Dnsmasq par le biais d'appel de
! 362: méthodes DBus. Il est possible par ce biais de mettre à jour l'adresse de
! 363: serveurs DNS amont (et les domaines correspondants) et de vider le cache. Cette
! 364: option nécessite que Dnsmasq soit compilé avec le support DBus. Si un nom de
! 365: service est fourni, dnsmasq fourni un service à ce nom, plutôt qu'avec la
! 366: valeur par défaut :
! 367: .B uk.org.thekelleys.dnsmasq
! 368: .TP
! 369: .B \-o, --strict-order
! 370: Par défaut, Dnsmasq envoie les requêtes à n'importe lequel des serveurs amonts
! 371: dont il a connaissance tout en essayant de favoriser les serveurs qu'il sait
! 372: fonctionner. Cette option force Dnsmasq à essayer d'interroger, pour chaque
! 373: requête, les serveurs DNS dans leur ordre d'apparition dans le fichier
! 374: /etc/resolv.conf.
! 375: .TP
! 376: .B --all-servers
! 377: Par défaut, lorsque dnsmasq a plus d'un serveur amont disponible, il n'envoie
! 378: les requêtes qu'à un seul serveur. Spécifier cette option force dnsmasq à
! 379: effectuer ses requêtes à tous les serveurs disponibles. Le résultat renvoyé
! 380: au client sera celui fournit par le premier serveur ayant répondu.
! 381: .TP
! 382: .B --stop-dns-rebind
! 383: Rejete (et enregistre dans le journal d'activité) les adresses dans la gamme
! 384: d'adresses IP privée (au sens RFC1918) qui pourraient être renvoyées par les
! 385: serveurs amonts suite à une résolution de nom. Cela bloque les attaques cherchant
! 386: à détourner de leur usage les logiciels de navigation web ('browser') en s'en
! 387: servant pour découvrir les machines situées sur le réseau local.
! 388: .TP
! 389: .B --rebind-localhost-ok
! 390: Exclue 127.0.0/8 des vérifications de réassociation DNS. Cette gamme d'adresses
! 391: est retournée par les serveurs Realtime Blackhole (RBL, utilisés dans la
! 392: lutte contre le spam), la bloquer peut entraîner des disfonctionnements de ces
! 393: services.
! 394: .TP
! 395: .B --rebind-domain-ok=[<domaine>]|[[/<domaine>/[<domaine>/]
! 396: Ne pas détecter ni bloquer les actions de type dns-rebind pour ces domaines.
! 397: Cette option peut prendre comme valeur soit un nom de domaine soit plusieurs
! 398: noms de domains entourés par des '/', selon une syntaxe similaire à l'option
! 399: --server, c-à-d :
! 400: .B --rebind-domain-ok=/domaine1/domaine2/domaine3/
! 401: .TP
! 402: .B \-n, --no-poll
! 403: Ne pas vérifier régulièrement si le fichier /etc/resolv.conf a été modifié.
! 404: .TP
! 405: .B --clear-on-reload
! 406: Lorsque le fichier /etc/resolv.conf est relu, vider le cache DNS.
! 407: Cela est utile si les nouveaux serveurs sont susceptibles d'avoir des données
! 408: différentes de celles stockées dans le cache.
! 409: .TP
! 410: .B \-D, --domain-needed
! 411: Indique à Dnsmasq de ne jamais transmettre en amont de requêtes A ou AAAA pour
! 412: des noms simples, c'est à dire ne comprenant ni points ni nom de domaine. Si un
! 413: nom n'est pas dans /etc/hosts ou dans la liste des baux DHCP, alors une réponse
! 414: de type "non trouvé" est renvoyée.
! 415: .TP
! 416: .B \-S, --local, --server=[/[<domaine>]/[domaine/]][<Adresse IP>[#<port>][@<Adresse IP source>|<interface>[#<port>]]]
! 417: Spécifie directement l'adresse IP d'un serveur de nom amont. Cette option ne
! 418: supprime pas la lecture du fichier /etc/resolv.conf : utiliser pour cela
! 419: l'option
! 420: .B -R .
! 421: Si un ou plusieurs nom(s) de domaine(s) optionnel(s) sont fournis, ce
! 422: serveur sera uniquement utilisé uniquement pour ce(s) domaine(s), et toute
! 423: requête concernant ce(s) domaine(s) sera adressée uniquement à ce serveur.
! 424: Cette option est destinée aux serveurs de nom privés : si vous avez un serveur
! 425: de nom sur votre réseau ayant pour adresse IP 192.168.1.1 et effectuant la
! 426: résolution des noms de la forme xxx.internal.thekelleys.org.uk, alors
! 427: .B -S /internal.thekelleys.org.uk/192.168.1.1
! 428: enverra toutes les requêtes pour les machines internes vers ce serveur de nom,
! 429: alors que toutes les autres requêtes seront adressées aux serveurs indiqués dans
! 430: le fichier /etc/resolv.conf. Une spécification de nom de domaine vide,
! 431: .B //
! 432: possède le sens particulier de "pour les noms non qualifiés uniquement",
! 433: c'est-à-dire les noms ne possédant pas de points. Un port non standard peut être
! 434: rajouté à la suite des adresses IP en utilisant le caractère #. Plus d'une
! 435: option
! 436: .B -S
! 437: est autorisée, en répétant les domaines et adresses IP comme requis.
! 438:
! 439: Le domaine le plus spécifique l'emporte sur le domaine le moins spécifique,
! 440: ainsi :
! 441: .B --server=/google.com/1.2.3.4
! 442: .B --server=/www.google.com/2.3.4.5
! 443: enverra les requêtes pour *.google.com à 1.2.3.4, à l'exception des requêtes
! 444: *www.google.com, qui seront envoyées à 2.3.4.5.
! 445:
! 446: L'adresse spéciale '#' signifie "utiliser les serveurs standards", ainsi
! 447: .B --server=/google.com/1.2.3.4
! 448: .B --server=/www.google.com/#
! 449: enverra les requêtes pour *.google.com à 1.2.3.4, à l'exception des requêtes
! 450: pour *www.google.com qui seront envoyées comme d'habitude (c-à-d aux serveurs
! 451: définis par défaut).
! 452:
! 453: Il est également permis de donner une option
! 454: .B -S
! 455: avec un nom de domaine mais sans
! 456: adresse IP; Cela informe Dnsmasq que le domaine est local et qu'il doit répondre
! 457: aux requêtes le concernant depuis les entrées contenues dans le fichier
! 458: /etc/hosts ou les baux DHCP, et ne doit en aucun cas transmettre les requêtes
! 459: aux serveurs amonts.
! 460: .B local
! 461: est synonyme de
! 462: .B server
! 463: ("serveur") afin de rendre plus claire l'utilisation de cette option pour cet
! 464: usage particulier.
! 465:
! 466: Les adresses IPv6 peuvent inclure un identifiant de zone sous la forme
! 467: %interface tel que par exemple
! 468: fe80::202:a412:4512:7bbf%eth0.
! 469:
! 470: La chaîne de caractères optionnelle suivant le caractère @ permet de définir
! 471: la source que Dnsmasq doit utiliser pour les réponses à ce
! 472: serveur de nom. Il doit s'agir d'une des adresses IP appartenant à la machine sur
! 473: laquelle tourne Dnsmasq ou sinon la ligne sera ignorée et une erreur sera
! 474: consignée dans le journal des événements, ou alors d'un nom d'interface. Si un nom
! 475: d'interface est donné, alors les requêtes vers le serveur de nom seront envoyées
! 476: depuis cette interface; si une adresse ip est donnée, alors l'adresse source de
! 477: la requête sera l'adresse en question. L'option query-port est ignorée pour tous
! 478: les serveurs ayant une adresse source spécifiée, mais il est possible de la donner
! 479: directement dans la spécification de l'adresse source. Forcer les requêtes à être
! 480: émises depuis une interface spécifique n'est pas possible sur toutes les plateformes
! 481: supportées par dnsmasq.
! 482: .TP
! 483: .B \-A, --address=/<domaine>/[domaine/]<adresse IP>
! 484: Spécifie une adresse IP à retourner pour toute requête pour les domaines fournis
! 485: en option. Les requêtes pour ce(s) domaine(s) ne sont jamais transmises aux
! 486: serveurs amonts et reçoivent comme réponse l'adresse IP spécifiée qui peut être
! 487: une adresse IPv4 ou IPv6. Pour donner à la fois une adresse IPv4 et une adresse
! 488: IPv6 pour un domaine, utiliser plusieurs options
! 489: .B -A.
! 490: Il faut noter que le
! 491: contenu du fichier /etc/hosts et de celui des baux DHCP supplante ceci pour des
! 492: noms individuels. Une utilisation courante de cette option est de rediriger la
! 493: totalité du domaine doubleclick.net vers un serveur web local afin d'éviter les
! 494: bannières publicitaires. La spécification de domaine fonctionne de la même façon
! 495: que
! 496: .B --server,
! 497: avec la caractéristique supplémentaire que
! 498: .B /#/
! 499: coïncide avec tout domaine. Ainsi,
! 500: .B --address=/#/1.2.3.4
! 501: retournera 1.2.3.4 pour toute requête
! 502: n'ayant de réponse ni dans /etc/hosts, ni dans les baux DHCP, et n'étant pas
! 503: transmise à un serveur spécifique par le biais d'une directive
! 504: .B --server.
! 505: .TP
! 506: .B --ipset=/<domaine>/[domaine/]<ipset>[,<ipset>]
! 507: Obtient les adresses IP des domaines spécifiés et les place dans les groupes
! 508: d'IP netfilter (ipset) indiqués. Domaines et sous-domaines sont résolus de la
! 509: même façon que pour --address. Ces groupes d'IP doivent déjà exister. Voir
! 510: ipset(8) pour plus de détails.
! 511: .TP
! 512: .B \-m, --mx-host=<nom de l'hôte>[[,<nom du MX>],<préference>]
! 513: Spécifie un enregistrement de type MX pour <nom de l'hôte> retournant le nom
! 514: donné dans <nom du MX> (s'il est présent), ou sinon le nom spécifié dans
! 515: l'option
! 516: .B --mx-target
! 517: si elle est présente. Sinon retourne le nom de la machine
! 518: sur laquelle Dnsmasq tourne. La valeur par défaut (spécifiée dans l'option
! 519: .B --mx-target
! 520: ) est utile dans un réseau local pour rediriger les courriers
! 521: électroniques vers un serveur central. La valeur de préférence est optionnelle
! 522: et vaut par défaut 1 si elle n'est pas spécifiée. Plus d'une entrée MX peut être
! 523: fournie pour un hôte donné.
! 524: .TP
! 525: .B \-t, --mx-target=<nom d'hôte>
! 526: Spécifie la réponse par défaut fournie par Dnsmasq pour les requêtes sur des
! 527: enregistrements de type MX. Voir
! 528: .B --mx-host.
! 529: Si
! 530: .B --mx-target
! 531: est donné mais pas de
! 532: .B --mx-host,
! 533: alors Dnsmasq retourne comme réponse un enregistrement MX
! 534: contenant le nom d'hôte spécifié dans l'option
! 535: .B --mx-target
! 536: pour toute requête
! 537: concernant le MX de la machine sur laquelle tourne Dnsmasq.
! 538: .TP
! 539: .B \-e, --selfmx
! 540: Définit, pour toutes les machines locales, un MX correspondant à l'hôte
! 541: considéré. Les machines locales sont celles définies dans le fichier /etc/hosts
! 542: ou dans un bail DHCP.
! 543: .TP
! 544: .B \-L, --localmx
! 545: Définit, pour toutes les machines locales, un enregistrement MX pointant sur
! 546: l'hôte spécifié par mx-target (ou la machine sur laquelle Dnsmasq tourne). Les
! 547: machines locales sont celles définies dans le fichier /etc/hosts ou dans un bail
! 548: DHCP.
! 549: .TP
! 550: .B \-W --srv-host=<_service>.<_protocole>.[<domaine>],[<cible>[,<port>[,<priorité>[,<poids>]]]]
! 551: Spécifie un enregistrement DNS de type SRV. Voir la RFC2782 pour plus de
! 552: détails. Si le champs <domaine> n'est pas fourni, prends par défaut la valeur
! 553: fournie dans l'option
! 554: .B --domain.
! 555: La valeur par défaut pour le domaine est vide et le port par défaut est 1, alors
! 556: que les poids et priorités par défaut sont 0. Attention lorsque vous transposez
! 557: des valeurs issues d'une configuration BIND : les ports, poids et priorités sont
! 558: dans un ordre différents. Pour un service/domaine donné, plus d'un
! 559: enregistrement SRV est autorisé et tous les enregistrements qui coïncident sont
! 560: retournés dans la réponse.
! 561: .TP
! 562: .B --host-record=<nom>[,<nom>....][<adresse IPv4>],[<adresse IPv6>]
! 563: Ajoute des enregistrements A, AAAA et PTR dans le DNS. Ceci permet d'ajouter
! 564: un ou plusieurs noms dans le DNS et de les associer à des enregistrements IPv4
! 565: (A) ou IPv6 (AAAA). Un nom peut apparaître dans plus d'une entrée
! 566: .B host-record
! 567: et de fait être associé à plus d'une adresse. Seule la première entrée créée
! 568: l'enregistrement PTR associée au nom. Ceci correspond à la même règle que celle
! 569: utilisée lors de la lecture du fichier hosts.
! 570: Les options
! 571: .B host-record
! 572: sont considérées lues avant le fichier hosts, ainsi un nom apparaissant dans
! 573: une option host-record et dans le fichier hosts n'aura pas d'enregistrement
! 574: PTR associé à l'entrée dans le fichier hosts. A l'inverse du fichier hosts, les
! 575: noms ne sont pas étendus, même lorsque l'option
! 576: .B expand-hosts
! 577: est activée. Les noms longs et les noms courts peuvent apparaitre dans la même
! 578: entrée
! 579: .B host-record,
! 580: c-à-d
! 581: .B --host-record=laptop,laptop.thekelleys.org,192.168.0.1,1234::100
! 582: .TP
! 583: .B \-Y, --txt-record=<nom>[[,<texte>],<texte>]
! 584: Définit un enregistrement DNS de type TXT. La valeur de l'enregistrement TXT est
! 585: un ensemble de chaînes de caractères, donc un nombre variable de chaînes de
! 586: caractères peuvent être spécifiées, séparées par des virgules. Utilisez des
! 587: guillemets pour mettre une virgule dans une chaîne de caractères. Notez que la
! 588: longueur maximale pour une chaîne est de 255 caractères, les chaînes plus
! 589: longues étant découpées en morceaux de 255 caractères de longs.
! 590: .TP
! 591: .B --ptr-record=<nom>[,<cible>]
! 592: Définit un enregistrement DNS de type PTR.
! 593: .TP
! 594: .B --naptr-record=<nom>,<ordre>,<préférence>,<drapeaux>,<service>,<expr. régulière>[,<remplacement>]
! 595: Retourne un enregistrement de type NAPTR, tel que spécifié dans le RFC3403.
! 596: .TP
! 597: .B --cname=<cname>,<cible>
! 598: Retourne un enregistrement de type CNAME qui indique que <cname> est en
! 599: réalité <cible>. Il existe des contraintes significatives sur la valeur
! 600: de cible; il doit s'agir d'un nom DNS qui est connu de dnsmasq via /etc/hosts
! 601: (ou un fichier hôtes additionnel), ou via DHCP, ou par un autre
! 602: .B --cname.
! 603: Si une cible ne satisfait pas ces critères, le CNAME est ignoré. Le CNAME
! 604: doit être unique, mais il est autorisé d'avoir plus d'un CNAME pointant
! 605: vers la même cible.
! 606: .TP
! 607: .B --dns-rr=<nom>,<numéro-RR>,[<données hexadécimales>]
! 608: Retourne un enregistrement DNS arbitraire. Le numéro correspond au type
! 609: d'enregistrement (qui est toujours de la classe C_IN). La valeur de
! 610: l'enregistrement est donnée dans les données hexadécimales, qui peuvent
! 611: être de la forme 01:23:45, 01 23 45,+012345 ou n'importe quelle combinaison.
! 612: .TP
! 613: .B --interface-name=<nom>,<interface>
! 614: Définit un entregistrement DNS associant le nom avec l'adresse primaire sur
! 615: l'interface donnée en argument. Cette option spécifie un enregistrement de type
! 616: A pour le nom donné en argument de la même façon que s'il était défini par une
! 617: ligne de /etc/hosts, sauf que l'adresse n'est pas constante mais dépendante de
! 618: l'interface définie. Si l'interface est inactive, non existante ou non
! 619: configurée, une réponse vide est fournie. Un enregistrement inverse (PTR) est
! 620: également créé par cette option, associant l'adresse de l'interface avec le nom.
! 621: Plus d'un nom peut être associé à une interface donnée en répétant cette option
! 622: plusieurs fois; dans ce cas, l'enregistrement inverse pointe vers le nom fourni
! 623: dans la première instance de cette option.
! 624: .TP
! 625: .B --add-mac
! 626: Ajoute l'adresse MAC du requêteur aux requêtes DNS transmises aux serveurs
! 627: amonts. Cela peut être utilisé dans un but de filtrage DNS par les serveurs
! 628: amonts. L'adresse MAC peut uniquement être ajoutée si le requêteur est sur le
! 629: même sous-réseau que le serveur dnsmasq. Veuillez noter que le mécanisme
! 630: utilisé pour effectuer cela (une option EDNS0) n'est pas encore standardisée,
! 631: aussi cette fonctionalité doit être considérée comme expérimentale. Notez
! 632: également qu'exposer les adresses MAC de la sorte peut avoir des implications
! 633: en termes de sécurité et de vie privée.
! 634: .TP
! 635: .B \-c, --cache-size=<taille>
! 636: Définit la taille du cache de Dnsmasq. La valeur par défaut est de 150 noms.
! 637: Définir une valeur de zéro désactive le cache.
! 638: .TP
! 639: .B \-N, --no-negcache
! 640: Désactive le "cache négatif". Le "cache négatif" permet à Dnsmasq de se souvenir
! 641: des réponses de type "no such domain" fournies par les serveurs DNS en amont et
! 642: de fournir les réponses sans avoir à re-transmettre les requêtes aux serveurs
! 643: amont.
! 644: .TP
! 645: .B \-0, --dns-forward-max=<nombre de requêtes>
! 646: Définit le nombre maximum de requêtes DNS simultanées. La valeur par défaut est
! 647: 150, ce qui devrait être suffisant dans la majorité des configurations. La seule
! 648: situation identifiée dans laquelle cette valeur nécessite d'être augmentée est
! 649: lorsqu'un serveur web a la résolution de nom activée pour l'enregistrement de
! 650: son journal des requêtes, ce qui peut générer un nombre important de requêtes
! 651: simultanées.
! 652: .TP
! 653: .B --proxy-dnssec
! 654: Un resolveur sur une machine cliente peut effectuer la validation DNSSEC de
! 655: deux façons : il peut effectuer lui-même les opérations de chiffrements sur
! 656: la réponse reçue, ou il peut laisser le serveur récursif amont faire la
! 657: validation et positionner un drapeau dans la réponse au cas où celle-ci est
! 658: correcte. Dnsmasq n'est pas un validateur DNSSEC, aussi il ne peut effectuer
! 659: la validation comme un serveur de nom récursif, cependant il peut retransmettre
! 660: les résultats de validation de ses serveurs amonts. Cette option permet
! 661: l'activation de cette fonctionalité. Vous ne devriez utiliser cela que si vous
! 662: faites confiance aux serveurs amonts
! 663: .I ainsi que le réseau entre vous et eux.
! 664: Si vous utilisez le premier mode DNSSEC, la validation par le resolveur des
! 665: clients, cette option n'est pas requise. Dnsmasq retourne toujours toutes les
! 666: données nécessaires par un client pour effectuer la validation lui-même.
! 667: .TP
! 668: .B --auth-zone=<domaine>[,<sous-réseau>[,<sous-réseau>.....]]
! 669: Définie une zone DNS pour laquelle dnsmasq agit en temps que serveur faisant
! 670: autorité. Les enregistrements DNS définis localement et correspondant à ce
! 671: domaine seront fournis, à ceci près que les enregistrements A et AAAA doivent
! 672: se situer dans l'un des sous-réseaux précisés si ceux-ci sont définis, ou dans
! 673: un réseau correspondant à une plage DHCP. Le ou les sous-réseaux sont également
! 674: utilisé pour définir les domaines in-addr.arpa et ipv6.arpa servant à
! 675: l'interrogation DNS inverse. Dans le cas d'IPv4, la longueur du masque de
! 676: réseau doit être de 8, 16 ou 24.
! 677: .TP
! 678: .B --auth-soa=<numéro de série>[,<mainteneur de zone (hostmaster)>[,<rafraichissement>[,<nombre de réessais>[,<expiration>]]]]
! 679: Spécifie les champs de l'enregistrement de type SOA (Start Of Authority)
! 680: associé à une zone pour laquelle le serveur fait autorité. A noter que cela est
! 681: optionnel, les valeurs par défaut devant convenir à la majorité des cas.
! 682: .TP
! 683: .B --auth-sec-servers=<domaine>[,<domaine>[,<domaine>...]]
! 684: Spécifie un ou plusieurs serveur de nom secondaires pour une zone pour
! 685: laquelle dnsmasq fait autorité. Ces serveurs doivent-être configurés pour
! 686: récupérer auprès de dnsmasq les informations liées à la zone au travers d'un
! 687: transfert de zone, et répondre aux requêtes pour toutes les zones pour
! 688: lesquelles dnsmasq fait autorité.
! 689: .TP
! 690: .B --auth-peer=<adresse IP>[,<adresse IP>[,<adresse IP>...]]
! 691: Spécifie la ou les adresses de serveurs secondaires autorisés à initier des
! 692: requêtes de transfert de zone (AXFR) pour les zones pour lesquelles
! 693: dnsmasq fait autorité. Si cette option n'est pas fournie, les requêtes AXFR
! 694: seront acceptées pour tous les serveurs secondaires.
! 695: .TP
! 696: .B --conntrack
! 697: Lis le marquage de suivi de connexion Linux associé aux requêtes DNS entrantes
! 698: et positionne la même marque au trafic amont utilisé pour répondre à ces
! 699: requétes. Cela permet au trafic généré par Dnsmasq d'étre associé aux requêtes
! 700: l'ayant déclenché, ce qui est pratique pour la gestion de la bande passante
! 701: (accounting) et le filtrage (firewall). Dnsmasq doit pour cela être compilé
! 702: avec le support conntrack, le noyau doit également inclure conntrack et être
! 703: configuré pour cela. Cette option ne peut pas être combinée avec
! 704: --query-port.
! 705: .TP
! 706: .B \-F, --dhcp-range=[tag:<label>[,tag:<label>],][set:<label>],]<adresse de début>[,<adresse de fin>][,<mode>][,<masque de réseau>[,<broadcast>]][,<durée de bail>]
! 707: .TP
! 708: .B \-F, --dhcp-range=[tag:<label>[,tag:<label>],][set:<label>],]<addresse IPv6 de début>[,<adresse IPv6 de fin>|constructor:<interface>][,<mode>][,<longueur de préfixe>][,<durée de bail>]
! 709:
! 710: Active le serveur DHCP. Les adresses seront données dans la plage comprise entre
! 711: <adresse de début> et <adresse de fin> et à partir des adresses définies
! 712: statiquement dans l'option
! 713: .B dhcp-host.
! 714: Si une durée de bail est donnée, alors les baux seront donnés pour cette
! 715: durée. La durée de bail est donnée en secondes, en minutes (exemple : 45m),
! 716: en heures (exemple : 1h) ou être la chaine de caractère "infinite" pour une
! 717: durée indéterminée. Si aucune valeur n'est donnée, une durée de bail par défaut
! 718: de une heure est appliquée. La valeur minimum pour un bail DHCP est de 2
! 719: minutes.
! 720:
! 721: Pour les plages IPv6, la durée de bail peut-être égale au mot-clef "deprecated"
! 722: (obsolète); Cela positionne la durée de vie préférée envoyée dans les baux DHCP
! 723: ou les annonces routeurs à zéro, ce qui incite les clients à utiliser d'autres
! 724: adresses autant que possible, pour toute nouvelle connexion, en préalable à
! 725: la renumérotation.
! 726:
! 727: Cette option peut être répétée, avec différentes adresses,
! 728: pour activer le service DHCP sur plus d'un réseau. Pour des réseaux directement
! 729: connectés (c'est-à-dire des réseaux dans lesquels la machine sur laquelle tourne
! 730: Dnsmasq possède une interface), le masque de réseau est optionnel : Dnsmasq la
! 731: déterminera à partir de la configuration des interfaces.
! 732:
! 733: Pour les réseaux pour lesquels le service DHCP se fait via un relais DHCP
! 734: ("relay agent"), Dnsmasq est incapable de déterminer le masque par lui-même,
! 735: aussi il doit être spécifié, faute de quoi Dnsmasq essaiera de le deviner en
! 736: fonction de la classe (A, B ou C) de l'adresse réseau. L'adresse de broadcast
! 737: est toujours optionnelle.
! 738:
! 739: Il est toujours possible d'avoir plus d'une plage DHCP pour un même
! 740: sous-réseau.
! 741:
! 742: Pour IPv6, les paramètres sont légèrement différents : au lieu d'un masque de
! 743: réseau et d'une adresse de broadcast, il existe une longueur de préfixe
! 744: optionnelle. Si elle est omise, la valeur par défaut est 64. À la différence
! 745: d'IPv4, la longueur de préfixe n'est pas automatiquement déduite de la
! 746: configuration de l'interface. La taille minimale pour la longueur de préfixe
! 747: est 64.
! 748:
! 749: Pour IPv6 (et IPv6 uniquement), il est possible de définir les plages d'une
! 750: autre façon. Dans ce cas, l'adresse de départ et l'adresse de fin optionnelle
! 751: contiennent uniquement la partie réseau (par exemple ::1) et sont suivies par
! 752: .B constructor:<interface>.
! 753: Cela forme un modèle décrivant comment construire la plage, à partir des
! 754: adresses assignées à l'interface. Par exemple
! 755:
! 756: .B --dhcp-range=::1,::400,constructor:eth0
! 757:
! 758: provoque la recherche d'adresses de la forme <réseau>::1 sur eth0 et crée une
! 759: plage allant de <réseau>::1 à <réseau>:400. Si une interface est assignée à
! 760: plus d'un réseau, les plages correspondantes seront automatiquement créées,
! 761: rendues obsolètes puis supprimées lorsque l'adress est rendue obsolète puis
! 762: supprimée. Le nom de l'interface peut être spécifié avec un caractère joker '*'
! 763: final.
! 764:
! 765: L'identifiant de label optionnel
! 766: .B set:<label>
! 767: fournie une étiquette alphanumérique qui identifie ce réseau, afin de permettre
! 768: la fourniture d'options DHCP spécifiques à chaque réseau.
! 769: Lorsque préfixé par 'tag:', la signification change, et au lieu de définir un
! 770: label, il définit le label pour laquelle la règle s'applique. Un seul label peut-
! 771: être défini mais plusieurs labels peuvent coïncider.
! 772:
! 773: Le mot clef optionnel <mode> peut être égal à
! 774: .B static
! 775: ("statique") ce qui indique à Dnsmasq d'activer le service DHCP pour le réseau
! 776: spécifié, mais de ne pas activer l'allocation dynamique d'adresses IP : Seuls
! 777: les hôtes possédant des adresses IP statiques fournies via
! 778: .B dhcp-host
! 779: ou présentes dans le fichier /etc/ethers seront alors servis par le DHCP. Il est
! 780: possible d'activer un mode "fourre-tout" en définissant un réseau statique
! 781: comportant uniquement des zéros, c'est à dire :
! 782: .B --dhcp=range=::,static
! 783: Cela permet de retourner des réponses à tous les paquets de type
! 784: Information-request (requête d'information) en mode DHCPv6 sans état sur le
! 785: sous-réseau configuré.
! 786:
! 787: Pour IPv4, le <mode> peut est égal à
! 788: .B proxy
! 789: , auquel cas Dnsmasq fournira un service de DHCP proxy pour le sous-réseau
! 790: spécifié. (voir
! 791: .B pxe-prompt
! 792: et
! 793: .B pxe-service
! 794: pour plus de détails).
! 795:
! 796: Pour IPv6, le mode peut-être une combinaison des valeurs
! 797: .B ra-only, slaac, ra-names, ra-stateless.
! 798:
! 799: .B ra-only
! 800: indique à dnsmasq de n'effectuer que des annonces de routeur (Router
! 801: Advertisement, RA) sur ce sous-réseau, et de ne pas faire de DHCP.
! 802:
! 803: .B slaac
! 804: indique à dnsmasq d'effectuer des annonces de routeur sur ce sous-réseau
! 805: et de positionner dans celles-ci le bit A, afin que les clients utilisent
! 806: des adresses SLAAC. Lorsqu'utilisé conjointement avec une plage DHCP ou des
! 807: affectations statiques d'adresses DHCP, les clients disposeront à la fois
! 808: d'adresses DHCP assignées et d'adresses SLAAC.
! 809:
! 810: .B ra-stateless
! 811: indique à dnsmasq d'effectuer des annonces de routeur avec les bits 0 et A
! 812: positionnés, et de fournir un service DHCP sans état ("stateless"). Les clients
! 813: utiliseront des adresses SLAAC, et utiliseront DHCP pour toutes les autres
! 814: informations de configuration.
! 815:
! 816: .B ra-names
! 817: active un mode qui fourni des noms DNS aux hôtes fonctionnant en double pile
! 818: ("dual stack") et configurés pour faire du SLAAC en IPv6. Dnsmasq utilise le
! 819: bail IPv4 de l'hôte afin de dériver le nom, le segment de réseau et l'adresse
! 820: MAC et assume que l'hôte disposera d'une adresse IPv6 calculée via l'algorithme
! 821: SLAAC, sur le même segment de réseau. Un ping est envoyé à l'adresse, et si une
! 822: réponse est obtenue, un enregistrement AAAA est rajouté dans le DNS pour cette
! 823: adresse IPv6. Veuillez-noter que cela n'arrive que pour les réseaux directement
! 824: connectés (et non ceux pour lesquels DHCP se fait via relai), et ne
! 825: fonctionnera pas si un hôte utilise les "extensions de vie privée"
! 826: ("privacy extensions").
! 827: .B ra-names
! 828: peut-être combiné avec
! 829: .B ra-stateless
! 830: et
! 831: .B slaac.
! 832:
! 833: .TP
! 834: .B \-G, --dhcp-host=[<adresse matérielle>][,id:<identifiant client>|*][,set:<label>][,<adresse IP>][,<nom d'hôte>][,<durée de bail>][,ignore]
! 835: Spécifie les paramètres DHCP relatifs à un hôte. Cela permet à une machine
! 836: possédant une adresse matérielle spécifique de se voir toujours allouée les
! 837: mêmes nom d'hôte, adresse IP et durée de bail. Un nom d'hôte spécifié comme
! 838: ceci remplace le nom fourni par le client DHCP de la machine hôte. Il est
! 839: également possible d'omettre l'adresse matérielle et d'inclure le nom d'hôte,
! 840: auquel cas l'adresse IP et la durée de bail s'appliqueront à toute machine se
! 841: réclamant de ce nom. Par exemple
! 842: .B --dhcp-host=00:20:e0:3b:13:af,wap,infinite
! 843: spécifie à Dnsmasq de fournir à la machine d'adresse matérielle
! 844: 00:20:e0:3b:13:af le nom, et un bail de durée indéterminée.
! 845:
! 846: .B --dhcp-host=lap,192.168.0.199
! 847: spécifie à Dnsmasq d'allouer toujours à la machine portant le nom lap
! 848: l'adresse IP 192.168.0.199.
! 849:
! 850: Les adresses allouées de la sorte ne sont pas contraintes à une plage d'adresse
! 851: spécifiée par une option --dhcp-range, mais elles se trouver dans le même
! 852: sous-réseau qu'une plage dhcp-range valide. Pour les sous-réseaux qui n'ont pas
! 853: besoin d'adresses dynamiquement allouées, utiliser le mot-clef "static" dans la
! 854: déclaration de plage d'adresses dhcp-range.
! 855:
! 856: Il est possible
! 857: d'utiliser des identifiants clients plutôt que des adresses matérielles pour
! 858: identifier les hôtes, en préfixant par ceux-ci par 'id:'. Ainsi,
! 859: .B --dhcp-host=id:01:02:03:04,.....
! 860: réfère à l'hôte d'identifiant 01:02:03:04. Il est également possible de
! 861: spécifier l'identifiant client sous la forme d'une chaîne de caractères, comme
! 862: ceci :
! 863: .B --dhcp-host=id:identifiantclientsousformedechaine,.....
! 864:
! 865: Un seul
! 866: .B dhcp-host
! 867: peut contenir une adresse IPv4, une adresse IPv6, ou les deux en même temps.
! 868: Les adresses IPv6 doivent-être mises entre crochets comme suit :
! 869: .B --dhcp-host=laptop,[1234::56]
! 870: Les adresses IPv6 peuvent ne contenir que la partie identifiant de client :
! 871: .B --dhcp-host=laptop,[::56]
! 872: Dans ce cas, lorsque des plages dhcp sont définies automatiquement par le biais
! 873: de constructeurs, la partie réseau correspondante est rajoutée à l'adresse.
! 874: A noter que pour le DHCP IPv6, l'adresse matérielle n'est en principe pas
! 875: disponible, aussi un client doit-être identifié par un identifiant de client
! 876: (appellé "DUID client") ou un nom d'hôte.
! 877:
! 878: L'option spéciale id:* signifie : "ignorer tout identifiant client et n'utiliser
! 879: que l'adresse matérielle". Cela est utile lorsqu'un client présente un
! 880: identifiant client mais pas les autres.
! 881:
! 882: Si un nom apparaît dans /etc/hosts, l'adresse associée peut être allouée à un
! 883: bail DHCP mais seulement si une option
! 884: .B --dhcp-host
! 885: spécifiant le nom existe par ailleurs. Seul un nom d'hôte peut-être donné dans
! 886: une option
! 887: .B dhcp-host
! 888: , mais les alias sont possibles au travers de l'utilisation des CNAMEs. (Voir
! 889: .B --cname
! 890: ).
! 891: Le mot clef "ignore" ("ignorer") indique
! 892: à Dnsmasq de ne jamais fournir de bail DHCP à une machine. La machine peut être
! 893: spécifiée par son adresse matérielle, son identifiant client ou son nom d'hôte.
! 894: Par exemple
! 895: .B --dhcp-host=00:20:e0:3b:13:af,ignore
! 896: Cela est utile lorsqu'un autre serveur DHCP sur le réseau doit être utilisé par
! 897: certaines machines.
! 898:
! 899: Le paramètre set:<identifiant réseau> permet de définir un
! 900: identifiant de réseau lorsque l'option dhcp-host est utilisée. Cela peut servir
! 901: à sélectionner des options DHCP juste pour cet hôte. Plus d'un label peut être
! 902: fourni dans une directive dhcp-host (et dans cette seule directive). Lorsqu'une
! 903: machine coïncide avec une directive dhcp-host (ou une impliquée par
! 904: /etc/ethers), alors le label réservé "known" ("connu") est associé. Cela permet à
! 905: Dnsmasq d'être configuré pour ignorer les requêtes issus de machines inconnue
! 906: par le biais de
! 907: .B --dhcp-ignore=tag:!known.
! 908:
! 909: Les adresses ethernet (mais pas les identifiants clients) peuvent être définies
! 910: avec des octets joker, ainsi par exemple
! 911: .B --dhcp-host=00:20:e0:3b:13:*,ignore
! 912: demande à Dnsmasq d'ignorer une gamme d'adresses matérielles. Il est à noter
! 913: que "*" doit-être précédé d'un caractère d'échappement ou mis entre guillemets
! 914: lorsque spécifié en option de ligne de commande, mais pas dans le fichier de
! 915: configuration.
! 916:
! 917: Les adresses matérielles coïncident en principe avec n'importe
! 918: quel type de réseau (ARP), mais il est possible de les limiter à un seul type
! 919: ARP en les précédant du type ARP (en Hexadécimal) et de "-". Ainsi
! 920: .B --dhcp-host=06-00:20:e0:3b:13:af,1.2.3.4
! 921: coïncidera uniquement avec des adresses matérielles Token-Ring, puisque le type
! 922: ARP pour une adresse Token-Ring est 6.
! 923:
! 924: Un cas spécial, pour IPv4, correspond à l'inclusion d'une ou plusieurs adresses
! 925: matérielles, c-à-d :
! 926: .B --dhcp-host=11:22:33:44:55:66,12:34:56:78:90:12,192.168.0.2.
! 927: Cela permet à une adresse IP d'être associé à plusieurs adresses
! 928: matérielles, et donne à dnsmasq la permission d'abandonner un bail DHCP
! 929: attribué à l'une de ces adresses lorsqu'une autre adresse dans la liste
! 930: demande un bail. Ceci est une opération dangereuse qui ne fonctionnera
! 931: de manière fiable que si une adresse matérielle est active à un moment
! 932: donné et dnsmasq n'a aucun moyen de s'assurer de cela. Cela est utile,
! 933: par exemple, pour allouer une adresse IP stable à un laptop qui
! 934: aurait à la fois une connexion filaire et sans-fil.
! 935: .TP
! 936: .B --dhcp-hostsfile=<chemin>
! 937: Lis les informations d'hôtes DHCP dans le fichier spécifié. Si l'argument est
! 938: un chemin vers un répertoire, lis tous les fichiers de ce répertoire. Le
! 939: fichier contient des informations à raison d'un hôte par ligne. Le format
! 940: d'une ligne est la même que le texte fourni à la droite sur caractère "=" dans
! 941: l'option
! 942: .B --dhcp-host.
! 943: L'avantage de stocker les informations sur les hôtes DHCP dans ce fichier est
! 944: que celles-ci peuvent être modifiées sans recharger Dnsmasq; le fichier sera
! 945: relu lorsque Dnsmasq reçoit un signal SIGHUP.
! 946: .TP
! 947: .B --dhcp-optsfile=<chemin>
! 948: Lis les informations relatives aux options DHCP dans le fichier spécifié. Si
! 949: l'argument est un chemin vers un répertoire, lis tous les fichiers de ce
! 950: répertoire. L'intérêt d'utiliser cette option est le même que pour
! 951: --dhcp-hostsfile : le fichier spécifié sera rechargé à la réception par
! 952: dnsmasq d'un signal SIGHUP. Notez qu'il est possible d'encoder l'information
! 953: via
! 954: .B --dhcp-boot
! 955: en utilisant les noms optionnels bootfile-name, server-ip-address et
! 956: tftp-server. Ceci permet d'inclure ces options dans un fichier "dhcp-optsfile".DNSMASQ_SUPPLIED_HOSTNAME
! 957: .TP
! 958: .B \-Z, --read-ethers
! 959: Lis les informations d'hôtes DHCP dans le fichier /etc/ethers. Le format de
! 960: /etc/ethers est une adresse matérielle suivie, soit par un nom d'hôte, soit par
! 961: une adresse IP sous la forme de 4 chiffres séparés par des points. Lorsque lu
! 962: par Dnsmasq, ces lignes ont exactement le même effet que l'option
! 963: .B --dhcp-host
! 964: contenant les mêmes informations. /etc/ethers est relu à la réception d'un
! 965: signal SIGHUP par Dnsmasq. Les adresses IPv6 ne sont PAS lues dans /etc/ethers.
! 966: .TP
! 967: .B \-O, --dhcp-option=[tag:<label>,[tag:<label>]][encap:<option>,][vi-encap:<entreprise>,][vendor:[<classe_vendeur>],][<option>|option:<nom d'option>|option6:<option>|option6:<nom d'option>],[<valeur>[,<valeur>]]
! 968: Spécifie des options différentes ou supplémentaires pour des clients DHCP. Par
! 969: défaut, Dnsmasq envoie un ensemble standard d'options aux clients DHCP : le
! 970: masque de réseau et l'adresse de broadcast sont les mêmes que pour l'hôte
! 971: sur lequel tourne Dnsmasq, et le serveur DNS ainsi que la route par défaut
! 972: prennent comme valeur l'adresse de la machine sur laquelle tourne Dnsmasq.
! 973: (Des règles équivalentes s'appliquent en IPv6). Si une option de nom de domaine
! 974: a été définie, son contenu est transmis. Cette option de configuration permet
! 975: de changer toutes ces valeurs par défaut, ou de spécifier d'autres options.
! 976: L'option DHCP à transmettre peut être fournie sous forme d'un nombre décimal
! 977: ou sous la forme "option:<nom d'option>". Les nombres correspondants aux options
! 978: sont définis dans la RFC2132 et suivants. Les noms d'options connus par Dnsmasq
! 979: peuvent être obtenus via "Dnsmasq --help dhcp". Par exemple, pour définir la
! 980: route par défaut à 192.168.4.4, il est possible de faire
! 981: .B --dhcp-option=3,192.168.4.4
! 982: ou
! 983: .B --dhcp-option = option:router, 192.168.4.4
! 984: ou encore, pour positionner l'adresse du serveur de temps à 192.168.0.4, on peut
! 985: faire
! 986: .B --dhcp-option = 42,192.168.0.4
! 987: ou
! 988: .B --dhcp-option = option:ntp-server, 192.168.0.4
! 989: L'adresse 0.0.0.0 prends ici le sens "d'adresse de la machine sur laquelle
! 990: tourne Dnsmasq". Les types de données autorisées sont des adresses IP sous la
! 991: forme de 4 chiffres séparés par des points, un nombre décimal, une liste de
! 992: caractères hexadécimaux séparés par des 2 points, ou une chaîne de caractères.
! 993: Si des labels optionnels sont fournis, alors cette option n'est envoyée
! 994: qu'aux réseaux dont tous les labels coïncident avec ceux de la requête.
! 995:
! 996: Un traitement spécial est effectué sur les chaînes de caractères fournies pour
! 997: l'option 119, conformément à la RFC 3397. Les chaînes de caractères ou les
! 998: adresses IP sous forme de 4 chiffres séparés par des points donnés en arguments
! 999: de l'option 120 sont traités conforméments à la RFC 3361. Les adresses IP sous
! 1000: forme de 4 chiffres séparés par des points suivies par une barre montante "/",
! 1001: puis une taille de masque sont encodés conforméments à la RFC 3442.
! 1002:
! 1003: Les options IPv6 sont fournies en utilisant le mot-clef
! 1004: .B option6:
! 1005: suivi par le numéro d'option ou le nom d'option. L'espace de nommage des options
! 1006: IPv6 est disjint de l'espace de nommage des options IPv4. Les adresses IPv6
! 1007: en option doivent être entourées de crochets, comme par exemple :
! 1008: .B --dhcp-option=option6:ntp-server,[1234::56]
! 1009:
! 1010: Attention : aucun test n'étant fait pour vérifier que des données d'un type
! 1011: adéquat sont envoyées pour un numéro d'option donné, il est tout à fait possible
! 1012: de persuader Dnsmasq de générer des paquets DHCP illégaux par une utilisation
! 1013: incorrecte de cette option. Lorsque la valeur est un nombre décimal, Dnsmasq
! 1014: doit déterminer la taille des données. Cela est fait en examinant le numéro de
! 1015: l'option et/ou la valeur, mais peut-être évité en rajoutant un suffixe d'une
! 1016: lettre comme suit :
! 1017: b = un octet, s = 2 octets, i = 4 octets. Cela sert essentiellement pour des
! 1018: options encapsulées de classes de vendeurs (voir plus bas), pour lesquelles
! 1019: Dnsmasq ne peut déterminer la taille de la valeur. Les données d'options
! 1020: consistant uniquement de points et de décimaux sont interprétées par Dnsmasq
! 1021: comme des adresses IP, et envoyées comme telles. Pour forcer l'envoi sous forme
! 1022: de chaîne de caractère, il est nécessaire d'utiliser des guillemets doubles. Par
! 1023: exemple, l'utilisation de l'option 66 pour fournir une adresse IP sous la forme
! 1024: d'une chaîne de caractères comme nom de serveur TFTP, il est nécessaire de faire
! 1025: comme suit :
! 1026: .B --dhcp-option=66,"1.2.3.4"
! 1027:
! 1028: Les options encapsulées de classes de vendeurs peuvent-être aussi spécifiées
! 1029: (pour IPv4 seulement) en utilisant
! 1030: .B --dhcp-option
! 1031: : par exemple
! 1032: .B --dhcp-option=vendor:PXEClient,1,0.0.0.0
! 1033: envoie l'option encapsulée de classe de vendeur "mftp-address=0.0.0.0" à
! 1034: n'importe quel client dont la classe de vendeur correspond à "PXEClient". La
! 1035: correspondance pour les classes de vendeur s'effectue sur des sous-chaînes de
! 1036: caractères (voir
! 1037: .B --dhcp-vendorclass
! 1038: pour plus de détails). Si une option de
! 1039: classe de vendeur (numéro 60) est envoyée par Dnsmasq, alors cela est utilisé
! 1040: pour sélectionner les options encapsulées, de préférence à toute option envoyée
! 1041: par le client. Il est possible d'omettre complètement une classe de vendeur :
! 1042: .B --dhcp-option=vendor:,1,0.0.0.0
! 1043: Dans ce cas l'option encapsulée est toujours envoyée.
! 1044:
! 1045: En IPv4, les options peuvent-être encapsulées au sein d'autres options :
! 1046: par exemple
! 1047: .B --dhcp-option=encap:175, 190, "iscsi-client0"
! 1048: enverra l'option 175, au sein de laquelle se trouve l'option 190.
! 1049: Plusieurs options encapsulées avec le même numéro d'option seront correctement
! 1050: combinées au sein d'une seule option encapsulée. Il n'est pas possible de
! 1051: spécifier encap: et vendor: au sein d'une même option dhcp.
! 1052:
! 1053: La dernière variante pour les options encapsulées est "l'option de Vendeur
! 1054: identifiant le vendeur" ("Vendor-Identifying Vendor Options") telle que
! 1055: décrite dans le RFC3925. Celles-ci sont spécifiées comme suit :
! 1056: .B --dhcp-option=vi-encap:2, 10, "text"
! 1057: Le numéro dans la section vi-encap: est le numéro IANA de l'entreprise servant
! 1058: à identifier cette option. Cette forme d'encapsulation est également supportée
! 1059: en IPv6.
! 1060:
! 1061: L'adresse 0.0.0.0 n'est pas traitée de manière particulière lorsque fournie dans
! 1062: une option encapsulée.
! 1063: .TP
! 1064: .B --dhcp-option-force=[tag:<label>,[tag:<label>]][encap:<option>,][vi-encap:<entreprise>,][vendor:[<classe_vendeur>],][<option>|option:<nom d'option>],[<valeur>[,<valeur>]]
! 1065: Cela fonctionne exactement de la même façon que
! 1066: .B --dhcp-option
! 1067: sauf que cette option sera toujours envoyée, même si le client ne la demande pas
! 1068: dans la liste de paramêtres requis. Cela est parfois nécessaire, par exemple lors
! 1069: de la fourniture d'options à PXELinux.
! 1070: .TP
! 1071: .B --dhcp-no-override
! 1072: (IPv4 seulement) Désactive la réutilisation des champs DHCP nom de serveur et
! 1073: nom de fichier comme espace supplémentaire pour les options. Si cela est
! 1074: possible, dnsmasq déplace les informations sur le serveur de démarrage
! 1075: et le nom de fichier (fournis par 'dhcp-boot') en dehors des champs
! 1076: dédiés à cet usage dans les options DHCP. Cet espace supplémentaire est
! 1077: alors disponible dans le paquet DHCP pour d'autres options, mais peut, dans
! 1078: quelques rares cas, perturber des clients vieux ou défectueux. Cette
! 1079: option force le comportement à l'utilisation des valeurs "simples et sûres"
! 1080: afin d'éviter des problèmes dans de tels cas.
! 1081: .TP
! 1082: .B \-U, --dhcp-vendorclass=set:<label>,[enterprise:<numéro IANA d'enterprise>,]<classe de vendeur>
! 1083:
! 1084: Associe une chaîne de classe de vendeur à un label. La plupart
! 1085: des clients DHCP fournissent une "classe de vendeur" ("vendor class") qui
! 1086: représente, d'une certaine façon, le type d'hôte. Cette option associe des
! 1087: classes de vendeur à des labels, de telle sorte que des options DHCP peuvent-être
! 1088: fournie de manière sélective aux différentes classes d'hôtes. Par exemple,
! 1089: .B dhcp-vendorclass=set:printers,Hewlett-Packard JetDirect
! 1090: ou
! 1091: .B dhcp-vendorclass=printers,Hewlett-Packard JetDirect
! 1092: permet de n'allouer des options qu'aux imprimantes HP de la manière suivante :
! 1093: .B --dhcp-option=tag:printers,3,192.168.4.4
! 1094: La chaîne de caractères de la classe de vendeur founie en argument est cherchée
! 1095: en temps que sous-chaîne de caractères au sein de la classe de vendeur fournie
! 1096: par le client, de façon à permettre la recherche d'un sous-ensemble de la chaîne
! 1097: de caractères ("fuzzy matching"). Le préfixe set: est optionnel mais autorisé
! 1098: afin de conserver une certaine homogénéité.
! 1099:
! 1100: Notez qu'en IPv6 (et seulement en IPv6), les noms de classes de vendeurs
! 1101: sont dans un espace de nom associé au numéro attribué à l'entreprise par
! 1102: l'IANA. Ce numéro est fourni par le biais du mot-clef enterprise: et seules
! 1103: les classes de vendeurs associées au numéro spécifié seront cherchées.
! 1104: .TP
! 1105: .B \-j, --dhcp-userclass=set:<label>,<classe utilisateur>
! 1106: Associe une chaîne de classe d'utilisateur à un label (effectue la
! 1107: recherche sur des sous-chaînes, comme pour les classes de vendeur). La plupart
! 1108: des clients permettent de configurer une "classe d'utilisateur". Cette option
! 1109: associe une classe d'utilisateur à un label, de telle manière qu'il soit
! 1110: possible de fournir des options DHCP spécifiques à différentes classes d'hôtes.
! 1111: Il est possible, par exemple, d'utiliser ceci pour définir un serveur
! 1112: d'impression différent pour les hôtes de la classe "comptes" et ceux de la
! 1113: classe "ingénierie".
! 1114: .TP
! 1115: .B \-4, --dhcp-mac=set:<label>,<adresse MAC>
! 1116: (IPv4 uniquement) Associe une adresse matérielle (MAC) à un label. L'adresse
! 1117: matérielle peut inclure des jokers. Par exemple
! 1118: .B --dhcp-mac=set:3com,01:34:23:*:*:*
! 1119: permet de définir le label "3com" pour n'importe quel hôte dont l'adresse
! 1120: matérielle coïncide avec les critères définis.
! 1121: .TP
! 1122: .B --dhcp-circuitid=set:<label>,<identifiant de circuit>, --dhcp-remoteid=set:<label>,<identifiant distant>
! 1123: Associe des options de relais DHCP issus de la RFC3046 à des labels.
! 1124: Cette information peut-être fournie par des relais DHCP. L'identifiant
! 1125: de circuit ou l'identifiant distant est normalement fourni sous la forme d'une
! 1126: chaîne de valeurs hexadécimales séparées par des ":", mais il est également
! 1127: possible qu'elle le soit sous la forme d'une simple chaîne de caractères. Si
! 1128: l'identifiant de circuit ou d'agent correspond exactement à celui fourni par le
! 1129: relais DHCP, alors le label est apposé.
! 1130: .B dhcp-remoteid
! 1131: est supporté en IPv6 (mais non dhcp-circuitid).
! 1132: .TP
! 1133: .B --dhcp-subscrid=set:<label>,<identifiant d'abonné>
! 1134: (IPv4 et IPv6) Associe des options de relais DHCP issues de la RFC3993 à des
! 1135: labels.
! 1136: .TP
! 1137: .B --dhcp-proxy[=<adresse ip>]......
! 1138: (IPv4 seulement) Un agent relai DHCP normal est uniquement utilisé pour faire
! 1139: suivre les éléments initiaux de l'interaction avec le serveur DHCP. Une fois
! 1140: que le client est configuré, il communique directement avec le serveur. Cela
! 1141: n'est pas souhaitable si le relais rajoute des informations supplémentaires
! 1142: aux paquets DHCP, telles que celles utilisées dans
! 1143: .B dhcp-circuitid
! 1144: et
! 1145: .B dhcp-remoteid.
! 1146: Une implémentation complète de relai peut utiliser l'option serverid-override
! 1147: de la RFC 5107 afin de forcer le serveur DHCP à utiliser le relai en temps que
! 1148: proxy complet, de sorte que tous les paquets passent par le relai. Cette option
! 1149: permet d'obtenir le même résultat pour des relais ne supportant pas la RFC
! 1150: 5107. Fournie seule, elle manipule la valeur de server-id pour toutes les
! 1151: interactions via des relais. Si une liste d'adresses IP est donnée, seules les
! 1152: interactions avec les relais dont l'adresse est dans la liste seront affectées.
! 1153: .TP
! 1154: .B --dhcp-match=set:<label>,<numéro d'option>|option:<nom d'option>|vi-encap:<entreprise>[,<valeur>]
! 1155: Si aucune valeur n'est spécifiée, associe le label si le client
! 1156: envoie une option DHCP avec le numéro ou le nom spécifié. Lorsqu'une valeur est
! 1157: fournie, positionne le label seulement dans le cas où l'option est fournie et
! 1158: correspond à la valeur. La valeur peut-être de la forme "01:ff:*:02", auquel
! 1159: cas le début de l'option doit correspondre (en respectant les jokers). La
! 1160: valeur peut aussi être de la même forme que dans
! 1161: .B dhcp-option
! 1162: , auquel cas l'option est traitée comme un tableau de valeur, et un des
! 1163: éléments doit correspondre, ainsi
! 1164:
! 1165: --dhcp-match=set:efi-ia32,option:client-arch,6
! 1166:
! 1167: spécifie le label "efi-ia32" si le numéro 6 apparaît dnas la liste
! 1168: d'architectures envoyé par le client au sein de l'option 93. (se réferer
! 1169: au RFC 4578 pour plus de détails). Si la valeur est un chaine de caractères,
! 1170: celle-ci est recherchée (correspondance en temps que sous-chaîne).
! 1171:
! 1172: Pour la forme particulière vi-encap:<numéro d'entreprise>, la comparaison se
! 1173: fait avec les classes de vendeur "identifiant de vendeur" ("vendor-identifying
! 1174: vendor classes") pour l'entreprise dont le numéro est fourni en option.
! 1175: Veuillez vous réferer à la RFC 3925 pour plus de détail.
! 1176: .TP
! 1177: .B --tag-if=set:<label>[,set:<label>[,tag:<label>[,tag:<label>]]]
! 1178: Effectue une opération booléenne sur les labels. Si tous les labels
! 1179: apparaissant dans la liste tag:<label> sont positionnés, alors tous les
! 1180: la de la liste "set:<labels>" sont positionnés (ou supprimés, dans le cas
! 1181: où "tag:!<label>" utilisé).
! 1182: Si aucun tag:<label> n'est spécifié, alors tous les labels fournis par
! 1183: set:<label> sont positionnés.
! 1184: N'importe quel nombre de set: ou tag: peuvent être fournis, et l'ordre est sans
! 1185: importance.
! 1186: Les lignes tag-if sont executées dans l'ordre, ce qui fait que si un label dans
! 1187: tag:<label> est un label positionné par une rêgle
! 1188: .B tag-if,
! 1189: la ligne qui positionne le label doit précéder celle qui le teste.
! 1190: .TP
! 1191: .B \-J, --dhcp-ignore=tag:<label>[,tag:<label>]
! 1192: Lorsque tous les labels fournis dans l'option sont présents, ignorer l'hôte et
! 1193: ne pas donner de bail DHCP.
! 1194: .TP
! 1195: .B --dhcp-ignore-names[=tag:<label>[,tag:<label>]]
! 1196: Lorsque tous les labels fournis dans l'option sont présents, ignorer le
! 1197: nom de machine fourni par l'hôte. Il est à noter que, à la différence de
! 1198: l'option "dhcp-ignore", il est permis de ne pas fournir de label.
! 1199: Dans ce cas, les noms d'hôtes fournis par les clients DHCP seront toujours
! 1200: ignorés, et les noms d'hôtes seront ajoutés au DNS en utilisant uniquement la
! 1201: configuration dhcp-host de Dnsmasq, ainsi que le contenu des fichiers /etc/hosts
! 1202: et /etc/ethers.
! 1203: .TP
! 1204: .B --dhcp-generate-names=tag:<label>[,tag:<label>]
! 1205: (IPv4 seulement) Générer un nom pour les clients DHCP qui autrement n'en aurait
! 1206: pas, en utilisant l'adresse MAC sous sa forme hexadécimale, séparée par des
! 1207: tirets.
! 1208: Noter que si un hôte fourni un nom, celui-ci sera utilisé de préférence au nom
! 1209: autogénéré, à moins que
! 1210: .B --dhcp-ignore-names
! 1211: ne soit positionné.
! 1212: .TP
! 1213: .B --dhcp-broadcast=[tag:<label>[,tag:<label>]]
! 1214: (IPv4 seulement) Lorsque tous les labels fournis dans l'option sont présents,
! 1215: toujours utiliser le broadcast pour communiquer avec l'hôte lorsque celui-ci
! 1216: n'est pas configuré. Il est possible de ne spécifier aucun label, auquel cas
! 1217: cette option s'applique inconditionnellement. La plupart des clients DHCP
! 1218: nécessitant une réponse par le biais d'un broadcast activent une option dans
! 1219: leur requête, ce qui fait que cela se fait automatiquement, mais ce n'est pas
! 1220: le cas de certains vieux clients BOOTP.
! 1221: .TP
! 1222: .B \-M, --dhcp-boot=[tag:<label>,]<nom de fichier>,[<nom de serveur>[,<adresse de serveur>|<nom du serveur tftp>]]
! 1223: (IPv4 seulement) Spécifie les options BOOTP devant être retournées par le
! 1224: serveur DHCP. Le nom de serveur ainsi que l'adresse sont optionnels : s'ils
! 1225: ne sont pas fournis, le nom est laissé vide et l'adresse fournie est celle de
! 1226: la machine sur laquelle s'exécute Dnsmasq. Si Dnsmasq founit un service TFTP (voir
! 1227: .B --enable-tftp
! 1228: ), alors seul un nom de fichier est requis ici pour permettre un démarrage par
! 1229: le réseau.
! 1230: Si d'éventuels labels sont fournis, ils doivent coïncider avec
! 1231: ceux du client pour que cet élement de configuration lui soit envoyé.
! 1232: Une adresse de serveur TFTP peut être spécifiée à la place de l'adresse IP,
! 1233: sous la forme d'un nom de domaine qui sera cherché dans le fichier /etc/hosts.
! 1234: Ce nom peut être associé dans /etc/hosts avec plusieurs adresses IP, auquel cas
! 1235: celles-ci seront utilisées tour à tour (algorithme round-robin).
! 1236: Cela peut-être utiliser pour équilibrer la charge tftp sur plusieurs serveurs.
! 1237: .TP
! 1238: .B --dhcp-sequential-ip
! 1239: Dnsmasq est conçu pour choisir l'adresse IP des clients DHCP en utilisant
! 1240: un hachage de l'adresse MAC du client. Cela permet en général à l'adresse
! 1241: IP du client de rester stable au fil du temps, même lorsque le client laisse
! 1242: expirer son bail DHCP de temps en temps. Dans ce mode de fonctionnement par
! 1243: défaut, les adresses IP sont distribuées de façon pseudo-aléatoire dans la
! 1244: totalité de la plage d'adresses utilisable. Il existe des circonstances (par
! 1245: exemples pour du déploiement de serveur) où il est plus pratique d'allouer les
! 1246: adresses IP de manière séquentielle, en commençant par la plus petite adresse
! 1247: disponible, et c'est ce mode de fonctionnement qui est permis par cette option.
! 1248: Veuillez noter que dans ce mode séquentiel, les clients qui laissent expirer
! 1249: leur bail ont beaucoup plus de chance de voir leur adresse IP changer, aussi
! 1250: cette option ne devrait pas être utilisée dans un cas général.
! 1251: .TP
! 1252: .B --pxe-service=[tag:<label>,]<CSA>,<entrée de menu>[,<nom de fichier>|<type de service de démarrage>][,<adresse de serveur>|<nom de serveur>]
! 1253: La plupart des ROMS de démarrage PXE ne permettent au système PXE que la simple
! 1254: obtention d'une adresse IP, le téléchargement du fichier spécifié dans
! 1255: .B dhcp-boot
! 1256: et son exécution. Cependant, le système PXE est capable de fonctions bien plus
! 1257: complexes pour peu que le serveur DHCP soit adapté.
! 1258:
! 1259: Ceci spécifie l'option de démarrage qui apparaitra dans un menu de démarrage
! 1260: PXE. <CSA> est le type du système client. Seuls des types de services valides
! 1261: apparaitront dans un menu. Les types connus sont x86PC, PC98, IA64_EFI, Alpha,
! 1262: Arc_x86, Intel_Lean_Client, IA32_EFI, BC_EFI, Xscale_EFI et X86-64_EFI;
! 1263: D'autres types peuvent-être spécifiés sous la forme d'une valeur entière. Le
! 1264: paramètre après le texte correspondant à l'entrée dans le menu peut être un nom
! 1265: de fichier, auquel cas Dnsmasq agit comme un serveur de démarrage et indique au
! 1266: client PXE qu'il faut télécharger ce fichier via TFTP, soit depuis ce serveur
! 1267: (l'option
! 1268: .B enable-tftp
! 1269: doit être spécifiée pour que cela marche), soit depuis un autre serveur TFTP
! 1270: si une adresse ou un nom de serveur est fournie.
! 1271: Veuillez noter que le suffixe de "couche" (en principe ".0") est fourni par PXE
! 1272: et ne doit pas être rajouté au nom de fichier. Si une valeur numérique entière
! 1273: est fournir pour le type de démarrage, en remplacement du nom de fichier, le
! 1274: client PXE devra chercher un service de démarrage de ce type sur le réseau.
! 1275: Cette recherche peut être faite via broadcast ou directement auprès d'un
! 1276: serveur si son adresse IP ou son nom sont fournis dans l'option.
! 1277: Si aucun nom de fichier n'est donné ni aucune valeur de type de service de
! 1278: démarrage n'est fournie (ou qu'une valeur de 0 est donnée pour le type de
! 1279: service), alors l'entrée de menu provoque l'interruption du démarrage par
! 1280: le réseau et la poursuite du démarrage sur un média local. L'adresse de serveur
! 1281: peut être donnée sous la forme de nom de domaine qui est recherché dans
! 1282: /etc/hosts. Ce nom peut-être associé à plusieurs adresses IP, qui dans ce cas
! 1283: sont utilisées à tour de rôle (en "round-robin").
! 1284: .TP
! 1285: .B --pxe-prompt=[tag:<label>,]<invite>[,<délai>]
! 1286: Cette option permet d'afficher une invite à la suite du démarrage PXE. Si un
! 1287: délai est fourni, alors la première entrée du menu de démarrage sera
! 1288: automatiquement exécutée après ce délai. Si le délai vaut 0, alors la première
! 1289: entrée disponible sera exécutée immédiatement. Si
! 1290: .B pxe-prompt
! 1291: est omis, le système attendra un choix de l'utilisateur s'il existe plusieurs
! 1292: entrées dans le menu, ou démarrera immédiatement dans le cas où il n'y a qu'une
! 1293: seule entrée. Voir
! 1294: .B pxe-service
! 1295: pour plus de détails sur les entrées de menu.
! 1296:
! 1297: Dnsmasq peut servir de "proxy-DHCP" PXE, dans le cas où un autre serveur DHCP
! 1298: sur le réseau est responsable de l'allocation des adresses IP, auquel cas
! 1299: Dnsmasq se contente de fournir les informations données dans les options
! 1300: .B pxe-prompt
! 1301: et
! 1302: .B pxe-service
! 1303: pour permettre le démarrage par le réseau. Ce mode est activé en utilisant le
! 1304: mot-clef
! 1305: .B proxy
! 1306: dans
! 1307: .B dhcp-range.
! 1308: .TP
! 1309: .B \-X, --dhcp-lease-max=<nombre>
! 1310: Limite Dnsmasq à un maximum de <nombre> baux DHCP. Le défaut est de 1000. Cette
! 1311: limite permet d'éviter des attaques de déni de service ("DoS") par des hôtes
! 1312: créant des milliers de baux et utilisant beaucoup de mémoire dans le processus
! 1313: Dnsmasq.
! 1314: .TP
! 1315: .B \-K, --dhcp-authoritative
! 1316: Doit être spécifié lorsque dnsmasq est réellement le seul serveur DHCP
! 1317: sur le réseau. Pour DHCPv4, cela change le comportement par défaut qui est
! 1318: celui d'un strict respect des RFC, afin que les requêtes DHCP pour des baux
! 1319: inconnus par des hôtes inconnus ne soient pas ignorées. Cela permet à de
! 1320: nouveaux hôtes d'obtenir des baux sans tenir compte de fastidieuses
! 1321: temporisations ("timeout"). Cela permet également à Dnsmasq de reconstruire
! 1322: sa base de données contenant les baux sans que les clients n'aient besoin de
! 1323: redemander un bail, si celle-ci est perdue.
! 1324: Dans le cas de DHCPv6, cela positionne la priorité des réponses à 255 (le
! 1325: maximum) au lieu de 0 (le minimum).
! 1326: .TP
! 1327: .B --dhcp-alternate-port[=<port serveur>[,<port client>]]
! 1328: (IPv4 seulement) Change les ports utilisés par défaut pour le DHCP. Si cette
! 1329: option est donnée seule sans argument, alors change les ports utilisés pour le
! 1330: DHCP de 67 et 68 respectivement à 1067 et 1068. Si un seul argument est donné, ce
! 1331: numéro est utilisé pour le port serveur et ce numéro plus 1 est utilisé pour le
! 1332: port client. Enfin, en fournissant deux numéros de ports, il est possible de
! 1333: spécifier arbitrairement 2 ports à la fois pour le serveur et pour le client DHCP.
! 1334: .TP
! 1335: .B \-3, --bootp-dynamic[=<identifiant de réseau>[,<identifiant de réseau>]]
! 1336: (IPv4 seulement) Permet l'allocation dynamique d'adresses IP à des clients BOOTP.
! 1337: Utiliser cette option avec précaution, une adresse allouée à un client BOOTP
! 1338: étant perpétuelle, et de fait n'est plus disponibles pour d'autres hôtes. Si
! 1339: aucun argument n'est donné, alors cette option permet une allocation dynamique
! 1340: dans tous les cas. Si des arguments sont spécifiés, alors l'allocation ne se
! 1341: fait que lorsque tous les identifiants coïncident. Il est possible de répeter
! 1342: cette option avec plusieurs jeux d'arguments.
! 1343: .TP
! 1344: .B \-5, --no-ping
! 1345: (IPv4 seulement) Par défaut, le serveur DHCP tente de s'assurer qu'une adresse
! 1346: n'est pas utilisée avant de l'allouer à un hôte. Cela est fait en envoyant une
! 1347: requête ICMP de type "echo request" (aussi connue sous le nom de "ping") à
! 1348: l'adresse en question. Si le serveur obtient une réponse, alors l'adresse doit
! 1349: déjà être utilisée et une autre est essayée. Cette option permet de supprimer
! 1350: cette vérification. A utiliser avec précaution.
! 1351: .TP
! 1352: .B --log-dhcp
! 1353: Traces additionnelles pour le service DHCP : enregistre toutes les options
! 1354: envoyées aux clients DHCP et les labels utilisés pour la
! 1355: détermination de celles-ci.
! 1356: .TP
! 1357: .B \-l, --dhcp-leasefile=<chemin de fichier>
! 1358: Utilise le fichier dont le chemin est fourni pour stocker les informations de
! 1359: baux DHCP.
! 1360: .TP
! 1361: .B --dhcp-duid=<ID d'entreprise>,<uid>
! 1362: (IPv6 seulement) Spécifie le numéro d'UID de serveur persistant que le serveur
! 1363: DHCPv6 doit utiliser. Cette option n'est normalement pas requise, Dnsmasq
! 1364: créant un DUID automatiquement lorsque cela est nécessaire. Lorsque cette
! 1365: option est positionnée, elle fournit à Dnsmasq les données nécessaires à la
! 1366: création d'un DUID de type DUID-EN. Veuillez noter qu'une fois créé, le DUID
! 1367: est stocké dans la base des baux, aussi changer entre un DUID créé
! 1368: automatiquement et un DUID-EN et vice-versa impose de réinitialiser la base de
! 1369: baux. Le numéro d'ID d'entreprise est assigné par l'IANA, et l'uid est une
! 1370: chaine hexadécimale unique à chaque serveur.
! 1371: .TP
! 1372: .B \-6 --dhcp-script=<chemin de fichier>
! 1373: Lorsqu'un bail DHCP est créé, qu'un ancien est supprimé, ou qu'un transfert
! 1374: TFTP est terminé, le fichier dont le
! 1375: chemin est spécifié est exécuté. Le <chemin de fichier> doit être un chemin
! 1376: absolu, aucune recherche n'est effectuée via la variable d'environnement PATH.
! 1377: Les arguments fournis à celui-ci sont soit
! 1378: "add" ("ajouter"), "old" ("ancien") ou "del" ("supprimer"), suivi de l'adresse
! 1379: MAC de l'hôte (ou le DUID pour IPv6) puis l'adresse IP et le nom d'hôte si
! 1380: celui-ci est connu."add" signifie qu'un bail a été créé, "del" signifie qu'il a
! 1381: été supprimé, "old" notifie que le bail existait au lancement de Dnsmasq, ou un
! 1382: changement d'adresse MAC ou de nom d'hôte pour un bail existant (ou, dans le cas
! 1383: où leasefile-ro est spécifié, un changement de durée de bail ou d'identifiant
! 1384: d'hôte). Si l'adresse Mac est d'un type de réseau autre qu'ethernet, il est
! 1385: nécessaire de la préceder du type de réseau, par exemple "06-01:23:45:67:89:ab"
! 1386: pour du token ring. Le processus est exécuté en temps que super-utilisateur
! 1387: (si Dnsmasq a été lancé en temps que "root"), même si Dnsmasq est configuré
! 1388: pour changer son UID pour celle d'un utilisateur non-privilégié.
! 1389:
! 1390: L'environnement est hérité de celui de l'invocation du processus Dnsmasq,
! 1391: auquel se rajoute quelques unes ou toutes les variables décrites ci-dessous :
! 1392:
! 1393: Pour IPv4 et IPv6 :
! 1394:
! 1395: DNSMASQ_DOMAIN si le nom de domaine pleinement qualifié de l'hôte est connu, la
! 1396: part relative au domaine y est stockée. (Notez que le nom d'hôte transmis comme
! 1397: argument au script n'est jamais pleinement qualifié).
! 1398:
! 1399: Si le client fournit un nom d'hôte, DNSMASQ_SUPPLIED_HOSTNAME.
! 1400:
! 1401: Si le client fournit des classes d'utilisateur, DNSMASQ_USER_CLASS0 à
! 1402: DNSMASQ_USER_CLASSn.
! 1403:
! 1404: Si Dnsmasq a été compilé avec l'option HAVE_BROKEN_RTC ("horloge RTC
! 1405: défectueuse"), alors la durée du bail (en secondes) est stockée dans la
! 1406: variable DNSMASQ_LEASE_LENGTH, sinon la date d'expiration du bail est toujours
! 1407: stocké dans la variable d'environnement DNSMASQ_LEASE_EXPIRES. Le nombre de
! 1408: secondes avant expiration est toujours stocké dans DNSMASQ_TIME_REMAINING.
! 1409:
! 1410: Si un bail était associé à un nom d'hôte et
! 1411: que celui-ci est supprimé, un évênement de type "old" est généré avec le
! 1412: nouveau statut du bail, c-à-d sans nom d'hôte, et le nom initial est fourni
! 1413: dans la variable d'environnement DNSMASQ_OLD_HOSTNAME.
! 1414:
! 1415: La variable DNSMASQ_INTERFACE contient le nom de l'interface sur laquelle la
! 1416: requête est arrivée; ceci n'est pas renseigné dans le cas des actions "old"
! 1417: ayant lieu après un redémarrage de dnsmasq.
! 1418:
! 1419: La variable DNSMASQ_RELAY_ADDRESS est renseignée si le client a utilisé un
! 1420: relai DHCP pour contacter Dnsmasq, si l'adresse IP du relai est connue.
! 1421:
! 1422: DNSMASQ_TAGS contient tous les labels fournis pendant la transaction DHCP,
! 1423: séparés par des espaces.
! 1424:
! 1425: DNSMASQ_LOG_DHCP est positionné si
! 1426: .B --log-dhcp
! 1427: est activé.
! 1428:
! 1429: Pour IPv4 seulement :
! 1430:
! 1431: DNSMASQ_CLIENT_ID, si l'hôte a fourni un identifiant de client.
! 1432:
! 1433: DNSMASQ_CIRCUIT_ID, DNSMASQ_SUBSCRIBER_ID, DNSMASQ_REMOTE_ID si un relai DHCP a
! 1434: rajouté l'une de ces options.
! 1435:
! 1436: Si le client fournit une information de classe de vendeur, DNSMASQ_VENDOR_CLASS.
! 1437:
! 1438: Pour IPv6 seulement :
! 1439:
! 1440: Si le client fournit une classe de vendeur (vendor-class), positionne
! 1441: DNSMASQ_VENDOR_CLASS_ID avec comme contenu le numéro IANA de l'entreprise pour
! 1442: la classe, et DNSMASQ_VENDOR_CLASS0..DNSMASQ_VENDOR_CLASSn pour les données.
! 1443:
! 1444: DNSMASQ_SERVER_DUID contient le DUID du serveur : cette valeur est la même
! 1445: pour chaque appel au script.
! 1446:
! 1447: DNSMASQ_IAID contenant l'IAID pour le bail. Si le bail est une allocation
! 1448: temporaire, cela est préfixé par le caractère 'T'.
! 1449:
! 1450: A noter que le nom d'hôte fourni, la classe de vendeur ou les données de classe
! 1451: d'utilisateur sont uniquement fournies pour les actions "add" ou l'action "old"
! 1452: lorsqu'un hôte reprend un bail existant, puisque ces informations ne sont pas
! 1453: conservées dans la base de baux de dnsmasq.
! 1454:
! 1455: Tous les descripteurs de fichiers sont fermés, sauf stdin, stdout et stderr qui
! 1456: sont ouverts sur /dev/null (sauf en mode déverminage).
! 1457:
! 1458: Le script n'est pas lancé de manière concurrente : au plus une instance du
! 1459: script est executée à la fois (dnsmasq attends qu'une instance de script se
! 1460: termine avant de lancer la suivante). Les changements dans la base des baux
! 1461: nécessitant le lancement du script sont placé en attente dans une queue jusqu'à
! 1462: terminaison d'une instance du script en cours. Si cette mise en queue fait que
! 1463: plusieurs changements d'états apparaissent pour un bail donné avant que le
! 1464: script puisse être lancé, alors les états les plus anciens sont supprimés et
! 1465: lorsque le script sera finalement lancé, ce sera avec l'état courant du bail.
! 1466:
! 1467: Au démarrage de Dnsmasq, le script sera invoqué pour chacun des baux existants
! 1468: dans le fichier des baux. Le script sera lancé avec l'action "del" pour les
! 1469: baux expirés, et "old" pour les autres. Lorsque Dnsmasq reçoit un signal HUP,
! 1470: le script sera invoqué avec une action "old" pour tous les baux existants.
! 1471:
! 1472: Il existe deux autres actions pouvant apparaître comme argument au script :
! 1473: "init" et "tftp". D'autres sont susceptibles d'être rajoutées dans le futur,
! 1474: aussi les scripts devraient-être écrits de sorte à ignorer les actions
! 1475: inconnues. "init" est décrite ci-dessous dans
! 1476: .B --leasefile-ro.
! 1477: L'action "tftp" est invoquée lorsqu'un transfert de fichier TFTP s'est
! 1478: terminé. Ses arguments sont la taille du fichier en octets, l'adresse à
! 1479: laquelle le fichier a été envoyé, ainsi que le chemin complet du fichier.
! 1480:
! 1481: .TP
! 1482: .B --dhcp-luascript=<chemin>
! 1483: Spécifie un script écrit en Lua, devant être exécuté lorsque des baux sont
! 1484: créés, détruits ou modifiés. Pour utiliser cette option, dnsmasq doit être
! 1485: compilé avec avec le support de Lua. L'interpréteur Lua est initialisé une
! 1486: seule fois, lorsque dnsmasq démarre, ce qui fait que les variables globales
! 1487: persistent entre les évênements liés aux baux. Le code Lua doit définir une
! 1488: fonction
! 1489: .B lease
! 1490: et peut fournir des fonctions
! 1491: .B init
! 1492: et
! 1493: .B shutdown
! 1494: qui sont appellées, sans arguments, lorsque dnsmasq démarre ou s'arrête.
! 1495: Il peut également fournir une fonction
! 1496: .B tftp.
! 1497:
! 1498: La fonction
! 1499: .B lease
! 1500: reçoit les informations détaillées dans
! 1501: .B --dhcp-script.
! 1502: Il reçoit deux arguments. Le premier spécifie l'action, qui est une chaîne de
! 1503: caractères contenant les valeurs "add" (ajout), "old" (réactivation d'un bail
! 1504: existant) ou "del" (suppression). Le deuxième est une table contenant des
! 1505: paires de valeurs de labels. Les labels correspondent pour l'essentiel aux
! 1506: valeurs d'environnement détaillées ci-dessus, ainsi le label "domain" (domaine)
! 1507: contient les mêmes données que la variable d'environnement DNSMASQ_DOMAIN. Il
! 1508: existe quelques labels supplémentaires contenant les données fournies comme
! 1509: arguments à
! 1510: .B --dhcp-script.
! 1511: Ces labels sont
! 1512: .B mac_address, ip_address
! 1513: (pour respectivement l'adresse MAC et l'adresse IP)
! 1514: et
! 1515: .B hostname
! 1516: (le nom d'hôte) dans le cas d'IPv4, et
! 1517: .B client_duid, ip_address
! 1518: (valeur DUID du client et adresse IP respectivement)
! 1519: ainsi que
! 1520: .B hostname
! 1521: (le nom d'hôte) dans le cas d'IPv6.
! 1522:
! 1523: La fonction
! 1524: .B tftp
! 1525: est appelée de la même façon que la fonction "lease", et la table contient les
! 1526: labels
! 1527: .B destination_address,
! 1528: .B file_name
! 1529: et
! 1530: .B file_size
! 1531: (respectivement "adresse de destination", "nom de fichier" et "taille de fichier").
! 1532: .TP
! 1533: .B --dhcp-scriptuser
! 1534: Spécifie l'utilisateur sous lequel le script shell lease-change ou le script
! 1535: doivent être exécutés. La valeur par défaut correspond à l'utilisateur root
! 1536: mais peut-être changée par le biais de cette option.
! 1537: .TP
! 1538: .B \-9, --leasefile-ro
! 1539: Supprimer complètement l'usage du fichier servant de base de donnée pour les
! 1540: baux DHCP. Le fichier ne sera ni créé, ni lu, ni écrit. Change la façon dont le
! 1541: script de changement d'état de bail est lancé (si celui-ci est fourni par le
! 1542: biais de l'option
! 1543: .B --dhcp-script
! 1544: ), de sorte que la base de données de baux puisse
! 1545: être complètement gérée par le script sur un stockage externe. En addition aux
! 1546: actions décrites dans
! 1547: .B --dhcp-script,
! 1548: le script de changement d'état de bail est appellé une fois, au lancement de
! 1549: Dnsmasq, avec pour seul argument "init". Lorsqu'appellé de la sorte, le script
! 1550: doit fournir l'état de la base de baux, dans le format de fichier de baux de
! 1551: Dnsmasq, sur sa sortie standard (stdout) et retourner un code de retour de 0.
! 1552: Positionner cette option provoque également une invocation du script de
! 1553: changement d'état de bail à chaque changement de l'identifiant de client, de
! 1554: longueur de bail ou de date d'expiration.
! 1555: .TP
! 1556: .B --bridge-interface=<interface>,<alias>[,<alias>]
! 1557: Traiter les requêtes DHCP arrivant sur n'importe laquelle des interfaces <alias>
! 1558: comme si elles arrivaient de l'interface <interface>. Cette option est
! 1559: nécessaire lors de l'utilisation de pont ethernet "ancien mode" sur plate-forme
! 1560: BSD, puisque dans ce cas les paquets arrivent sur des interfaces "tap" n'ont
! 1561: pas d'adresse IP.
! 1562: .TP
! 1563: .B \-s, --domain=<domaine>[,<gamme d'adresses>[,local]]
! 1564: Spécifie le domaine du serveur DHCP. Le domaine peut être donné de manière
! 1565: inconditionnelle (sans spécifier de gamme d'adresses IP) ou pour des gammes
! 1566: d'adresses IP limitées. Cela a deux effets; tout d'abord, le
! 1567: serveur DHCP retourne le domaine à tous les hôtes le demandant, deuxièmement,
! 1568: cela spécifie le domaine valide pour les hôtes DHCP configurés. Le but de cela
! 1569: est de contraindre les noms d'hôte afin qu'aucun hôte sur le LAN ne puisse
! 1570: fournir via DHCP un nom tel que par exemple "microsoft.com" et capturer du
! 1571: trafic de manière illégitime. Si aucun nom de domaine n'est spécifié, alors
! 1572: les noms d'hôtes avec un nom de domaine (c-à-d un point dans le nom) seront
! 1573: interdits et enregistrés dans le journal (logs). Si un suffixe est fourni, alors
! 1574: les noms d'hôtes possédant un domaine sont autorisés, pour peu que le nom de
! 1575: domaine coïncide avec le nom fourni. De plus, si un suffixe est fourni, alors
! 1576: les noms d'hôtes ne possédant pas de nom de domain se voient rajouter le
! 1577: suffixe fourni dans l'option
! 1578: .B --domain.
! 1579: Ainsi, sur mon réseau, je peux configurer
! 1580: .B --domain=thekelleys.org.uk
! 1581: et avoir une machine dont le nom DHCP serait "laptop". L'adresse IP de cette
! 1582: machine sera disponible à la fois pour "laptop" et "laptop.thekelleys.org.uk".
! 1583: Si la valeur fournie pour <domaine> est "#", alors le nom de domaine est
! 1584: positionné à la première valeur de la directive "search" du fichier
! 1585: /etc/resolv.conf (ou équivalent).
! 1586:
! 1587: La gamme d'adresses peut être de la forme
! 1588: <adresse ip>,<adresse ip> ou <adresse ip>/<masque de réseau> voire une simple
! 1589: <adresse ip>. Voir
! 1590: .B --dhcp-fqdn
! 1591: qui peut changer le comportement de dnsmasq relatif aux domaines.
! 1592:
! 1593: Si la gamme d'adresse est fournie sous la forme
! 1594: <adresse ip>/<taille de réseau>, alors le drapeau "local" peut-être rajouté
! 1595: qui a pour effect d'ajouter --local-declarations aux requêtes DNS directes et
! 1596: inverses. C-à-d
! 1597: .B --domain=thekelleys.org.uk,192.168.0.0/24,local
! 1598: est identique à
! 1599: .B --domain=thekelleys.org.uk,192.168.0.0/24
! 1600: --local=/thekelleys.org.uk/ --local=/0.168.192.in-addr.arpa/
! 1601: La taille de réseau doit-être de 8, 16 ou 24 pour être valide.
! 1602: .TP
! 1603: .B --dhcp-fqdn
! 1604: Dans le mode par défaut, dnsmasq insère les noms non-qualifiés des clients
! 1605: DHCP dans le DNS. Pour cette raison, les noms doivent être uniques, même si
! 1606: deux clients ayant le même nom sont dans deux domaines différents. Si un
! 1607: deuxième client DHCP apparaît ayant le même nom qu'un client déjà existant,
! 1608: ce nom est transféré au nouveau client. Si
! 1609: .B --dhcp-fqdn
! 1610: est spécifié, ce comportement change : les noms non qualifiés ne sont plus
! 1611: rajoutés dans le DNS, seuls les noms qualifiés le sont. Deux clients DHCP
! 1612: avec le même nom peuvent tous les deux garder le nom, pour peu que la partie
! 1613: relative au domaine soit différente (c-à-d que les noms pleinements qualifiés
! 1614: diffèrent). Pour d'assurer que tous les noms ont une partie domaine, il doit-y
! 1615: avoir au moins un
! 1616: .B --domain
! 1617: sans gamme d'adresses de spécifié lorsque l'option
! 1618: .B --dhcp-fqdn
! 1619: est configurée.
! 1620: .TP
! 1621: .B --dhcp-client-update
! 1622: Normalement, lorsque dnsmasq fournit un bail DHCP, il positionne un label
! 1623: dans l'option FQDN pour indiquer au client qu'il ne doit pas tenter de faire
! 1624: une mise à jour DDNS avec son nom et son adresse IP. Ceci parce que la paire
! 1625: Nom-IP est rajoutée automatiquement dans la partie DNS de dnsmasq. Cette option
! 1626: inhibe ce comportement ce qui est utile, par exemple, pour permettre aux clients
! 1627: Windows de la mise à jour de serveurs Active Directory. Voir la RFC 4702 pour
! 1628: plus de détails.
! 1629: .TP
! 1630: .B --enable-ra
! 1631: Active la fonctionalité d'annonces routeurs IPv6 ("IPv6 Router Advertisement").
! 1632: DHCPv6 ne gère pas la configuration complète du réseau de la même façon que
! 1633: DHCPv4. La découverte de routeurs et la découverte (éventuelle) de préfixes pour
! 1634: la création autonome d'adresse sont gérées par un protocole différent.
! 1635: Lorsque DHCP est utilisé, seul un sous-ensemble de tout ceci est nécessaire et
! 1636: dnsmasq est à même de le gérer, en utilisant la configuration DHCP présente pour
! 1637: fournir la majorité des données. Lorsque les annonces routeurs (RA pour "Router
! 1638: Advertisement") sont activées, dnsmasq va annoncer un préfixe pour chaque
! 1639: dhcp-range et, par défaut, fournir comme valeur de routeur et de DNS récursif
! 1640: la valeur d'adresse link-local appropriée parmi celles de la machine sur
! 1641: laquelle tourne dnsmasq.
! 1642: Par défaut, les bits "managed address" sont positionnés, et le bit "use SLAAC"
! 1643: ("utiliser SLAAC") est réinitialisé. Cela peut-être changé pour des
! 1644: sous-réseaux donnés par le biais du mot clef de mode décris dans
! 1645: .B --dhcp-range.
! 1646: Les paramètres DNS du RFC6106 sont inclus dans les annonces. Par défaut,
! 1647: l'adresse link-local appropriée parmi celles de la machine sur laquelle tourne
! 1648: dnsmasq est spécifiée comme DNS récursif. Si elles sont fournies, les
! 1649: options dns-server et domain-search sont utilisées respectivement pour RDNSS et
! 1650: DNSSL.
! 1651: .TP
! 1652: .B --enable-tftp
! 1653: Active la fonction serveur TFTP. Celui-ci est de manière délibérée limité aux
! 1654: fonctions nécessaires au démarrage par le réseau ("net-boot") d'un client. Seul
! 1655: un accès en lecture est possible; les extensions tsize et blksize sont supportées
! 1656: (tsize est seulement supporté en mode octet).
! 1657: .TP
! 1658: .B --tftp-root=<répertoire>[,<interface>]
! 1659: Les fichiers à fournir dans les transferts TFTP seront cherchés en prenant le
! 1660: répertoire fourni comme racine. Lorsque cela est fourni, les chemins TFTP
! 1661: incluant ".." sont rejetés, afin d'éviter que les clients ne puissent sortir de
! 1662: la racine spécifiée. Les chemins absolus (commençant par "/") sont autorisés,
! 1663: mais ils doivent être à la racine TFTP fournie. Si l'option interface est
! 1664: spécifiée, le répertoire n'est utilisé que pour les requêtes TFTP reçues sur
! 1665: cette interface.
! 1666: .TP
! 1667: .B --tftp-unique-root
! 1668: Ajouter l'adresse IP du client TFTP en temps qu'élément de chemin, à la suite
! 1669: de la racine tftp (adresse sous forme de 4 chiffres séparés par des points).
! 1670: Uniquement valable si une racine TFTP est spécifiée et si le répertoire
! 1671: correspond existe. Ainsi, si la valeur pour tftp-root est "/tftp" et que le
! 1672: client d'adresse IP 1.2.3.4 requiert le fichier "monfichier", alors le chemin
! 1673: effective résultant sera "/tftp/1.2.3.4/monfichier" si /tftp/1.2.3.4 existe, ou
! 1674: "/tftp/monfichier" dans le cas contraire.
! 1675: .TP
! 1676: .B --tftp-secure
! 1677: Active le mode TFTP sécurisé : sans cela, tout fichier lisible
! 1678: par Dnsmasq est disponible via TFTP (les règles de contrôle d'accès unix
! 1679: habituelles s'appliquent). Lorsque l'option
! 1680: .B --tftp-secure
! 1681: est spécifiée, seuls les fichiers possédés par l'utilisateur sous lequel tourne
! 1682: le processus Dnsmasq sont accessibles. Si Dnsmasq est exécuté en temps que
! 1683: super-utilisateur ("root"), des règles différentes s'appliquent :
! 1684: .B --tftp-secure
! 1685: n'a aucun effet, mais seuls les fichiers ayant un droit de lecture pour tout le
! 1686: monde sont accessibles. Il n'est pas recommandé d'exécuter Dnsmasq sous
! 1687: l'utilisateur "root" lorsque le service TFTP est activé, et il est formellement
! 1688: déconseillé de le faire sans fournir l'option
! 1689: .B --tftp-root.
! 1690: Sans cela, en effet, l'accès de tous les fichiers du serveur pour lequel le
! 1691: droit de lecture pour tout le monde est positionné ("world-readable") devient
! 1692: possible par n'importe quel hôte sur le réseau.
! 1693: .TP
! 1694: .B --tftp-lowercase
! 1695: Converti les noms de fichiers des requêtes TFTP en minuscules. Cela est utile
! 1696: pour les requêtes effectuées depuis les machines Windows, dont les systèmes
! 1697: de fichiers sont insensibles à la casse et pour lesquels la détermination
! 1698: de la casse est parfois un peu aléatoire. A noter que le serveur tftp de
! 1699: dnsmasq converti systématiquement les "\\" en "/" dans les noms de fichiers.
! 1700: .TP
! 1701: .B --tftp-max=<connexions>
! 1702: Définit le nombre maximum de connexions TFTP simultanées autorisées. La valeur
! 1703: par défaut est de 50. Lorsqu'un grand nombre de connexions TFTP est spécifié,
! 1704: il se peut que la limite de nombre de descripteurs de fichiers par processus
! 1705: soit atteinte. Dnsmasq nécessite quelques descripteurs de fichiers, ainsi qu'un
! 1706: descripteur de fichier pour chaque connexion TFTP simultanée et pour chacun des
! 1707: fichiers devant être fournis. De fait, servir le même fichier à n clients ne
! 1708: nécessitera qu'environ n + 10 descripteurs de fichiers, alors que fournir des
! 1709: fichiers tous différents à n clients utilisera environ (2*n) + 10 descripteurs.
! 1710: Si elle est donnée, l'option
! 1711: .B --tftp-port-range
! 1712: peut affecter le nombre maximum de connexions concurrentes.
! 1713: .TP
! 1714: .B --tftp-no-blocksize
! 1715: Empêche le serveur TFTP de négocier l'option "blocksize" (taille de bloc) avec
! 1716: les clients. Certains clients buggés spécifient cette option mais se comportent
! 1717: ensuite de manière incorrecte si celle-ci est accordée.
! 1718: .TP
! 1719: .B --tftp-port-range=<début>,<fin>
! 1720: Un serveur TFTP écoute sur le port prédéfini 69 ("well-known port") pour
! 1721: l'initiation de la connexion, mais utilise également un port dynamiquement
! 1722: alloué pour chaque connexion. Normalement, ces ports sont alloués par
! 1723: le système d'exploitation, mais cette option permet de spécifier une gamme
! 1724: de ports à utiliser pour les transferts TFTP. Cela peut-être utile si
! 1725: TFTP doit traverser un dispositif garde-barrière ("firewall"). La valeur
! 1726: de début pour la plage de port ne peut-être inférieure à 1025 sauf si
! 1727: dnsmasq tourne en temps que super-utilisateur ("root"). Le nombre de
! 1728: connexions TFTP concurrentes est limitée par la taille de la gamme de
! 1729: ports ainsi spécifiée.
! 1730: .TP
! 1731: .B --tftp-port-range=<début>,<fin>
! 1732: Un serveur TFTP écoute sur un numéro de port bien connu (69) pour l'initiation
! 1733: de la connexion, et alloue dynamiquement un port pour chaque connexion. Ces
! 1734: numéros de ports sont en principe alloués par le système d'exploitation, mais
! 1735: cette option permet de spécifier une gamme de ports à utiliser pour les
! 1736: transferts TFTP. Cela peut-être utile lorsque ceux-ci doivent traverser un
! 1737: dispositif garde-barrière ("firewall"). Le début de la plage ne peut-être
! 1738: inférieur à 1024 à moins que Dnsmasq ne fonctionne en temps que
! 1739: super-utilisateur ("root"). Le nombre maximal de connexions TFTP concurrentes
! 1740: est limitée par la taille de la plage de ports ainsi définie.
! 1741: .TP
! 1742: .B \-C, --conf-file=<fichier>
! 1743: Spécifie un fichier de configuration différent. L'option "conf-file" est
! 1744: également autorisée dans des fichiers de configuration, ce qui permet
! 1745: l'inclusion de multiples fichiers de configuration. L'utilisation de "-" comme
! 1746: nom de fichier permet la lecture par dnsmasq de sa configuration sur l'entrée standard
! 1747: stdin.
! 1748: .TP
! 1749: .B \-7, --conf-dir=<répertoire>[,<extension de fichier>...]
! 1750: Lis tous les fichiers du répertoire spécifié et les traite comme des fichiers de
! 1751: configuration. Si des extensions sont données, tout fichier finissant par ces
! 1752: extensions seront ignorés. Tout fichier dont le nom se termine en ~ ou commence
! 1753: par ., ainsi que ceux commençant ou se terminant par # seront systématiquement
! 1754: ignorés.
! 1755: Cette option peut être donnée en ligne de commande ou dans un fichier de
! 1756: configuration.
! 1757: .SH FICHIER DE CONFIGURATION
! 1758: Au démarrage, Dnsmasq lis
! 1759: .I /etc/dnsmasq.conf,
! 1760: si ce fichier existe. (Sur FreeBSD, ce fichier est
! 1761: .I /usr/local/etc/dnsmasq.conf
! 1762: ) (voir cependant les options
! 1763: .B \-C
! 1764: et
! 1765: .B \-7
! 1766: ). Le format de ce fichier consiste en une option par ligne, exactement comme
! 1767: les options longues détaillées dans la section OPTIONS, mais sans être précédées
! 1768: par "--". Les lignes commençant par # sont des commentaires et sont ignorées.
! 1769: Pour les options qui ne peuvent-être spécifiées qu'une seule fois, celle du
! 1770: fichier de configuration prends le pas sur celle fournie en ligne de commande.
! 1771: Il est possible d'utiliser des guillemets afin d'éviter que les ",",":","." et
! 1772: "#" ne soit interprêtés, et il est possible d'utiliser les séquences
! 1773: d'échappement suivantes : \\\\ \\" \\t \\e \\b \\r et \\n. Elles correspondent
! 1774: respectivement à la barre oblique descendante ("anti-slash"), guillemets doubles,
! 1775: tabulation, caractère d'échappement ("escape"), suppression ("backspace"), retour ("return") et
! 1776: nouvelle ligne ("newline").
! 1777: .SH NOTES
! 1778: A la réception d'un signal SIGHUP,
! 1779: .B Dnsmasq
! 1780: vide son cache et recharge les fichiers
! 1781: .I /etc/hosts
! 1782: et
! 1783: .I /etc/ethers
! 1784: ainsi que tout autre fichier spécifié par les options
! 1785: .B --dhcp-hostsfile
! 1786: ,
! 1787: .B --dhcp-optsfile
! 1788: ou
! 1789: .B --addn-hosts.
! 1790: Le script de changement de bail est appellé pour chaque bail DHCP existant. Si
! 1791: l'option
! 1792: .B --no-poll
! 1793: est positionnée, alors le fichier
! 1794: .I /etc/resolv.conf
! 1795: est également rechargé.
! 1796: SIGHUP ne provoque PAS de rechargement du fichier de configuration.
! 1797: .PP
! 1798: A la réception d'un signal SIGUSR1,
! 1799: .B Dnsmasq
! 1800: écrit des statistiques dans les traces système. Les informations fournies sont :
! 1801: la taille du cache, le nombre de noms ayant été supprimés du cache avant
! 1802: expiration afin de faire de la place pour les nouveaux noms, ainsi que le nombre
! 1803: total d'entrées ayant été insérées dans le cache. Pour chaque serveur amont, il fournit
! 1804: le nomnbre de requêtes transmises ainsi que le nombre de requêtes ayant résulté par une
! 1805: erreur. Lorsque Dnsmasq a été lancé via
! 1806: .B --no-daemon
! 1807: ou lorsque la traçabilité maximale a été activée (
! 1808: .B -q
! 1809: ), la totalité du contenu du
! 1810: cache est de surcroît fournie.
! 1811: .PP
! 1812: A la réception d'un signal SIGUSR2 et lorsqu'il enregistre directement ses
! 1813: traces dans un fichier (voir
! 1814: .B --log-facility
! 1815: ), alors
! 1816: .B Dnsmasq
! 1817: ferme et re-rouvre le fichier de traces. Il faut noter que pendant cette
! 1818: opération Dnsmasq ne s'exécute pas en temps que "root". Lorsqu'il créé un
! 1819: fichier de traces pour la première fois, Dnsmasq change le propriétaire du
! 1820: fichier afin de le faire appartenir à l'utilisateur non "root" sous lequel
! 1821: Dnsmasq s'exécute. Le logiciel de rotation de fichiers de trace logrotate doit
! 1822: être configuré pour créer un nouveau fichier avec un propriétaire identique au
! 1823: fichier existant avant d'envoyer le signal SIGUSR2. Si une requête DNS TCP est
! 1824: en cours, l'ancien fichier de traces reste ouvert dans le processus fils qui
! 1825: traite la requête TCP et il peut y être écrit. Il existe cependant une limite
! 1826: de 150 secondes après laquelle tous les processus traitant des requêtes TCP
! 1827: expirent : pour cette raison, il est préférable de ne pas configurer la
! 1828: compression des fichiers de traces venant juste de faire l'objet d'une rotation.
! 1829: Dans le cas de l'utilisation du logiciel logrotate, les options requises sont
! 1830: .B create
! 1831: et
! 1832: .B delaycompress.
! 1833:
! 1834: .PP
! 1835: Dnsmasq est un logiciel de transmission de requêtes DNS : il n'est pas capable
! 1836: d'effectuer une résolution de nom récursive en partant des serveurs DNS racine,
! 1837: mais transmet de telles requêtes à un serveur DNS amont capable de telles
! 1838: recherches récursives, ce qui est typiquement le cas d'un serveur DNS de FAI.
! 1839: Par défaut, Dnsmasq lis
! 1840: .I /etc/resolv.conf
! 1841: pour découvrir les adresses IP des serveurs DNS amonts à utiliser, puisque cette
! 1842: information est en général stockée à cet endroit. A moins que l'option
! 1843: .B --no-poll
! 1844: ne soit utilisée,
! 1845: .B Dnsmasq
! 1846: vérifie la date de modification du fichier
! 1847: .I /etc/resolv.conf
! 1848: (ou l'équivalent si
! 1849: .B \--resolv-file
! 1850: est utilisé), et le relis lorsqu'il change. Cela permet de définir les serveurs
! 1851: DNS amont de manière dynamique lorsque PPP ou DHCP sont utilisés, puisque ces
! 1852: protocoles fournissent cette information.
! 1853: L'absence du fichier
! 1854: .I /etc/resolv.conf
! 1855: ne conduit pas à une erreur, puisqu'il peut très bien ne pas être créé avant
! 1856: qu'une connexion PPP ne soit établie. Dans ce cas, Dnsmasq vérifie régulièrement
! 1857: pour voir si un fichier
! 1858: .I /etc/resolv.conf
! 1859: est créé. Dnsmasq peut être configuré pour lire plus d'un fichier resolv.conf.
! 1860: Cela est utile sur un ordinateur portable où PPP et DHCP peuvent-être utilisés :
! 1861: Dnsmasq peut alors être configuré pour lire à la fois
! 1862: .I /etc/ppp/resolv.conf
! 1863: et
! 1864: .I /etc/dhcpc/resolv.conf
! 1865: et utilisera le contenu du fichier ayant changé en dernier, ce qui permet de
! 1866: passer automatiquement de serveurs DNS à d'autres.
! 1867: .PP
! 1868: Les serveurs amonts peuvent aussi être spécifiés sur la ligne de commande ou
! 1869: dans un fichier de configuration. Ces spécifications de serveurs peuvent
! 1870: éventuellement se voir adjoindre d'un nom de domaine qui précise à Dnsmasq quel
! 1871: serveur utiliser pour trouver les noms d'un domaine donné.
! 1872: .PP
! 1873: Pour configurer Dnsmasq afin qu'il se comporte comme un cache pour la machine
! 1874: sur laquelle il tourne, mettre "nameserver 127.0.0.1" dans le fichier
! 1875: .I /etc/resolv.conf
! 1876: afin de forcer les processus locaux à envoyer leurs requêtes à Dnsmasq. Ensuite,
! 1877: spécifier les serveurs DNS amont soit en les fournissant directement à Dnsmasq
! 1878: via l'option
! 1879: .B \--server
! 1880: ou alors en mettant leurs adresses dans un autre fichier, par exemple
! 1881: .I /etc/resolv.dnsmasq
! 1882: et en lançant Dnsmasq avec l'option
! 1883: .B \-r /etc/resolv.dnsmasq.
! 1884: Cette deuxième technique permet la mise-à-jour dynamique des addresses de
! 1885: serveurs DNS amont par le biais de PPP ou DHCP.
! 1886: .PP
! 1887: Les adresses dans /etc/hosts prennent le dessus sur celles fournies par le
! 1888: serveur DNS amont, ainsi "macompagnie.com 1.2.3.4" dans /etc/hosts assure que
! 1889: les requêtes pour "macompagnie.com" retourneront toujours 1.2.3.4, même si une
! 1890: requête au serveur DNS amont retournerait une adresse différente. Il y a une
! 1891: exception à ceci : si le DNS amont contient un CNAME qui pointe vers un nom
! 1892: présent dans /etc/hosts, alors la recherche du CNAME via Dnsmasq fournira
! 1893: l'adresse DNS amont. Pour contourner cela, il suffit de mettre l'entrée
! 1894: correspondant au CNAME dans /etc/hosts.
! 1895: .PP
! 1896: le système de label fonctionne comme suit : pour chaque requête DHCP, dnsmasq
! 1897: associe un ensemble de labels obtenus à partir des lignes de la configuration
! 1898: incluant set:<label>, y compris un pour la plage d'adresse (
! 1899: .B dhcp-range
! 1900: ) utilisée pour allouer l'adresse, un pour chaque entrée
! 1901: .B dhcp-host
! 1902: associée (auquel est rajouté le mot-clef "known" si une entrée dhcp-host
! 1903: coïncide).
! 1904:
! 1905: Le label "bootp" est associé aux requêtes BOOTP, un label dont le nom est le
! 1906: nom de l'interface sur laquelle la requête est arrivée.
! 1907:
! 1908: Pour les lignes de configuration comportant des éléments tag:<label>,
! 1909: seules seront valides celles pour lesquels tous les labels correspondants
! 1910: seront présents. C'est typiquement le cas des lignes dhcp-options.
! 1911: Un
! 1912: .B dhcp-option
! 1913: possédant des labels sera utilisé de préférence à un
! 1914: .B dhcp-option
! 1915: sans label, pour peu que _tous_ les labels positionnés correspondent à l'ensemble
! 1916: de labels décrit plus haut.
! 1917: Le préfixe '!' sur un label est un indicateur de négation, ainsi
! 1918: .B --dhcp=option=tag:!purple,3,1.2.3.4
! 1919: n'envoie l'option que lorsque le label "purple" n'est pas dans la liste de
! 1920: labels définis pour l'hôte considéré. (dans le cas de l'utilisation dans une
! 1921: ligne de commande au lieu d'un fichier de configuration, ne pas oublier
! 1922: d'échapper le caractère !, qui est un méta-caractère d'interpréteur de commande
! 1923: shell).
! 1924:
! 1925: Lors de la sélection d'une option, une étiquette spécifiée par dhcp-range
! 1926: passe après les autres étiquettes, ce qui permet de facilement remplacer des
! 1927: option génériques pour des hôtes spécifiques, ainsi :
! 1928: .B dhcp-range=set:interface1,......
! 1929: .B dhcp-host=set:monhote,.....
! 1930: .B dhcp-option=tag:interface1,option:nis-domain,"domaine1"
! 1931: .B dhcp-option=tag:monhote,option:nis-domain,"domaine2"
! 1932: va positionner l'option NIS-domain à domaine1 pour les hôtes dans la plage
! 1933: d'adresse, sauf pour monhote pour lequel cette valeur sera domaine2.
! 1934:
! 1935: .PP
! 1936: Veuillez noter que pour
! 1937: .B dhcp-range
! 1938: , les éléments tag:<label> et set:<label> sont tous les deux autorisés
! 1939: pour sélectionner la plage à utiliser selon, par exemple, le dhcp-host,
! 1940: et pour affecter l'option envoyée, sur la base de la plage sélectionnée.
! 1941:
! 1942: Ce système a évolué d'un système plus ancien et aux possibilités plus limitées,
! 1943: et pour des raisons de compatibilité "net:" peut être utilisé à la place de
! 1944: "tag:" et "set:" peut-être omis (à l'exception de
! 1945: .B dhcp-host,
! 1946: où "net:" peut-être utilisé à la place de "set:"). Pour les mêmes raisons, '#'
! 1947: peut-être utilisé à la place de '!' pour indiquer la négation.
! 1948: .PP
! 1949: Le serveur DHCP intégré dans Dnsmasq fonctionne également en temps que serveur
! 1950: BOOTP, pour peu que l'adresse MAC et l'adresse IP des clients soient fournies,
! 1951: que ce soit par le biais de l'option
! 1952: .B dhcp-host
! 1953: ou dans le fichier
! 1954: .I /etc/ethers
! 1955: , et que l'option
! 1956: .B dhcp-range
! 1957: soit présente afin d'activer le serveur DHCP pour un réseau donné (L'option
! 1958: .B --bootp-dynamic
! 1959: supprime la nécessité des associations statiques). Le paramètre
! 1960: "filename" (nom de fichier) de la requête BOOTP est utilisé comme label, ainsi
! 1961: que le label "bootp", permettant un certain contrôle sur les options retournées
! 1962: aux différentes classes d'hôtes.
! 1963:
! 1964:
! 1965: .SH CONFIGURATION EN TEMPS QUE SERVEUR FAISANT AUTORITÉ
! 1966: .PP
! 1967: Configurer dnsmasq pour agir en temps que serveur DNS faisant autorité est
! 1968: compliqué par le fait que cela implique la configuration de serveurs DNS
! 1969: externes pour mettre en place la délégation. Seront présentés ci-dessous trois
! 1970: scénarios de complexité croissante. Le pré-requis pour chacun de ces scénarios
! 1971: est l'existence d'une adresse IP globalement disponible, d'un enregistrement de
! 1972: type A ou AAAA pointant vers cette adresse, ainsi que d'un serveur DNS externe
! 1973: capable d'effectuer la délégation de la zone en question. Pour la première
! 1974: partie de ces explications, nous allons appeller serveur.exemple.com
! 1975: l'enregistrement A (ou AAAA) de l'adresse globalement accessible, et
! 1976: notre.zone.com la zone pour laquelle dnsmasq fait autorité.
! 1977:
! 1978: La configuration la plus simple consiste en deux lignes de configuration,
! 1979: sous la forme :
! 1980: .nf
! 1981: .B auth-server=serveur.exemple.com,eth0
! 1982: .B auth-zone=notre.zone.com,1.2.3.0/24
! 1983: .fi
! 1984:
! 1985: ainsi que deux enregistrements dans le DNS externe :
! 1986:
! 1987: .nf
! 1988: serveur.exemple.com A 192.0.43.10
! 1989: notre.zone.com NS serveur.exemple.com
! 1990: .fi
! 1991:
! 1992: eth0 est l'interface réseau externe sur laquelle dnsmasq écoute, dont l'adresse
! 1993: IP (globalement accessible) est 192.0.43.10.
! 1994:
! 1995: A noter que l'adresse IP externe peut parfaitement être dynamique (par exemple
! 1996: attribuée par un FAI via DHCP ou PPP). Dans ce cas, l'enregistrement de type A
! 1997: doit être lié à cet enregistrement dynamique par l'une ou l'autre des techniques
! 1998: habituelles de système DNS dynamique.
! 1999:
! 2000: Un exemple plus complexe mais en pratique plus utile correspond au cas où
! 2001: l'adresse IP globalement accessible se trouve dans la zone pour laquelle
! 2002: dnsmasq fait autorité, le plus souvent à la racine. Dans ce cas nous avons :
! 2003:
! 2004: .nf
! 2005: .B auth-server=notre.zone.com,eth0
! 2006: .B auth-zone=notre.zone.com,1.2.3.0/24
! 2007: .fi
! 2008:
! 2009: .nf
! 2010: notre.zone.com A 1.2.3.4
! 2011: notre.zone.com NS our.zone.com
! 2012: .fi
! 2013:
! 2014: L'enregistrement A pour notre.zone.com est dorénavant un enregistrement "colle"
! 2015: qui résoud le problème de poule et d'oeuf consistant à trouver l'adresse IP
! 2016: du serveur de nom pour notre.zone.com lorsque l'enregistrement se trouve dans
! 2017: la zone en question. Il s'agit du seul rôle de cet enregistrement : comme dnsmasq
! 2018: fait désormais autorité pour notre.zone.com, il doit également fournir cet
! 2019: enregistrement. Si l'adresse externe est statique, cela peut-être réalisé par
! 2020: le biais d'une entrée dans
! 2021: .B /etc/hosts
! 2022: ou via un
! 2023: .B --host-record.
! 2024:
! 2025: .nf
! 2026: .B auth-server=notre.zone.com,eth0
! 2027: .B host-record=notre.zone.com,1.2.3.4
! 2028: .B auth-zone=notre.zone.com,1.2.3.0/24
! 2029: .fi
! 2030:
! 2031: Si l'adresse externe est dynamique, l'adresse associée à notre.zone.com doit
! 2032: être dérivée de l'interface correspondante. Cela peut être fait en utilisant
! 2033: .B interface-name
! 2034: Sous la forme :
! 2035:
! 2036: .nf
! 2037: .B auth-server=notre.zone.com,eth0
! 2038: .B interface-name=notre.zone.com,eth0
! 2039: .B auth-zone=notre.zone.com,1.2.3.0/24
! 2040: .fi
! 2041:
! 2042: La configuration finale rajoute à cette base un serveur DNS secondaire. Il
! 2043: s'agit d'un autre serveur DNS qui apprend les données DNS de la zone en
! 2044: effectuant un transfert de zone, et qui joue le rôle de serveur de secours
! 2045: au cas où le serveur principal devenait inaccessible. La configuration
! 2046: de ce serveur secondaire sort du cadre de cette page de manuel. Les éléments
! 2047: de configuration à rajouter dans dnsmasq sont les simples :
! 2048:
! 2049: .nf
! 2050: .B auth-sec-servers=secondaire.monfai.com
! 2051: .fi
! 2052:
! 2053: et
! 2054:
! 2055: .nf
! 2056: notre.zone.com NS secondaire.monfai.com
! 2057: .fi
! 2058:
! 2059: L'addition d'une option auth-sec-servers active les transferts de zone dans
! 2060: dnsmasq, ce qui permet au serveur secondaire de venir collecter les données
! 2061: DNS. Si vous souhaitez restreindre l'accès à ces données à des hôtes
! 2062: spécifiques, vous pouvez le faire via :
! 2063:
! 2064: .nf
! 2065: .B auth-peer=<adresse IP du serveur secondaire>
! 2066: .fi
! 2067:
! 2068: Dnsmasq joue le rôle de serveur faisant autorité pour les domaines in-addr.arpa
! 2069: et ipv6.arpa associés aux sous-réseaux définis dans la déclaration de zone
! 2070: auth-zone, ce qui fait que les requêtes DNS inversées (de l'adresse vers
! 2071: le nom) peuvent-simplement être configurées avec un enregistrement NS
! 2072: adéquat. Par exemple, comme nous définissons plus haut les adresses
! 2073: 1.2.3.0/24 :
! 2074: .nf
! 2075: 3.2.1.in-addr.arpa NS notre.zone.com
! 2076: .fi
! 2077:
! 2078: Veuillez noter que pour l'instant, les zones inverses ne sont pas
! 2079: disponibles dans les transferts de zone, donc il est inutile de configurer
! 2080: de serveur secondaire pour la résolution inverse.
! 2081:
! 2082: .PP
! 2083: Lorsque dnsmasq est configuré en temps que serveur faisant autorité,
! 2084: les données suivantes sont utilisées pour peupler la zone considérée :
! 2085: .PP
! 2086: .B --mx-host, --srv-host, --dns-rr, --txt-record, --naptr-record
! 2087: , pour autant que les noms des enregistrements se trouvent dans la zone en
! 2088: question.
! 2089: .PP
! 2090: .B --cname
! 2091: pour peu que le nom soit dans le domaine. Si la cible du CNAME n'est
! 2092: pas pleinement qualifiée, alors elle est qualifiée avec le nom de la
! 2093: zone pour laquelle le serveur fait autorité.
! 2094: .PP
! 2095: Les adresses IPv4 et IPv6 extraites de /etc/hosts (et
! 2096: .B --addn-hosts
! 2097: ) ainsi que les options
! 2098: .B --host-record
! 2099: fournissant des adresses situées dans l'un des sous-réseaux spécifiés dans
! 2100: .B --auth-zone.
! 2101: .PP
! 2102: Adresses spécifiées par
! 2103: .B --interface-name.
! 2104: Dans ce cas, l'adresse n'est pas limitée à l'un des sous-réseaux donné dans
! 2105: .B --auth-zone.
! 2106:
! 2107: .PP
! 2108: Les adresses de baux DHCP, si l'adresse est située dans l'un des sous-réseaux de
! 2109: .B --auth-zone
! 2110: OU dans une plage DHCP construite. Dans le mode par défaut, où le bail
! 2111: DHCP a un nom non qualifié, et éventuellement pour un nom qualifié construit
! 2112: via
! 2113: .B --domain
! 2114: , alors le nom dans la zone faisant autorité est construit à partir du nom
! 2115: non qualifié et du nom de domaine de la zone. Cela peut on non être égal
! 2116: celui fourni par
! 2117: .B --domain.
! 2118: Si l'option
! 2119: .B --dhcp-fqdn
! 2120: est fournie, alors les noms pleinemenet qualifiés associés aux baux DHCP
! 2121: sont utilisés, dès lors qu'ils correspondent au nom de domaine associé
! 2122: à la zone.
! 2123:
! 2124:
! 2125: .SH CODES DE SORTIE
! 2126: .PP
! 2127: 0 - Dnsmasq s'est correctement lancé en tâche de fond, ou alors s'est
! 2128: correctement terminé si le lancement en tâche de fond n'a pas été activé.
! 2129: .PP
! 2130: 1 - Un problème de configuration a été détecté.
! 2131: .PP
! 2132: 2 - Un problème est survenu avec un accès réseau (adresse déjà utilisée,
! 2133: tentative d'utiliser un port privilégié sans les permissions nécessaires).
! 2134: .PP
! 2135: 3 - Un problème est survenu avec une opération sur un système de fichier
! 2136: (fichier ou répertoire manquant, permissions).
! 2137: .PP
! 2138: 4 - Impossibilité d'allouer de la mémoire.
! 2139: .PP
! 2140: 5 - Autre problème.
! 2141: .PP
! 2142: 11 ou plus - un code de retour différent de 0 a été reçu lors de l'appel au
! 2143: processus "init" du script des bails. Le code de retour de Dnsmasq correspond
! 2144: au code de retour du script plus 10.
! 2145:
! 2146: .SH LIMITES
! 2147: Les valeurs par défaut pour les limites de ressources de Dnsmasq sont en général
! 2148: conservatrices et appropriées pour des utilisations embarquées sur des machines
! 2149: de type routeur ayant des processeurs lents et une mémoire limitée. Sur du
! 2150: matériel plus performant, il est possible d'augmenter les limites et de gérer
! 2151: plus de clients. Les remarques suivantes s'appliquent à Dnsmasq version 2.37 et
! 2152: ultérieur : les versions précédentes ne montaient pas en charge aussi bien.
! 2153:
! 2154: .PP
! 2155: Dnsmasq est capable de gérer le DNS et DHCP pour au moins un millier de clients.
! 2156: Pour cela, la durée des bail ne doit pas être très courte (moins d'une heure).
! 2157: La valeur de
! 2158: .B --dns-forward-max
! 2159: peut-être augmentée : commencer par la rendre égale au nombre de clients et
! 2160: l'augmenter si le DNS semble lent. Noter que la performance du DNS dépends
! 2161: également de la performance des serveurs amonts. La taille du cache DNS peut-
! 2162: être augmentée : la limite en dur est de 10000 entrées et la valeur par défaut
! 2163: (150) est très basse. Envoyer un signal SIGUSR1 à Dnsmasq le fait émettre des
! 2164: informations utiles pour paramétrer la taille de cache. Voir la section
! 2165: .B NOTES
! 2166: pour plus de détails.
! 2167: .PP
! 2168: Le serveur TFTP intégré est capable de plusieurs transferts de fichiers
! 2169: simultanés : La limite absolue est liée au nombre maximal de descripteurs de
! 2170: fichiers alloué à un processus et à la capacité de l'appel système select() à
! 2171: gérer un grand nombre de HANDLE de fichier. Si la limite est fixée trop haut par
! 2172: le biais de
! 2173: .B --tftp-max
! 2174: elle sera réduite et la limite actuelle sera enregistrée au démarrage. Il faut
! 2175: noter que plus de transferts sont possible lorsque le même fichier est transmis
! 2176: au lieu d'avoir un fichier différent pour chaque transfert.
! 2177:
! 2178: .PP
! 2179: Il est possible d'utiliser Dnsmasq pour bloquer la publicité sur la toile
! 2180: en associant des serveurs de publicité bien connus à l'adresse 127.0.0.1 ou
! 2181: 0.0.0.0 par le biais du fichier
! 2182: .B /etc/hosts
! 2183: ou d'un fichier d'hôte additionnel. Cette liste peut-être très longue, Dnsmasq
! 2184: ayant été testé avec succès avec un million de noms. Cette taille de fichier
! 2185: nécessite un processeur à 1 Ghz et environ 60 Mo de RAM.
! 2186:
! 2187: .SH INTERNATIONALISATION
! 2188: Dnsmasq peut être compilé pour supporter l'internationalisation. Pour cela,
! 2189: les cibles "all-i18n" et "install-i18n" doivent être données à make, en lieu
! 2190: et place des cibles standards "all" et "install". Lorsque compilé avec le
! 2191: support de l'internationalisation, dnsmasq supporte les noms de domaines
! 2192: internationalisés ("internationalised domain names" ou IDN), et les messages de
! 2193: traces ("logs") sont écrits dans la langue locale. Les noms de domaines dans
! 2194: /etc/hosts, /etc/ethers et /etc/dnsmasq.conf contenant des caractères
! 2195: non-ASCII seront transformés selon la représentation punycode interne
! 2196: aux DNS. Veuillez noter que dnsmasq détermine la langue pour les messages
! 2197: ainsi que le jeu de caractères susceptible d'être utilisé dans les fichiers
! 2198: de configuration à partir de la variable d'environnement LANG. Ceci devrait
! 2199: être configuré à la valeur par défaut du système par les scripts démarrant
! 2200: dnsmasq. Lorsque les fichiers de configuration sont édités, veuillez faire
! 2201: attention à le faire en utilisant la valeur de locale par défaut du système
! 2202: et non une valeur spécifique à l'utilisateur, puisque dnsmasq n'a aucun
! 2203: moyen de déterminer directement la valeur de jeu de caractère utilisé,
! 2204: et assume de ce fait qu'il s'agit de la valeur par défaut du système.
! 2205:
! 2206: .SH FICHIERS
! 2207: .IR /etc/dnsmasq.conf
! 2208:
! 2209: .IR /usr/local/etc/dnsmasq.conf
! 2210: .IR /var/run/dnsmasq/resolv.conf
! 2211: .IR /etc/ppp/resolv.conf
! 2212: .IR /etc/dhcpc/resolv.conf
! 2213:
! 2214: .IR /etc/resolv.conf
! 2215:
! 2216: .IR /etc/hosts
! 2217:
! 2218: .IR /etc/ethers
! 2219:
! 2220: .IR /var/lib/misc/dnsmasq.leases
! 2221:
! 2222: .IR /var/db/dnsmasq.leases
! 2223:
! 2224: .IR /var/run/dnsmasq.pid
! 2225: .SH VOIR AUSSI
! 2226: .BR hosts (5),
! 2227: .BR resolver (5)
! 2228: .SH AUTEUR
! 2229: Cette page de manuel a été écrite par Simon Kelley <simon@thekelleys.org.uk>.
! 2230:
! 2231: La traduction dans un français bancal a été commise par Gildas Le Nadan
! 2232: <3ntr0p13@gmail.com> : Toute révision/correction permettant de corriger
! 2233: orthographe ou grammaire mais surtout les éventuelles fautes de sens sera la
! 2234: bienvenue!
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/cvsweb/back.gif){kind=icon}
Return to dnsmasq.8 CVS log ![[TXT]](/icons/cvsweb/text.gif){kind=icon}
![[DIR]](/icons/cvsweb/dir.gif){kind=icon}
Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / dnsmasq / man / fr