3 Dnsmasq \- Un serveur DHCP et cache DNS poids-plume.
9 est un serveur DHCP et DNS à faible empreinte mémoire. Il offre à la fois les
10 services DNS et DHCP pour un réseau local (LAN).
12 Dnsmasq accepte les requêtes DNS et y réponds soit en utilisant un petit cache
13 local, soit en effectuant une requête à un serveur DNS récursif externe (par
14 exemple celui de votre fournisseur d'accès internet). Il charge le contenu du
15 fichier /etc/hosts afin que les noms locaux n'apparaissant pas dans les DNS
16 globaux soient tout de même résolus, et assure également la résolution de nom
17 pour les hôtes présents dans le service DHCP.
19 Le serveur DHCP Dnsmasq DHCP supporte les définitions d'adresses statiques, les
20 réseaux multiples, le relai DHCP et les spécifications de sous-réseaux conformes
21 à la RFC3011. Il envoie par défaut un jeu raisonnable de paramètres DHCP, et
22 peut être configuré pour envoyer n'importe quel option DHCP.
23 Il inclut un serveur TFTP sécurisé en lecture seule permettant le démarrage via
24 le réseau/PXE de clients DHCP et supporte également le protocole BOOTP.
26 Dnsmasq supporte IPv6 pour le DNS mais pas pour le DHCP.
28 Notes : Il est possible d'utiliser des options sans leur donner de paramètre.
29 Dans ce cas, la fonction correspondante sera désactivée. Par exemple
31 (sans paramètre après le =) désactive l'écriture du fichier PID.
32 Sur BSD, à moins que le logiciel ne soit compilé avec la bibliothèque GNU
33 getopt, la forme longue des options ne fonctionne pas en ligne de commande; Elle
34 est toujours supportée dans le fichier de configuration.
37 Ne pas charger les noms du fichier /etc/hosts.
39 .B \-H, --addn-hosts=<fichier>
40 Fichiers d'hôtes additionnels. Lire le fichier spécifié en plus de /etc/hosts.
43 est spécifié, lire uniquement le fichier spécifié. Cette option peut être
44 répétée afin d'ajouter d'autres fichiers.
46 .B \-E, --expand-hosts
47 Ajoute le nom de domaine aux noms simples (ne contenant pas de point dans le
48 nom) contenus dans le fichier /etc/hosts, de la même façon que pour le service
51 .B \-T, --local-ttl=<durée>
52 Lorsque Dnsmasq répond avec une information provenant du fichier /etc/hosts ou
53 avec un bail DHCP, il donne un temps de vie (time-to-live) positionné à zéro,
54 afin d'indiquer à la machine faisant la requête que celle-ci ne doit pas être
55 mise dans un cache. Ceci est le comportement correct dans presque toutes les
57 Cette option permet de spécifier la valeur de time-to-live à retourner (en
58 secondes). Cela permet de réduire la charge sur le serveur, mais les clients
59 risquent d'utiliser des données périmées dans certains cas.
61 .B \-k, --keep-in-foreground
62 Ne pas aller en tâche de fond au lancement, mais en dehors de cela, fonctionner
63 normalement. Ce mode est prévu pour les cas où Dnsmasq est lancé par daemontools
67 Mode debug (déverminage) : ne pas aller en tâche de fond, ne pas écrire de
68 fichier pid, ne pas changer d'identifiant utilisateur, générer un état complet
69 du cache lors de la réception d'un signal SIGUSR1, envoyer les logs sur la
70 sortie standard d'erreur ("stderr") de même que dans le syslog, ne pas créer de
71 processus fils pour traiter les requêtes TCP.
74 Enregistrer les résultats des requêtes DNS traitées par Dnsmasq dans un fichier
75 de traces ("logs"). Active la génération d'un état complet du cache lors de la
76 réception d'un signal SIGUSR1.
78 .B \-8, --log-facility=<facility>
79 Définit la "facility" dans laquelle Dnsmasq enverra ses entrées syslog, par
80 défaut DAEMON ou LOCAL0 si le mode debug est activé. Si la "facility" contient
81 au moins un caractère "/", alors Dnsmasq considère qu'il s'agit d'un fichier et
82 enverra les logs dans le fichier correspondant à la place du syslog. (Les
83 erreurs lors de la lecture de la configuration vont toujours vers le syslog,
84 mais tous les messages postérieures à un démarrage réussi seront exclusivement
85 envoyés vers le fichier de logs). Lorsque Dnsmasq est configuré pour envoyer
86 ses traces vers un fichier, la réception d'un signal SIGUSR2 entraine la
87 fermeture et réouverture du fichier. Cela permet la rotation de fichiers de
88 traces sans nécessiter l'arrêt de Dnsmasq.
90 .B --log-async[=<lignes>]
91 Permet l'envoi de traces de manière asynchrone, et de manière optionnelle, le
92 nombre de lignes devant être mises dans la file d'attente par Dnsmasq lorsque
93 l'écriture vers le syslog est lente.
94 Dnsmasq peut envoyer ses logs de manière asynchrone : cela lui permet de
95 continuer à fonctionner sans être bloqué par le syslog, et permet à syslog
96 d'utiliser Dnsmasq pour les résolutions DNS sans risque d'interblocage.
97 Si la file d'attente devient pleine, Dnsmasq loggera le dépassement de file et
98 le nombre de messages perdus. La longueur par défaut de la file d'attente est de
99 5 et une valeur saine sera comprise entre 5 et 25, avec une limite maximum
102 .B \-x, --pid-file=<chemin>
103 Spécifie un fichier dans lequel stocker le numéro de processus (pid). La valeur
104 par défaut est /var/run/dnsmasq.pid.
106 .B \-u, --user=<nom d'utilisateur>
107 Spécifie l'identité (nom d'utilisateur) prise par Dnsmasq après le démarrage.
108 Dnsmasq doit normalement être démarré en temps que root ("super-utilisateur"),
109 mais abandonne ses privilèges après le démarrage en changeant d'identité.
110 Normalement cet utilisateur est l'utilisateur nobody ("personne"), mais il est
111 possible d'en définir un autre par le biais de ce paramètre.
113 .B \-g, --group=<nom de groupe>
114 Spécifie le groupe sous lequel Dnsmasq s'exécute. Par défaut, il s'agit du
115 groupe "dip", afin de faciliter l'accès au fichier /etc/ppp/resolv.conf qui
116 n'est en général pas en lecture par tout le monde.
119 Imprime le numéro de version.
121 .B \-p, --port=<port>
122 Ecoute sur le port numéro <port> au lieu du port DNS standard (53). Cette option
123 est essentiellement utile à des fins de déverminage ("debug").
125 .B \-P, --edns-packet-max=<taille>
126 Spécifie la taille maximum de paquet UDP EDNS.0 supporté par le relai DNS. Le
127 défaut est de 1280, qui est la valeur maximale
128 recommandée pour ethernet dans la RFC2671.
130 .B \-Q, --query-port=<numéro de port>
131 Envoie et écoute les requêtes DNS sortantes depuis le port UDP spécifié par
132 <numéro de port>, et non sur un port défini lors de l'exécution. Cette option
133 permet de simplifier les règles de garde-barrière ("firewall"). Sans cela en
134 effet, votre garde-barrière serait obligé d'accepter les connexions depuis les
135 serveurs DNS externes sur une plage de ports UDP, ou de s'adapter dynamiquement
136 au port utilisé par l'instance courante de Dnsmasq.
138 .B \-i, --interface=<nom d'interface>
139 N'écouter que sur l'interface réseau spécifiée. Dnsmasq aujoute automatiquement
140 l'interface locale ("loopback") à la liste des interfaces lorsque l'option
147 n'est donnée, Dnsmasq écoutera sur toutes les interfaces disponibles sauf
148 celle(s) spécifiée(s) par l'option
149 .B --except-interface.
150 Les alias d'interfaces IP (e-g "eth1:0") ne peuvent être utilisés ni avec
153 .B \--except-interface.
158 .B \-I, --except-interface=<interface name>
159 Ne pas écouter sur l'interface spécifiée. Notez que l'ordre dans lesquelles les
165 .B --except-interface
166 sont fournies n'importe pas, et que l'option
167 .B --except-interface
168 l'emporte toujours sur les autres.
170 .B \-2, --no-dhcp-interface=<nom d'interface>
171 Ne pas fournir de service DHCP sur l'interface spécifiée, mais fournir tout de
174 .B \-a, --listen-address=<adresse IP>
175 Ecouter sur la ou les adresse(s) IP spécifiée(s). Les options
179 peuvent-être spécifiées simultanément, auquel cas un jeu d'interfaces et
180 d'adresses seront utilisées. Notez que si
183 n'est donnée alors qu'une option
185 l'est, Dnsmasq n'écoutera pas automatiquement sur l'interface locale
186 ("loopback"). Pour activer l'écoute sur l'interface locale, il est alors
187 nécessaire de fournir explicitement son adresse IP, 127.0.0.1 via l'option
188 .B \--listen-address.
190 .B \-z, --bind-interfaces
191 Sur les systèmes qui le supporte, Dnsmasq s'associe avec l'interface joker
192 ("wildcard"), même lorsqu'il ne doit écouter que sur certaines interfaces. Par
193 la suite, il rejette les requêtes auxquelles il ne doit pas répondre. Cette
194 situation présente l'avantage de fonctionner même lorsque les interfaces vont
195 et viennent ou changent d'adresses. L'option
197 force Dnsmasq à ne réellement s'associer qu'avec les interfaces sur lesquelles
198 il doit écouter. L'un des seuls cas où cette option est utile est celui où un
199 autre serveur de nom (ou une autre instance de Dnsmasq) tourne sur la même
200 machine. Utiliser cette option permet également d'avoir plusieurs instances de
201 Dnsmasq fournissant un service DHCP sur la même machine.
203 .B \-y, --localise-queries
204 Retourne des réponses aux requêtes DNS dépendantes de l'interface sur laquelle
205 la requête a été reçue, à partir du fichier /etc/hosts. Si un nom dans
206 /etc/hosts a plus d'une adresse associée avec lui, et qu'une des adresses au
207 moins est dans le même sous-réseau que l'interface sur laquelle la requête a été
208 reçue, alors ne retourne que la(les) adresse(s) du sous-réseau considéré. Cela
209 permet d'avoir dans /etc/hosts un serveur avec de multiples adresses, une pour
210 chacune de ses interfaces, et de fournir aux hôtes l'adresse correcte (basée sur
211 le réseau auquel ils sont attachés). Cette possibilité est actuellement limitée
215 Fausse résolution inverse pour les réseaux privés. Toutes les requêtes DNS
216 inverses pour des adresses IP privées (ie 192.168.x.x, etc...) qui ne sont pas
217 trouvées dans /etc/hosts ou dans le fichier de baux DHCP se voient retournées
218 une réponse "pas de tel domaine" ("no such domain") au lieu d'être transmises
219 aux serveurs de nom amont ("upstream server").
221 .B \-V, --alias=<ancienne IP>,<nouvelle IP>[,<masque>]
222 Modifie les adresses IPv4 retournées par les serveurs de nom amont;
223 <ancienne IP> est remplacée par <nouvelle IP>. Si le <masque> optionnel est
224 fourni, alors toute adresse correspondant à l'adresse <ancienne IP>/<masque>
225 sera réécrite. Ainsi par exemple
226 .B --alias=1.2.3.0,6.7.8.0,255.255.255.0
227 modifiera 1.2.3.56 en 6.7.8.56 et 1.2.3.67 en 6.7.8.67.
228 Cette fonctionnalité correspond à ce que les routeurs Cisco PIX appellent
229 "bidouillage DNS" ("DNS doctoring").
231 .B \-B, --bogus-nxdomain=<adresse IP>
232 Transforme les réponses contenant l'adresse IP fournie en réponses "pas de tel
233 domaine" ("no such domain"). Ceci a pour but de neutraliser la modification
234 sournoise mise en place par Verisign en septembre 2003, lorsqu'ils ont commencé
235 à retourner l'adresse d'un serveur web publicitaire en réponse aux requêtes pour
236 les noms de domaines non enregistrés, au lieu de la réponse correcte "NXDOMAIN".
237 Cette option demande à Dnsmasq de retourner la réponse correcte lorsqu'il
238 constate ce comportement. L'adresse retournée par Verisign en septembre 2003
241 .B \-f, --filterwin2k
242 Les dernières versions de windows font des requêtes DNS périodiques auxquelles
243 non seulement les serveurs DNS publics ne peuvent donner de réponse, mais qui,
244 de surcroît, peuvent poser des problèmes en déclenchant des connexions
245 intempestives pour des liens réseaux avec des connexions "à la demande". Fournir
246 cette option active le filtrage des requêtes de ce type. Les requêtes bloquées
247 sont les requêtes pour les entrées de type SOA ou SRV, ainsi que les requêtes de
248 type ANY avec des noms possédant des caractères sous-lignés (requêtes pour des
251 .B \-r, --resolv-file=<fichier>
252 Lis les adresses des serveurs de nom amont dans le fichier de nom <fichier>,
253 au lieu du fichier /etc/resolv.conf. Pour le format de ce fichier, voir dans le
256 les entrées correspondant aux serveurs de noms (nameserver). Dnsmasq peut lire
257 plusieurs fichiers de type resolv.conf, le premier fichier spécifié remplace le
258 fichier par défaut, le contenu des suivants est rajouté dans la liste des
259 fichiers à consulter. Seul le fichier ayant la dernière date de modification
260 sera chargé en mémoire.
263 Ne pas lire le contenu du fichier /etc/resolv.conf. N'obtenir l'adresse des
264 serveurs de nom amont que depuis la ligne de commande ou le fichier de
265 configuration de Dnsmasq.
267 .B \-1, --enable-dbus
268 Autoriser la mise à jour de la configuration de Dnsmasq par le biais d'appel de
269 méthodes DBus. Il est possible par ce biais de mettre à jour l'adresse de
270 serveurs DNS amont (et les domaines correspondants) et de vider le cache. Cette
271 option nécessite que Dnsmasq soit compilé avec le support DBus.
273 .B \-o, --strict-order
274 Par défaut, Dnsmasq envoie les requêtes à n'importe lequel des serveurs amonts
275 dont il a connaissance tout en essayant de favoriser les serveurs qu'il sait
276 fonctionner. Cette option force Dnsmasq à essayer d'interroger, pour chaque
277 requête, les serveurs DNS dans leur ordre d'apparition dans le fichier
281 Ne pas vérifier régulièrement si le fichier /etc/resolv.conf a été modifié.
284 Lorsque le fichier /etc/resolv.conf est relu, vider le cache DNS.
285 Cela est utile si les nouveaux serveurs sont susceptibles d'avoir des données
286 différentes de celles stockées dans le cache.
288 .B \-D, --domain-needed
289 Indique à Dnsmasq de ne jamais transmettre en amont de requêtes pour des noms
290 simples, ne comprenant donc ni points ni nom de domaine. Si un nom n'est pas
291 dans /etc/hosts ou dans la liste des baux DHCP, alors une réponse de type
292 "non trouvé" est renvoyée.
294 .B \-S, --local, --server=[/[<domaine>]/[domaine/]][<Adresse IP>[#<port>][@<Adresse IP source>[#<port>]]]
295 Spécifie directement l'adresse IP d'un serveur de nom amont. Cette option ne
296 supprime pas la lecture du fichier /etc/resolv.conf : utiliser pour cela
299 Si un ou plusieurs nom(s) de domaine(s) optionnel(s) sont fournis, ce
300 serveur sera uniquement utilisé uniquement pour ce(s) domaine(s), et toute
301 requête concernant ce(s) domaine(s) sera adressée uniquement à ce serveur.
302 Cette option est destinée aux serveurs de nom privés : si vous avez un serveur
303 de nom sur votre réseau ayant pour adresse IP 192.168.1.1 et effectuant la
304 résolution des noms de la forme xxx.internal.thekelleys.org.uk, alors
305 .B -S /internal.thekelleys.org.uk/192.168.1.1
306 enverra toutes les requêtes pour les machines internes vers ce serveur de nom,
307 alors que toutes les autres requêtes seront adressées aux serveurs indiqués dans
308 le fichier /etc/resolv.conf. Une spécification de nom de domaine vide,
310 possède le sens particulier de "pour les noms non qualifiés uniquement",
311 c'est-à-dire les noms ne possédant pas de points. Un port non standard peut être
312 rajouté à la suite des adresses IP en utilisant le caractère #. Plus d'une
315 est autorisée, en répétant les domaines et adresses IP comme requis.
317 Il est également permis de donner une option
319 avec un nom de domaine mais sans
320 adresse IP; Cela informe Dnsmasq que le domaine est local et qu'il doit répondre
321 aux requêtes le concernant depuis les entrées contenues dans le fichier
322 /etc/hosts ou les baux DHCP, et ne doit en aucun cas transmettre les requêtes
327 ("serveur") afin de rendre plus claire l'utilisation de cette option pour cet
330 La deuxième adresse IP optionnelle suivant le caractère @ permet de définir
331 l'adresse source que Dnsmasq doit utiliser comme source pour les réponses à ce
332 serveur de nom. Il doit s'agir d'une des adresses appartenant à la machine sur
333 laquelle tourne Dnsmasq ou sinon la ligne sera ignorée et une erreur sera
334 consignée dans le journal des événements. L'option
336 est ignorée pour tous les serveurs ayant une adresse source spécifiée, mais il
337 est possible de la donner directement dans la spécification de l'adresse source.
339 .B \-A, --address=/<domaine>/[domaine/]<adresse IP>
340 Spécifie une adresse IP à retourner pour toute requête pour les domaines fournis
341 en option. Les requêtes pour ce(s) domaine(s) ne sont jamais transmises aux
342 serveurs amonts et reçoivent comme réponse l'adresse IP spécifiée qui peut être
343 une adresse IPv4 ou IPv6. Pour donner à la fois une adresse IPv4 et une adresse
344 IPv6 pour un domaine, utiliser plusieurs options
347 contenu du fichier /etc/hosts et de celui des baux DHCP supplante ceci pour des
348 noms individuels. Une utilisation courante de cette option est de rediriger la
349 totalité du domaine doubleclick.net vers un serveur web local afin d'éviter les
350 bannières publicitaires. La spécification de domaine fonctionne de la même façon
353 avec la caractéristique supplémentaire que
355 coïncide avec tout domaine. Ainsi,
356 .B --address=/#/1.2.3.4
357 retournera 1.2.3.4 pour toute requête
358 n'ayant de réponse ni dans /etc/hosts, ni dans les baux DHCP, et n'étant pas
359 transmise à un serveur spécifique par le biais d'une directive
362 .B \-m, --mx-host=<nom de l'hôte>[[,<nom du MX>],<préference>]
363 Spécifie un enregistrement de type MX pour <nom de l'hôte> retournant le nom
364 donné dans <nom du MX> (s'il est présent), ou sinon le nom spécifié dans
367 si elle est présente. Sinon retourne le nom de la machine
368 sur laquelle Dnsmasq tourne. La valeur par défaut (spécifiée dans l'option
370 ) est utile dans un réseau local pour rediriger les courriers
371 électroniques vers un serveur central. La valeur de préférence est optionnelle
372 et vaut par défaut 1 si elle n'est pas spécifiée. Plus d'une entrée MX peut être
373 fournie pour un hôte donné.
375 .B \-t, --mx-target=<nom d'hôte>
376 Spécifie la réponse par défaut fournie par Dnsmasq pour les requêtes sur des
377 enregistrements de type MX. Voir
381 est donné mais pas de
383 alors Dnsmasq retourne comme réponse un enregistrement MX
384 contenant le nom d'hôte spécifié dans l'option
387 concernant le MX de la machine sur laquelle tourne Dnsmasq.
390 Définit, pour toutes les machines locales, un MX correspondant à l'hôte
391 considéré. Les machines locales sont celles définies dans le fichier /etc/hosts
392 ou dans un bail DHCP.
395 Définit, pour toutes les machines locales, un enregistrement MX pointant sur
396 l'hôte spécifié par mx-target (ou la machine sur laquelle Dnsmasq tourne). Les
397 machines locales sont celles définies dans le fichier /etc/hosts ou dans un bail
400 .B \-W --srv-host=<_service>.<_protocole>.[<domaine>],[<cible>[,<port>[,<priorité>[,<poids>]]]]
401 Spécifie un enregistrement DNS de type SRV. Voir la RFC2782 pour plus de
402 détails. Si le champs <domaine> n'est pas fourni, prends par défaut la valeur
403 fournie dans l'option
405 La valeur par défaut pour le domaine est vide et le port par défaut est 1, alors
406 que les poids et priorités par défaut sont 0. Attention lorsque vous transposez
407 des valeurs issues d'une configuration BIND : les ports, poids et priorités sont
408 dans un ordre différents. Pour un service/domaine donné, plus d'un
409 enregistrement SRV est autorisé et tous les enregistrements qui coïncident sont
410 retournés dans la réponse.
412 .B \-Y, --txt-record=<nom>[[,<texte>],<texte>]
413 Définit un enregistrement DNS de type TXT. La valeur de l'enregistrement TXT est
414 un ensemble de chaînes de caractères, donc un nombre variable de chaînes de
415 caractères peuvent être spécifiées, séparées par des virgules.
417 .B --ptr-record=<nom>[,<cible>]
418 Définit un enregistrement DNS de type PTR.
420 .B --interface-name=<nom>,<interface>
421 Définit un entregistrement DNS associant le nom avec l'adresse primaire sur
422 l'interface donnée en argument. Cette option spécifie un enregistrement de type
423 A pour le nom donné en argument de la même façon que s'il était défini par une
424 ligne de /etc/hosts, sauf que l'adresse n'est pas constante mais dépendante de
425 l'interface définie. Si l'interface est inactive, non existante ou non
426 configurée, une réponse vide est fournie. Un enregistrement inverse (PTR) est
427 également créé par cette option, associant l'adresse de l'interface avec le nom.
428 Plus d'un nom peut être associé à une interface donnée en répétant cette option
429 plusieurs fois; dans ce cas, l'enregistrement inverse pointe vers le nom fourni
430 dans la première instance de cette option.
432 .B \-c, --cache-size=<taille>
433 Définit la taille du cache de Dnsmasq. La valeur par défaut est de 150 noms.
434 Définir une valeur de zéro désactive le cache.
436 .B \-N, --no-negcache
437 Désactive le "cache négatif". Le "cache négatif" permet à Dnsmasq de se souvenir
438 des réponses de type "no such domain" fournies par les serveurs DNS en amont et
439 de fournir les réponses sans avoir à re-transmettre les requêtes aux serveurs
442 .B \-0, --dns-forward-max=<nombre de requêtes>
443 Définit le nombre maximum de requêtes DNS simultanées. La valeur par défaut est
444 150, ce qui devrait être suffisant dans la majorité des configurations. La seule
445 situation identifiée dans laquelle cette valeur nécessite d'être augmentée est
446 lorsqu'un serveur web a la résolution de nom activée pour l'enregistrement de
447 son journal des requêtes, ce qui peut générer un nombre important de requêtes
450 .B \-F, --dhcp-range=[[net:]identifiant de réseau,]<adresse de début>,<adresse de fin>[[,<masque de réseau>],<broadcast>][,<durée de bail par défaut>]
451 Active le serveur DHCP. Les adresses seront données dans la plage comprise entre
452 <adresse de début> et <adresse de fin> et à partir des adresses définies
453 statiquement dans l'option
455 Si une durée de bail est donnée, alors les baux seront donnés pour cette
456 durée. La durée de bail est donnée en secondes, en minutes (exemple : 45m),
457 en heures (exemple : 1h) ou être la chaine de caractère "infinite" pour une
458 durée indéterminée. Cette option peut être répétée, avec différentes adresses,
459 pour activer le service DHCP sur plus d'un réseau. Pour des réseaux directement
460 connectés (c'est-à-dire des réseaux dans lesquels la machine sur laquelle tourne
461 Dnsmasq possède une interface), le masque de réseau est optionnel. Il est par
462 contre requis pour les réseaux pour lesquels le service DHCP se fait via un
463 relais DHCP ("relay agent"). L'adresse de broadcast est toujours optionnelle.
465 Sur certains systèmes, Dnsmasq ne peut écouter que sur une interface lorsqu'il
466 utilise DHCP, et le nom de l'interface doit être spécifié par l'option
468 Cette limitation affecte tous les systèmes OpenBSD avant la version 4.0. Il
469 est toujours possible d'avoir plus d'une plage DHCP pour un même sous-réseau.
471 L'identifiant de réseau optionnel est un label alphanumérique qui permet de
472 marquer ce réseau afin de fournir des options DHCP spécifiques à chaque réseau.
473 Lorsque préfixé par 'net:', la signification change est au lieu de définir un
474 label, il définit le label pour laquelle la règle s'applique. Un seul label peut-
475 être défini mais plusieurs labels peuvent coïncider.
477 L'adresse de fin peut être remplacée par le mot-clef
479 ("statique") qui indique à Dnsmasq d'activer le service DHCP pour le réseau
480 spécifié, mais de ne pas activer l'allocation dynamique d'adresses IP. Seuls les
481 hôtes possédant des adresses IP statiques fournies via
483 ou présentes dans le fichier /etc/ethers seront alors servis par le DHCP.
485 .B \-G, --dhcp-host=[<adresse matérielle>][,id:<identifiant client>|*][,net:<identifiant de réseau>][,<adresse IP>][,<nom d'hôte>][,<durée de bail>][,ignore]
486 Spécifie les paramètres DHCP relatifs à un hôte. Cela permet à une machine
487 possédant une adresse matérielle spécifique de se voir toujours allouée les
488 mêmes nom d'hôte, adresse IP et durée de bail. Un nom d'hôte spécifié comme
489 ceci remplace le nom fourni par le client DHCP de la machine hôte. Il est
490 également possible d'omettre l'adresse matérielle et d'inclure le nom d'hôte,
491 auquel cas l'adresse IP et la durée de bail s'appliqueront à toute machine se
492 réclamant de ce nom. Par exemple
493 .B --dhcp-host=00:20:e0:3b:13:af,wap,infinite
494 spécifie à Dnsmasq de fournir à la machine d'adresse matérielle
495 00:20:e0:3b:13:af le nom, et un bail de durée indéterminée.
497 .B --dhcp-host=lap,192.168.0.199
498 spécifie à Dnsmasq d'allouer toujours à la machine portant le nom lap
499 l'adresse IP 92.168.0.199. Les adresses allouées comme ceci ne sont pas
500 contraintes dans une plage d'adresse spécifiée par une option --dhcp-range, mais
501 elles doivent être sur un réseau servi par le serveur DHCP. Il est possible
502 d'utiliser des identifiants clients plutôt que des adresses matérielles pour
503 identifier les hôtes, en préfixant par ceux-ci par 'id:'. Ainsi,
504 .B --dhcp-host=id:01:02:03:04,.....
505 réfère à l'hôte d'identifiant 01:02:03:04. Il est également possible de
506 spécifier l'identifiant client sous la forme d'une chaîne de caractères, comme
508 .B --dhcp-host=id:identifiantclientsousformedechaine,.....
509 L'option spéciale id:* signifie : "ignorer tout identifiant client et n'utiliser
510 que l'adresse matérielle". Cela est utile lorsqu'un client présente un
511 identifiant client mais pas les autres.
513 Si un nom apparaît dans /etc/hosts, l'adresse associée peut être allouée à un
514 bail DHCP mais seulement si une option
516 spécifiant le nom existe par ailleurs. Le mot clef "ignore" ("ignorer") indique
517 à Dnsmasq de ne jamais fournir de bail DHCP à une machine. La machine peut être
518 spécifiée par son adresse matérielle, son identifiant client ou son nom d'hôte.
520 .B --dhcp-host=00:20:e0:3b:13:af,ignore
521 Cela est utile lorsqu'un autre serveur DHCP sur le réseau doit être utilisé par
522 certaines machines. Le paramètre net:<identifiant réseau> permet de définir un
523 identifiant de réseau lorsque l'option dhcp-host est utilisée. Cela peut servir
524 à sélectionner des options DHCP juste pour cet hôte. Lorsqu'une machine coïncide
525 avec une directive dhcp-host (ou une impliquée par /etc/ethers), alors
526 l'identifiant réseau réservé "known" ("connu") est associé. Cela permet à
527 Dnsmasq d'être configuré pour ignorer les requêtes issus de machines inconnue
529 .B --dhcp-ignore=#known.
531 Les adresses ethernet (mais pas les identifiants clients) peuvent être définies
532 avec des octets joker, ainsi par exemple
533 .B --dhcp-host=00:20:e0:3b:13:*,ignore
534 demande à Dnsmasq d'ignorer une gamme d'adresses matérielles. Il est à noter
535 que "*" doit-être précédé d'un caractère d'échappement ou mis entre guillemets
536 lorsque spécifié en option de ligne de commande, mais pas dans le fichier de
537 configuration. Les adresses matérielles coïncident en principe avec n'importe
538 quel type de réseau (ARP), mais il est possible de les limiter à un seul type
539 ARP en les précédant du type ARP (en Hexadécimal) et de "-". Ainsi
540 .B --dhcp-host=06-00:20:e0:3b:13:af,1.2.3.4
541 coïncidera uniquement avec des adresses matérielles Token-Ring, puisque le type
542 ARP pour une adresse Token-Ring est 6.
544 .B --dhcp-hostsfile=<fichier>
545 Lis les informations d'hôtes DHCP dans le fichier spécifié. Le fichier contient
546 des informations à raison d'un hôte par ligne. Le format d'une ligne est la même
547 que le texte fourni à la droite sur caractère "=" dans l'option
549 L'avantage de stocker les informations sur les hôtes DHCP dans ce fichier est
550 que celles-ci peuvent être modifiées sans recharger Dnsmasq; le fichier sera
551 relu lorsque Dnsmasq reçoit un signal SIGHUP.
553 .B \-Z, --read-ethers
554 Lis les informations d'hôtes DHCP dans le fichier /etc/ethers. Le format de
555 /etc/ethers est une adresse matérielle suivie, soit par un nom d'hôte, soit par
556 une adresse IP sous la forme de 4 chiffres séparés par des points. Lorsque lu
557 par Dnsmasq, ces lignes ont exactement le même effet que l'option
559 contenant les mêmes informations. /etc/ethers est relu à la réception d'un
560 signal SIGHUP par Dnsmasq.
562 .B \-O, --dhcp-option=[<identifiant_de_réseau>,[<identifiant_de_réseau>,]][vendor:[<classe_vendeur>],][<opt>|option:<nom d'option>],[<valeur>[,<valeur>]]
563 Spécifie des options différentes ou supplémentaires pour des clients DHCP. Par
564 défaut, Dnsmasq envoie un ensemble standard d'options aux clients DHCP : le
565 masque de réseau et l'adresse de broadcast sont les mêmes que pour l'hôte
566 sur lequel tourne Dnsmasq, et le serveur DNS ainsi que la route par défaut
567 prennent comme valeur l'adresse de la machine sur laquelle tourne Dnsmasq. Si
568 une option de nom de domaine a été définie, son contenu est transmis. Cette
569 option de configuration permet de changer toutes ces valeurs par défaut, ou de
570 spécifier d'autres options. L'option DHCP à transmettre peut être fournie sous
571 forme d'un nombre décimal ou sous la forme "option:<nom d'option>". Les nombres
572 correspondants aux options sont définis dans la RFC2132 et suivants. Les noms
573 d'options connus par Dnsmasq peuvent être obtenus via "Dnsmasq --help dhcp".
574 Par exemple, pour définir la route par défaut à 192.168.4.4, il est possible de
576 .B --dhcp-option=3,192.168.4.4
578 .B --dhcp-option = option:router, 192.168.4.4
579 ou encore, pour positionner l'adresse du serveur de temps à 192.168.0.4, on peut
581 .B --dhcp-option = 42,192.168.0.4
583 .B --dhcp-option = option:ntp-server, 192.168.0.4
584 L'adresse 0.0.0.0 prends ici le sens "d'adresse de la machine sur laquelle
585 tourne Dnsmasq". Les types de données autorisées sont des adresses IP sous la
586 forme de 4 chiffres séparés par des points, un nombre décimal, une liste de
587 caractères hexadécimaux séparés par des 2 points, ou une chaîne de caractères.
588 Si des identifiants de réseaux sont fournis, alors cette option n'est envoyée
589 qu'aux réseaux dont tous les identifiants coïncident.
591 Un traitement spécial est effectué sur les chaînes de caractères fournies pour
592 l'option 119, conformément à la RFC 3397. Les chaînes de caractères ou les
593 adresses IP sous forme de 4 chiffres séparés par des points donnés en arguments
594 de l'option 120 sont traités conforméments à la RFC 3361. Les adresses IP sous
595 forme de 4 chiffres séparés par des points suivies par une barre montante "/",
596 puis une taille de masque sont encodés conforméments à la RFC 3442.
598 Attention : aucun test n'étant fait pour vérifier que des données d'un type
599 adéquat sont envoyées pour un numéro d'option donné, il est tout à fait possible
600 de persuader Dnsmasq de générer des paquets DHCP illégaux par une utilisation
601 incorrecte de cette option. Lorsque la valeur est un nombre décimal, Dnsmasq
602 doit déterminer la taille des données. Cela est fait en examinant le numéro de
603 l'option et/ou la valeur, mais peut-être évité en rajoutant un suffixe d'une
605 b = un octet, s = 2 octets, i = 4 octets. Cela sert essentiellement pour des
606 options encapsulées de classes de vendeurs (voir plus bas), pour lesquelles
607 Dnsmasq ne peut déterminer la taille de la valeur. Les données d'options
608 consistant uniquement de points et de décimaux sont interprétées par Dnsmasq
609 comme des adresses IP, et envoyées comme telles. Pour forcer l'envoi sous forme
610 de chaîne de caractère, il est nécessaire d'utiliser des guillemets doubles. Par
611 exemple, l'utilisation de l'option 66 pour fournir une adresse IP sous la forme
612 d'une chaîne de caractères comme nom de serveur TFTP, il est nécessaire de faire
614 .B --dhcp-option=66,"1.2.3.4"
616 Les options encapsulées de classes de vendeurs peuvent-être aussi spécifiées en
620 .B --dhcp-option=vendor:PXEClient,1,0.0.0.0
621 envoie l'option encapsulée de classe de vendeur "mftp-address=0.0.0.0" à
622 n'importe quel client dont la classe de vendeur correspond à "PXEClient". La
623 correspondance pour les classes de vendeur s'effectue sur des sous-chaînes de
625 .B --dhcp-vendorclass
626 pour plus de détails). Si une option de
627 classe de vendeur (numéro 60) est envoyée par Dnsmasq, alors cela est utilisé
628 pour sélectionner les options encapsulées, de préférence à toute option envoyée
629 par le client. Il est possible d'omettre complètement une classe de vendeur :
630 .B --dhcp-option=vendor:,1,0.0.0.0
631 Dans ce cas l'option encapsulée est toujours envoyée.
632 L'adresse 0.0.0.0 n'est pas traitée de manière particulière lorsque fournie dans
633 une option encapsulée de classe de vendeur.
635 .B --dhcp-option-force=[<identifiant de réseau>,[<identifiant de réseau>,]][vendor:[<classe de vendeur>],]<opt>,[<valeur>[,<valeur>]]
636 Cela fonctionne exactement de la même façon que
638 sauf que cette option sera toujours envoyée, même si le client ne la demande pas
639 dans la liste de paramêtres requis. Cela est parfois nécessaire, par exemple lors
640 de la fourniture d'options à PXELinux.
642 .B \-U, --dhcp-vendorclass=<identifiant de réseau>,<classe de vendeur>
643 Associe une chaîne de classe de vendeur à un indentifiant de réseau. La plupart
644 des clients DHCP fournissent une "classe de vendeur" ("vendor class") qui
645 représente, d'une certaine façon, le type d'hôte. Cette option associe des
646 classes de vendeur à des labels, de telle sorte que des options DHCP peuvent-être
647 fournie de manière sélective aux différentes classes d'hôtes. Par exemple,
648 .B dhcp-vendorclass=printers,Hewlett-Packard JetDirect
649 permet de n'allouer des options qu'aux imprimantes HP de la manière suivante :
650 .B --dhcp-option=printers,3,192.168.4.4
651 La chaîne de caractères de la classe de vendeur founie en argument est cherchée
652 en temps que sous-chaîne de caractères au sein de la classe de vendeur fournie
653 par le client, de façon à permettre la recherche d'un sous-ensemble de la chaîne
654 de caractères ("fuzzy matching").
656 .B \-j, --dhcp-userclass=<identifiant de réseau>,<classe utilisateur>
657 Associe une chaîne de classe d'utilisateur à un identifiant réseau (effectue la
658 recherche sur des sous-chaînes, comme pour les classes de vendeur). La plupart
659 des clients permettent de configurer une "classe d'utilisateur". Cette option
660 associe une classe d'utilisateur à un label, de telle manière qu'il soit
661 possible de fournir des options DHCP spécifiques à différentes classes d'hôtes.
662 Il est possible, par exemple, d'utiliser ceci pour définir un serveur
663 d'impression différent pour les hôtes de la classe "comptes" et ceux de la
666 .B \-4, --dhcp-mac=<identifiant de réseau>,<adresse MAC>
667 Associe une adresse matérielle (MAC) à un identifiant réseau. L'adresse
668 matérielle peut inclure des jokers. Par exemple
669 .B --dhcp-mac=3com,01:34:23:*:*:*
670 permet de définir le label "3com" pour n'importe quel hôte dont l'adresse
671 matérielle coïncide avec les critères définis.
673 .B --dhcp-circuitid=<identifiant de réseau>,<identifiant de circuit>, --dhcp-remoteid=<identifiant de réseau>,<identifiant distant>
674 Associe des options de relais DHCP issus de la RFC3046 à des identifiants de
675 réseau. Cette information peut-être fournie par des relais DHCP. L'identifiant
676 de circuit ou l'identifiant distant est normalement fourni sous la forme d'une
677 chaîne de valeurs hexadécimales séparées par des ":", mais il est également
678 possible qu'elle le soit sous la forme d'une simple chaîne de caractères. Si
679 l'identifiant de circuit ou d'agent correspond exactement à celui fourni par le
680 relais DHCP, alors l'identifiant de réseau est positionné.
682 .B --dhcp-subscrid=<identifiant de réseau>,<identifiant d'abonné>
683 Associe des options de relais DHCP issues de la RFC3993 à des identifiants de
686 .B \-J, --dhcp-ignore=<identifiant de réseau>[,<identifiant de réseau>]
687 Lorsque tous les identifiants de réseau fournis coïncident avec la liste
688 d'identifiants réseau dérivée des classes de réseau, hôte, vendeur et
689 utilisateur, ignorer l'hôte et ne pas donner de bail DHCP.
691 .B --dhcp-ignore-names[=<identifiant de réseau>[,<identifiant de réseau>]]
692 Lorsque tous les identifiant de réseau coïncident avec la liste d'identifiants
693 réseau dérivées des classes de réseau, hôte, vendeur et utilisateur, ignorer le
694 nom de machine fourni par l'hôte. Il est à noter que, à la différence de
695 l'option "dhcp-ignore", il est permis de ne pas fournir d'identifiant réseau.
696 Dans ce cas, les noms d'hôtes fournis par les clients DHCP seront toujours
697 ignorés, et les noms d'hôtes seront ajoutés au DNS en utilisant uniquement la
698 configuration dhcp-host de Dnsmasq, ainsi que le contenu des fichiers /etc/hosts
701 .B \-M, --dhcp-boot=[net:<identifiant de réseau>,]<nom de fichier>,[<nom de serveur>[,<adresse de serveur>]]
702 Spécifie les options BOOTP devant être retournées par le serveur DHCP. Le nom de
703 serveur ainsi que l'adresse sont optionnels : s'ils ne sont pas fournis, le nom
704 est laissé vide et l'adresse fournie est celle de la machine sur laquelle
705 s'exécute Dnsmasq. Si Dnsmasq founit un service TFTP (voir
707 ), alors seul un nom de fichier est requis ici pour permettre un démarrage par
709 Si d'éventuels identifiants de réseau sont fournis, ils doivent coïncider avec
710 ceux du client pour que cet élement de configuration lui soit envoyé. Il est à
711 noter que les identifiants de réseau doivent-être préfixés par "net:".
713 .B \-X, --dhcp-lease-max=<nombre>
714 Limite Dnsmasq à un maximum de <nombre> baux DHCP. Le défaut est de 150. Cette
715 limite permet d'éviter des attaques de déni de service ("DoS") par des hôtes
716 créant des milliers de baux et utilisant beaucoup de mémoire dans le processus
719 .B \-K, --dhcp-authoritative
720 Cette option doit être donnée lorsque Dnsmasq est le seul serveur DHCP sur le
721 réseau. Cela change le comportement par défaut qui est celui d'un strict respect
722 des RFC, afin que les requêtes DHCP pour des baux inconnus par des hôtes
723 inconnus ne soient pas ignorées. Cela permet à de nouveaux hôtes d'obtenir des
724 baux sans tenir compte de fastidieuses temporisations ("timeout"). Cela permet
725 également à Dnsmasq de reconstruire sa base de donnée contenant les baux sans
726 que les clients n'aient besoin de redemander un bail, si celle-ci est perdue.
728 .B \-3, --bootp-dynamic
729 Permet l'allocation dynamique d'adresses IP à des clients BOOTP. Utiliser cette
730 option avec précaution, une adresse allouée à un client BOOTP étant perpétuelle,
731 et de fait n'est plus disponibles pour d'autres hôtes.
734 Par défaut, le serveur DHCP tente de s'assurer qu'une adresse n'est pas utilisée
735 avant de l'allouer à un hôte. Cela est fait en envoyant une requête ICMP de type
736 "echo request" (aussi connue sous le nom de "ping") à l'adresse en question. Si
737 le serveur obtient une réponse, alors l'adresse doit déjà être utilisée et une
738 autre est essayée. Cette option permet de supprimer cette vérification. A
739 utiliser avec précaution.
742 Traces additionnelles pour le service DHCP : enregistre toutes les options
743 envoyées aux clients DHCP et les identifiants de réseaux utilisés pour la
744 détermination de celles-ci.
746 .B \-l, --dhcp-leasefile=<chemin de fichier>
747 Utilise le fichier dont le chemin est fourni pour stocker les informations de
748 baux DHCP. Si cette option est fournie mais qu'aucune option de type dhcp-range
749 n'est donnée, alors un comportement de type Dnsmasq version 1 est activé. Le
750 fichier fourni est supposé être un fichier de baux DHCP de type ISC DHCPD et est
751 parcouru à la recherche de baux contenant des noms d'hôtes. Les noms trouvés
752 sont rajoutés au DNS. Cette fonctionalité peut être exclue de Dnsmasq à la
753 compilation, auquel cas une erreur sera produite. Il est à noter que
754 l'intégration avec un fichier de baux au format ISC est une fonctionalité
755 obsolète. Elle ne devrait pas être utilisée dans les nouvelles installations et
756 sera retirée dans une future version.
758 .B \-6 --dhcp-script=<chemin de fichier>
759 Lorsqu'un bail DHCP est créé, ou qu'un ancien est supprimé, le fichier dont le
760 chemin est spécifié est exécuté. Les arguments fournis à celui-ci sont soit
761 "add" ("ajouter"), "old" ("ancien") ou "del" ("supprimer"), suivi de l'adresse
762 MAC de l'hôte (ou "<null>") puis l'adresse IP et le nom d'hôte si celui-ci est
763 connu."add" signifie qu'un bail a été créé, "del" signifie qu'il a été supprimé,
764 "old" notifie que le bail existait au lancement de Dnsmasq, ou un changement
765 d'adresse MAC ou de nom d'hôte pour un bail existant (ou, dans le cas où
766 leasefile-ro est spécifié, un changement de durée de bail ou d'identifiant
767 d'hôte). Le processus est exécuté en temps que super-utilisateur (si Dnsmasq a
768 été lancé en temps que "root"), même si Dnsmasq est configuré pour changer son
769 UID pour celle d'un utilisateur non-privilégié. L'environnement est hérité de
770 celui de l'invocation du processus Dnsmasq, et si l'hôte fournit un identifiant
771 de client, celui-ci est stocké dans la variable d'environnement
772 DNSMASQ_CLIENT_ID. Si le client fournit une information de classe de vendeur ou
773 de classe d'utilisateur, celles-ci sont positionnées dans les variables
774 DNSMASQ_VENDOR_CLASS et DNSMASQ_USER_CLASS0 à DNSMASQ_USER_CLASSn
775 respectivement, mais seulement pour les actions "add" et "old" lorsqu'un hôte
776 reprend un bail existant, ces variables n'étant pas stockées dans la base de
777 baux de Dnsmasq. Si Dnsmasq a été compilé avec l'option HAVE_BROKEN_RTC
778 ("horloge RTC défectueuse"), alors la durée du bail (en secondes) est stockée
779 dans la variable DNSMASQ_LEASE_LENGTH, sinon la date d'expiration du bail est
780 toujours stocké dans la variable d'environnement DNSMASQ_LEASE_EXPIRES. Le
781 nombre de secondes avant expiration est toujours stocké dans
782 DNSMASQ_TIME_REMAINING. Si un bail était associé à un nom d'hôte et que celui-ci
783 est supprimé, un évênement de type "old" est généré avec le nouveau statut du
784 bail, c-à-d sans nom d'hôte, et le nom initial est fourni dans la variable
785 d'environnement DNSMASQ_OLD_HOSTNAME.
786 Tous les descripteurs de fichiers sont fermés, sauf stdin, stdout et stderr qui
787 sont ouverts sur /dev/null (sauf en mode déverminage).
788 Le script n'est pas lancé de manière concurrente : si un autre changement de
789 bail intervient, le script ne sera relancé que lorsque l'exécution actuelle sera
791 Au démarrage de Dnsmasq, le script sera invoqué pour chacun des baux existants
792 dans le fichier des baux. Le script sera lancé avec l'action "del" pour les baux
793 expirés, et "old" pour les autres. <chemin de fichier> doit être un chemin
794 absolu (c'est-à-dire partant de la racine "/"), aucune recherche n'aura lieu
795 dans les répertoires de la variable d'environnement PATH. Lorsque Dnsmasq reçoit
796 un signal HUP, le script sera invoqué avec une action "old" pour tous les baux
799 .B \-9, --leasefile-ro
800 Supprimer complètement l'usage du fichier servant de base de donnée pour les
801 baux DHCP. Le fichier ne sera ni créé, ni lu, ni écrit. Change la façon dont le
802 script de changement d'état de bail est lancé (si celui-ci est fourni par le
805 ), de sorte que la base de données de baux puisse
806 être complètement gérée par le script sur un stockage externe. En addition aux
807 actions décrites dans
809 le script de changement d'état de bail est appellé une fois, au lancement de
810 Dnsmasq, avec pour seul argument "init". Lorsqu'appellé de la sorte, le script
811 doit fournir l'état de la base de baux, dans le format de fichier de baux de
812 Dnsmasq, sur sa sortie standard (stdout) et retourner un code de retour de 0.
813 Positionner cette option provoque également une invocation du script de
814 changement d'état de bail à chaque changement de l'identifiant de client, de
815 longueur de bail ou de date d'expiration.
817 .B --bridge-interface=<interface>,<alias>[,<alias>]
818 Traiter les requêtes DHCP arrivant sur n'importe laquelle des interfaces <alias>
819 comme si elles arrivaient de l'interface <interface>. Cette option est
820 uniquement disponible sous FreeBSD et DragonflyBSD, et est uniquement nécessaire
821 lors de l'utilisation de pont ethernet "ancien mode", puisque dans ce cas les
822 paquets arrivent sur des interfaces "tap" n'ayant pas d'adresse IP.
824 .B \-s, --domain=<domaine>
825 Spécifie le domaine du serveur DHCP. Cela a deux effets; tout d'abord, le
826 serveur DHCP retourne le domaine à tous les hôtes le demandant, deuxièmement,
827 cela spécifie le domaine valide pour les hôtes DHCP configurés. Le but de cela
828 est de contraindre les noms d'hôte afin qu'aucun hôte sur le LAN ne puisse
829 fournir via DHCP un nom tel que par exemple "microsoft.com" et capturer du
830 trafic de manière illégitime. Si aucun nom de domaine n'est spécifié, alors
831 les noms d'hôtes avec un nom de domaine (c-à-d un point dans le nom) seront
832 interdits et enregistrés dans le journal (logs). Si un suffixe est fourni, alors
833 les noms d'hôtes possédant un domaine sont autorisés, pour peu que le nom de
834 domaine coïncide avec le nom fourni. De plus, si un suffixe est fourni, alors
835 les noms d'hôtes ne possédant pas de nom de domain se voient rajouter le
836 suffixe fourni dans l'option
838 Ainsi, sur mon réseau, je peux configurer
839 .B --domain=thekelleys.org.uk
840 et avoir une machine dont le nom DHCP serait "laptop". L'adresse IP de cette
841 machine sera disponible à la fois pour "laptop" et "laptop.thekelleys.org.uk".
842 Si la valeur fournie pour <domaine> est "#", alors le nom de domaine est
843 positionné à la première valeur de la directive "search" du fichier
844 /etc/resolv.conf (ou équivalent).
847 Active la fonction serveur TFTP. Celui-ci est de manière délibérée limité aux
848 fonctions nécessaires au démarrage par le réseau ("net-boot") d'un client : seul
849 un accès en lecture est possible, et uniquement en mode binaire/octet. Les
850 extensions tsize et blksize sont supportées.
852 .B --tftp-root=<répertoire>
853 Les fichiers à fournir dans les transferts TFTP seront cherchés en prenant le
854 répertoire fourni comme racine. Lorsque cela est fourni, les chemins TFTP
855 incluant ".." sont rejetés, afin d'éviter que les clients ne puissent sortir de
856 la racine spécifiée. Les chemins absolus (commençant par "/") sont autorisés,
857 mais ils doivent être à la racine TFTP fournie.
859 .B --tftp-unique-root
860 Ajouter l'adresse IP du client TFTP en temps qu'élément de chemin, à la suite
861 de la racine tftp (adresse sous forme de 4 chiffres séparés par des points).
862 Uniquement valable si une racine TFTP est spécifiée et si le répertoire
863 correspond existe. Ainsi, si la valeur pour tftp-root est "/tftp" et que le
864 client d'adresse IP 1.2.3.4 requiert le fichier "monfichier", alors le chemin
865 effective résultant sera "/tftp/1.2.3.4/monfichier" si /tftp/1.2.3.4 existe, ou
866 "/tftp/monfichier" dans le cas contraire.
869 Active le mode TFTP sécurisé : sans cela, tout fichier lisible
870 par Dnsmasq est disponible via TFTP (les règles de contrôle d'accès unix
871 habituelles s'appliquent). Lorsque l'option
873 est spécifiée, seuls les fichiers possédés par l'utilisateur sous lequel tourne
874 le processus Dnsmasq sont accessibles. Si Dnsmasq est exécuté en temps que
875 super-utilisateur ("root"), des règles différentes s'appliquent :
877 n'a aucun effet, mais seuls les fichiers ayant un droit de lecture pour tout le
878 monde sont accessibles. Il n'est pas recommandé d'exécuter Dnsmasq sous
879 l'utilisateur "root" lorsque le service TFTP est activé, et il est formellement
880 déconseillé de le faire sans fournir l'option
882 Sans cela, en effet, l'accès de tous les fichiers du serveur pour lequel le
883 droit de lecture pour tout le monde est positionné ("world-readable") devient
884 possible par n'importe quel hôte sur le réseau.
886 .B --tftp-max=<connexions>
887 Définit le nombre maximum de connexions TFTP simultanées autorisées. La valeur
888 par défaut est de 50. Lorsqu'un grand nombre de connexions TFTP est spécifié,
889 il se peut que la limite de nombre de descripteurs de fichiers par processus
890 soit atteinte. Dnsmasq nécessite quelques descripteurs de fichiers, ainsi qu'un
891 descripteur de fichier pour chaque connexion TFTP simultanée et pour chacun des
892 fichiers devant être fournis. De fait, servir le même fichier à n clients ne
893 nécessitera qu'environ n + 10 descripteurs de fichiers, alors que fournir des
894 fichiers tous différents à n clients utilisera environ (2*n) + 10 descripteurs.
896 .B --tftp-no-blocksize
897 Empêche le serveur TFTP de négocier l'option "blocksize" (taille de bloc) avec
898 les clients. Certains clients buggés spécifient cette option mais se comportent
899 ensuite de manière incorrecte si celle-ci est accordée.
901 .B --tftp-port-range=<début>,<fin>
902 Un serveur TFTP écoute sur un numéro de port bien connu (69) pour l'initiation
903 de la connexion, et alloue dynamiquement un port pour chaque connexion. Ces
904 numéros de ports sont en principe alloués par le système d'exploitation, mais
905 cette option permet de spécifier une gamme de ports à utiliser pour les
906 transferts TFTP. Cela peut-être utile lorsque ceux-ci doivent traverser un
907 dispositif garde-barrière ("firewall"). Le début de la plage ne peut-être
908 inférieur à 1024 à moins que Dnsmasq ne fonctionne en temps que
909 super-utilisateur ("root"). Le nombre maximal de connexions TFTP concurrentes
910 est limitée par la taille de la plage de ports ainsi définie.
912 .B \-C, --conf-file=<fichier>
913 Spécifie un fichier de configuration différent. L'option "conf-file" est
914 également autorisée dans des fichiers de configuration, ce qui permet
915 l'inclusion de multiples fichiers de configuration.
917 .B \-7, --conf-dir=<répertoire>
918 Lis tous les fichiers du répertoire spécifié et les traite comme des fichiers de
919 configuration. Les fichiers dont les noms se terminent en ~ ou commençant par .,
920 ainsi que ceux commençant ou se terminant par # ne sont pas pris en compte.
921 Cette option peut être donnée en ligne de commande ou dans un fichier de
923 .SH FICHIER DE CONFIGURATION
924 Au démarrage, Dnsmasq lis
925 .I /etc/dnsmasq.conf,
926 si ce fichier existe. (Sur FreeBSD, ce fichier est
927 .I /usr/local/etc/dnsmasq.conf
928 ) (voir cependant les options
932 ). Le format de ce fichier consiste en une option par ligne, exactement comme
933 les options longues détaillées dans la section OPTIONS, mais sans être précédées
934 par "--". Les lignes commençant par # sont des commentaires et sont ignorées.
935 Pour les options qui ne peuvent-être spécifiées qu'une seule fois, celle du
936 fichier de configuration prends le pas sur celle fournie en ligne de commande.
937 Il est possible d'utiliser des guillemets afin d'éviter que les ",",":","." et
938 "#" ne soit interprêtés, et il est possible d'utiliser les séquences
939 d'échappement suivantes : \\\\ \\" \\t \\a \\b \\r et \\n. Elles correspondent
940 respectivement à la barre oblique descendante ("anti-slash"), guillemets doubles,
941 tabulation, sonnerie ("bell"), suppression ("backspace"), retour ("return") et
942 nouvelle ligne ("newline").
944 A la réception d'un signal SIGHUP,
946 vide son cache et recharge les fichiers
950 ainsi que tout autre fichier spécifié par les options
956 Le script de changement de bail est appellé pour chaque bail DHCP existant. Si
959 est positionnée, alors le fichier
961 est également rechargé.
962 SIGHUP ne provoque PAS de rechargement du fichier de configuration.
964 A la réception d'un signal SIGUSR1,
966 écrit des statistiques dans les traces système. Les informations fournies sont :
967 la taille du cache, le nombre de noms ayant été supprimés du cache avant
968 expiration afin de faire de la place pour les nouveaux noms, ainsi que le nombre
969 total d'entrées ayant été insérées dans le cache.
970 Lorsque Dnsmasq a été lancé via
972 ou lorsque la traçabilité maximale a été activée (
974 ), la totalité du contenu du
975 cache est de surcroît fournie.
977 A la réception d'un signal SIGUSR2 et lorsqu'il enregistre directement ses
978 traces dans un fichier (voir
982 ferme et re-rouvre le fichier de traces. Il faut noter que pendant cette
983 opération Dnsmasq ne s'exécute pas en temps que "root". Lorsqu'il créé un
984 fichier de traces pour la première fois, Dnsmasq change le propriétaire du
985 fichier afin de le faire appartenir à l'utilisateur non "root" sous lequel
986 Dnsmasq s'exécute. Le logiciel de rotation de fichiers de trace logrotate doit
987 être configuré pour créer un nouveau fichier avec un propriétaire identique au
988 fichier existant avant d'envoyer le signal SIGUSR2. Si une requête DNS TCP est
989 en cours, l'ancien fichier de traces reste ouvert dans le processus fils qui
990 traite la requête TCP et il peut y être écrit. Il existe cependant une limite
991 de 150 secondes après laquelle tous les processus traitant des requêtes TCP
992 expirent : pour cette raison, il est préférable de ne pas configurer la
993 compression des fichiers de traces venant juste de faire l'objet d'une rotation.
994 Dans le cas de l'utilisation du logiciel logrotate, les options requises sont
1001 Dnsmasq est un logiciel de transmission de requêtes DNS : il n'est pas capable
1002 d'effectuer une résolution de nom récursive en partant des serveurs DNS racine,
1003 mais transmet de telles requêtes à un serveur DNS amont capable de telles
1004 recherches récursives, ce qui est typiquement le cas d'un serveur DNS de FAI.
1005 Par défaut, Dnsmasq lis
1007 pour découvrir les adresses IP des serveurs DNS amonts à utiliser, puisque cette
1008 information est en général stockée à cet endroit. A moins que l'option
1012 vérifie la date de modification du fichier
1016 est utilisé), et le relis lorsqu'il change. Cela permet de définir les serveurs
1017 DNS amont de manière dynamique lorsque PPP ou DHCP sont utilisés, puisque ces
1018 protocoles fournissent cette information.
1019 L'absence du fichier
1021 ne conduit pas à une erreur, puisqu'il peut très bien ne pas être créé avant
1022 qu'une connexion PPP ne soit établie. Dans ce cas, Dnsmasq vérifie régulièrement
1023 pour voir si un fichier
1025 est créé. Dnsmasq peut être configuré pour lire plus d'un fichier resolv.conf.
1026 Cela est utile sur un ordinateur portable où PPP et DHCP peuvent-être utilisés :
1027 Dnsmasq peut alors être configuré pour lire à la fois
1028 .I /etc/ppp/resolv.conf
1030 .I /etc/dhcpc/resolv.conf
1031 et utilisera le contenu du fichier ayant changé en dernier, ce qui permet de
1032 passer automatiquement de serveurs DNS à d'autres.
1034 Les serveurs amonts peuvent aussi être spécifiés sur la ligne de commande ou
1035 dans un fichier de configuration. Ces spécifications de serveurs peuvent
1036 éventuellement se voir adjoindre d'un nom de domaine qui précise à Dnsmasq quel
1037 serveur utiliser pour trouver les noms d'un domaine donné.
1039 Pour configurer Dnsmasq afin qu'il se comporte comme un cache pour la machine
1040 sur laquelle il tourne, mettre "nameserver 127.0.0.1" dans le fichier
1042 afin de forcer les processus locaux à envoyer leurs requêtes à Dnsmasq. Ensuite,
1043 spécifier les serveurs DNS amont soit en les fournissant directement à Dnsmasq
1046 ou alors en mettant leurs adresses dans un autre fichier, par exemple
1047 .I /etc/resolv.dnsmasq
1048 et en lançant Dnsmasq avec l'option
1049 .B \-r /etc/resolv.dnsmasq.
1050 Cette deuxième technique permet la mise-à-jour dynamique des addresses de
1051 serveurs DNS amont par le biais de PPP ou DHCP.
1053 Les adresses dans /etc/hosts prennent le dessus sur celles fournies par le
1054 serveur DNS amont, ainsi "macompagnie.com 1.2.3.4" dans /etc/hosts assure que
1055 les requêtes pour "macompagnie.com" retourneront toujours 1.2.3.4, même si une
1056 requête au serveur DNS amont retournerait une adresse différente. Il y a une
1057 exception à ceci : si le DNS amont contient un CNAME qui pointe vers un nom
1058 présent dans /etc/hosts, alors la recherche du CNAME via Dnsmasq fournira
1059 l'adresse DNS amont. Pour contourner cela, il suffit de mettre l'entrée
1060 correspondant au CNAME dans /etc/hosts.
1063 les identifiants de réseau fonctionnent comme suit : Dnsmasq associe à chaque
1064 requête DHCP un ensemble d'identifiants de réseau; un pour la plage d'adresse
1067 ) utilisée pour allouer l'adresse, une pour chaque entrée
1069 associée et éventuellement une pour chaque classe de vendeur ou d'utilisateur
1070 fournie par le client DHCP dans sa requête. Les options DHCP (
1072 ) ayant un identifiant de réseau seront utilisés de préférence à celles
1073 sans identifiants de réseau, pour peu que
1075 les labels correspondent.
1076 Le préfixe '#' sur un label est un indicateur de négation, ainsi
1077 .B --dhcp=option=#purple,3,1.2.3.4
1078 envoie l'option lorsque le label "purple" n'est pas dans la liste de labels
1079 valides pour l'hôte considéré.
1081 Si l'identifiant de réseau dans la plage d'adresses DHCP (
1083 ) est préfixé par 'net:', alors sa signification change : au lieu d'associer un
1084 label à la plage spécifiée, cela indique un label de réseau devant être spécifié
1085 par le client DHCP. Ainsi, s'il y a plus d'une plage d'adresses DHCP sur un
1086 sous-réseau, et que l'une est préfixée par un identifiant de réseau (par exemple
1087 l'un spécifié dans une option de classe de vendeur), alors un hôte ayant
1088 l'identifiant de réseau en question positionné se verra allouer une adresse dans
1089 la plage d'adresses DHCP préfixée.
1091 Le serveur DHCP intégré dans Dnsmasq fonctionne également en temps que serveur
1092 BOOTP, pour peu que l'adresse MAC et l'adresse IP des clients soient fournies,
1093 que ce soit par le biais de l'option
1099 soit présente afin d'activer le serveur DHCP pour un réseau donné (L'option
1101 supprime la nécessité des associations statiques). Le paramètre
1102 "filename" (nom de fichier) de la requête BOOTP est comparé avec les
1103 identifiants de réseaux des options
1105 ainsi que le label "bootp", ce qui permet de contrôler les options retournées
1106 aux différentes classes d'hôtes.
1110 0 - Dnsmasq s'est correctement lancé en tâche de fond, ou alors s'est
1111 correctement terminé si le lancement en tâche de fond n'a pas été activé.
1113 1 - Un problème de configuration a été détecté.
1115 2 - Un problème est survenu avec un accès réseau (adresse déjà utilisée,
1116 tentative d'utiliser un port privilégié sans les permissions nécessaires).
1118 3 - Un problème est survenu avec une opération sur un système de fichier
1119 (fichier ou répertoire manquant, permissions).
1121 4 - Impossibilité d'allouer de la mémoire.
1125 11 ou plus - un code de retour différent de 0 a été reçu lors de l'appel au
1126 processus "init" du script des bails. Le code de retour de Dnsmasq correspond
1127 au code de retour du script plus 10.
1130 Les valeurs par défaut pour les limites de ressources de Dnsmasq sont en général
1131 conservatrices et appropriées pour des utilisations embarquées sur des machines
1132 de type routeur ayant des processeurs lents et une mémoire limitée. Sur du
1133 matériel plus performant, il est possible d'augmenter les limites et de gérer
1134 plus de clients. Les remarques suivantes s'appliquent à Dnsmasq version 2.37 et
1135 ultérieur : les versions précédentes ne montaient pas en charge aussi bien.
1138 Dnsmasq est capable de gérer le DNS et DHCP pour au moins un millier de clients.
1139 Evidement, pour cela la valeur de
1141 doit être augmentée et la durée des baux ne doit pas être très courte (moins
1142 d'une heure). La valeur de
1143 .B --dns-forward-max
1144 peut-être augmentée : commencer par la rendre égale au nombre de clients et
1145 l'augmenter si le DNS semble lent. Noter que la performance du DNS dépends
1146 également de la performance des serveurs amonts. La taille du cache DNS peut-
1147 être augmentée : la limite en dur est de 10000 entrées et la valeur par défaut
1148 (150) est très basse. Envoyer un signal SIGUSR1 à Dnsmasq le fait émettre des
1149 informations utiles pour paramétrer la taille de cache. Voir la section
1151 pour plus de détails.
1153 Le serveur TFTP intégré est capable de plusieurs transferts de fichiers
1154 simultanés : La limite absolue est liée au nombre maximal de descripteurs de
1155 fichiers alloué à un processus et à la capacité de l'appel système select() à
1156 gérer un grand nombre de HANDLE de fichier. Si la limite est fixée trop haut par
1159 elle sera réduite et la limite actuelle sera enregistrée au démarrage. Il faut
1160 noter que plus de transferts sont possible lorsque le même fichier est transmis
1161 au lieu d'avoir un fichier différent pour chaque transfert.
1164 Il est possible d'utiliser Dnsmasq pour bloquer la publicité sur la toile
1165 en associant des serveurs de publicité bien connus à l'adresse 127.0.0.1 ou
1166 0.0.0.0 par le biais du fichier
1168 ou d'un fichier d'hôte additionnel. Cette liste peut-être très longue, Dnsmasq
1169 ayant été testé avec succès avec un million de noms. Cette taille de fichier
1170 nécessite un processeur à 1 Ghz et environ 60 Mo de RAM.
1173 .IR /etc/dnsmasq.conf
1175 .IR /usr/local/etc/dnsmasq.conf
1177 .IR /etc/resolv.conf
1183 .IR /var/lib/misc/dnsmasq.leases
1185 .IR /var/db/dnsmasq.leases
1187 .IR /var/run/dnsmasq.pid
1192 Cette page de manuel a été écrite par Simon Kelley <simon@thekelleys.org.uk>.
1194 La traduction dans un français bancal a été commise par Gildas Le Nadan
1195 <3ntr0p13@gmail.com> : Toute révision/correction permettant de corriger
1196 orthographe ou grammaire mais surtout les éventuelles fautes de sens sera la
projects / people / ms / dnsmasq.git / blob