import of dnsmasq-2.46.tar.gz

This commit is contained in:
Simon Kelley
2008-11-14 20:04:27 +00:00
parent 1ad24ae15c
commit 9009d74652
38 changed files with 4374 additions and 3918 deletions

View File

@@ -414,8 +414,15 @@ Retornar un r
.B --naptr-record=<nombre>,<orden>,<preferencia>,<opciones>,<servicio>,<regexp>[,<remplazo>]
Retornar un r<>cord DNS NAPTR, como especificado en RFC3403.
.TP
.B --cname=<cname>,<target>
Retornar un expediente CNAME que indica que <cname> es realmente <target>. Hay
limitaciones significativas en el target. Debe ser un nombre DNS que le es conocido
a dnsmasq desde /etc/hosts (o archivos hosts adicionales) o de DHCP. Si el target
no satisface este criterio, el cname entero es ignorado. El cname debe ser <20>nico,
pero es permisible tener m<>s de un cname indicando el mismo target.
.TP
.B --interface-name=<nombre>,<interface>
Retornar un r<EFBFBD>cord DNS, asociando el nombre con la direcci<63>n primaria
Retornar un expediente DNS, asociando el nombre con la direcci<63>n primaria
en la interface brindada. Esta opci<63>n especifica un expediente tipo A
para el nombre brindado de la misma forma que una l<>nea de /etc/hosts,
excepto que la direcci<63>n no es constante y es en vez tomada de la
@@ -500,9 +507,11 @@ hardware para identificar hosts prefijando 'id:'. O sea que:
se refiere al host con identificador de cliente 01:02:03:04.
Tambi<EFBFBD>n se permite especificar el ID de cliente como texto, as<61>:
.B --dhcp-host=id:iddeclientecomotexto,.....
La opci<63>n especial id:* significa "ignorar cualquier ID de cliente
y usar solamente direcciones MAC." Esto es <20>til cuando un cliente
presenta un ID de cliente algunas veces pero otras no.
Si un nombre aparece en /etc/hosts, la direcci<63>n asociada puede
ser alocada a un arriendo DHCP, pero solo si existe una opci<63>n
.B --dhcp-host
@@ -511,14 +520,16 @@ le dice a dnsmasq que no debe ofrecer jam
una m<>quina. La m<>quina puede ser especificada por direcci<63>n de
hardware, ID de cliente, o nombre de host, por ejemplo:
.B --dhcp-host=00:20:e0:3b:13:af,ignore
Esto es <20>til cuando hay otro servidor DHCP en la red para ser
usado por alg<6C>nas m<>quinas. El net:<network-id> fija la etiqueta
network-id cuando sea que esta directiva dhcp-host est<73> en uso.
Esto puede ser usado para enviar selectivamente opciones DHCP
a este host. Cuando un host coincide con cualquier directiva
dhcp-host (o una implicada por /etc/ethers) entonces la etiqueta
network-id especial "known" es fijada. Esto permite que dnsmasq sea
configurado para ignorar pedidos desde m<>quinas desconocidas usando
Esto es <20>til cuando hay otro servidor DHCP en la red que debe ser
usado por alg<6C>nas m<>quinas.
El net:<network-id> fija la etiqueta network-id cuando sea que
esta directiva dhcp-host est<73> en uso. Esto puede ser usado para
enviar selectivamente opciones DHCP a este host. Cuando un host
coincide con cualquier directiva dhcp-host (o una implicada por
/etc/ethers) entonces la etiqueta network-id especial "known" es
fijada. Esto permite que dnsmasq sea configurado para ignorar
pedidos desde m<>quinas desconocidas usando
.B --dhcp-ignore=#known
Direcciones ethernet (pero no client-ids) pueden tener bytes
comod<EFBFBD>nes, as<61> que por ejemplo
@@ -526,12 +537,23 @@ comod
causar<EFBFBD> que dnsmasq ignore un rango de direcciones ethernet. N<>tese
que el "*" necesitar<61> ser escapado o escrito entre comillas en la
l<EFBFBD>nea de comandos, pero no en el archivo de configuraci<63>n.
Direcciones de hardware normalmente coinciden con cualquier
tipo de red (ARP), pero es posible restringirlas a un tipo ARP
singular precediendolo con el tipo ARP (en HEX) y "-". As<41> que
.B --dhcp-host=06-00:20:e0:3b:13:af,1.2.3.4
solo coincidir<69>a con una direcci<63>n de hardware Token-Ring, dado que
el tipo ARP para Token-Ring es 6.
Como caso especial, es posible incluir m<>s de una direcci<63>n de
hardware. Esto permite que una direcci<63>n IP sea asociada con
direcciones de hardware m<>ltiples, y le brinda a dnsmasq permiso
para abandonar un arriendo DHCP a una de las direcciones de hardware
cuando otra pide un arriendo. N<>tese que esto es algo peligroso,
s<EFBFBD>lo funcionar<61> dependiblemente si una de las direcciones de hardware
est<EFBFBD> activa en cualquier momento y dnsmasq no tiene forma de enforzar
esto. Pero es <20>til, por ejemplo, para alocar una direcci<63>n IP estable
a una laptop que tiene interfaces al<61>mbricas e inal<61>mbricas.
.TP
.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.
@@ -731,11 +753,14 @@ es usado para el servidor y el n
para el cliente. Finalmente, dos n<>meros permiten que se especifiquen
ambos los puertos de servidor y cliente para DHCP.
.TP
.B \-3, --bootp-dynamic
.B \-3, --bootp-dynamic[=<network-id>[,<network-id>]]
Habilitar alocaci<63>n din<69>mica de direcciones IP a clientes BOOTP. Usar
esto con cuidado, ya que cada direcci<63>n alocada a un cliente BOOTP
es arrendada para siempre, y consecuentemente queda no-disponible
para re-uso por otros hosts.
para re-uso por otros hosts. Si esto es brindado sin etiquetas,
entonces incondicionalmente habilita alocaci<63>n din<69>mica. Con
etiquetas, solo cuando todas las etiquetas est<73>n fijadas. Puede
ser repetido con diferentes juegos de etiquetas.
.TP
.B \-5, --no-ping
Por predetermindado, el servidor DHCP tratar<61> de asegurarse que una
@@ -763,20 +788,24 @@ en instalaciones nuevas, y ser
.TP
.B \-6 --dhcp-script=<path>
Cuando un arriendo DHCP nuevo es creado, o uno viejo es
destruido, el binario especificado por esta opci<63>n es ejecutado.
destruido, el ejecutable especificado por esta opci<63>n es ejecutado.
Los argumentos para el binario son "add", "old", o "del", la direcci<63>n
MAC del host (o "<null>"), la direcci<63>n IP, y el hostname, si es
MAC del host, la direcci<63>n IP, y el hostname, si es
conocido. "add" significa que un arriendo ha sido creado, "del" que
ha sido destruido, y "old" es una notificaci<63>n de un arriendo existente
cuando dnsmasq inicia o un cambio a una MAC o nombre host de un arriendo
existente (tambi<62>n, tiempo de arriendo o vencimiento y client-id, si
leasefile-ro est<73> fijado). El proceso es ejecutado como root (asumiendo
que dnsmasq fue originalmente ejecutado como root) a<>n si dnsmasq est<73>
configurado para cambiar su UID a un usuario sin privilegios.
leasefile-ro est<73> fijado). Si la direcci<63>n MAC es de un tipo de red
que no es ethernet, tendr<64> el tipo de red precolocado, por ejemplo
"06-01:23:45:67:89:ab" para token ring. El proceso es ejecutado como root
(asumiendo que dnsmasq fue originalmente ejecutado como root) a<>n si dnsmasq
est<EFBFBD> configurado para cambiar su UID a un usuario sin privilegios.
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 cliente brinda informaci<63>n de clase de vendedor
o usuario, estos son brindados en las variables DNSMASQ_VENDOR_CLASS y
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
DNSMASQ_USER_CLASS0..DNSMASQ_USER_CLASSn, pero solo para acciones "add"
y "old" cuando un host resume un arriendo existente, dado a que estos
datos no son almacenados en la base de datos de arriendos de dnsmasq.
@@ -829,11 +858,12 @@ est
puentes "estilo viejo", ya que los paquetes llegan a interfaces tap que no
tienen una direcci<63>n IP.
.TP
.B \-s, --domain=<dominio>
Especifica el dominio para el servidor DHCP. Esto tiene dos efectos:
Primeramente, causa que el servidor DHCP le devuelva el dominio a
cualquier host que lo pida. Segundamente, fija el dominio para el cual
es legal para hosts configurados mediante DHCP reclamar. La intenci<63>n es
.B \-s, --domain=<dominio>[,<rango de IPs>]
Especifica los dominios DNS para el servidor DHCP. Dominios pueden ser
brindados incondicionalmente (sin el rango de IPs) o para rangos limitados. Esto
tiene dos efectos: Primeramente, causa que el servidor DHCP le devuelva el
dominio a cualquier host que lo pida. Segundamente, fija el dominio para el
cual es legal para hosts configurados mediante DHCP reclamar. La intenci<63>n es
restringir nombres de host para que un host no-confiado en la LAN no
pueda proclamar su nombre v<>a DHCP, como por ejemplo "microsoft.com" y
capturar tr<74>fico no destinado a ella. Si ning<6E>n sufijo de dominio es
@@ -850,7 +880,28 @@ de esa m
.B dnsmasq
como "laptop" y "laptop.thekelleys.org.uk". Si el dominio es brindado
como "#" entonces el dominio es leido desde la primera directiva search
en /etc/resolv.conf (o equivalente).
en /etc/resolv.conf (o equivalente). El rango de direcciones puede ser
<direcci<63>n IP>,<direcci<63>n IP> or <direcci<63>n IP>/<m<>scara de subred>. Ver
.B --dhcp-fqdn el cual puede cambiar el comportamiento de dnsmasq con
dominios.
.TP
.B --dhcp-fqdn
En el modo predeterminado, dnsmasq pone los nombres no-calificados
de clientes DHCP en el DNS. Por esta raz<61>n, los nombres deben ser <20>nicos,
a<EFBFBD>n si dos clientes que tienen el mismo nombre est<73>n en dominios
diferentes. Si un segundo cliente DHCP aparece el cual tiene el mismo
nombre que un cliente existente, el nombre es transferido al cliente nuevo. Si
.B --dhcp-fqdn
est<EFBFBD> fijado, este comportamiento cambia: El nombre no-calificado
no es puesto en el DNS, solo el nombre calificado. Dos clientes DHCP con
el mismo nombre pueden ambos quedarse con el nombre, con tal que la parte
de dominio sea diferente (o sea que los nombres completamente calificados
difieran). Para asegurar que todos los nombres tengan una parte de dominio,
debe haber al menos
.B --domain
sin una direcci<63>n especificada cuando
.B --dhcp-fqdn
est<EFBFBD> fijado.
.TP
.B --enable-tftp
Habilitar la funci<63>n de servidor TFTP. Esto est<73> deliberadamente limitado
@@ -1056,9 +1107,11 @@ una del
.B dhcp-range
usado para alocar la direcci<63>n, una de cualquier
.B dhcp-host
que coincida, y posiblemente muchas de clases de vendedor y usuario
que coinicdan que hayan sido enviadas por el cliente DHCP.
Cualquier opci<63>n
que coincida (y "known" si un dhcp-host coincide), la etiqueta "bootp"
para pedidos BOOTP, una etiqueta cuyo nombre es el nombre de la
interface donde lleg<65> el pedido, y posiblemente muchas de clases
de vendedor y usuario que coincidan que hayan sido enviadas por
el cliente DHCP. Cualquier opci<63>n
.B dhcp-option
que tenga etiquetas network-id ser<EFBFBD> usada en preferencia de una opci<EFBFBD>n
.B dhcp-option,