import of dnsmasq-2.41.tar.gz

This commit is contained in:
Simon Kelley
2008-02-12 20:43:05 +00:00
parent 5aabfc78bc
commit 824af85bdf
42 changed files with 8609 additions and 4729 deletions

View File

@@ -55,6 +55,15 @@ cierto tiempo de vida (en segundos) para estas respuestas. Esto
reduce la carga sobre el servidor al costo de que los clientes
usaran datos a<>ejos bajo algunas circunstancias.
.TP
.B --neg-ttl=<tiempo>
Respuestas negativas desde servidores upstream normalmente contienen
informaci<EFBFBD>n time-to-live (tiempo de vida) en expedientes SOA que
dnsmasq usa para hacer cach<63>. Si las respuestas de servidores upstream
omiten esta informaci<63>n, dnsmasq no mete la respuesta en el cach<63>.
Esta opci<63>n brinda un valor predeterminado para el time-to-live que
dnsmasq usa para meter respuestas en el cach<63> a<>n en la ausencia de
un expediente SOA.
.TP
.B \-k, --keep-in-foreground
No ir hacia el fondo al iniciar, pero aparte de eso ejecutar como
normal. La intenci<63>n de esto es para cuando dnsmasq es ejecutado
@@ -113,7 +122,8 @@ Mostrar el n
.TP
.B \-p, --port=<puerto>
Escuchar en el puerto <puerto> en vez del puerto est<73>ndar DNS (53).
Principalmente <20>til para debugging.
Fijar esto a cero deshabilita completamente la funci<63>n DNS, dejando
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
@@ -263,6 +273,18 @@ cuales sabe que est
probar cada b<>squeda con cada servidor estrictamente en el orden
que aparecen en /etc/resolv.conf
.TP
.B --all-servers
Por predeterminado, cuando dnsmasq tiene m<>s de un servidor upstream
disponible, enviar<61> b<>squedas a solo un servidor. Fijar esta opci<63>n
forza a dnsmasq a enviar todas las b<>squedas a todos los servidores
disponibles. La respuesta del servidor que responda primero ser<65>
devuelta al solicitante original.
.TP
.B --stop-dns-rebind
Denegar (y bitacorear) direcciones de servidores upstream que est<73>n
dentro de rangos IP privados. Esto bloquea un ataque donde un navegador
detr<EFBFBD>s de un firewall es usado para analizar m<>quinas en la red local.
.TP
.B \-n, --no-poll
No revisar periodicamente a /etc/resolv.conf en busca de cambios.
.TP
@@ -277,7 +299,7 @@ sin puntos o partes de dominios, a servidores upstream. Si el nombre
no se conoce desde /etc/hosts o desde DHCP entonces una respuesta
"no encontrado" es devuelta.
.TP
.B \-S, --local, --server=[/[<dominio>]/[dominio/]][<direcci<63>n IP>[#<puerto>][@<remitente>[#<puerto>]]]
.B \-S, --local, --server=[/[<dominio>]/[dominio/]][<direcci<63>n IP>[#<puerto>][@<IP de remitente>|<interface>[#<puerto>]]
Especificar la direcci<63>n IP de servidores upstream directamente. Fijar
esta opci<63>n no suprime la lectura de /etc/resolv.conf, use -R para
hacer eso. Si uno a m<>s dominios opcionales son brindados, ese servidor
@@ -307,14 +329,19 @@ es un sin
.B server
para hacer los archivos de configuraci<63>n mas claros en este caso.
La segunda direcci<63>n IP opcional despu<EFBFBD>s del car<61>cter @ le dice
a dnsmasq como fijar la direcci<63>n de remitente de las b<>squedas
hacia este servidor DNS. Debe ser una direcci<63>n perteneciente a
la m<>quina en la cual corre dnsmasq, de forma contraria esta
l<EFBFBD>nea de servidor ser<65> bitacoreada y despu<70>s ignorada. La opci<63>n
query-port es ignorada para cualquier servidores que tengan una
direcci<EFBFBD>n remitente especificada, pero el puerto puede ser
especificado directamente como parte de la direcci<63>n remitente.
El string opcional despues del car<61>cter @ le dice a dnsmasq como fijar
el remitente de las b<>squedas hacia este servidor DNS. Debe ser una
direcci<EFBFBD>n IP, la cual debe ser perteneciente a la m<>quina en la cual
corre dnsmasq, de forma contraria esta l<>nea de servidor ser<65> bitacoreada
y despu<70>s ignorada, o un nombre de interface. Si un nombre de interface
es brindado, entonces b<>squedas hacia el servidor ser<65>n forzadas v<>a esa
interface; si una direcci<63>n IP es brindada, entonces la direcci<63>n de
remitente de las b<>squedas ser<65> fijada a esa direcci<63>n.
La etiqueta query-port es ignorada para cualquier servidores que tengan
una direcci<63>n remitente especificada, pero el puerto puede ser
especificado directamente como parte de la direcci<63>n remitente. Forzar
b<EFBFBD>squedas a una interface no est<73> implementado en todas las plataformas
soportadas por dnsmasq.
.TP
.B \-A, --address=/<dominio>/[dominio/]<direcci<63>n IP>
Especificar una direcci<63>n IP para retornar por cualquier host en
@@ -498,6 +525,11 @@ el tipo ARP para Token-Ring es 6.
.B --dhcp-hostsfile=<archivo>
Leer informaci<63>n host DHCP desde el archivo especificado. El archivo contiene informaci<63>n de un host por l<>nea. El formato de una l<>nea es igual que texto hacia la derecha de '=' en --dhcp-host. La ventaja de almacenar informaci<63>n host DHCP en este archivo es que puede ser cambiada sin tener que reiniciar dnsmasq. El archivo ser<65> re-le<6C>do cuando dnsmasq recibe un SIGHUP.
.TP
.B --dhcp-optsfile=<archivo>
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.
.TP
.B \-Z, --read-ethers
Leer /etc/ethers en busca de informaci<63>n sobre hosts para el servidor
DHCP. El formato de /etc/ethers es una direcci<63>n de hardware, seguida
@@ -580,6 +612,14 @@ excepto que la opci
la lista de pedido de par<61>metros. Esto se necesita aveces, por ejemplo cuando
enviando opciones a PXELinux.
.TP
.B --dhcp-no-override
Deshabilitar la reutilizaci<63>n de los campos DHCP de nombre de servidor y
archivo como espacio para opciones extra. Si puede, dnsmasq mueve la informaci<63>n
del servidor boot y del nombre de archivo (de dhcp-boot) de sus campos dedicados
hacia opciones DHCP. Esto crea espacio extra en el paquete DHCP para opciones,
pero puede raramente confundir clientes viejos o defectuosos. Esta opci<63>n forza
comportamiento "simple y sencillo" para prevenir problemas en tales casos.
.TP
.B \-U, --dhcp-vendorclass=<network-id>,<vendor-class>
Trazar desde un string vendor-class a un network id. La mayor<6F>a de los
clientes DHCP proveen una "vendor class" la cual representa, en cierto
@@ -619,6 +659,11 @@ 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>,<n<>mero de opci<EFBFBD>n>
Fijar la opci<63>n network-id si el cliente env<6E>a un opci<63>n DHCP del nombre
brindado. Esto puede ser utilizado para identificar clientes particulares
que env<6E>an informaci<63>n usando n<>meros privados de opciones.
.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
@@ -633,6 +678,14 @@ y en tal caso nombres de host proveidos por clientes DHCP siempre son
ignorados, y hosts DHCP son agregados al DNS usando solo la configuraci<63>n
dhcp-host en dnsmasq y el contenido de /etc/hosts y /etc/ethers.
.TP
.B --dhcp-broadcast=<network-id>[,<network-id>]
Cuando todos los network-ids brindados coinciden con el juego de network-ids
derivados de la red, host, clases de vendedor y usuarios, siempre usar
broadcast para comunicarse con el host cuando est<73> sin configurar. La
mayor<EFBFBD>a de clientes DHCP que necesitan respuestas broadcast fijan una
opci<EFBFBD>n en sus pedidos para que esto pase automaticamente, algunos
clientes BOOTP viejos no lo hacen.
.TP
.B \-M, --dhcp-boot=[net:<network-id>,]<filename>,[<servername>[,<server address>]]
Fijar opciones BOOTP que han de ser devueltas por el servidor DHCP. Nombre
y direcci<63>n de servidor son opcionales: si no son brindadas, el nombre es
@@ -716,7 +769,9 @@ es almacenado en DNSMASQ_TIME_REMAINING.
Si un arriendo sol<6F>a tener un nombre de host, el cual es removido, un
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_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.
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).
@@ -812,13 +867,25 @@ un descriptor de archivo por cada coneccion TFTP concurrente, y por archivo
<EFBFBD>nico (mas algunos otros). De tal manera que servirle el mismo archivo
simult<EFBFBD>neo a n clientes requerir<69> el uso de n + 10 descriptores de archivo,
y servirles archivos diferentes simult<6C>neamente requerir<69> (2*n) + 10
descriptores.
descriptores. Si
.B --tftp-port-range
es brindado, eso puede afectar el n<>mero de conexiones simult<6C>neas.
.TP
.B --tftp-no-blocksize
No permitir que el servidor negocie la opci<63>n "blocksize" con un cliente.
Algunos clientes con errores piden esta opci<63>n pero se port<72>n mal cuando se
les brinda.
.TP
.B --tftp-port-range=<inicio>,<final>
Un servidor TFTP escucha por inicios de conexi<78>n en un puerto bien conocido
(69), pero tambien usa un puerto dinamicamente seleccionado para cada
conexi<EFBFBD>n. Normalmente estos son seleccionados por el sistema operativo,
pero esta opci<63>n especifica un rango de puertos para ser usado por transferencias
TFTP. Esto puede ser <20>til cuando TFTP tiene que pasar atraves de un firewall.
El comienzo del rango no puede ser menor a 1025 a menos que dnsmasq est<73> corriendo
como root. El n<>mero de conexiones simult<6C>neas est<73> limitado por el tama<6D>o del
rango de puertos.
.TP
.B \-C, --conf-file=<archivo>
Especificar un archivo de configuraci<63>n diferente. La opci<63>n conf-file
tambi<EFBFBD>n es permitida en archivos de configuraci<63>n, para incluir m<>ltiples
@@ -845,8 +912,8 @@ y son ignoradas. Para opciones que solo pueden ser especificadas una
sola vez, el archivo de configuraci<63>n invalida la l<>nea de comandos.
Las comillas son permitidas en el archivo de configuraci<63>n: entre comillas
tipo " los significados especiales de ,:. y # son eliminados y los
siguientes escapes son permitidos: \\\\ \\" \\t \\a \\b \\r y \\n. El
<EFBFBD>ltimo corresponde a tab, bell, backspace, return y newline.
siguientes escapes son permitidos: \\\\ \\" \\t \\e \\b \\r y \\n.
Corresponden a tab, escape, backspace, return y newline.
.SH NOTAS
Al recibir un SIGHUP
.B dnsmasq
@@ -854,7 +921,8 @@ libera su cache y entonces recarga
.I /etc/hosts
y
.I /etc/ethers
al igual que cualquier archivo brindado con --dhcp-hostsfile.
al igual que cualquier archivo brindado con --dhcp-hostsfile, --dhcp-optsfile,
o --addn-hosts.
El archivo gui<75>n de cambio de arriendos es llamado para todos los arriendos
DHCP existentes. Si
.B
@@ -866,10 +934,12 @@ NO re-lee el archivo de configuraci
.PP
Al recibir un SIGUSR1,
.B dnsmasq
escribe estad<EFBFBD>sticas de cach<EFBFBD> a la bit<EFBFBD>cora del sistema. Escribe el tama<EFBFBD>o
escribe estad<EFBFBD>sticas a la bit<EFBFBD>cora del sistema. Escribe el tama<EFBFBD>o
del cach<63>, el numero de nombres que han tenido que ser removidos del
cach<EFBFBD> antes de que vencieran para hacer espacio para nombres nuevos, y el
n<EFBFBD>mero total de nombres que han sido insertados en el cach<63>. En modo
n<EFBFBD>mero total de nombres que han sido insertados en el cach<63>. Para cada
servidor upstream brinda el n<>mero de b<>squedas enviadas, y el
n<EFBFBD>mero que resultaron en error. En modo
.B --no-daemon
o cuando bitacor<6F>o completo est<73> habilitado (-q), una descarga completa de
el contenido del cach<63> es hecha.