mirror of
https://github.com/pi-hole/dnsmasq.git
synced 2025-12-19 10:18:25 +00:00
import of dnsmasq-2.52.tar.gz
This commit is contained in:
@@ -123,8 +123,7 @@ to zero completely disables DNS function, leaving only DHCP and/or TFTP.
|
||||
.TP
|
||||
.B \-P, --edns-packet-max=<size>
|
||||
Specify the largest EDNS.0 UDP packet which is supported by the DNS
|
||||
forwarder. Defaults to 1280, which is the RFC2671-recommended maximum
|
||||
for ethernet.
|
||||
forwarder. Defaults to 4096, which is the RFC5625-recommended size.
|
||||
.TP
|
||||
.B \-Q, --query-port=<query_port>
|
||||
Send outbound DNS queries from, and listen for their replies on, the
|
||||
@@ -427,7 +426,7 @@ Set the maximum number of concurrent DNS queries. The default value is
|
||||
where this needs to be increased is when using web-server log file
|
||||
resolvers, which can generate large numbers of concurrent queries.
|
||||
.TP
|
||||
.B \-F, --dhcp-range=[[net:]network-id,]<start-addr>,<end-addr>[[,<netmask>],<broadcast>][,<lease time>]
|
||||
.B \-F, --dhcp-range=[[net:]network-id,]<start-addr>,<end-addr>[,<netmask>[,<broadcast>]][,<lease time>]
|
||||
Enable the DHCP server. Addresses will be given out from the range
|
||||
<start-addr> to <end-addr> and from statically defined addresses given
|
||||
in
|
||||
@@ -564,7 +563,7 @@ have exactly the same effect as
|
||||
options containing the same information. /etc/ethers is re-read when
|
||||
dnsmasq receives SIGHUP.
|
||||
.TP
|
||||
.B \-O, --dhcp-option=[<network-id>,[<network-id>,]][encap:<opt>,][vendor:[<vendor-class>],][<opt>|option:<opt-name>],[<value>[,<value>]]
|
||||
.B \-O, --dhcp-option=[<network-id>,[<network-id>,]][encap:<opt>,][vi-encap:<enterprise>,][vendor:[<vendor-class>],][<opt>|option:<opt-name>],[<value>[,<value>]]
|
||||
Specify different or extra options to DHCP clients. By default,
|
||||
dnsmasq sends some standard options to DHCP clients, the netmask and
|
||||
broadcast address are set to the same as the host running dnsmasq, and
|
||||
@@ -632,10 +631,16 @@ options are given which are encapsulated with the same option number
|
||||
then they will be correctly combined into one encapsulated option.
|
||||
encap: and vendor: are may not both be set in the same dhcp-option.
|
||||
|
||||
The final variant on encapsulated options is "Vendor-Identifying
|
||||
Vendor Options" as specified by RFC3925. These are denoted like this:
|
||||
.B --dhcp-option=vi-encap:2, 10, "text"
|
||||
The number in the vi-encap: section is the IANA enterprise number
|
||||
used to identify this option.
|
||||
|
||||
The address 0.0.0.0 is not treated specially in
|
||||
encapsulated options.
|
||||
.TP
|
||||
.B --dhcp-option-force=[<network-id>,[<network-id>,]][encap:<opt>,][vendor:[<vendor-class>],]<opt>,[<value>[,<value>]]
|
||||
.B --dhcp-option-force=[<network-id>,[<network-id>,]][encap:<opt>,][vi-encap:<enterprise>,][vendor:[<vendor-class>],]<opt>,[<value>[,<value>]]
|
||||
This works in exactly the same way as
|
||||
.B --dhcp-option
|
||||
except that the option will always be sent, even if the client does
|
||||
@@ -687,7 +692,7 @@ agent ID and one provided by a relay agent, the network-id tag is set.
|
||||
.B --dhcp-subscrid=<network-id>,<subscriber-id>
|
||||
Map from RFC3993 subscriber-id relay agent options to network-id tags.
|
||||
.TP
|
||||
.B --dhcp-match=<network-id>,<option number>|option:<option name>[,<value>]
|
||||
.B --dhcp-match=<network-id>,<option number>|option:<option name>|vi-encap:<enterprise>[,<value>]
|
||||
Without a value, set the network-id tag if the client sends a DHCP
|
||||
option of the given number or name. When a value is given, set the tag only if
|
||||
the option is sent and matches the value. The value may be of the form
|
||||
@@ -702,7 +707,11 @@ must match, so
|
||||
|
||||
will set the tag "efi-ia32" if the the number 6 appears in the list of
|
||||
architectures sent by the client in option 93. (See RFC 4578 for
|
||||
details.) If the value is a string, substring matching is used.
|
||||
details.) If the value is a string, substring matching is used.
|
||||
|
||||
The special form with vi-encap:<enterpise number> matches against
|
||||
vendor-identifying vendor classes for the specified enterprise. Please
|
||||
see RFC 3925 for more details of the rare and interesting beasts.
|
||||
.TP
|
||||
.B \-J, --dhcp-ignore=<network-id>[,<network-id>]
|
||||
When all the given network-ids match the set of network-ids derived
|
||||
@@ -736,7 +745,7 @@ If the optional network-id(s) are given,
|
||||
they must match for this configuration to be sent. Note that
|
||||
network-ids are prefixed by "net:" to distinguish them.
|
||||
.TP
|
||||
.B --pxe-service=[net:<network-id>,]<CSA>,<menu text>,<basename>|<bootservicetype>[,<server address>]
|
||||
.B --pxe-service=[net:<network-id>,]<CSA>,<menu text>[,<basename>|<bootservicetype>][,<server address>]
|
||||
Most uses of PXE boot-ROMS simply allow the PXE
|
||||
system to obtain an IP address and then download the file specified by
|
||||
.B dhcp-boot
|
||||
@@ -759,8 +768,9 @@ suffix (normally ".0") is supplied by PXE, and should not be added to
|
||||
the basename. If an integer boot service type, rather than a basename
|
||||
is given, then the PXE client will search for a
|
||||
suitable boot service for that type on the network. This search may be done
|
||||
by multicast or broadcast, or direct to a server if its IP address is provided. A boot service
|
||||
type of 0 is special, and will abort the net boot procedure and
|
||||
by broadcast, or direct to a server if its IP address is provided.
|
||||
If no boot service type or filename is provided (or a boot service type of 0 is specified)
|
||||
then the menu entry will abort the net boot procedure and
|
||||
continue booting from local media.
|
||||
.TP
|
||||
.B --pxe-prompt=[net:<network-id>,]<prompt>[,<timeout>]
|
||||
@@ -865,7 +875,9 @@ 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. DNSMASQ_RELAY_ADDRESS is set if the client
|
||||
used a DHCP relay to contact dnsmasq and the IP address of the relay is known.
|
||||
used a DHCP relay to contact dnsmasq and the IP address of the relay
|
||||
is known. DNSMASQ_TAGS contains all the network-id tags set during the
|
||||
DHCP transaction, separated by spaces.
|
||||
All file descriptors are
|
||||
closed except stdin, stdout and stderr which are open to /dev/null
|
||||
(except in debug mode).
|
||||
|
||||
@@ -49,7 +49,8 @@ ese directorio.
|
||||
.TP
|
||||
.B \-E, --expand-hosts
|
||||
Agregar el dominio a nombres sencillos (sin punto) en /etc/hosts de la
|
||||
misma manera que con nombres derivados de DHCP.
|
||||
misma manera que con nombres derivados de DHCP. N<>tese que esto no
|
||||
aplica a nombres de dominio en cnames, expedientes PTR, TXT, etc.
|
||||
.TP
|
||||
.B \-T, --local-ttl=<tiempo>
|
||||
Al responder con informaci<63>n desde /etc/hosts o desde el archivo
|
||||
@@ -133,8 +134,8 @@ solo DHCP y/o TFTP.
|
||||
.TP
|
||||
.B \-P, --edns-packet-max=<tama<6D>o>
|
||||
Especificar el paquete UDP EDNS.0 m<>s grande que es soportado por
|
||||
el reenviador DNS. Por predeterminado es 1280, lo cual es el
|
||||
m<EFBFBD>ximo recomendado en RFC2671 para ethernet.
|
||||
el reenviador DNS. Por predeterminado es 4096, lo cual es el
|
||||
tama<EFBFBD>o recomendado en RFC5625.
|
||||
.TP
|
||||
.B \-Q, --query-port=<puerto>
|
||||
Enviar b<>squedas outbound desde, y escuchar por respuestas en,
|
||||
@@ -459,7 +460,7 @@ de casos. La
|
||||
es al usar resolvedores de bit<69>coras de servidores web, los cuales pueden
|
||||
generar un n<>mero inmenso de b<>squedas simult<6C>neas.
|
||||
.TP
|
||||
.B \-F, --dhcp-range=[[net:]network-id,]<direcci<63>n-inicio>,<direcci<63>n-final>[[,<m<>scara>],<broadcast>][,<tiempo de arriendo>]
|
||||
.B \-F, --dhcp-range=[[net:]network-id,]<direcci<63>n-inicio>,<direcci<63>n-final>[,<m<>scara>[,<broadcast>]][,<tiempo de arriendo>]
|
||||
Habilitar el servidor DHCP. Direcciones ser<65>n distribuidas desde el
|
||||
rango <direcci<63>n-inicio> hasta <direcci<63>n-final> y desde direcciones definidas
|
||||
est<EFBFBD>ticamente en opciones
|
||||
@@ -578,6 +579,11 @@ Leer informaci
|
||||
Leer informaci<63>n sobre opciones DHCP desde el archivo especificado. La
|
||||
ventaja de usar esta opci<63>n es la misma que con --dhcp-hostsfile: el
|
||||
archivo dhcp-optsfile ser<65> re-le<6C>do cuando dnsmasq recibe un SIGHUP.
|
||||
N<EFBFBD>tese que es posible colocar la informaci<63>n mediante
|
||||
.B --dhcp-boot
|
||||
como opciones DHCP, usando los nombres de opci<63>n bootfile-name,
|
||||
server-ip-address, y tftp-server. Esto permite que sean incluidas en
|
||||
un archivo dhcp-optsfile.
|
||||
.TP
|
||||
.B \-Z, --read-ethers
|
||||
Leer /etc/ethers en busca de informaci<63>n sobre hosts para el servidor
|
||||
@@ -587,7 +593,7 @@ dnsmasq, estas l
|
||||
.B --dhcp-host
|
||||
que contienen la misma informaci<63>n. /etc/ethers es re-le<6C>da cuando dnsmasq recibe un SIGHUP.
|
||||
.TP
|
||||
.B \-O, --dhcp-option=[<network-id>,[<network-id>,]][encap:<opt>,][vendor:[<vendor-class>],][<opt>|option:<opt-name>],[<value>[,<value>]]
|
||||
.B \-O, --dhcp-option=[<network-id>,[<network-id>,]][encap:<opt>,][vi-encap:<enterprise>,][vendor:[<vendor-class>],][<opt>|option:<opt-name>],[<valor>[,<valor>]]
|
||||
Especificar opciones diferentes o extra a clientes DHCP. Por
|
||||
predeterminado, dnsmasq env<6E>a algunas opciones est<73>ndar a clientes
|
||||
DHCP. La m<>scara de subred y direcci<63>n broadcast son fijadas igual
|
||||
@@ -657,9 +663,16 @@ enviar
|
||||
opciones son brindadas que est<73>n encapsuladas con el mismo n<>mero de
|
||||
opci<EFBFBD>n entonces ser<65>n correctamente combinadas en una opci<63>n encapsulada.
|
||||
encap: y vendor: no pueden ser fijadas ambas dentro de la misma opci<63>n dhcp-option.
|
||||
|
||||
La variante final en opciones encapsuladas es "Vendor-Identifying Vendor Options"
|
||||
como especificado en RFC3925. Estos son denotados as<61>:
|
||||
.B --dhcp-option=rfc3925-encap:2, 10, "text"
|
||||
El n<>mero en la secci<63>n rfc3925-encap: es el n<>mero enterprise usado
|
||||
para identificar esta opci<63>n.
|
||||
|
||||
La direcci<63>n 0.0.0.0 no es tratada de forma especial en opciones encapsuladas.
|
||||
.TP
|
||||
.B --dhcp-option-force=[<network-id>,[<network-id>,]][encap:<opt>,][vendor:[<vendor-class>],]<opt>,[<value>[,<value>]]
|
||||
.B --dhcp-option-force=[<network-id>,[<network-id>,]][encap:<opt>,][rfc3925-encap:<enterprise>,][vendor:[<vendor-class>],]<opt>,[<valor>[,<valor>]]
|
||||
Esto funciona ex<65>ctamente de la misma forma que
|
||||
.B --dhcp-option
|
||||
excepto que la opci<63>n siempre ser<65> enviada, a<>n si el cliente no la pide en
|
||||
@@ -713,7 +726,7 @@ network-id es fijado.
|
||||
.B --dhcp-subscrid=<network-id>,<subscriber-id>
|
||||
Trazar de opciones relay subscriber-id RFC3993 a opciones network-id.
|
||||
.TP
|
||||
.B --dhcp-match=<network-id>,<option number>|option:<option name>[,<value>]
|
||||
.B --dhcp-match=<network-id>,<option number>|option:<option name>|vi-encap:<enterprise>[,<valor>]
|
||||
Sin un valor, fijar la etiqueta network-id si el cliente env<6E>a una opci<63>n
|
||||
DHCP del n<>mero o valor brindado. Cuando un valor es brindado, fijar la
|
||||
etiqueta solo si la opci<63>n es enviada y coincide con el valor. El valor puede
|
||||
@@ -729,6 +742,11 @@ coincidir, as
|
||||
fijar<EFBFBD> la etiqueta a "efi-ia32" si el n<>mero 6 aparece en la lista de
|
||||
architecturas enviada por los clientes en opci<63>n 93. (Ver RFC 4578 para
|
||||
detalles.) Si el valor es un string, coincidencia substring es usada.
|
||||
|
||||
La forma especial con vi-encap:<enterpise number> busca coincidencia con
|
||||
clases de vendedor identificadoras para el enterprise especificado. Por
|
||||
favor ver RFC 3925 para mas detalles sobre las bestias raras e interesantes.
|
||||
.TP
|
||||
.B \-J, --dhcp-ignore=<network-id>[,<network-id>]
|
||||
Cuando todos los network ids brindados coincidan con el juego de
|
||||
network ids derivados de las clases net, host, y vendor, ignorar
|
||||
@@ -762,7 +780,7 @@ el inicio atrav
|
||||
ellas deber<65>n coincidir para que esta configuraci<63>n sea enviada. N<>tese
|
||||
que network-ids est<73>n prefijadas con "net:" para distinguirlas.
|
||||
.TP
|
||||
.B --pxe-service=[net:<network-id>,]<CSA>,<texto de men<EFBFBD>>,<nombre base>|<tipo de servicio boot>[,<direcci<63>n de servidor>]
|
||||
.B --pxe-service=[net:<network-id>,]<CSA>,<texto de men<EFBFBD>>[,<nombre base>|<tipo de servicio boot>][,<direcci<63>n de servidor>]
|
||||
La mayor<6F>a de usos para boot-ROMS PXE simplemente permiten al sistema PXE
|
||||
obtener una direcci<63>n IP y entonces bajar el archivo especificado por
|
||||
.B dhcp-boot
|
||||
@@ -784,10 +802,11 @@ direcci
|
||||
N<EFBFBD>tese que el sufijo "layer" (normalmente ".0") es brindado por PXE, y
|
||||
no debe ser agregado al nombre base. Si un n<>mero entero es brindado en vez
|
||||
de un nombre base, entonces el cliente PXE buscar<61> un servicio boot adecuado
|
||||
para ese tipo de red. Esta b<>squeda puede ser hecha mediante multicast o
|
||||
broadcast, o directamente a un servidor si la direcci<63>n IP es brindada. Un
|
||||
tipo de servicio boot de 0 es especial, y abortar<61> el proceso boot de red
|
||||
y continuar<61> desde medio local.
|
||||
para ese tipo de red. Esta b<>squeda puede ser hecha mediante broadcast,
|
||||
o directamente a un servidor si la direcci<63>n IP es brindada. Si ning<6E>n tipo
|
||||
de servicio boot o nombre de archivo es brindado (o un tipo de servicio boot
|
||||
de 0 es especificado), entonces la opci<63>n de men<65> abortar<61> el proceso net boot
|
||||
y continuar<61> desde el medio local.
|
||||
.TP
|
||||
.B --pxe-prompt=[net:<network-id>,]<prompt>[,<timeout>]
|
||||
Fijar esto hace que un aviso sea expuesto despues del boot PXE. Si el timeout
|
||||
@@ -879,10 +898,11 @@ El ambiente es heredado del usuario que ha invocado a dnsmasq, y si el
|
||||
host brind<6E> un client-id, es almacenado en la variable de ambiente
|
||||
DNSMASQ_CLIENT_ID. Si el dominio completamente calificado del host
|
||||
es conocido, la parte de dominio es almacenada en DNSMASQ_DOMAIN. Si
|
||||
el cliente brinda informaci<63>n de clase de vendedoro usuario,
|
||||
estos son brindados en las variables DNSMASQ_VENDOR_CLASS y
|
||||
el cliente brinda informaci<63>n de clase de vendedor, nombre de host,
|
||||
o clase de usuario, estos son brindados en las variables
|
||||
DNSMASQ_VENDOR_CLASS, DNSMASQ_SUPPLIED_HOSTNAME, y
|
||||
DNSMASQ_USER_CLASS0..DNSMASQ_USER_CLASSn, pero solo para acciones "add"
|
||||
y "old" cuando un host resume un arriendo existente, dado a que estos
|
||||
y "old" cuando un host reanuda un arriendo existente, dado a que estos
|
||||
datos no son almacenados en la base de datos de arriendos de dnsmasq.
|
||||
Si dnsmasq fue compilado con HAVE_BROKEN_RTC, entonces la duraci<63>n del
|
||||
arriendo (en segundos) es almacenada en DNSMASQ_LEASE_LENGTH, de otra
|
||||
@@ -894,7 +914,10 @@ evento "old" es generado con el nuevo estado del arriendo, (por ejemplo, sin
|
||||
nombre), y el nombre anterior es brindado en la variable de ambiente
|
||||
DNSMASQ_OLD_HOSTNAME. DNSMASQ_INTERFACE almacena el nombre de la interface
|
||||
en la cual lleg<65> el pedido; esto no es fijado para acciones "viejas"
|
||||
cuando dnsmasq re-inicia.
|
||||
cuando dnsmasq re-inicia. DNSMASQ_RELAY_ADDRESS es fijado si el cliente
|
||||
us<EFBFBD> un relay DHCP para contactar a dnsmasq y la direcci<63>n IP del relay
|
||||
es conocida. DNSMASQ_TAGS contiene todas las etiquetas network-id fijadas
|
||||
durante la transacci<63>n DHCP, separadas por espacios.
|
||||
Todos los descriptores de archivo est<73>n cerrados
|
||||
excepto stdin, stdout, y stderr los cuales est<73>n abiertos a /dev/null
|
||||
(excepto en modo debug).
|
||||
@@ -1040,11 +1063,13 @@ Especificar un archivo de configuraci
|
||||
tambi<EFBFBD>n es permitida en archivos de configuraci<63>n, para incluir m<>ltiples
|
||||
archivos de configuraci<63>n.
|
||||
.TP
|
||||
.B \-7, --conf-dir=<directorio>
|
||||
.B \-7, --conf-dir=<directorio>[,<file-extension>......]
|
||||
Leer todos los archivos dentro del directorio brindado como archivos
|
||||
de configuraci<63>n. Archivos cuyos nombres terminen con ~ o comienzen
|
||||
con . o comienzen y terminen con # son ignorados. Esta opci<63>n puede
|
||||
ser brindada en la l<>nea de comandos o en un archivo de configuraci<63>n.
|
||||
de configuraci<63>n. Si extensiones son brindadas, cualquier archivo que
|
||||
termine en esas extensiones son ignorados. Cualquier archivos cuyos nombres
|
||||
terminen con ~ o comienzen con . o comienzen y terminen con # siempre son
|
||||
ignorados. Esta opci<63>n puede ser brindada en la l<>nea de comandos o en un
|
||||
archivo de configuraci<63>n.
|
||||
.SH ARCHIVO DE CONFIGURACION
|
||||
Al inicio, dnsmasq lee
|
||||
.I /etc/dnsmasq.conf,
|
||||
@@ -1285,6 +1310,23 @@ o en un archivo hosts adicional. La lista puede ser muy larga. Dnsmasq ha sido
|
||||
probado exit<69>samente con un mill<6C>n de nombres. Ese tama<6D>o de archivo necesita
|
||||
un CPU de 1GHz y aproximadamente 60MB de RAM.
|
||||
|
||||
.SH INTERNACIONALIZACION
|
||||
|
||||
Dnsmasq puede ser compilado con soporte para internacionalizaci<63>n. Para hacer esto,
|
||||
los targets make "all-i18n" y "install-i18n" deber<65>n ser usados en vez de
|
||||
los targets est<73>ndares "all" y "install". Cuando internacionalizaci<63>n es
|
||||
compilada, dnsmasq producir<69> mensajes de bit<69>cora en el lenguaje local y soportar<61>
|
||||
dominios internacionalizados (IDN). Nombres de dominio en /etc/hosts, /etc/ethers,
|
||||
y /etc/dnsmasq.conf que contienen car<61>cteres no-ASCII ser<65>n traducidos a
|
||||
representaci<EFBFBD>n interna DNS punycode. N<>tese que dnsmasq determina ambos el
|
||||
lenguaje para mensajes y el juego de car<61>cteres asumido para archivos de configuraci<63>n
|
||||
de la variable ambiental LANG. Esto debe estar fijado al valor predeterminado del sistema
|
||||
por el gui<75>n responsable de iniciar dnsmasq. Al editar archivos de configuraci<63>n,
|
||||
tener cuidado de hacerlo usando solo el locale predeterminado del sistema y no
|
||||
uno especifico del usuario, dado a que dnsmasq no tiene ninguna manera directa de
|
||||
determinar el juego de caracteres en uso, y debe asumir que es el predeterminado
|
||||
del sistema.
|
||||
|
||||
.SH ARCHIVOS
|
||||
.IR /etc/dnsmasq.conf
|
||||
|
||||
|
||||
@@ -140,8 +140,7 @@ que le DHCP ou le TFTP.
|
||||
.TP
|
||||
.B \-P, --edns-packet-max=<taille>
|
||||
Spécifie la taille maximum de paquet UDP EDNS.0 supporté par le relai DNS. Le
|
||||
défaut est de 1280, qui est la valeur maximale
|
||||
recommandée pour ethernet dans la RFC2671.
|
||||
défaut est de 4096, qui est la valeur recommandée dans la RFC5625.
|
||||
.TP
|
||||
.B \-Q, --query-port=<numéro de port>
|
||||
Envoie et écoute les requêtes DNS sortantes depuis le port UDP spécifié par
|
||||
@@ -503,7 +502,7 @@ lorsqu'un serveur web a la résolution de nom activée pour l'enregistrement de
|
||||
son journal des requêtes, ce qui peut générer un nombre important de requêtes
|
||||
simultanées.
|
||||
.TP
|
||||
.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>]
|
||||
.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>]
|
||||
Active le serveur DHCP. Les adresses seront données dans la plage comprise entre
|
||||
<adresse de début> et <adresse de fin> et à partir des adresses définies
|
||||
statiquement dans l'option
|
||||
@@ -650,7 +649,7 @@ par Dnsmasq, ces lignes ont exactement le même effet que l'option
|
||||
contenant les mêmes informations. /etc/ethers est relu à la réception d'un
|
||||
signal SIGHUP par Dnsmasq.
|
||||
.TP
|
||||
.B \-O, --dhcp-option=[<identifiant_de_réseau>,[<identifiant_de_réseau>,]][encap:<option>,][vendor:[<classe_vendeur>],][<option>|option:<nom d'option>],[<valeur>[,<valeur>]]
|
||||
.B \-O, --dhcp-option=[<identifiant_de_réseau>,[<identifiant_de_réseau>,]][encap:<option>,][vi-encap:<entreprise>,][vendor:[<classe_vendeur>],][<option>|option:<nom d'option>],[<valeur>[,<valeur>]]
|
||||
Spécifie des options différentes ou supplémentaires pour des clients DHCP. Par
|
||||
défaut, Dnsmasq envoie un ensemble standard d'options aux clients DHCP : le
|
||||
masque de réseau et l'adresse de broadcast sont les mêmes que pour l'hôte
|
||||
@@ -729,10 +728,17 @@ Plusieurs options encapsulées avec le même numéro d'option seront correctemen
|
||||
combinées au sein d'une seule option encapsulée. Il n'est pas possible de
|
||||
spécifier encap: et vendor: au sein d'une même option dhcp.
|
||||
|
||||
La dernière variante pour les options encapsulées est "l'option de Vendeur
|
||||
identifiant le vendeur" ("Vendor-Identifying Vendor Options") telle que
|
||||
décrite dans le RFC3925. Celles-ci sont spécifiées comme suit :
|
||||
.B --dhcp-option=vi-encap:2, 10, "text"
|
||||
Le numéro dans la section vi-encap: est le numéro IANA de l'entreprise servant
|
||||
à identifier cette option.
|
||||
|
||||
L'adresse 0.0.0.0 n'est pas traitée de manière particulière lorsque fournie dans
|
||||
une option encapsulée.
|
||||
.TP
|
||||
.B --dhcp-option-force=[<identifiant de réseau>,[<identifiant de réseau>,]][encap:<option>,][vendor:[<classe de vendeur>],]<option>,[<valeur>[,<valeur>]]
|
||||
.B --dhcp-option-force=[<identifiant de réseau>,[<identifiant de réseau>,]][encap:<option>,][vi-encap:<entreprise>,][vendor:[<classe de vendeur>],]<option>,[<valeur>[,<valeur>]]
|
||||
Cela fonctionne exactement de la même façon que
|
||||
.B --dhcp-option
|
||||
sauf que cette option sera toujours envoyée, même si le client ne la demande pas
|
||||
@@ -794,7 +800,7 @@ relais DHCP, alors l'identifiant de réseau est positionné.
|
||||
Associe des options de relais DHCP issues de la RFC3993 à des identifiants de
|
||||
réseau.
|
||||
.TP
|
||||
.B --dhcp-match=<identifiant de réseau>,<numéro d'option>|option:<nom d'option>[,<valeur>]
|
||||
.B --dhcp-match=<identifiant de réseau>,<numéro d'option>|option:<nom d'option>|vi-encap:<entreprise>[,<valeur>]
|
||||
Si aucune valeur n'est spécifiée, associe l'identifiant de réseau si le client
|
||||
envoie une option DHCP avec le numéro ou le nom spécifié. Lorsqu'une valeur est
|
||||
fournie, positionne le label seulement dans le cas où l'option est fournie et
|
||||
@@ -811,6 +817,11 @@ spécifie le label "efi-ia32" si le numéro 6 apparaît dnas la liste
|
||||
d'architectures envoyé par le client au sein de l'option 93. (se réferer
|
||||
au RFC 4578 pour plus de détails). Si la valeur est un chaine de caractères,
|
||||
celle-ci est recherchée (correspondance en temps que sous-chaîne).
|
||||
|
||||
Pour la forme particulière vi-encap:<numéro d'entreprise>, la comparaison se
|
||||
fait avec les classes de vendeur "identifiant de vendeur" ("vendor-identifying
|
||||
vendor classes") pour l'entreprise dont le numéro est fourni en option.
|
||||
Veuillez vous réferer à la RFC 3925 pour plus de détail.
|
||||
.TP
|
||||
.B \-J, --dhcp-ignore=<identifiant de réseau>[,<identifiant de réseau>]
|
||||
Lorsque tous les identifiants de réseau fournis coïncident avec la liste
|
||||
@@ -847,7 +858,7 @@ Si d'éventuels identifiants de réseau sont fournis, ils doivent coïncider ave
|
||||
ceux du client pour que cet élement de configuration lui soit envoyé. Il est à
|
||||
noter que les identifiants de réseau doivent-être préfixés par "net:".
|
||||
.TP
|
||||
.B --pxe-service=[net:<identifiant de réseau>,]<CSA>,<entrée de menu>,<nom de fichier>|<type de service de démarrage>[,<adresse de serveur>]
|
||||
.B --pxe-service=[net:<identifiant de réseau>,]<CSA>,<entrée de menu>[,<nom de fichier>|<type de service de démarrage>][,<adresse de serveur>]
|
||||
La plupart des ROMS de démarrage PXE ne permettent au système PXE que la simple
|
||||
obtention d'une adresse IP, le téléchargement du fichier spécifié dans
|
||||
.B dhcp-boot
|
||||
@@ -870,10 +881,12 @@ Veuillez noter que le suffixe de "couche" (en principe ".0") est fourni par PXE
|
||||
et ne doit pas être rajouté au nom de fichier. Si une valeur numérique entière
|
||||
est fournir pour le type de démarrage, en remplacement du nom de fichier, le
|
||||
client PXE devra chercher un service de démarrage de ce type sur le réseau.
|
||||
Cette recherche peut être faite via multicast ou broadcast, ou directement
|
||||
auprès d'un serveur si son adresse IP est fournie dans l'option. Un service de
|
||||
démarrage de type 0 est spécial et provoquera une interruption du démarrage par
|
||||
le réseau ainsi que la poursuite du démarrage sur un média local.
|
||||
Cette recherche peut être faite via broadcast ou directement auprès d'un
|
||||
serveur si son adresse IP est fournie dans l'option.
|
||||
Si aucun nom de fichier n'est donné ni aucune valeur de type de service de
|
||||
démarrage n'est fournie (ou qu'une valeur de 0 est donnée pour le type de
|
||||
service), alors l'entrée de menu provoque l'interruption du démarrage par
|
||||
le réseau et la poursuite du démarrage sur un média local.
|
||||
.TP
|
||||
.B --pxe-prompt=[net:<identifiant de réseau>,]<invite>[,<délai>]
|
||||
Cette option permet d'afficher une invite à la suite du démarrage PXE. Si un
|
||||
@@ -984,7 +997,9 @@ 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.
|
||||
l'adresse IP du relai est connue. DNSMASQ_TAGS contient tous les labels
|
||||
d'identifiants de réseau fournis pendant la transaction DHCP, séparés par des
|
||||
espaces.
|
||||
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
|
||||
@@ -1421,6 +1436,25 @@ ou d'un fichier d'hôte additionnel. Cette liste peut-être très longue, Dnsmas
|
||||
ayant été testé avec succès avec un million de noms. Cette taille de fichier
|
||||
nécessite un processeur à 1 Ghz et environ 60 Mo de RAM.
|
||||
|
||||
.SH INTERNATIONALISATION
|
||||
Dnsmasq peut être compilé pour supporter l'internationalisation. Pour cela,
|
||||
les cibles "all-i18n" et "install-i18n" doivent être données à make, en lieu
|
||||
et place des cibles standards "all" et "install". Lorsque compilé avec le
|
||||
support de l'internationalisation, dnsmasq supporte les noms de domaines
|
||||
internationalisés ("internationalised domain names" ou IDN), et les messages de
|
||||
traces ("logs") sont écrits dans la langue locale. Les noms de domaines dans
|
||||
/etc/hosts, /etc/ethers et /etc/dnsmasq.conf contenant des caractères
|
||||
non-ASCII seront transformés selon la représentation punycode interne
|
||||
aux DNS. Veuillez noter que dnsmasq détermine la langue pour les messages
|
||||
ainsi que le jeu de caractères susceptible d'être utilisé dans les fichiers
|
||||
de configuration à partir de la variable d'environnement LANG. Ceci devrait
|
||||
être configuré à la valeur par défaut du système par les scripts démarrant
|
||||
dnsmasq. Lorsque les fichiers de configuration sont édités, veuillez faire
|
||||
attention à le faire en utilisant la valeur de locale par défaut du système
|
||||
et non une valeur spécifique à l'utilisateur, puisque dnsmasq n'a aucun
|
||||
moyen de déterminer directement la valeur de jeu de caractère utilisé,
|
||||
et assume de ce fait qu'il s'agit de la valeur par défaut du système.
|
||||
|
||||
.SH FICHIERS
|
||||
.IR /etc/dnsmasq.conf
|
||||
|
||||
|
||||
Reference in New Issue
Block a user