diff options
author | Simon Kelley <simon@thekelleys.org.uk> | 2009-10-13 17:49:32 +0100 |
---|---|---|
committer | Simon Kelley <simon@thekelleys.org.uk> | 2012-01-05 17:31:14 +0000 |
commit | 1f15b81d610eb7c9612814603221d25871927833 (patch) | |
tree | 1d995f04f10265e1306a2ccbedb4402617fca520 /man | |
parent | 77e94da7bb3839872abca8e3b8733cfe649d404f (diff) | |
download | dnsmasq-1f15b81d610eb7c9612814603221d25871927833.tar.gz |
import of dnsmasq-2.51.tar.gzv2.51
Diffstat (limited to 'man')
-rw-r--r-- | man/dnsmasq.8 | 43 | ||||
-rw-r--r-- | man/fr/dnsmasq.8 | 52 |
2 files changed, 66 insertions, 29 deletions
diff --git a/man/dnsmasq.8 b/man/dnsmasq.8 index c7b98ad..a5eac63 100644 --- a/man/dnsmasq.8 +++ b/man/dnsmasq.8 @@ -45,7 +45,8 @@ additional hosts file. If a directory is given, then read all the files containe .TP .B \-E, --expand-hosts Add the domain to simple names (without a period) in /etc/hosts -in the same way as for DHCP-derived names. +in the same way as for DHCP-derived names. Note that this does not +apply to domain names in cnames, PTR records, TXT records etc. .TP .B \-T, --local-ttl=<time> When replying with information from /etc/hosts or the DHCP leases @@ -547,7 +548,12 @@ the file will be re-read when dnsmasq receives SIGHUP. .B --dhcp-optsfile=<file> Read DHCP option information from the specified file. The advantage of using this option is the same as for --dhcp-hostsfile: the -dhcp-optsfile will be re-read when dnsmasq receives SIGHUP. +dhcp-optsfile will be re-read when dnsmasq receives SIGHUP. Note that +it is possible to encode the information in a +.B --dhcp-boot +flag as DHCP options, using the options names bootfile-name, +server-ip-address and tftp-server. This allows these to be included +in a dhcp-optsfile. .TP .B \-Z, --read-ethers Read /etc/ethers for information about hosts for the DHCP server. The @@ -842,8 +848,9 @@ The environment is inherited from the invoker of dnsmasq, and if the host provided a client-id, this is stored in the environment variable DNSMASQ_CLIENT_ID. If the fully-qualified domain name of the host is known, the domain part is stored in DNSMASQ_DOMAIN. -If the client provides vendor-class or user-class -information, these are provided in DNSMASQ_VENDOR_CLASS and +If the client provides vendor-class, hostname or user-class, + these are provided in DNSMASQ_VENDOR_CLASS +DNSMASQ_SUPPLIED_HOSTNAME and DNSMASQ_USER_CLASS0..DNSMASQ_USER_CLASSn variables, but only for "add" actions or "old" actions when a host resumes an existing lease, since these data are not held in dnsmasq's lease @@ -857,7 +864,8 @@ removed, an "old" event is generated with the new state of the lease, ie no name, and the former name is provided in the environment variable DNSMASQ_OLD_HOSTNAME. DNSMASQ_INTERFACE stores the name of the interface on which the request arrived; this is not set for "old" -actions when dnsmasq restarts. +actions when dnsmasq restarts. DNSMASQ_RELAY_ADDRESS is set if the client +used a DHCP relay to contact dnsmasq and the IP address of the relay is known. All file descriptors are closed except stdin, stdout and stderr which are open to /dev/null (except in debug mode). @@ -995,10 +1003,11 @@ of concurrent TFTP connections is limited by the size of the port range. Specify a different configuration file. The conf-file option is also allowed in configuration files, to include multiple configuration files. .TP -.B \-7, --conf-dir=<directory> +.B \-7, --conf-dir=<directory>[,<file-extension>......] Read all the files in the given directory as configuration -files. Files whose names end in ~ or start with . or start and end -with # are skipped. This flag may be given on the command +files. If extension(s) are given, any files which end in those +extensions are skipped. Any files whose names end in ~ or start with . or start and end +with # are always skipped. This flag may be given on the command line or in a configuration file. .SH CONFIG FILE At startup, dnsmasq reads @@ -1238,6 +1247,24 @@ or an additional hosts file. The list can be very long, dnsmasq has been tested successfully with one million names. That size file needs a 1GHz processor and about 60Mb of RAM. +.SH INTERNATIONALISATION +Dnsmasq can be compiled to support internationalisation. To do this, +the make targets "all-i18n" and "install-i18n" should be used instead of +the standard targets "all" and "install". When internationalisation +is compiled in, dnsmasq will produce log messages in the local +language and support internationalised domain names (IDN). Domain +names in /etc/hosts, /etc/ethers and /etc/dnsmasq.conf which contain +non-ASCII characters will be translated to the DNS-internal punycode +representation. Note that +dnsmasq determines both the language for messages and the assumed +charset for configuration +files from the LANG environment variable. This should be set to the system +default value by the script which is responsible for starting +dnsmasq. When editing the configuration files, be careful to do so +using only the system-default locale and not user-specific one, since +dnsmasq has no direct way of determining the charset in use, and must +assume that it is the system default. + .SH FILES .IR /etc/dnsmasq.conf diff --git a/man/fr/dnsmasq.8 b/man/fr/dnsmasq.8 index 1059989..92ec024 100644 --- a/man/fr/dnsmasq.8 +++ b/man/fr/dnsmasq.8 @@ -51,7 +51,8 @@ fichiers contenus dans ce répertoire. .B \-E, --expand-hosts Ajoute le nom de domaine aux noms simples (ne contenant pas de point dans le nom) contenus dans le fichier /etc/hosts, de la même façon que pour le service -DHCP. +DHCP. Notez que cela ne s'applique pas au nom de domaine dans les CNAME, les +enregistrements PTR, TXT, etc... .TP .B \-T, --local-ttl=<durée> Lorsque Dnsmasq répond avec une information provenant du fichier /etc/hosts ou @@ -634,7 +635,11 @@ relu lorsque Dnsmasq reçoit un signal SIGHUP. .B --dhcp-optsfile=<fichier> Lis les informations relatives aux options DHCP dans le fichier spécifié. L'intérêt d'utiliser cette option est le même que pour --dhcp-hostsfile : le -fichier spécifié ser rechargé à la réception par dnsmasq d'un signal SIGHUP. +fichier spécifié sera rechargé à la réception par dnsmasq d'un signal SIGHUP. +Notez qu'il est possible d'encoder l'information via +.B --dhcp-boot +en utilisant les noms optionnels bootfile-name, server-ip-address et +tftp-server. Ceci permet d'inclure ces options dans un fichier "dhcp-optsfile".DNSMASQ_SUPPLIED_HOSTNAME .TP .B \-Z, --read-ethers Lis les informations d'hôtes DHCP dans le fichier /etc/ethers. Le format de @@ -961,22 +966,25 @@ L'environnement est hérité de celui de l'invocation du processus Dnsmasq, et si l'hôte fournit un identifiant de client, celui-ci est stocké dans la variable d'environnement DNSMASQ_CLIENT_ID. Si un nom de domaine pleinement qualifié (FQDN) est connu pour l'hôte, la part relative au domaine est stockée -dans DNSMASQ_DOMAIN. Si le client fournit une information de classe de vendeur -ou de classe d'utilisateur, celles-ci sont positionnées dans les variables -DNSMASQ_VENDOR_CLASS et DNSMASQ_USER_CLASS0 à DNSMASQ_USER_CLASSn -respectivement, mais seulement pour les actions "add" et "old" lorsqu'un hôte -reprend un bail existant, ces variables n'étant pas stockées dans la base de -baux de Dnsmasq. Si Dnsmasq a été compilé avec l'option HAVE_BROKEN_RTC -("horloge RTC défectueuse"), alors la durée du bail (en secondes) est stockée -dans la variable DNSMASQ_LEASE_LENGTH, sinon la date d'expiration du bail est -toujours stocké dans la variable d'environnement DNSMASQ_LEASE_EXPIRES. Le -nombre de secondes avant expiration est toujours stocké dans -DNSMASQ_TIME_REMAINING. Si un bail était associé à un nom d'hôte et que celui-ci -est supprimé, un évênement de type "old" est généré avec le nouveau statut du -bail, c-à-d sans nom d'hôte, et le nom initial est fourni dans la variable -d'environnement DNSMASQ_OLD_HOSTNAME. La variable DNSMASQ_INTERFACE contient le nom de -l'interface sur laquelle la requête est arrivée; ceci n'est pas renseigné -dans le cas des actions "old" ayant lieu après un redémarrage de dnsmasq. +dans DNSMASQ_DOMAIN. Si le client fournit une information de classe de vendeur, +de classe d'utilisateur ou un nom d'hôte, celles-ci sont positionnées dans les +variables DNSMASQ_VENDOR_CLASS et DNSMASQ_USER_CLASS0 à DNSMASQ_USER_CLASSn +et DNSMASQ_SUPPLIED_HOSTNAME respectivement, mais seulement pour les actions +"add" et "old" lorsqu'un hôte reprend un bail existant, ces variables n'étant +pas stockées dans la base de baux de Dnsmasq. Si Dnsmasq a été compilé avec +l'option HAVE_BROKEN_RTC ("horloge RTC défectueuse"), alors la durée du bail +(en secondes) est stockée dans la variable DNSMASQ_LEASE_LENGTH, sinon la date +d'expiration du bail est toujours stocké dans la variable d'environnement +DNSMASQ_LEASE_EXPIRES. Le nombre de secondes avant expiration est toujours +stocké dans DNSMASQ_TIME_REMAINING. Si un bail était associé à un nom d'hôte et +que celui-ci est supprimé, un évênement de type "old" est généré avec le +nouveau statut du bail, c-à-d sans nom d'hôte, et le nom initial est fourni +dans la variable d'environnement DNSMASQ_OLD_HOSTNAME. La variable +DNSMASQ_INTERFACE contient le nom de l'interface sur laquelle la requête est +arrivée; ceci n'est pas renseigné dans le cas des actions "old" ayant lieu +après un redémarrage de dnsmasq. La variable DNSMASQ_RELAY_ADDRESS est +renseignée si le client a utilisé un relai DHCP pour contacter Dnsmasq, si +l'adresse IP du relai est connue. Tous les descripteurs de fichiers sont fermés, sauf stdin, stdout et stderr qui sont ouverts sur /dev/null (sauf en mode déverminage). Le script n'est pas lancé de manière concurrente : si un autre changement de @@ -1152,10 +1160,12 @@ Spécifie un fichier de configuration différent. L'option "conf-file" est également autorisée dans des fichiers de configuration, ce qui permet l'inclusion de multiples fichiers de configuration. .TP -.B \-7, --conf-dir=<répertoire> +.B \-7, --conf-dir=<répertoire>[,<extension de fichier>...] Lis tous les fichiers du répertoire spécifié et les traite comme des fichiers de -configuration. Les fichiers dont les noms se terminent en ~ ou commençant par ., -ainsi que ceux commençant ou se terminant par # ne sont pas pris en compte. +configuration. Si des extensions sont données, tout fichier finissant par ces +extensions seront ignorés. Tout fichier dont le nom se termine en ~ ou commence +par ., ainsi que ceux commençant ou se terminant par # seront systématiquement +ignorés. Cette option peut être donnée en ligne de commande ou dans un fichier de configuration. .SH FICHIER DE CONFIGURATION |