3 dnsmasq \- Un ligero servidor DHCP y DNS con caché.
9 es un ligero servidor DNS, TFTP y DHCP. Su propósito es proveer servicios DNS
10 y DHCP a una red de área local.
12 Dnsmasq acepta búsquedas DNS y las responde desde un pequeño
13 caché local, o las reenvía hacia un servidor DNS real recursivo.
14 Carga el contenido de /etc/hosts, de tal forma que nombres de
15 hosts locales los cuales no aparecen en el DNS mundial puedan ser
16 resueltos. También responde a búsquedas DNS para hosts configurados
19 El servidor DHCP dnsmasq incluye soporte para asignación de direcciones
20 estáticas, redes múltiples, DHCP-relay y especificadores de subredes
21 RFC3011. Automáticamente envía un predeterminado sensible de opciones
22 DHCP, y puede ser configurado para enviar cualquier opciones DHCP deseadas,
23 incluyendo opciones encapsuladas por vendedores. Incluye un servidor seguro
24 TFTP solo-lectura para permitir el inicio vía red/PXE de hosts DHCP. Tambíen
25 incluye soporte para BOOTP.
28 incluye soporte IPv6 para DNS, pero no para DHCP.
30 Nótese que en general parámetros ausentes son permitidos y deshabilitan
31 funciones, por ejemplo "--pid-file=" deshabilita la escritura de un
32 archivo PID. En BSD, a menos que la librería GNU getopt esté enlazada,
33 la forma larga de las opciones no funciona en la línea de comandos,
34 pero todavía es reconocida en el archivo de configuración.
37 No leer los nombres de hosts en /etc/hosts.
39 .B \-H, --addn-hosts=<archivo>
40 Archivo de hosts adicional. Leer el archivo especificado adicionalmente
41 a /etc/hosts. Si se brinda -h, leer solo el archivo especificado. Esta
42 opción puede ser repetida para más de un archivo de hosts adicional.
44 .B \-E, --expand-hosts
45 Agregar el dominio a nombres sencillos (sin punto) en /etc/hosts de la
46 misma manera que con nombres derivados de DHCP.
48 .B \-T, --local-ttl=<tiempo>
49 Al responder con información desde /etc/hosts o desde el archivo
50 de arriendos DHCP, dnsmasq fija el tiempo de vida (TTL) a cero por
51 predeterminado, significando que el remitente no debrá cachear
52 la información por sí mismo. Esto es lo correcto a hacer en casi
53 todas las situaciones. Esta opción permite que se especifique
54 cierto tiempo de vida (en segundos) para estas respuestas. Esto
55 reduce la carga sobre el servidor al costo de que los clientes
56 usaran datos añejos bajo algunas circunstancias.
59 Respuestas negativas desde servidores upstream normalmente contienen
60 información time-to-live (tiempo de vida) en expedientes SOA que
61 dnsmasq usa para hacer caché. Si las respuestas de servidores upstream
62 omiten esta información, dnsmasq no mete la respuesta en el caché.
63 Esta opción brinda un valor predeterminado para el time-to-live que
64 dnsmasq usa para meter respuestas en el caché aún en la ausencia de
67 .B \-k, --keep-in-foreground
68 No ir hacia el fondo al iniciar, pero aparte de eso ejecutar como
69 normal. La intención de esto es para cuando dnsmasq es ejecutado
70 bajo daemontools o launchd.
73 Modo debug: no hacer un fork hacia el fondo, no crear un archivo PID,
74 no cambiar el ID del usuario, generar un cache dump completo al
75 recibir un SIGUSR1, bitacorear a stderr al igual que a syslog, no
76 forkear procesos nuevos para manejar búsquedas TCP.
79 Bitacorear los resultados de búsquedas DNS manejadas por dnsmasq.
80 Habilitar un dump de caché completo al recibir un SIGUSR1.
82 .B \-8, --log-facility=<facilidad>
83 Fijar la facilidad a la cual dnsmasq deberá enviar mensajes syslog,
84 esto es DAEMON por predeterminado, y LOCAL0 cuando el modo debug está
85 en operación. Si la facilidad brindada contiene por lo menos un carácter
86 "/", se trata como un nombre de archivo, y dnsmasq bitacoreará a dicho
87 archivo, en vez de syslog. (Errores durante la lectura de la configuración
88 irán a syslog todavía, pero todo output desde un inicio exitoso, y todo
89 output mientras en ejecución, irá a este archivo exclusivamente.)
90 Al bitacorear a un archivo, dnsmasq cerrará y reabrirá el archivo al
91 recibir un SIGUSR2. Esto permite que el archivo de bitácora sea rotado
92 sin detener a dnsmasq.
94 .B --log-async[=<líneas>]
95 Habilitar bitacoréo asincrónico y opcionalmente fijar el límite de número
96 de líneas que serán enviadas a la coleta por dnsmasq cuando syslog está
97 lento. Dnsmasq puede bitacorear asincrónicamente: esto le permite continuar
98 funcionando sin ser bloqueado por syslog, y permite a syslog usar dnsmasq
99 para búsquedas DNS sin riesgo de tranque. Si la coleta de líneas de bitácora
100 se llena, dnsmasq bitacoreará el desbordamiento, y el número de mensajes
101 perdidos. El tamaño predeterminado de coleta es 5, un valor sano sería 5-25,
102 y un límite de 100 es impuesto.
104 .B \-x, --pid-file=<path>
105 Especificar un path alterno donde dnsmasq debe guardar su PID.
106 Normalmente es /var/run/dnsmasq.pid.
108 .B \-u, --user=<usuario>
109 Especificar el userid al cual dnsmasq debe cambiarse despues de iniciar.
110 Dnsmasq normalmente debe ser iniciado como root, pero soltará los
111 privilegios root despues del inicio, cambiando a otro usuario.
112 Normalmente este usuario es "nobody", pero eso se puede cambiar
115 .B \-g, --group=<grupo>
116 Especificar el grupo como el cual dnsmasq correrá. El predeterminado
117 es "dip", si está disponible, para facilitar el acceso a
118 /etc/ppp/resolv.conf el cuál normálmente no es globalmente leíble.
121 Mostrar el número de versión.
123 .B \-p, --port=<puerto>
124 Escuchar en el puerto <puerto> en vez del puerto estándar DNS (53).
125 Fijar esto a cero deshabilita completamente la función DNS, dejando
128 .B \-P, --edns-packet-max=<tamaño>
129 Especificar el paquete UDP EDNS.0 más grande que es soportado por
130 el reenviador DNS. Por predeterminado es 1280, lo cual es el
131 máximo recomendado en RFC2671 para ethernet.
133 .B \-Q, --query-port=<puerto>
134 Enviar búsquedas outbound desde, y escuchar por respuestas en,
135 el puerto UDP <puerto> en vez de usar puertos aleatorios. Nótese
136 que usar esta opción hace que dnsmasq sea menos seguro contra
137 ataques de spoofing DNS, pero puede ser más rápido y usar menos
139 Fijar esta opción a zero hace que dnsmasq use un solo puerto,
140 asignado por el sistema operativo (esto era el comportamiento
141 predeterminado en versiones anteriores a 2.43).
143 .B --min-port=<puerto>
144 No usar puertos menores a <puerto> como remitentes para búsquedas
145 DNS outbound. Dnsmasq escoje puertos aleatorios como remitentes
146 para búsquedas DNS outbound. Cuando esta opción es brindada, los
147 puertos usados siempre serán mayores que el especificado. Esto es
148 útil para sistemas detras de firewalls.
150 .B \-i, --interface=<nombre de interface>
151 Escuchar solo en las interfaces especificadas. Dnsmasq automáticamente
152 agrega la interface loopback a la lista de interfaces para usar cuando
155 es usada. Si ninguna opción
159 es brindada, dnsmasq escucha en todas las interfaces disponibles excepto
160 cualquiera fijada con opciones
161 .B \--except-interface
162 Interfaces IP alias (por ejemplo, "eth1:0") no pueden ser utilizadas con
165 .B --except-interface
166 , usar --listen-address en vez.
168 .B \-I, --except-interface=<nombre de interface>
169 No escuchar en la interface especificada. Nótese que el orden de
174 .B --except-interface
175 no importa y las opciones
176 .B --except-interface
177 siempre invalidan a las otras.
179 .B \-2, --no-dhcp-interface=<nombre de interface>
180 No proveer DHCP ni TFTP en la interface especificada, pero sí
181 proveer servicio DNS.
183 .B \-a, --listen-address=<dirección IP>
184 Escuchar en la(s) dirección(es) IP especificada(s). Las opciones
188 ambas pueden ser brindadas, y en tal caso el juego de ambas
189 direcciones IP y interfaces es usada. Nótese que si ninguna opción
191 es brindada, pero sí se brinda la opción
193 , entonces dnsmasq no escuchará automáticamente en la interface
194 loopback. Para obtener esto, su dirección IP, 127.0.0.1, debe ser
195 explícitamente brindada como una opción
198 .B \-z, --bind-interfaces
199 En sistemas que inluyen el soporte, dnsmasq acopla la dirección
200 de comodín, aún cuando está escuchando solamente en algunas
201 interfaces. Entonces descarta búsquedas a las cuales no debe
202 responder. Esto tiene la ventaja de funcionar aún cuando
203 interfaces van y vienen y cambian direcciones. Esta opción forza
204 a dnsmasq a acoplarse realmente solo a las interfaces en
205 las cuales está escuchando. Casi la única vez que esto es útil
206 es cuando se está corriendo otro servidor DNS (o otra instancia
207 de dnsmasq) en la misma máquina. Fijar esta opción tambien
208 habilita multiples instancias de dnsmasq, las cuales proveen
209 servicio DHCP en la misma máquina.
211 .B \-y, --localise-queries
212 Retornar respuestas a búsquedas DNS desde /etc/hosts las cuales dependen
213 de la interface donde entró la búsqueda. Si un nombre en /etc/hosts tiene
214 mas de una dirección asociada con el, y por lo menos una de esas direcciones
215 está en la misma subred de la interface donde fue enviada, entónces
216 retornar solo las direcciones en esa subred. Esto permite a un servidor
217 tener direcciones múltiples en /etc/hosts correspondientes a cada una de
218 sus interfaces y cada host recibirá la respuesta adecuada
219 dependiendo de cual red tengan adjunta. Por el momento, esta facilidad
220 está limitada a IPv4.
223 Búsquedas privadas reversas raras. Toda búsqueda reversa para rangos de IP
224 privados (192.168.x.x, etc.) los cuales no se encuentren en
225 /etc/hosts o en el archivo de arriendos DHCP es respondida con
226 "dominio no existente" en vez de ser reenviada upstream.
228 .B \-V, --alias=<IP viejo>,<IP nuevo>[,<máscara>]
229 Modificar direcciones IPv4 retornadas desde servidores DNS upstream;
230 <IP viejo> es remplazado con <IP nuevo>. Si la máscara opcional
231 es brindada, entonces cualquier dirección que coincida con el
232 <IP viejo> enmascarado será re-escrita. Así que, por ejemplo,
233 .B --alias=1.2.3.0,6.7.8.0,255.255.255.0 trazará 1.2.3.56 a 6.7.8.56
234 y 1.2.3.67 a 6.7.8.67. Esto es lo que
235 ruteadores Cisco PIX llaman "DNS doctoring".
237 .B \-B, --bogus-nxdomain=<dirección IP>
238 Transformar respuestas que contienen la dirección IP brindada a
239 respuestas tipo "Dominio no existe". La intención de esto es actuar
240 en contra de una movida desviada hecha por Verisign en septiembre
241 del 2003, cuando comenzaron a retornar la dirección de un servidor
242 de publicidad en respuesta a búsquedas por nombres no registrados,
243 en vez de la correcta respuesta NXDOMAIN. Esta opción le dice a dnsmasq
244 que debe forjear la respuesta correcta cuando ve este comportamiento.
245 Para septiembre 2003 la dirección IP siendo retornada por Verisign
248 .B \-f, --filterwin2k
249 Algunas versiones de Windows hacen búsquedas DNS periódicas las cuales no
250 reciben respuestas sensibles desde el DNS público y pueden causar problemas
251 activando enlaces marcación-en-demanda. Esta opción filtra dichas búsquedas.
252 Las búsquedas filtradas son para registros tipo SOA y SRV, al igual que
253 tipo ANY donde el nombre pedido contiene _, para atrapar búsquedas LDAP.
255 .B \-r, --resolv-file=<archivo>
256 Leer las direcciones IP de servidores DNS upstream desde <archivo>,
257 en vez de /etc/resolv.conf. Para el formato de este archivo, ver
259 Las únicas líneas relevantes a dnsmasq son las de servidores DNS. A
260 dnsmasq se le puede decir que revise más de un archivo resolv.conf,
261 el primer archivo especificado remplaza al predeterminado, y los
262 subsiguientes son agregados a la lista. Esto es solo
263 permitido al hacer polling; el archivo con la actual fecha
264 de modificación más nueva es el que será usado.
267 No leer /etc/resolv.conf. Obtener los servidores DNS upstream solo
268 desde la línea de comandos o desde el archivo de configuración de
271 .B \-1, --enable-dbus
272 Permitir que la configuración de dnsmasq sea actualizada vía llamadas
273 de método DBus. La configuración que puede ser cambiada es servidores
274 DNS upstream (y dominios correspondientes) y limpieza de caché. Esta
275 opción requiere que dnsmasq haya sido compilado con soporte para DBus.
277 .B \-o, --strict-order
278 Por predeterminado, dnsmasq enviará búsquedas a cualquiera de los
279 servidores upstream que conoce, y trata de favorecer servidores los
280 cuales sabe que están activos. Fijar esta opción forza a dnsmasq a
281 probar cada búsqueda con cada servidor estrictamente en el orden
282 que aparecen en /etc/resolv.conf
285 Por predeterminado, cuando dnsmasq tiene más de un servidor upstream
286 disponible, enviará búsquedas a solo un servidor. Fijar esta opción
287 forza a dnsmasq a enviar todas las búsquedas a todos los servidores
288 disponibles. La respuesta del servidor que responda primero será
289 devuelta al solicitante original.
292 Denegar (y bitacorear) direcciones de servidores upstream que están
293 dentro de rangos IP privados. Esto bloquea un ataque donde un navegador
294 detrás de un firewall es usado para analizar máquinas en la red local.
297 No revisar periodicamente a /etc/resolv.conf en busca de cambios.
300 Cuando sea que /etc/resolv.conf es re-leida, liberar el caché DNS.
301 Esto es útil cuando servidores DNS nuevos puedan tener datos diferentes
302 a los contenidos en el caché.
304 .B \-D, --domain-needed
305 Le dice a dnsmasq que no debe reenviar búsquedas para nombres sencillos,
306 sin puntos o partes de dominios, a servidores upstream. Si el nombre
307 no se conoce desde /etc/hosts o desde DHCP entonces una respuesta
308 "no encontrado" es devuelta.
310 .B \-S, --local, --server=[/[<dominio>]/[dominio/]][<dirección IP>[#<puerto>][@<IP de remitente>|<interface>[#<puerto>]]
311 Especificar la dirección IP de servidores upstream directamente. Fijar
312 esta opción no suprime la lectura de /etc/resolv.conf, use -R para
313 hacer eso. Si uno a más dominios opcionales son brindados, ese servidor
314 es usado solo para esos dominios y las búsquedas son hechas usando
315 el servidor especificado solamente. La intención de esto es para el
316 uso con servidores DNS privados: si usted tiene un servidor DNS en su
317 red el cual lidea con nombres de la forma
318 xxx.internal.thekelleys.org.uk en 192.168.1.1 entonces brindar la
320 .B -S /internal.thekelleys.org.uk/192.168.1.1
321 enviará todas las búsquedas de máquinas internas a ese servidor DNS,
322 todas las demás búsquedas serán enviadas a los servidores en
323 /etc/resolv.conf. Una especificación de dominio en blanco,
325 tiene el significado especial de "solo nombres no calificados", o
326 sea nombres sin ningún punto en ellos. Un puerto no-estándar puede
327 ser especificado como parte de la dirección IP usando el caracter
328 #. Más de una opción -S es permitida, con partes de dominio o
329 dirección IP repetidas como sea necesario.
331 También se permite una opción -S la cual brinda un dominio pero
332 ninguna dirección IP; esto le dice a dnsmasq que un dominio es local
333 y puede responder a búsquedas desde /etc/hosts o DHCP pero nunca
334 deberá reenviar búsquedas en ese dominio a ningún servidor upstream.
338 para hacer los archivos de configuración mas claros en este caso.
340 El string opcional despues del carácter @ le dice a dnsmasq como fijar
341 el remitente de las búsquedas hacia este servidor DNS. Debe ser una
342 dirección IP, la cual debe ser perteneciente a la máquina en la cual
343 corre dnsmasq, de forma contraria esta línea de servidor será bitacoreada
344 y después ignorada, o un nombre de interface. Si un nombre de interface
345 es brindado, entonces búsquedas hacia el servidor serán forzadas vía esa
346 interface; si una dirección IP es brindada, entonces la dirección de
347 remitente de las búsquedas será fijada a esa dirección.
348 La etiqueta query-port es ignorada para cualquier servidores que tengan
349 una dirección remitente especificada, pero el puerto puede ser
350 especificado directamente como parte de la dirección remitente. Forzar
351 búsquedas a una interface no está implementado en todas las plataformas
352 soportadas por dnsmasq.
354 .B \-A, --address=/<dominio>/[dominio/]<dirección IP>
355 Especificar una dirección IP para retornar por cualquier host en
356 los dominios brindados. Búsquedas en estos dominios nunca son
357 reenviadas, y siempre son respondidas con la dirección IP
358 especificada, la cual puede ser IPv4 o IPv6. Para brindar ambas
359 direcciones IPv4 y IPv6 para un dominio, usar opciones -A repetidas.
360 Nótese que /etc/hosts y arriendos DHCP invalidan esto para nombres
361 individuales. Un uso común para esto es redireccionar el dominio
362 doubleclick.net entero a algún servidor web local amigable para
363 evitar banners de publicidad. La especificación funciona de la misma
364 forma que con --server, con la facilidad adicional que /#/ coincide
365 con cualquier dominio. De tal forma, --address=/#/1.2.3.4 siempre
366 retornará 1.2.3.4 para cualquier búsqueda no respondida desde
367 /etc/hosts o DHCP y que no haya sido enviada a un servidor DNS
368 upstream por una directiva --server mas especifica.
370 .B \-m, --mx-host=<nombre mx>[[,<nombre de host>],<preferencia>]
371 Retornar un record llamado <mx name> apuntando hacia el nombre de
372 host brindado (opcionalmente), o el host especificado en la opción
373 --mx-target, o si esa opción no es brindada, el host en el cual
374 dnsmasq está corriendo. El predeterminado es útil para redireccionar
375 correo de sistemas en la red local hacia un servidor central. La
376 opción de preferencia es opcional, y su predeterminado es 1 si no
377 es brindada. Más de un record MX puede ser brindado para un host.
379 .B \-t, --mx-target=<nombre de host>
380 Especificar el target predeterminado para el record MX devuelto
381 por dnsmasq. Ver --mx-host. Si --mx-target es brindado, pero no
382 --mx-host, entonces dnsmasq devuelve un record MX conteniendo
383 el target MX para búsquedas MX en el nombre de host de la máquina donde
384 dnsmasq está corriendo.
387 Retornar un record MX apuntándose a sí mismo para cada máquina local.
388 Máquinas locales son aquellas en /etc/hosts o con arriendos DHCP.
391 Retornar un record MX apuntando al host brindado por mx-target (o
392 la máquina donde dnsmasq está corriendo) para cada máquina local.
393 Máquinas locales son aquellas en /etc/hosts o con arriendos DHCP.
395 .B \-W, --srv-host=<_servicio>.<_prot>.[<dominio>],[<target>[,<puerto>[,<prioridad>[,<peso>]]]]
396 Retornar un record DNS SRV. Ver RFC2782 para detalles. Si no es
397 brindada, el dominio se predetermina a el brindado por
399 El predeterminado para el dominio target está vacío, el predeterminado
400 para puerto es uno, y los predeterminados para peso y prioridad son cero.
401 Tener cuidado al transponer data desde archivos de zona BIND: los
402 números de puerto, peso, y prioridad están en un orden diferente. Más
403 de un record SRV para un servicio/dominio es permitido, todos los que
404 coincidan son retornados.
406 .B \-Y, --txt-record=<nombre>[[,<texto>],<texto>]
407 Retornar un récord DNS TXT. El valor del récord TXT es una serie de
408 strings, así que cualquier número puede ser incluido, dividido por
411 .B --ptr-record=<nombre>[,<target>]
412 Retornar un récord DNS PTR.
414 .B --naptr-record=<nombre>,<orden>,<preferencia>,<opciones>,<servicio>,<regexp>[,<remplazo>]
415 Retornar un récord DNS NAPTR, como especificado en RFC3403.
417 .B --cname=<cname>,<target>
418 Retornar un expediente CNAME que indica que <cname> es realmente <target>. Hay
419 limitaciones significativas en el target. Debe ser un nombre DNS que le es conocido
420 a dnsmasq desde /etc/hosts (o archivos hosts adicionales) o de DHCP. Si el target
421 no satisface este criterio, el cname entero es ignorado. El cname debe ser único,
422 pero es permisible tener más de un cname indicando el mismo target.
424 .B --interface-name=<nombre>,<interface>
425 Retornar un expediente DNS, asociando el nombre con la dirección primaria
426 en la interface brindada. Esta opción especifica un expediente tipo A
427 para el nombre brindado de la misma forma que una línea de /etc/hosts,
428 excepto que la dirección no es constante y es en vez tomada de la
429 interface brindada. Si la interface está deshabilitada, nó configurada,
430 o nó existente, un récord vacío es devuelto. El récord PTR relevante
431 tambien es creado, trazando la dirección de la interface a el nombre.
432 Más de un nombre puede ser asociado con una dirección de interface,
433 repitiendo la opción. En tal caso, la primera instancia es usada para
434 la traza reversa dirección-a-nombre.
436 .B \-c, --cache-size=<tamaño de caché>
437 Fijar el tamaño del caché de dnsmasq. El predeterminado es 150 nombres.
438 Fijar el tamaño a cero deshabilita el caché.
440 .B \-N, --no-negcache
441 Deshabilitar caché negativo. El caché negativo le permite a dnsmasq
442 recordar resultados tipo "dominio no existe" desde servidores DNS
443 upstream y responder búsquedas idénticas sin reenviarlas nuevamente.
445 .B \-0, --dns-forward-max=<búsquedas>
446 Fijar el número máximo de búsquedas DNS simultáneas. El valor
447 predeterminado es 150, lo cuál debería estar bien para la mayoría
448 de casos. La única situación conocida donde esto debe ser incrementado
449 es al usar resolvedores de bitácoras de servidores web, los cuales pueden
450 generar un número inmenso de búsquedas simultáneas.
452 .B \-F, --dhcp-range=[[net:]network-id,]<dirección-inicio>,<dirección-final>[[,<máscara>],<broadcast>][,<tiempo de arriendo predeterminado>]
453 Habilitar el servidor DHCP. Direcciones serán distribuidas desde el
454 rango <dirección-inicio> hasta <dirección-final> y desde direcciones definidas
455 estáticamente en opciones
457 Si el tiempo de arriendo es especificado, entonces arriendos serán
458 otorgados por esa cantidad de tiempo. El tiempo de arriendo es en
459 segundos, o minutos (por ejemplo, 45m), o horas (por ejemplo, 1h), o el
460 literal "infinite". Esta opción puede ser repetida, con diferentes
461 direcciones, para habilitar servicio DHCP en más de una red. Para
462 redes conectadas diréctamente (en otras palabras, redes en las
463 cuales la máquina corriendo dnsmasq tiene una interface) la
464 máscara de subred es opcional. Pero, es requerida para redes que
465 reciben servicio DHCP vía un agente de relay. La dirección de
466 broadcast siempre es opcional. En algunos sistemas rotos, dnsmasq
467 solo puede escuchar en una interface cuando se usa DHCP, y el
468 nombre de esa interface debe ser brindado usando la opción
470 Esta limitación actualmente afecta a OpenBSD antes de versión 4.0.
471 Siempre se permite tener más de un rango dhcp (dhcp-range) en una
472 subred. El parámetro opcional network-id es una etiqueta alfanumérica
473 la cual marca esta red de tal forma que opciones dhcp puedan ser
474 especificadas en base a cada red.
475 Cuando es prefijada con 'net:' entonces el significado cambia
476 de "fijar etiqueta" a "coincidir con etiqueta". Solo una etiqueta puede
477 ser fijada, pero más de una puede ser revisada por coincidencias. La
478 dirección final puede ser remplazada por la palabra clave
480 la cual le dice a dnsmasq que debe habilitar DHCP para la red
481 especificada, pero no alocar dinámicamente direcciones IP.
482 Solo hosts que tienen direcciones estáticas brindadas vía
484 o desde /etc/ethers serán servidas.
486 .B \-G, --dhcp-host=[<dirección de hardware>][,id:<client_id>|*][,net:<netid>][,<dirección IP>][,<nombre de host>][,<tiempo de arriendo>][,ignore]
487 Especificar parámetros por host para el servidor DHCP. Esto permite
488 que una máquina con una dirección de hardware particular sea siempre
489 alocada el mismo nombre de host, dirección IP, y tiempo de arriendo.
490 Un nombre de host especificado de esta manera toma presedencia
491 sobre cualquiera suministrado por el cliente DHCP en la máquina.
492 También se permite omitir la direccion de hardware y incluir el
493 nombre de host; en tal caso la dirección IP y los tiempos de arriendo
494 serán aplicables a cualquier máquina que reclame ese nombre.
496 .B --dhcp-host=00:20:e0:3b:13:af,wap,infinite
497 le dice a dnsmasq que debe darle a la máquina con dirección
498 ethernet 00:20:e0:3b:13:af el nombre wap, y un arriendo DHCP infinito.
499 .B --dhcp-host=lap,192.168.0.199
500 le dice a dnsmasq que siempre debe alocarle a la maquina lap
501 la dirección IP 192.168.0.199. Direcciones alocadas de esta manera
502 no tienen que estar dentro del rango dado con la opción --dhcp-range,
503 pero deben estar en la red siendo servida por el servidor DHCP. Se
504 permite usar identificadores de clientes en vez de direcciones de
505 hardware para identificar hosts prefijando 'id:'. O sea que:
506 .B --dhcp-host=id:01:02:03:04,.....
507 se refiere al host con identificador de cliente 01:02:03:04.
508 También se permite especificar el ID de cliente como texto, así:
509 .B --dhcp-host=id:iddeclientecomotexto,.....
511 La opción especial id:* significa "ignorar cualquier ID de cliente
512 y usar solamente direcciones MAC." Esto es útil cuando un cliente
513 presenta un ID de cliente algunas veces pero otras no.
515 Si un nombre aparece en /etc/hosts, la dirección asociada puede
516 ser alocada a un arriendo DHCP, pero solo si existe una opción
518 la cual especifica el nombre también. La palabra clave "ignore"
519 le dice a dnsmasq que no debe ofrecer jamás un arriendo DHCP a
520 una máquina. La máquina puede ser especificada por dirección de
521 hardware, ID de cliente, o nombre de host, por ejemplo:
522 .B --dhcp-host=00:20:e0:3b:13:af,ignore
523 Esto es útil cuando hay otro servidor DHCP en la red que debe ser
524 usado por algúnas máquinas.
526 El net:<network-id> fija la etiqueta network-id cuando sea que
527 esta directiva dhcp-host está en uso. Esto puede ser usado para
528 enviar selectivamente opciones DHCP a este host. Cuando un host
529 coincide con cualquier directiva dhcp-host (o una implicada por
530 /etc/ethers) entonces la etiqueta network-id especial "known" es
531 fijada. Esto permite que dnsmasq sea configurado para ignorar
532 pedidos desde máquinas desconocidas usando
533 .B --dhcp-ignore=#known
534 Direcciones ethernet (pero no client-ids) pueden tener bytes
535 comodínes, así que por ejemplo
536 .B --dhcp-host=00:20:e0:3b:13:*,ignore
537 causará que dnsmasq ignore un rango de direcciones ethernet. Nótese
538 que el "*" necesitará ser escapado o escrito entre comillas en la
539 línea de comandos, pero no en el archivo de configuración.
541 Direcciones de hardware normalmente coinciden con cualquier
542 tipo de red (ARP), pero es posible restringirlas a un tipo ARP
543 singular precediendolo con el tipo ARP (en HEX) y "-". Así que
544 .B --dhcp-host=06-00:20:e0:3b:13:af,1.2.3.4
545 solo coincidiría con una dirección de hardware Token-Ring, dado que
546 el tipo ARP para Token-Ring es 6.
548 Como caso especial, es posible incluir más de una dirección de
549 hardware. Esto permite que una dirección IP sea asociada con
550 direcciones de hardware múltiples, y le brinda a dnsmasq permiso
551 para abandonar un arriendo DHCP a una de las direcciones de hardware
552 cuando otra pide un arriendo. Nótese que esto es algo peligroso,
553 sólo funcionará dependiblemente si una de las direcciones de hardware
554 está activa en cualquier momento y dnsmasq no tiene forma de enforzar
555 esto. Pero es útil, por ejemplo, para alocar una dirección IP estable
556 a una laptop que tiene interfaces alámbricas e inalámbricas.
558 .B --dhcp-hostsfile=<archivo>
559 Leer información host DHCP desde el archivo especificado. El archivo contiene informació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ón host DHCP en este archivo es que puede ser cambiada sin tener que reiniciar dnsmasq. El archivo será re-leído cuando dnsmasq recibe un SIGHUP.
561 .B --dhcp-optsfile=<archivo>
562 Leer información sobre opciones DHCP desde el archivo especificado. La
563 ventaja de usar esta opción es la misma que con --dhcp-hostsfile: el
564 archivo dhcp-optsfile será re-leído cuando dnsmasq recibe un SIGHUP.
566 .B \-Z, --read-ethers
567 Leer /etc/ethers en busca de información sobre hosts para el servidor
568 DHCP. El formato de /etc/ethers es una dirección de hardware, seguida
569 por ya sea un nombre de host o una dirección IP. Al ser leidas por
570 dnsmasq, estas líneas tienen exáctamente el mismo efecto que opciones
572 que contienen la misma información. /etc/ethers es re-leída cuando dnsmasq recibe un SIGHUP.
574 .B \-O, --dhcp-option=[<network-id>,[<network-id>,]][vendor:[<vendor-class>],][<opt>|option:<opt-name>],[<value>[,<value>]]
575 Especificar opciones diferentes o extra a clientes DHCP. Por
576 predeterminado, dnsmasq envía algunas opciones estándar a clientes
577 DHCP. La máscara de subred y dirección broadcast son fijadas igual
578 a las del host que corre dnsmasq, y el servidor DNS y ruteador
579 a la dirección de la máquina que corre dnsmasq. Si la opción de
580 nombre de dominio ha sido fijada, es enviada. Esta opción permite
581 que esos predeterminados sean sobrescritos, o que sean especificadas
582 otras opciones. La opción a ser enviada puede ser brindada como un
583 número decimal o como "option:<option-name>". Los números de opción
584 están especificados en RFC2132 y RFCs subsiguientes. El juego de
585 option-names conocido por dnsmasq puede ser descubierto ejecutando
586 "dnsmasq --help dhcp". Por ejemplo, para fijar la ruta predeterminada a
587 192.168.4.4, hágase un
588 .B --dhcp-option=3,192.168.4.4
590 .B --dhcp-option=option:router, 192.168.4.4
591 y para fijar la dirección de servidor de tiempo a 192.168.0.4,
593 .B --dhcp-option=42,192.168.0.4
595 .B --dhcp-option=option:ntp-server, 192.168.0.4
596 La dirección especial 0.0.0.0 es entendida que significa "la
597 dirección de la máquina que corre dnsmasq". Tipos de data permitidos
598 son direcciones IP de cuatro segmentos, un número decimal, dígitos hex
599 separados por colones, y un string de texto. Si las network-ids
600 opcionales son brindadas, entonces esta opción es solo enviada cuando
601 todas las network-ids coinciden.
603 Procesamiento especial es llevado a cabo en un argumento de texto para
604 la opción 119, en conforme con RFC3397. Direcciones IP textuales o de
605 cuatro segmentos como argumentos a la opción 120 son manejados mediante
606 RFC3361. Direcciones IP de cuatro segmentos que son seguidas por un diagonal
607 (slash) y después una máscara son codificados mediante RFC3442.
609 Tener cuidado: niguna verificación es hecha sobre si el número de tipo
610 correcto es enviado, y es muy posible persuadir a dnsmasq para que
611 genere paquetes DHCP ilegales mediante uso inadecuado de esta opción.
612 Cuando el valor es un número decimal, dnsmasq debe determinar qué tan
613 grande es el objeto de data. Esto es hecho mediante una examinación del
614 número de opción, y/o el valor, pero puede ser invalidado agregándole
615 una opción de una sola letra de esta forma: b = un byte, s = dos bytes,
616 i = cuatro bytes. Esto es principalmente útil con opciones encapsuladas
617 tipo vendedor (ver abajo) donde dnsmasq no puede determinar el tamaño
618 de data usando el número de opción. Data de opción la cual consiste
619 solo de puntos y dígitos será interpretada por dnsmasq como una
620 dirección IP, y será insertada dentro de una opción de esa manera.
621 Para forzar un string literal, usar comillas. Por ejemplo, cuando se
622 usa la opción 66 para enviar una IP literal como un nombre de servidor
623 TFTP, es necesario hacer:
624 .B --dhcp-option=66,"1.2.3.4"
626 Opciones encapsuladas vendor-class también pueden ser especificadas usando
627 --dhcp-option: por ejemplo
628 .B --dhcp-option=vendor:PXEClient,1,0.0.0.0
629 envía la opción específica de clase de vendedor "mftp-address=0.0.0.0" a
630 cualquier cliente cuyo vendor-class
631 coincida con "PXEClient". El revisado de coincidencias vendor-class está
632 basado en substrings (ver --dhcp-vendorclass para detalles). Si una opción
633 vendor-class (número 60) es enviada por dnsmasq, entonces es usada para
634 seleccionar opciones encapsuladas en preferencia sobre cualquiera enviada
635 por el cliente. Es posible omitir el vendorclass completamente;
636 .B --dhcp-option=vendor:,1,0.0.0.0
637 caso en el cuál la opción encapsulada siempre es enviada. La dirección
638 0.0.0.0 no es tratada de forma especial en opciones de clase de vendedor
641 .B --dhcp-option-force=[<network-id>,[<network-id>,]][vendor:[<vendor-class>],]<opt>,[<value>[,<value>]]
642 Esto funciona exáctamente de la misma forma que
644 excepto que la opción siempre será enviada, aún si el cliente no la pide en
645 la lista de pedido de parámetros. Esto se necesita aveces, por ejemplo cuando
646 enviando opciones a PXELinux.
648 .B --dhcp-no-override
649 Deshabilitar la reutilización de los campos DHCP de nombre de servidor y
650 archivo como espacio para opciones extra. Si puede, dnsmasq mueve la información
651 del servidor boot y del nombre de archivo (de dhcp-boot) de sus campos dedicados
652 hacia opciones DHCP. Esto crea espacio extra en el paquete DHCP para opciones,
653 pero puede raramente confundir clientes viejos o defectuosos. Esta opción forza
654 comportamiento "simple y sencillo" para prevenir problemas en tales casos.
656 .B \-U, --dhcp-vendorclass=<network-id>,<vendor-class>
657 Trazar desde un string vendor-class a un network id. La mayoría de los
658 clientes DHCP proveen una "vendor class" la cual representa, en cierto
659 sentido, el tipo de host. Esta opción traza clases de vendedor a network
660 ids, de tal forma que opciones DHCP pueden ser selectivamente entregadas
661 a diferentes clases de hosts. Por ejemplo
662 .B dhcp-vendorclass=printers,Hewlett-Packard JetDirect
663 peritiría que opciones sean fijadas solo para impresoras HP así:
664 .B --dhcp-option=printers,3,192.168.4.4
665 El string vendor-class es coordinado con el vendor-class proveido por
666 el cliente, para permitir coincidencias borrosas.
668 .B \-j, --dhcp-userclass=<network-id>,<user-class>
669 Trazar desde un string user-class a un network id (con coordinación
670 substring, como con vendor-class). La mayoría de los clientes DHCP
671 proveen un "user class" el cual es configurable. Esta opción traza
672 clases user a network ids, de tal manera que opciones DHCP puedan
673 ser selectivamente enviadas a diferentes tipos de hosts. Es posible,
674 por ejemplo, usar esto para especificar una impresora diferente para
675 hosts en la clase "cuentas" que para los de la clase "ingenieria".
677 .B \-4, --dhcp-mac=<network-id>,<dirección MAC>
678 Trazar desde una dirección MAC a una network id. La dirección MAC
679 puede incluir comodínes. Por ejemplo:
680 .B --dhcp-mac=3com,01:34:23:*:*:*
681 fijaría el tag "3com" a cualquier host el cual su MAC coincida con
684 .B --dhcp-circuitid=<network-id>,<circuit-id>, --dhcp-remoteid=<network-id>,<remote-id>
685 Trazar de opciones agente de relay RFC3046 a opciones network-id. Estos
686 datos pueden ser proveídos por agentes de relay DHCP. El circuit-id o
687 remote-id es normlamente brindado como hex separado por doblepuntos, pero
688 también se permite un string simple. Si se obtiene una coincidencia exacta
689 entre el circuit o agent ID y uno proveído por un agente de relay,
690 network-id es fijado.
692 .B --dhcp-subscrid=<network-id>,<subscriber-id>
693 Trazar de opciones relay subscriber-id RFC3993 a opciones network-id.
695 .B --dhcp-match=<network-id>,<número de opción>
696 Fijar la opción network-id si el cliente envía un opción DHCP del nombre
697 brindado. Esto puede ser utilizado para identificar clientes particulares
698 que envían información usando números privados de opciones.
700 .B \-J, --dhcp-ignore=<network-id>[,<network-id>]
701 Cuando todos los network ids brindados coincidan con el juego de
702 network ids derivados de las clases net, host, y vendor, ignorar
703 el host y no brindarle un arriendo DHCP.
705 .B --dhcp-ignore-names[=<network-id>[,<network-id>]]
706 Cuando todos los network-ids brindados coinciden con el juego de
707 network-ids derivado de la red, host, classes de vendedor y usuario,
708 ignorar cualquier nombre de host proveido por el host. Nótese que,
709 a diferencia de dhcp-ignore, es permisible no brindar ningún tag netid,
710 y en tal caso nombres de host proveidos por clientes DHCP siempre son
711 ignorados, y hosts DHCP son agregados al DNS usando solo la configuración
712 dhcp-host en dnsmasq y el contenido de /etc/hosts y /etc/ethers.
714 .B --dhcp-broadcast=<network-id>[,<network-id>]
715 Cuando todos los network-ids brindados coinciden con el juego de network-ids
716 derivados de la red, host, clases de vendedor y usuarios, siempre usar
717 broadcast para comunicarse con el host cuando está sin configurar. La
718 mayoría de clientes DHCP que necesitan respuestas broadcast fijan una
719 opción en sus pedidos para que esto pase automaticamente, algunos
720 clientes BOOTP viejos no lo hacen.
722 .B \-M, --dhcp-boot=[net:<network-id>,]<filename>,[<servername>[,<server address>]]
723 Fijar opciones BOOTP que han de ser devueltas por el servidor DHCP. Nombre
724 y dirección de servidor son opcionales: si no son brindadas, el nombre es
725 dejado en blanco, y la dirección es fijada a la de la máquina que corre
726 dnsmasq. Si dnsmasq está brindando servicio TFTP (ver
728 ) entonces solo el nombre de archivo es requirido aquí para habilitar
729 el inicio atravéz de una red. Si las opcionales network-ids son brindadas,
730 ellas deberán coincidir para que esta configuración sea enviada. Nótese
731 que network-ids están prefijadas con "net:" para distinguirlas.
733 .B \-X, --dhcp-lease-max=<número>
734 Limita a dnsmasq a el número especificado de arriendos DHCP. El
735 predeterminado es 150. El limite es para prevenir ataques DoS desde
736 hosts que crean cientos de arriendos y usan mucha de la memoria del
739 .B \-K, --dhcp-authoritative
740 Esta opción debe ser fijada cuando dnsmasq es definitivamente el único
741 servidor DHCP en la red. Cambia el comportamiento de RFC de tal manera
742 que pedidos desde hosts no conocidos no serán ignorados. Esto permite que
743 hosts nuevos puedan conseguir un arriendo sin sin un timeout bajo toda
744 circunstancia. También permite que dnsmasq reconstruya su base de datos
745 de arriendos sin que cada cliente necesite readquirir un arriendo
746 si la base de datos es perdida.
748 .B --dhcp-alternate-port[=<puerto de servidor>[,<puerto de cliente>]]
749 Cambiar del predeterminado los puertos usados para DHCP. Si esta opción
750 es brindada sola, sin argumentos, cambia los puertos usados para DHCP
751 de 67 y 68 a 1067 y 1068. Si un solo argumento es brindado, ese puerto
752 es usado para el servidor y el número de puerto mas uno es usado
753 para el cliente. Finalmente, dos números permiten que se especifiquen
754 ambos los puertos de servidor y cliente para DHCP.
756 .B \-3, --bootp-dynamic[=<network-id>[,<network-id>]]
757 Habilitar alocación dinámica de direcciones IP a clientes BOOTP. Usar
758 esto con cuidado, ya que cada dirección alocada a un cliente BOOTP
759 es arrendada para siempre, y consecuentemente queda no-disponible
760 para re-uso por otros hosts. Si esto es brindado sin etiquetas,
761 entonces incondicionalmente habilita alocación dinámica. Con
762 etiquetas, solo cuando todas las etiquetas están fijadas. Puede
763 ser repetido con diferentes juegos de etiquetas.
766 Por predetermindado, el servidor DHCP tratará de asegurarse que una
767 dirección no esté en uso antes de alocarsela a un host. Hace esto
768 enviando un echo ICMP (ping) a la dirección referente. Si recibe una
769 respuesta, entonces la dirección debe estar siendo usada, y se repite
770 la prueba con otra. Esta opción deshabilita esta prueba. Usar con
774 Bitacoréo extra para DHCP: Bitacorear todas las opciones enviadas a
775 clientes DHCP y las etiquetas netid usadas para determinarlos.
777 .B \-l, --dhcp-leasefile=<path>
778 Usar el archivo especificado para almacenar información de arriendos
779 DHCP. Si esta opción es brindada, pero ninguna opcion dhcp-range es
780 brindada, entonces se activa comportamiento tipo dnsmasq versión 1.
781 El archivo brindado se asume es un archivo de arriendos dhcpd ISC y
782 es analizado en busca de arriendos los cuales son agregados al sistema
783 DNS si tienen un nombre de host. Esta funcionalidad pudo haber sido
784 excluida de dnsmasq a la hora de compilación, y en tal caso ocurrirá
785 un error. Nótese que la integración de archivos de
786 arriendo ISC es una caracterísctica depreciada. No debería ser usada
787 en instalaciones nuevas, y será eliminada en una versión futura.
789 .B \-6 --dhcp-script=<path>
790 Cuando un arriendo DHCP nuevo es creado, o uno viejo es
791 destruido, el ejecutable especificado por esta opción es ejecutado.
792 Los argumentos para el binario son "add", "old", o "del", la dirección
793 MAC del host, la dirección IP, y el hostname, si es
794 conocido. "add" significa que un arriendo ha sido creado, "del" que
795 ha sido destruido, y "old" es una notificación de un arriendo existente
796 cuando dnsmasq inicia o un cambio a una MAC o nombre host de un arriendo
797 existente (también, tiempo de arriendo o vencimiento y client-id, si
798 leasefile-ro está fijado). Si la dirección MAC es de un tipo de red
799 que no es ethernet, tendrá el tipo de red precolocado, por ejemplo
800 "06-01:23:45:67:89:ab" para token ring. El proceso es ejecutado como root
801 (asumiendo que dnsmasq fue originalmente ejecutado como root) aún si dnsmasq
802 está configurado para cambiar su UID a un usuario sin privilegios.
803 El ambiente es heredado del usuario que ha invocado a dnsmasq, y si el
804 host brindó un client-id, es almacenado en la variable de ambiente
805 DNSMASQ_CLIENT_ID. Si el dominio completamente calificado del host
806 es conocido, la parte de dominio es almacenada en DNSMASQ_DOMAIN. Si
807 el cliente brinda información de clase de vendedoro usuario,
808 estos son brindados en las variables DNSMASQ_VENDOR_CLASS y
809 DNSMASQ_USER_CLASS0..DNSMASQ_USER_CLASSn, pero solo para acciones "add"
810 y "old" cuando un host resume un arriendo existente, dado a que estos
811 datos no son almacenados en la base de datos de arriendos de dnsmasq.
812 Si dnsmasq fue compilado con HAVE_BROKEN_RTC, entonces la duración del
813 arriendo (en segundos) es almacenada en DNSMASQ_LEASE_LENGTH, de otra
814 manera el tiempo de vencimiento es almacenado en DNSMASQ_LEASE_EXPIRES.
815 El número de segundos faltante para el vencimiento del arriendo siempre
816 es almacenado en DNSMASQ_TIME_REMAINING.
817 Si un arriendo solía tener un nombre de host, el cual es removido, un
818 evento "old" es generado con el nuevo estado del arriendo, (por ejemplo, sin
819 nombre), y el nombre anterior es brindado en la variable de ambiente
820 DNSMASQ_OLD_HOSTNAME. DNSMASQ_INTERFACE almacena el nombre de la interface
821 en la cual llegó el pedido; esto no es fijado para acciones "viejas"
822 cuando dnsmasq re-inicia.
823 Todos los descriptores de archivo están cerrados
824 excepto stdin, stdout, y stderr los cuales están abiertos a /dev/null
825 (excepto en modo debug).
826 Este guión no es invocado concurrentemente: si cambios de arriendos
827 subsiguientes ocurren, el guión no es invocado otra vez hasta que
828 cualquier invocación existente haga exit. Al inicio de dnsmasq, el guión
829 será invocado para todos los arriendos existentes mientras van siendo
830 leídos desde el archivo de arriendos. Arriendos vencidos serán llamados
831 con "del" y otros con "old". <path> debe ser un path absoluto, ninguna
832 búsqueda PATH ocurre. Cuando dnsmasq recibe una señal HUP, el guión será
833 invocado para arriendos existentes con un evento "old".
836 Especificar el usuario como el cual se debe correr el archivo
837 guión de cambio de arriendos. Este es root por predeterminado,
838 pero puede ser cambiado a otro usuario mediante esta opción.
840 .B \-9, --leasefile-ro
841 Suprimir completamente el uso del archivo de arriendos. El archivo no será
842 creado, leído, ni escrito. Cambiar la manera en la cuál el archivo guión de
843 cambio de arriendo (si es brindado) es llamado, de tal forma que la base de
844 datos de arriendospueda ser mantenida en almacenaje externo por el archivo
845 guión. Adicionálmente a las invocaciones brindadas en
847 el archivo de cambio de arriendos es llamado una vez, al inicio de dnsmasq,
848 con el único argumento "init". Cuando invocado de esta forma, el guión debería
849 escribir el estado guardado de la base de datos de arriendos, en formato de
850 archivo de arriendos dnsmasq, a stdout y hacer exit con código exit cero. Fijar
851 esta opción también forza que el archivo de cambio de arriendos sea llamado
852 cuando hay cambios hechos a el client-id y tiempos de arriendo y vencimiento.
854 .B --bridge-interface=<nombre de interface>,<alias>[,<alias>]
855 Tratar paquetes de pedidos DHCP que llegan a cualquiera de las interfaces <alias>
856 como si hubieran llegado a la interface <nombre de interface>. Esta opción solo
857 está disponible en plataformas BSD, y es necesaria cuando se usan
858 puentes "estilo viejo", ya que los paquetes llegan a interfaces tap que no
859 tienen una dirección IP.
861 .B \-s, --domain=<dominio>[,<rango de IPs>]
862 Especifica los dominios DNS para el servidor DHCP. Dominios pueden ser
863 brindados incondicionalmente (sin el rango de IPs) o para rangos limitados. Esto
864 tiene dos efectos: Primeramente, causa que el servidor DHCP le devuelva el
865 dominio a cualquier host que lo pida. Segundamente, fija el dominio para el
866 cual es legal para hosts configurados mediante DHCP reclamar. La intención es
867 restringir nombres de host para que un host no-confiado en la LAN no
868 pueda proclamar su nombre vía DHCP, como por ejemplo "microsoft.com" y
869 capturar tráfico no destinado a ella. Si ningún sufijo de dominio es
870 especificado, entonces cualquier nombre de host con una parte de dominio
871 (o sea con un punto) será negada y bitacorada. Si un sufijo es especificado,
872 entonces nombres de host con una parte de dominio son permitidos, con tal
873 que la parte de dominio coincida con el sufijo. Adicionalmente, cuando
874 un sufijo es fijado, entonces nombres de host sin parte de dominio tienen
875 el sufijo agregado como una parte de dominio opcional. Por ejemplo, en
877 .B --domain=thekelleys.org.uk
878 y tener una maquina cuyo nombre host DHCP es "laptop". La dirección IP
879 de esa máquina es disponible desde
881 como "laptop" y "laptop.thekelleys.org.uk". Si el dominio es brindado
882 como "#" entonces el dominio es leido desde la primera directiva search
883 en /etc/resolv.conf (o equivalente). El rango de direcciones puede ser
884 <dirección IP>,<dirección IP> or <dirección IP>/<máscara de subred>. Ver
885 .B --dhcp-fqdn el cual puede cambiar el comportamiento de dnsmasq con
889 En el modo predeterminado, dnsmasq pone los nombres no-calificados
890 de clientes DHCP en el DNS. Por esta razón, los nombres deben ser únicos,
891 aún si dos clientes que tienen el mismo nombre están en dominios
892 diferentes. Si un segundo cliente DHCP aparece el cual tiene el mismo
893 nombre que un cliente existente, el nombre es transferido al cliente nuevo. Si
895 está fijado, este comportamiento cambia: El nombre no-calificado
896 no es puesto en el DNS, solo el nombre calificado. Dos clientes DHCP con
897 el mismo nombre pueden ambos quedarse con el nombre, con tal que la parte
898 de dominio sea diferente (o sea que los nombres completamente calificados
899 difieran). Para asegurar que todos los nombres tengan una parte de dominio,
902 sin una dirección especificada cuando
907 Habilitar la función de servidor TFTP. Esto está deliberadamente limitado
908 a lo necesario para hacerle a un cliente un inicio vía red. Solo lectura es
909 permitida; las extensiones tsize y blksize son soportadas (tsize solo es
910 soportada en modo octeto).
912 .B --tftp-root=<directorio>
913 Buscar, relativo al directorio brindado, archivos para transferir mediante el
914 uso de TFTP. Cuando esta opción está fijada, paths TFTP que incluyen ".." son
915 rechazados, para prevenir que clientes salgan de la raíz especificada. Paths
916 absolutos (los que comienzan con "/") están permitidos, pero deben estar
917 dentro del tftp-root.
919 .B --tftp-unique-root
920 Agregar la dirección IP del cliente TFTP como un componente path del lado del
921 TFTP-root (en formato estándar de cuatro puntos). Solo válido si un tftp-root
922 está fijado y el directorio existe. Por ejemplo, si tftp-root es "/tftp" y el
923 cliente 1.2.3.4 pide el archivo "miarchivo" entonces el path efectivo será
924 "/tftp/1.2.3.4/miarchivo" si /tftp/1.2.3.4 existe o /tftp/miarchivo si no.
927 Habilitar modo TFTP seguro: sin esto, cualquier archivo que es leíble por el
928 proceso dnsmasq bajo reglas normales de control de acceso UNIX, está disponible
929 vía TFTP. Cuando la opción --tftp-secure es fijada, solo archivos
930 pertenecientes al usuario que corre el proceso dnsmasq están accesibles. Si
931 dnsmasq está corriendo como root, reglas diferentes aplican: --tftp-secure no
932 tiene ningún efecto, pero solo archivos que tienen el bit de lectura global
933 fijados están accesibles. No se recomienda correr dnsmasq como root con TFTP
934 habilitado, y mucho menos sin especificar --tftp-root, ya que se puede exponer
935 cualquier archivo de lectura global en el servidor a cualquier host de la red.
937 .B --tftp-max=<conecciones>
938 Fijar el número máximo permitido de conecciones TFTP simultáneas. Esto es 50
939 por predeterminado. Al servir un número grande de conecciones TFTP, límites
940 de descriptor de archivo por proceso pueden ser encontrados. Dnsmasq necesita
941 un descriptor de archivo por cada coneccion TFTP concurrente, y por archivo
942 único (mas algunos otros). De tal manera que servirle el mismo archivo
943 simultáneo a n clientes requerirá el uso de n + 10 descriptores de archivo,
944 y servirles archivos diferentes simultáneamente requerirá (2*n) + 10
947 es brindado, eso puede afectar el número de conexiones simultáneas.
949 .B --tftp-no-blocksize
950 No permitir que el servidor negocie la opción "blocksize" con un cliente.
951 Algunos clientes con errores piden esta opción pero se portán mal cuando se
954 .B --tftp-port-range=<inicio>,<final>
955 Un servidor TFTP escucha por inicios de conexión en un puerto bien conocido
956 (69), pero tambien usa un puerto dinamicamente seleccionado para cada
957 conexión. Normalmente estos son seleccionados por el sistema operativo,
958 pero esta opción especifica un rango de puertos para ser usado por transferencias
959 TFTP. Esto puede ser útil cuando TFTP tiene que pasar atraves de un firewall.
960 El comienzo del rango no puede ser menor a 1025 a menos que dnsmasq esté corriendo
961 como root. El número de conexiones simultáneas está limitado por el tamaño del
964 .B \-C, --conf-file=<archivo>
965 Especificar un archivo de configuración diferente. La opción conf-file
966 también es permitida en archivos de configuración, para incluir múltiples
967 archivos de configuración.
969 .B \-7, --conf-dir=<directorio>
970 Leer todos los archivos dentro del directorio brindado como archivos
971 de configuración. Archivos cuyos nombres terminen con ~ o comienzen
972 con . o comienzen y terminen con # son ignorados. Esta opción puede
973 ser brindada en la línea de comandos o en un archivo de configuración.
974 .SH ARCHIVO DE CONFIGURACION
975 Al inicio, dnsmasq lee
976 .I /etc/dnsmasq.conf,
977 si existe. (En FreeBSD, el archivo es
978 .I /usr/local/etc/dnsmasq.conf
979 ) (pero ver las opciónes
983 porfavor.) El formato de este archivo consiste de una opción por línea,
984 exáctamente como las opciones largas detalladas en la sección OPCIONES
985 pero sin el "--" al frente. Líneas que comienzan con # son comentarios
986 y son ignoradas. Para opciones que solo pueden ser especificadas una
987 sola vez, el archivo de configuración invalida la línea de comandos.
988 Las comillas son permitidas en el archivo de configuración: entre comillas
989 tipo " los significados especiales de ,:. y # son eliminados y los
990 siguientes escapes son permitidos: \\\\ \\" \\t \\e \\b \\r y \\n.
991 Corresponden a tab, escape, backspace, return y newline.
995 libera su cache y entonces recarga
999 al igual que cualquier archivo brindado con --dhcp-hostsfile, --dhcp-optsfile,
1001 El archivo guión de cambio de arriendos es llamado para todos los arriendos
1005 está fijado entonces SIGHUP también re-lee
1006 .I /etc/resolv.conf.
1008 NO re-lee el archivo de configuración.
1010 Al recibir un SIGUSR1,
1012 escribe estadísticas a la bitácora del sistema. Escribe el tamaño
1013 del caché, el numero de nombres que han tenido que ser removidos del
1014 caché antes de que vencieran para hacer espacio para nombres nuevos, y el
1015 número total de nombres que han sido insertados en el caché. Para cada
1016 servidor upstream brinda el número de búsquedas enviadas, y el
1017 número que resultaron en error. En modo
1019 o cuando bitacoréo completo está habilitado (-q), una descarga completa de
1020 el contenido del caché es hecha.
1022 Cuando recibe un SIGUSR2 y está bitacoreando diréctamente a un archivo (ver
1026 cerrará y reabrirá el archivo de bitácora. Nótese que durante esta
1027 operación, dnsmasq no estará corriendo como root. Al crear el archivo de
1028 bitácora, dnsmasq cambia el dueño del archivo a el usuario normal como
1029 el que correrá. Logrotate debe ser configurado para crear un archivo de
1030 bitácora nuevo con permisos iguales al existente, antes de enviar
1031 SIGUSR2. Si búsquedas DNS TCP están en progreso, el archivo de bitácora
1032 viejo se mantendrá abierto en procesos hijos que están manejando
1033 búsquedas TCP, y puede continuarse a escribirle. Hay un límite de 150
1034 segundos, después de lo cual todos los procesos TCP existentes se habrán
1035 vencido: por esta razón, no es sabio configurar compresión de archivos
1036 de bitácora para archivos que acaban de ser rotados. Con logrotate, las
1037 opciones requeridas son
1042 Dnsmasq es un reenviador de búsquedas DNS: no puede responder búsquedas
1043 arbitrarias comenzando desde los servidores root pero reenvía dichas
1044 búsquedas a un servidor DNS recursivo, el cual es típicamente proveído
1045 por el proveedor de Internet. Por predeterminado, dnsmasq lee
1047 para descubir las direcciones IP de los servidores DNS upstream que
1048 debe usar, dado a que esta información es normalmente almacenada allí.
1053 revisa el tiempo de modificación de
1057 es usado) y lo re-lee si ha cambiado. Esto permite que servidores DNS séan
1058 fijados dinámicamente vía PPP o DHCP ya que ambos protocolos brindan esta
1062 no es un error ya que pudo haber sido creada antes de que una conexión PPP
1063 haya existido. Dnsmasq simplemente sigue revisando en caso de que
1065 sea creado en algún momento. A dnsmasq se le puede decir que revise más
1066 de un archivo resolv.conf. Esto es útil en una laptop, donde ambos PPP y
1067 DHCP podrían estar siendo usados: dnsmasq puede ser fijado para revisar ambos
1068 .I /etc/ppp/resolv.conf
1070 .I /etc/dhcpc/resolv.conf
1071 y usará el contenido del que haya cambiado mas recientemente,
1072 brindando así la habilidad de cambio automático entre servidores DNS.
1074 Servidores upstream también pueden ser especificados en la línea de
1075 comandos o en el archivo de configuración. Estas especificaciones de
1076 servidor opcionalmente llevan un nombre de dominio el cual le dice a
1077 dnsmasq que debe usar ese servidor solo para encontrar nombres en ese
1078 dominio en particular.
1080 Para configurar dnsmasq como caché para el host donde está
1081 corriendo, poner un "nameserver 127.0.0.1" en
1083 para así forzar procesos locales a enviar búsquedas a dnsmasq. Entonces,
1084 o especificar los servidores upstream diréctamente a dnsmasq usando opciones
1086 o poniendo sus direcciones reales en otro archivo, digamos
1087 .I /etc/resolv.dnsmasq
1088 y correr dnsmasq con la opcion
1089 .B \-r /etc/resolv.dnsmasq
1090 Esta segunda técnica permite la actualización dinámica de las direcciones
1091 de servidor mediante PPP o DHCP.
1093 Direcciones en /etc/hosts "harán sombra" a diferentes direcciones para
1094 los mismos nombres en servidores DNS upstream, así que
1095 "miempresa.com 1.2.3.4" en /etc/hosts se asegurará que las búsquedas
1096 por "miempresa.com" siempre retornarán 1.2.3.4 aún si búsquedas en el
1097 servidor DNS upstream devolverían una dirección diferente. Hay una
1098 excepción a esto: si el servidor DNS upstream contiene un CNAME que
1099 apunta a un nombre sombreado, entonces buscando el CNAME a travéz de
1100 dnsmasq resultará en que la dirección no-sombreada será asociada con
1101 el destino del CNAME. Para circumventar esto, agregar el CNAME a
1102 /etc/hosts de tal manera que el CNAME es sombreado también.
1104 El sistema network-id funciona de la siguiente manera: Para cada pedido
1105 DHCP, dnsmasq colecciona un juego de etiquetas network-id válidas,
1108 usado para alocar la dirección, una de cualquier
1110 que coincida (y "known" si un dhcp-host coincide), la etiqueta "bootp"
1111 para pedidos BOOTP, una etiqueta cuyo nombre es el nombre de la
1112 interface donde llegó el pedido, y posiblemente muchas de clases
1113 de vendedor y usuario que coincidan que hayan sido enviadas por
1114 el cliente DHCP. Cualquier opción
1116 que tenga etiquetas network-id será usada en preferencia de una opción
1118 sin etiqueta, con tal que _todas_ las etiquetas coincidan en alguna
1119 parte del juego coleccionado describido arriba. El prefijo "#" en una
1120 etiqueta significa "no" así que --dhcp=option=#purple,3,1.2.3.4 envía
1121 la opción cuando la etiqueta network-id "purple" no está en el juego
1122 de etiquetas válidas.
1124 Si el network-id en un
1126 es prefijado con "net:", entonces su significado cambia de "fijar
1127 etiqueta" a "coincidir con etiqueta". O sea que si hay más de un
1128 dhcp-range en en una subred, y uno tiene una etiqueta network-id la
1129 cual está fijada (por ejemplo una opción de clase de vendedor) entonces
1130 hosts que fijen la etiqueta network-id serán alocados direcciones en
1131 el rango etiquetado.
1133 El servidor DHCP de dnsmasq funcionará como servidor BOOTP tambien,
1134 con tal que las direcciones MAC y IP de los clientes sean brindadas,
1135 ya sea usando configuraciones
1139 , y una configuración
1141 esté presente para activar el servidor DHCP en una red particular.
1142 (Fijar --bootp-dynamic elimina la necesidad de trazados estáticos.) El
1143 parámetro de nombre de archivos en un pedido BOOTP es revisado para
1144 ver si coincide con algún network-id en configuraciónes
1146 al igual que la etiqueta "bootp", permitiendo así algún control sobre
1147 las opciones devueltas a diferentes clases de hosts.
1151 0 - Dnsmasq hizo fork hacia el fondo exitosamente, o terminó de manera
1152 normal si ir al fondo no está habilitado.
1154 1 - Un problema con la configuración ha sido detectado.
1156 2 - Un problema con acceso a redes ocurrió (dirección en uso, intento
1157 de usar puertos privilegiados sin permiso).
1159 3 - Un problema con una operación de sistema de archivos ocurrió (archivo
1160 o directorio ausente, permisos).
1162 4 - Falla de alocación de memoria.
1164 5 - Otro problema misceláneo.
1166 11 o mayor - un codigo de retorno no cero fué recibido del llamado "init"
1167 del proceso de archivo guión de arriendos. El código exit de dnsmasq es
1168 el código exit del archivo guión con 10 sumado.
1171 Los valores predeterminados para limites de recursos son generálmente
1172 conservadores, y apropiados para uso en dispositivos tipo enrutador
1173 encrustrado con procesadores lentos y poca memoria. En hardware más
1174 capáz, es posible incrementar los límites, y soportar muchos mas
1175 clientes. Lo siguiente se aplica a dnsmasq-2.37: versiones previas
1176 no escalaban tan bien.
1179 Dnsmasq es capaz de soportar con DNS y DHCP a por lo menos mil (1,000)
1180 clientes. Por supuesto que para lograr esto debe aumentarse el valor de
1182 , y tiempos de arriendo no deben ser muy cortos (menos de una hora).
1184 .B --dns-forward-max
1185 puede ser aumentado: comienze con el equivalente a el número de clientes y
1186 auméntelo si parece lento el DNS. Nótese que el rendimiento DNS depende
1187 también de los servidores DNS upstream. El tamaño del caché DNS puede ser
1188 incrementado: el límite obligatorio es 10,000 nombres y el predeterminado
1189 (150) es muy bajo. El enviarle un SIGUSR1 a dnsmasq hace que bitacorée
1190 información que es útil para afinar el tamaño de caché. Ver la sección
1195 El servidor TFTP incorporado es capáz de soportar varias transferencias
1196 simultáneas de archivos: el límite absoluto está relacionado con el número
1197 de file-handles permitidos a un proceso y la habilidad del system call
1198 select() a soportar números grandes de file-handles. Si el límite es fijado
1201 será de-escalado y el límite real será bitacoreado al inicio. Nótese que más
1202 transferencias son posibles cuando el mismo archivo es enviado qué cuando
1203 cada transferencia envía un archivo diferente.
1206 Es posible usar dnsmasq para negar publicidad Web usando una lista de
1207 servidores de banners bien conocidos, todos resolviendose a 127.0.0.1 o
1210 o en un archivo hosts adicional. La lista puede ser muy larga. Dnsmasq ha sido
1211 probado exitósamente con un millón de nombres. Ese tamaño de archivo necesita
1212 un CPU de 1GHz y aproximadamente 60MB de RAM.
1215 .IR /etc/dnsmasq.conf
1217 .IR /usr/local/etc/dnsmasq.conf
1219 .IR /etc/resolv.conf
1225 .IR /var/lib/misc/dnsmasq.leases
1227 .IR /var/db/dnsmasq.leases
1229 .IR /var/run/dnsmasq.pid
1234 Este manual fue escrito por Simon Kelley <simon@thekelleys.org.uk>.
1236 Traducido a español por Christopher Chatham <chrislinux@gmail.com>.
projects / people / ms / dnsmasq.git / blob