2
<TH>MARARC 5 "Janeiro 2002" MARADNS "MaraDNS referencia"</TH>
3
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=iso8859-1">
8
mararc - Formato do arquivo de zona do mararc que MaraDNS utiliza.
10
<h1>FORMATO DO AQUIVO MARARC</h1>
11
O arquivo Mararc sua um syntax que � derivada do Python 2.3.3. Em
12
particular, Python 2.3.3 (e possivilmente outras vers�es do Python) podem ler
13
um arquivo corretamente formatado do mararc sem erro.
15
Ao contr�rio de Python, entretanto, um arquivo mararc pode somente
16
usar determinados nomes de vari�veis, e as vari�veis podem
17
somente ser declaradas como descritas abaixo.
21
Coment�rios (linhas ignoradas pelo analizador do MaraDNS) come�am com o
22
caractere '#', como assim:
24
# Isto � um coment�rio
26
O analizador MaraDNS ignora tamb�m as linhas que cont�m somente o espa�o branco.
29
O arquivo MaraRC suporta dois operadores: = and +=
31
O operador = pode ser usado para atribuir valores num�ricos a uma string.
33
O operador += pode somente ser usado em valores de string, e concatena
34
o valor � direita do operador += da string especificada, � esquerda do operador +=.
38
ipv4_bind_addresses = "10.2.19.83"
39
ipv4_bind_addresses += ",10.2.66.74"
40
ipv4_bind_addresses += ",10.3.87.13"
43
ipv4_bind_addresses agora tem os valores "10.2.19.83,10.2.66.74,10.3.87.13"
46
ipv4_alias["icann"] = "198.41.0.4"
47
ipv4_alias["icann"] += ",192.228.79.201"
48
ipv4_alias["icann"] += ",192.33.4.12,128.8.10.90"
51
<h1>VARI�VEIS MARARC</h1>
52
Segue � uma lista das vari�veis que podem ser declaradas no arquivo mararc.
54
<h1>FORMATO DAS VARI�VEIS DE DICION�RIO</h1>
56
Uma <b>vari�vel de dicion�rio</b>
57
� uma array que pode ter m�ltiplos elementos. Ao contr�rio de uma array
58
tradicional, estas array s�o posicionadas por string em vez de n�meros.
59
Estes s�o analogos �s arrays associativas, ou que o Perl chama de hashes.
62
A sintaxe de uma vari�vel de dicion�rio est� na seguinte forma:
64
name["index"] = "value"
66
Onde <b>name</b> � o nome da vari�vel de dicion�rio,
67
<b>index</b> � o �ndice da array, e
68
<b>value</b> � o valor armazenado nesse �ndice.
70
Cada vez que n�s temos uma vari�vel do tipo dicion�rio
71
(tal como csv2), n�s devemos primeiramente inicializ�-la
72
usando uma linha no seguinte formato:
76
Aqui, csv2 � o nome da vari�vel de "dicion�rio" que n�s
77
estamos inicializando.
79
<h1>VARI�VEIS DE DICION�RIO</h1>
81
Est� aqui uma lista de todos os estilos de vari�veis de
82
dicionario que MaraDNS usa:
85
A vari�vel do dicion�rio csv2 armazena todos os nomes de zona e nomes
86
de arquivos para as zonas de arquivos que MaraDNS usa. Note que os
87
arquivos csv2 s�o lidos depois que MaraDNS � chrooted. Portanto o nome
88
de arquivo � relativo ao chroot _dir.
93
csv2["example.net."] = "db.example.net"
96
Veja <b>csv2(5)</b> para uma descri��o do formato deste arquivo.
100
csv1: Usada para indicar o nome de arquivo para uso de uma deterninada
101
zona armazenada no formato de arquivo de zona csv1. Isto �
102
primeiramente para a compatibilidade com quem t�m arquivos de
106
csv1["zone"] = "filename"
109
Um arquivo pipe-separado. Veja
113
a zona que o arquivo em quest�o � autoritativo para
115
<b>nome de arquivo</b>:
116
no arquivo com os dados da zona CSV1
118
Note que os arquivos csv1 s�o lidos ap�s MaraDNS ser chrooted,
119
e, portanto o nome de arquivo � relativo ao chroot_dir.
122
Veja o man page <b>csv1(5)</b> para mais informa��es sobre este
127
ipv4_alias: Usado para dar apelidos ou pseud�nimos para pares
128
de ip/netmask endere�os de IP ipv4 (32-bit padr�o).
131
ipv4_alias["name"] = "ip1/netmask,ip2/netmask,etc"
134
<b>name</b>: O nome do alias em quest�o.
137
<b>ip</b>: A parcela do IP de um par de ip/netmask
140
<b>netmask</b>: a parcela da m�scara de um par de ip/netmask
143
<b>,</b>: Usado para separar pares de ip/netmask. Os espa�os podem
144
ser colocados antes ou depois desta v�rgula.
147
Um IP est� no formato decimal-pontilhado, e.g. "10.1.2.3".
149
O netmask pode estar em dois formatos: Um �nico n�mero entre
150
1 e 32, que indica o n�mero de bits "1" seguidos no netmask,
151
ou um netmask decimal-pontilhado de 4-digitos.
155
O netmask � usado para especificar uma faixa de IPs.
158
<h2>ipv4_alias examples</h2>
160
<b>10.1.1.1/24</b> indica que qualquer IP de 10.1.1.0 a 10.1.1.255
164
<b>10.1.1.1/255.255.255.0</b> � id�ntico a 10.1.1.1/24
167
<b>10.2.3.4/16</b> indica que qualquer IP de 10.2.0.0 a 10.2.255.255
171
<b>10.2.3.4/255.255.0.0</b>� id�ntico a 10.2.3.4/16
174
<b>127.0.0.0/8</b> indica que qualquer IP com "127" como o primeiro
175
octeto (n�mero) combinar�.
178
<b>127.0.0.0/255.0.0.0</b> � id�ntico a 127.0.0.0/8
181
O netmask � opcional, e, se n�o estiver presente, indica que somente
182
um �nico IP combinar�. por exemplo:
185
<b>10.9.9.9/32</b>, <b>10.9.9.9/255.255.255.255</b>, e <b>10.9.9.9</b>
186
s�o todos funcionalmente id�nticos, e indicam que somente o
187
IP 10.9.9.9 combinar�.
189
O significado de "combinar" depende para que n�s usamos o ipv4 ali�s.
192
ipv4 aliases can nest. E.g:
194
ipv4_alias["susan"] = "10.6.7.8/24"
195
ipv4_alias["office"] = "susan,10.9.9.9"
198
Onde "susan" em "office" alias combina com o valor do
202
Multiple levels of nesting are allowed. Self-referring nests will
206
<h2>root_servers</h2>
208
root_servers: Este � um elemento de "dicion�rio" especial que
209
pode (atualmente) ter somente um elemento: ".", que aponta
210
tanto para um IP, ou um ponteiro para um ipv4 ali�s que seja
211
uma lista de servidores ra�zes.
214
root_servers["."] = "list_of_servers"
217
Onde "." � a �nica array permitida para os servidores de raiz
218
(este formato � usado permitir uma potencial expans�o futura),
219
e list_of_servers � uma lista dos servidores de nomes raiz
220
no mesmo formato que ipv4_aliases.
223
Note que, enquanto o ips na lista dos servidores raizes puder
224
ter netmasks, a parcela do netmask � ignorada.
228
Os root_servers devem somente apontar para os servidores raizes.
229
Se desejar usar MaraDNS como um servidor de nome forwarding, que env�a
230
consultas DNS para um outro servidor, use a vari�vel upstream_servers.
233
<h2>upstream_servers</h2>
235
Isto � id�ntico � vari�vel do root_servers (pode ter somente um
236
elemento, o elemento � uma lista de ipv4_addresses, etc.), mas � usado
237
quando se deseja usar MaraDNS para consultar outros servidores recursivo,
238
em vez de consultar os servidores raizes para uma resposta.
241
Note que n�o se pode ter ambos root_servers e upstream_servers
242
setados em um dado arquivo mararc; MaraDNS retornar� com
243
um erro fatal se um tentar fazer isso.
245
<h2>Nota final em vari�veis do dicion�rio </h2>
247
csv1, csv2, ipv4_alias, e root_servers s�o atualmente as �nicas
248
vari�veis de dicion�rio existentes.
250
<h1>FORMATO DE UMA VARI�VEL NORMAL </h1>
252
Vari�veis normais. Estas s�o as vari�veis que podem somente
256
A sintaxe de uma vari�vel normal est� na forma
261
Onde <b>name</b > � o nome da vari�vel normal, e
262
<b>value</b > � o valor da vari�vel em quest�o.
264
<h1> VARI�VEIS NORMAIS</h1>
266
Aqui est� uma lista das vari�veis normais que MaraDNS usa:
268
<h2>ipv4_bind_addresses</h2>
270
ipv4_bind_addresses: O endere�o IP dado ao servidor MaraDNS.
272
Ista aceita um ou mais IPs ipv4 em nota��o pontilhado-decimal
273
(por exemplo "127.0.0.1"), e especifica em qual IP o servidor MaraDNS
274
estar� escutando. Os endere�os m�ltiplos s�o separados com uma
275
v�rgula, como estes: "10,1,2,3, 10,1,2,4, 127,0,0,1"
278
<h2>bind_address</h2>
280
bind_address: O endere�o IP dado ao servidor MaraDNS.
283
Ista aceita um ou mais IPs ipv4 em nota��o pontilhado-decimal
284
(por exemplo "127.0.0.1"), e especifica em qual IP o servidor MaraDNS
285
estar� escutando. Note que ipv4_bind_addresses tem a mesma
286
funcionalidade. Este nome � inclu�do de modo que os arquivos de
287
configura��o do MaraDNS 1.0 continuem a trabalhar com MaraDNS 1.2
290
<h2>bind_star_handling</h2>
292
In the case where there is both a star record for a given name and recordtype,
293
a non-star record with the same name but a different recordtype, and no record
294
for the given name and recordtype, MaraDNS will usually return the
295
star record. BIND, on the other hand, will return a "not there" reply.
300
<li>Se um registro n�o A para <tt>foo.example.com</tt> existir
301
<li>Um registro A para <tt>*.example.com</tt> existir
302
<li>Registro n�o A para <tt>foo.example.com</tt> exisir
303
<li>E o usu�rio pergunta por um registro A para <tt>foo.example.com</tt>
304
<li>MaraDNS geralmente retornar� um registro A anexado em <tt>*.example.com</tt>
305
<li>BIND, por outro lado, returnar� "not there" para <tt>foo.example.com</tt>
308
If the BIND behavior is desired, set <tt>bind_star_handling</tt> to 1.
309
Otherwise, set this to 0 (the default value if this is not set at all
310
in the <tt>mararc</tt> file).
314
MaraDNS finalizar� com um erro fatal se <tt>bind_star_handling</tt> tiver
315
qualquer valor al�m de 0 ou 1.
318
chroot_dir: The directory MaraDNS chroots to
321
Isto aceita um �nico valor: O caminho completo ao diret�rio
322
ao usar-se como chroot.
325
Note que os arquivos de zonas csv1 s�o lidos ap�s a
326
opera��o do chroot. Portanto, o chroot necessita ter
327
qualquer e todas as zona de arquivos que MaraDNS ir� carreguar.
329
<h2>csv2_default_zonefile</h2>
330
Este � um arquivo especial de zona que permite l� para ser
331
estrelas no <i>final</i > dos hostnames. Este arquivo �
332
similar a um arquivo normal da zona csv2, mas tem as
333
seguintes caracter�sticas e limita��es:
336
<li>As estrelas s�o permitidas no final dos hostnames
337
<li>Um registro SOA � imperativo
338
<li>Registro NS s�o imperativos
339
<li>Registros CNAME n�o s�o permitidos em um arquivo zona
340
<li>Delega��o de registros NSn�o s�o permitidos no arquivo de zona
341
<li>Arquivo de zona padr�o n�o pode ser transferido atrav�s da
342
transfer�ncia da zona
343
<li>Tanto os arquivos de zona recursivo e padr�o n�o podem ser
344
ativados ao mesmo tempo.
347
<h2>csv2_synthip_list</h2>
348
�s vezes a lista de IP dos servidores de nomes ser�o
349
diferente do que os servidores de nomes no qual um �
350
conectado. Isto permite que a lista sint�tica de servidor tenha IPs diferente.
353
Note que isto pode agir em uma maneira inesperada se endere�os
354
rote�veis e n�o rote�veisl (localhost e RFC1918) forem combinados;
355
em particular, uma lista com endere�os rote�veis e n�o rote�veis
356
rejeitar� os endere�os IP n�o rote�veis, e uma lista com rfc1918 e
357
endere�os do localhost rejeitar� os endere�os do localhost.
359
<h2>debug_msg_level</h2>
361
Este � um n�mero indicando qual � o n�vel da informa��o sobre um
362
processo em execu��o do MaraDNS que deve ser feito p�blico.
363
Quando ajustado para 0, nenhuma informa��o ser� feita p�blica.
366
Quando ajustada para um (padr�o), ou maior, uma consulta
367
Terre-con-erre-cigarro.maradns.org. retornar� o n�mero da
371
Quando ajustado para dois ou mais alto, um Tnumthreads. consulta
372
devolver� o n�mero de threads que MaraDNS est� atualmente
373
executando, e uns Tcache-elementos. a consulta devolver� o
374
n�mero de elementos no cache do MaraDNS. Se MaraDNS �
375
compilado com depura��o de informa��o, um Tmemusage.
376
a consulta devolver�; a quantia de mem�ria que MaraDNS alocou.
378
Quando ajustado a tr�s ou mais, um Ttimestamp. consulta devolver�,
379
em segundos desde a �poca de UNIX, o timestamp para o sistema
380
que MaraDNS est� executando.
384
<h2>default_rrany_set</h2>
385
Esta vari�vel determinava que tipo de registros de recurso foi devolvido
386
quando uma QUALQUER consulta foi enviada. No MaraDNS 1.2, as estruturas
387
de dados foram revisadas para devolver qualquer tipo de registro de recurso
388
quando uma consultar QUALQUER � enviada; esta vari�vel n�o faz nada, e
389
est� s� aqui de forma que os arquivos do MaraDNS 1.0 continuem funcionando.
391
Os �nicos valores aceitos para esta vari�vel eram 3 e 15.
393
<h2>dos_protection_level</h2>
394
Se isto � fixado a um valor n�o-zero, certas caracter�sticas do MaraDNS
395
ser�o incapacitadas de acelerar o tempo de resposta do MaraDNS.
396
Isto � projetado para situa��es quando um servidor MaraDNS est�
397
recebendo um n�mero grande de consultas, como durante uma
398
nega��o de ataque de servi�o (DOS).
401
Esta � uma vari�vel num�rica; seu valor padr�o � zero, indicando que
402
todas as caracter�sticas normais do MaraDNS est�o habilitadas.
403
Valores num�ricos mais altos incapacitam mais caracter�sticas:
406
<li>Um dos_protection_level de 1 ou acima incapacita MaraDNS de adquir
407
informa��o de estado remotamente
409
<li>Um dos_protection_level de 8 ou acima incapacita lookups de CNAME.
411
<li>Um dos_protection_level de 12 ou acima incapacita a delega��o registros de NS.
413
<li>Um dos_protection_level de 14 ou acima incapacita QUALQUER processo de registro
415
<li>Um dos_protection_level de 18 ou acima incapacita processo de registro de
416
estrela no come�o de hostnames (default_zonefiles ainda trabalham, por�m)
419
<h2>ipv6_bind_address</h2>
420
Se MaraDNS � compilado como um servidor autoritativo, ent�o esta
421
vari�vel contar� para MaraDNS para o qual ipv6 se dirigem para o
422
servidor UDP; para esta vari�vel ser ajustada, MaraDNS precisa ser
423
ligado a pelo menos um endere�o ipv4.
425
<h2>hide_disclaimer</h2>
426
Se isto � ajustado para "YES", MaraDNS n�o exibir� a retrata��o legal ao come�ar.
429
<h2>long_packet_ipv4</h2>
430
Esta � uma lista de IPs que n�s enviaremos pacotes UDP mais longo que
431
512 bytes RFC1035 permite se necess�rio. Isto foi projetado para permitir
432
<TT>zoneserver</TT> quando usado, enviar pacotes regulares de DNS
433
em cima de TCP, para receber pacotes com mais dados que pode caber
434
em um pacote de DNS de 512 bytes.
436
Esta vari�vel s� funciona se MaraDNS � compilado somente como
437
servidor autoritativo.
440
maradns_uid: O UID num�rico com que MaraDNS ser� executado
443
Isto aceita um �nico valor num�rico: O UID que MaraDNS executar�.
446
MaraDNS, o mais cedo poss�vel finaliza os privil�gios de root,
447
minimizando o dano que um potencial ataca pode causar.
448
Isto � o que o UID maradns se torna.
454
maradns_gid: O GID num�rico com que MaraDNS ser� executado
457
Isto aceita um �nico valor num�rico: O GID que MaraDNS executar�.
462
<h2>maximum_cache_elements</h2>
463
maximum_cache_elements: O n�mero m�ximo de elementos que n�s podemos
464
ter no cache das consultas recursivas.
467
Este cache de consultas recursivas � usado para armazenar entradas
468
n�s previamente obtivemos de consultas recursivas..
471
Se n�s chegarmos neste limite, o "guarda" come�a a trabalhar.
472
O guarda remove elementos ao acaso do cache (8 elementos
473
removidos por consulta) at� que n�s tenhamos 99% ou t�o
476
<p>O valor padr�o para est� vari�vel � 1024.
480
maxprocs: O n�mero de m�ximo de threads ou processos que MaraDNS
481
� permitido executar ao mesmo tempo.
483
Esta vari�vel � usada para minimizar o impacto no servidor quando
484
MaraDNS estiver fortemente carregado. Quando este n�mero � alcan�ado,
485
� imposs�vel MaraDNS gerar novos threads/processos at� o n�mero de
486
threads/processos estar reduzido.
488
<p> O valor padr�o para esta vari�vel � 64.
491
O valor de m�ximo que pode ter � 500.
493
<h2>max_ar_chain</h2>
494
max_ar_chain: O n�mero m�ximo de registros para exibir se um
495
registro na se��o adicional (por exemplo, o IP de um servidor
496
NS ou o ip de servidor MX) tem mais de um valor.
499
Isto � semelhante ao max_chain, mas aplica-se a registros na
500
se��o "adicional" (ou AR) .
503
Devido as limita��es nas estruturas de dados internas que MaraDNS
504
usa para armazenar RRs, se isto tiver um valor al�m de um, a rota��o
505
round robin de registros � desabilitada.
507
<p> O valor padr�o para esta vari�vel � 1.
510
max_chain: O n�mero de m�ximo de registros para exibir em uma cadeia
513
Com DNS, � poss�vel ter mais de um RR para um determinada etiqueta
514
de dom�nio. Por exemplo, "example.com" pode ter, como registro A,
515
uma lista de endere�os de ip m�ltiplos.
519
Isto fixa o n�mero m�ximo de registros que MaraDNS mostrar� para um �nico RR.
521
MaraDNS normalmente faz rota�� round-robin de registros.
522
Consequentemente, todos os registros para um determinada etiqueta
523
de DNS (por exemplo "example.com".) ser� vis�vel, embora n�o ao
524
mesmo tempo se h� mais registros que o valor max_chain permitiu.
526
<p>O valor padr�o para esta vari�vel � 8.
528
<h2>max_glueless_level</h2>
529
N�vel de glueless m�ximo permitido ao executar lookups recursivos.
533
Este � o n�mero m�ximo de vezes que MaraDNS voltar� para os "servidores
534
raizes" para descobrir o IP de um servidor de nome para o qual n�s n�o
535
temos uma cola para o IP, ou descobrir o valor A para um determinado
538
<h2>max_queries_total</h2>
539
N�mero m�ximo de consultas para executar quando realizamos lookups
540
recursivos. O valor padr�o � 32.
543
Este � o n�mero m�ximo de vezes que MaraDNS enviar� uma
544
consulta para um servidor de nomes para descobrir a resposta de
547
<h2>max_tcp_procs</h2>
548
max_tcp_procs: O (opcional) n�mero m�ximo de processos que o servidor de zona �
552
�s vezes, � desej�vel ter um n�mero m�ximo diferente de processos
553
tcp permitidos do que o m�ximo permitido de threads. Se esta vari�vel
554
n�o for setada, o n�mero de m�ximo de processos tcp permitidos
558
max_total: O n�mero m�ximo de registros para mostrar total
559
para uma determinada consulta de DNS.
562
Este � o m�ximo n�mero total de registros que MaraDNS far�
563
dispon�vel em uma resposta DNS.
565
<p> O valor padr�o para esta vari�vel � 20.
568
min_ttl: A quantia m�nima de tempo que um registro de recurso ficar� no
569
cache do MaraDNS, sem levar em conta o TTL o servidor remoto
573
Fixando este valor muda a quantia m�nima de tempo que o servidor
574
recursivo MaraDNS manter� um registro no cache. O valor est� em segundos.
577
O valor padr�o disto � 300 (5 minutos); o valor m�nimo para isto
580
<h2>min_ttl_cname</h2>
581
min_ttl_cname: A quantia m�nima de tempo que um registro de recurso ficar� no
582
cache do MaraDNS, sem levar em conta o TTL o servidor remoto
585
Fixando este valor muda a quantia m�nima de tempo que o servidor
586
recursivo MaraDNS manter� um registro CNAME no cache.
587
O valor est� em segundos.
590
O valor padr�o para isto � o valor do min_ttl de; o valor
591
m�nimo para isto � 180 (2 minutos).
593
<h2>no_fingerprint</h2>
594
no_fingerprint: Flag permite MaraDNS para ser mais dif�cil descobrir.
597
Algumas pessoas n�o sentem que � apropriado ter alguma informa��o,
598
como o n�mero da vers�o do MaraDNS sendo executado, esteja
599
publicamente dispon�vel.
605
Fixando no_fingerprint para 1, � poss�vel mandar MaraDNS n�o
606
revelar publicamente esta informa��o .
608
<h2>random_seed_file</h2>
609
randsom_seed_file: O arquivo do qual n�s lemos 16 bytes para adquirir 128-bit
610
para o pseudo seguro gerador de n�meros aleat�rio.
613
Esta localiza��o deste arquivo � relativo ao root do
614
sistema de arquivos n�o ao diret�rio de chroot do MaraDNS.
617
Este � idealmente um arquivo que � uma boa fonte de n�meros aleat�rios
618
(por exemplo / dev/urandom), mas tamb�m pode ser um arquivo fixo se
619
seu SO n�o tiver um gerador de n�mero aleat�rio decente. Neste caso,
620
tenha certeza que o conte�do daquele arquivo � aleat�rio e com permiss�es
621
600, possuido atrav�s do root.. N�s lemos o arquivo <B>antes de</B>
622
de derrubar os privil�gios do root..
624
<h2>recursive_acl</h2>
625
Lista dos ips permitidos a executar consultas recursiva com o parte
626
recursiva do servidor MaraDNS
629
O formato desta string � id�ntico ao formato de uma entrada de ipv4_alias.
632
spammers: Uma lista dos servidores DNS que o resolver recursivo n�o
636
Isto � usado principalmente para n�o permitir que dom�nios Spam-amig�veis
637
resolvam, desde que os spammers est�o come�ando o h�bito de usar
638
servidores de DNS Spam-amig�veis para resolver seus dom�nios,
639
permitindo pular de provedor a provedor.
642
O formato desta string � id�ntico ao formato de uma entrada de ipv4_alias.
644
<h2>synth_soa_origin</h2>
645
Quando uma zona de arquivo CSV2 n�o tiver um registro SOA,
646
MaraDNS gera um registro SOA automaticamente. Esta vari�vel
647
determina o nome do host para "SOA de origem" (que � chamado
648
o MNAME em RFC1035); este � o nome do host do servidor de
649
DNS que tem a "c�pia mestre" do arquivo de uma determinada
652
Este nome do host est� em formato humano-leg�vel sem um ponto
653
no final, por exemplo:
655
synth_soa_origin = "ns1.example.com"
657
Se isto n�o for setado, um registro SOA sint�tico usar� o nome da
658
zona para campo SOA origem (MNAME).
661
<h2>synth_soa_serial</h2>
662
Isto determina se n�s seguimos estritamente o RFC1912 se��o 2.2
663
com n�meros de s�rie de SOA. Se isto � fixado para 1 (valor padr�o),
664
n�s n�o seguimos estritamente o RFC1912 se��o 2.2 (o serial � um n�mero,
665
baseado no timestamp do arquivo de zona que � atualizado a cada seis
666
segundos), mas faz isto de forma que um n�mero de s�rie � garantido
667
a ser atualizado automaticamente toda vez a pessoa edita um arquivo de zona.
670
Se isto � fixado para 2, o n�mero de s�rie de SOA estar� em formato
671
YYYYMMDDHH onde YYYY � o ano de 4-d�gitos, MM � o m�s de 2-d�gitos,
672
DD � o dia de 2-d�gitos, e HH � a hora 2-d�gitos do tempo que o arquivo
673
de zona foi por �ltimo atualizado (GMT; localtime n�o funciona
674
em um ambiente chroot ()).Enquanto este formato � estritamente RFC1912
675
compat�vel, a desvantagem � que mais de uma edi��o num arquivo de
676
zona em uma hora n�o atualizar� o n�mero de s�rie.
679
Eu fortemente recomendo, a menos que seja extremamente importante
680
em ter uma zona de DNS que n�o gera nenhuma advert�ncia quando testada
681
no dnsreport.com, ter isto fixado para 1 (o valor padr�o). Tendo isto fixado
682
para 2 pode resultar em zona de arquivo atualizada n�o ser vista servidor
685
<h2>tcp_convert_acl</h2>
686
Isto s� se aplica ao programa zoneserver (geral DNS-em cima de-TCP ).
689
Esta � uma lista dos IPs que s�o permitidos conectar-se ao zoneserver
690
e enviar normais requisi�oes de TCP DNS. O zoneserver converter� a
691
requis�o TCP DNS para UDP DNS requisi��es, e enviar� a requisi�o UDP
692
em quest�o para o servidor especificado em <B>tcp_convert_server.</B>
693
Uma vez obtida a resposta do servidor UDP DNS, converter� a resposta
694
para uma requisi��o TCP e mandar� de volta a resposta ao cliente TCP original.
697
Se a flag RD (recurs�o desejada) � setada ou n�o quando convertendo
698
um TCP DNS pedem dentro para um UDP que o pedido de DNS � determinado
699
se o cliente de TCP est� na lista <B>recursive_acl.</B>
701
<h2>tcp_convert_server</h2>
702
Isto s� se aplica ao programa zoneserver (geral DNS-em cima de-TCP ).
704
Este � o servidor UDP para o qual n�s enviamos uma consulta quando
705
convertendo o DNS TCP requisi��es para servidores UDP. Note que,
706
enquanto este valor permitir os m�ltiplos IPs, todos os valores exceto
707
o primeiro � ignorado.
709
<h2>timeout_seconds</h2>
710
Isto s� aplica ao se realizar lookups recursivos.
712
A quantia de tempo, em segundos, para esperar por uma resposta de
713
um servidor de DNS remoto antes de disistir e tentar o pr�ximo servidor
714
na lista. O valor padr�o � 2 segundos.
716
Isto � para instala��es onde um servidor recursivo MaraDNS est� em
717
uma rede lenta que leva mais que dois segundos para enviar e receber
721
Note que, quanto maior for este valor, mais lentamente MaraDNS
722
processar� consultas recursivas quando um servidor DNS n�o
723
est� respondendo �s consultas do DNS.
725
<h2>timestamp_type</h2>
726
timestamp_type: O tipo do timestamp para mostrar. A finalidade principal
727
desta op��o � suprir a sa�da dos timestamps. Desde que o duende usa
728
o syslog() para exibir dados, e desde que o syslog() adiciona seu pr�prio
729
timestamp, esta op��o deve ser ajustada para 5 quando o maradns �
730
invocado com a ferramenta do duende.
733
Esta op��o permite tamb�m para quem n�o usam a ferramenta do
734
duende ver timestamps em formato humano. Esta op��o permite
735
somente timestamps no GMT, devido aos problemas em mostrar
736
hor�rios locais em um ambiente chroot().
740
Pode ter os seguintes valores:
743
<dd>A string "Timestamp" seguida por um UNIX timestamp
745
<dd>Apenas o timestamp do UNIX
747
<dd>Um GMT timestamp na l�ngua espanhola
749
<dd>Um GMT timestamp na l�ngua espanhola
751
<dd>Um timestamp usando asctime(gmtime()); geralmente na l�ngua inglesa
753
<dd>Nenhum timestamp qualquer � mostrado (esta � a melhor op��o
754
quando o maradns � invocado com a ferramenta <tt>duende</tt >) .
757
<p> O valor padr�o para vari�vel � 5.
759
<h2>verbose_level</h2>
760
verbose_level: O n�mero das mensagens que n�s registramos para stdout
763
Pode ter cinco valores:
766
<dd>Nenhuma mensagem exce��o a retrata��o legal e erros fatais de analise
768
<dd>Somente mensagens de inicializa��o registradas (N�vel padr�o)
770
<dd>Erro de consultas registradas
772
<dd>Todas as consultadas registradas
774
<dd>Todas as a��es que adicionam e removem registros do cache est�o registradas
777
<p> O valor padr�o para vari�vel � 1.
779
<h2>zone_transfer_acl</h2>
780
zone_transfer_acl: Lista dos ips permitidos em realiazar transfer�ncias
781
de zonas com o servidor de zona.
784
O formato desta string � id�ntico ao formato de uma entrada ipv4_alias.
786
<h1>EXEMPLO DO ARQUIVO MARARC</h1>
789
<include "../source/example_mararc">
793
Se declarar o mesmo �ndice duas vezes com uma vari�vel de dicion�rio,
794
MaraDNS finalizar� com um erro fatal. Isto porque vers�es antigas do
795
MaraDNS agiram de maneira diferente do que Python 2.3.3. Com
796
Python 2.3.3, a �ltima declara��o � usada, enquanto MaraDNS
797
usou para usar a primeira declara��o.
801
<h1>RETRATA��O LEGAL</h1>
802
THIS SOFTWARE IS PROVIDED BY THE AUTHORS ''AS IS'' AND ANY EXPRESS
803
OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
804
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
805
ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE
806
LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
807
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
808
SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
809
BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
810
WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
811
OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
812
EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
added
removed
doc/pt_br/source/mararc.ej
