2
<TH>CSV2 5 "junho 2004" MARADNS "refer�ncia MaraDNS"</TH>
4
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=iso8859-1">
8
csv2 - Descri��o do arquivo de zona csv2 usado por MaraDNS
11
O formato do arquivo de zona csv2 � o novo formato do arquivo de zona
12
para MaraDNS 1.2. Este formato de arquivo de zona usa qualquer tipo de
13
espa�o em branco (espa�o, tabula��o e retorno), ou o caracter '| ', para
14
delimitar campos. O parser do arquivo de zona � inteligente o bastante
15
para conhecer quantos campos de dados do registro que um determinado
16
registro de dado precisa; uma vez que s�o processados todos os campos para um
17
determinado registro, o parser analisa a pr�xima entrada que v� como
18
o nome para o pr�ximo registro processar.
21
Este formato de zona de arquivo tem registros na seguinte forma:
24
name [+ttl] [rtype] rdata
27
O nome � o nome do registro que n�s incluiremos, como "www.example.net.".
28
Isto deve ser colocado no come�o da linha. O rtype � o tipo de registro
29
para o registro, como "A" (endere�o de IP ipv4), "MX" (servidor de email), ou
30
"AAAA" (endere�o de IP ipv6). O TTL � quanto tempo outros servidores de DNS
31
deveriam armazenar estes dados na mem�ria deles (em segundos); este campo
32
precisa um '+' como seu caracter inicial. O rdata � o dados atuais para este
33
registro; o formato para o rdata � tipo-espec�fico.
36
Qualquer coisa em colchetes � um campo opcional. Se o TTL n�o � especificado,
37
o TTL � fixado para 86400 segundos (um dia). Se o rtype n�o � especificado,
38
� setado para ser um registro "A" (endere�o ipv4).
41
A zona de arquivo suporta coment�rios; coment�rios s�o especificados tendo um '#'
42
em qualquer lugar entre campos ou registros; quando um '#' � visto, o parser do csv2
43
ignora qualquer caracter que v� (com a exce��o do caracter '{' que n�o � permitido
44
atualmente em zonas de arquivos csv2) at� um nova linha. Um '#' normalmente pode ser
45
colocado dentro de um campo, e indica o fim de um campo quando colocado l�.
48
Os tipos de registro seguintes s�o suportados; uma descri��o do formato de dados dos
49
registros acomoda o tipo de registro:
53
Um registro tipo A armazena um endere�o ipv4. Isto � o tipo de registro padr�o, caso
54
o tipo de registro n�o seja especificado. Esse tipo de registro tem um campo: o IP para
58
a.example.net. 10.11.12.13
59
b.example.net. A 10.11.12.14
60
c.example.net. +64000 A 10.11.12.15
65
O registro PTR armazena o nome de um dado endere�o ipv4 ou ipv6, e � usado para
66
consultas de DNS reverso. Este tipo de registro tem um campo nele: O nome para o
67
registro em quest�o. Exemplos:
70
13.12.11.10.in-addr.arpa. PTR a.example.net.
71
14.12.11.10.in-addr.arpa. PTR b.example.net.
72
15.12.11.10.in-addr.arpa. +64000 PTR c.example.net.
77
Um registro MX armazena um registro de servidor de email, e � usado para entrega de email.
78
Este tipo de registro tem dois campos: A prioridade (ou "prefer�ncia" em linguagem de
79
DNS tradicional) do registro MX (n�meros mais baixos tem prioridades mais alta), e o nome do
80
servidor de email. Exemplo de email para example.net que � remetido a mail.example.net
81
que tem o IP "10.11.12.16":
84
example.net. MX 10 mail.example.net.
85
mail.example.net. 10.11.12.16
90
Um registro AAAA armazena o endere�o ipv6 para um determinado nome.
91
O IP est� em formato ipv6 padr�o "delimitado por dois pontos" :
92
oito 16-bits de n�meros hexadecimal est�o separados atrav�s de dois pontos.
93
Os dois pontos indicam m�ltiplos fluxos de todos n�meros hexas zeros.
94
Este registro tem s� um campo, o IP v6. Exemplo:
97
a.example.net. AAAA 3ffe:ffff:ffe:501:ffff::b:c:d
102
Uma registro SRV armazena uma defini��o de "servi�o." Este registro tem quatro campos:
103
Prioridade, peso, porta, e objetivo. Para mais informa��o, por favor recorra ao RFC 2782.
107
_http._tcp.% srv 0 0 80 a.%
112
Um registro NS especifica os nome de servidores para uma determinada zona.
113
Se os nomes dos servidores n�o s�o nome de delega��o de servidores (em outras
114
palavra, se os servidores de nome s�o os servidores de nome autoritativos para a zona),
115
eles precisam estar no come�o da zona, ou como os primeiros registros na zona, ou logo
116
depois do registro SOA. Os registros NS s�o opcionais; se n�o presentes, MaraDNS
117
far� uma educada suposi��o daqueles registros de NS que deveriam estar l�, baseado nos
118
IPs que MaraDNS ir� processar. Este registro tem um campo: O nome da m�quina do servidor.
122
example.net. NS ns1.example.net.
123
example.net. NS ns2.example.net.
128
Uma registro SOA armazena o come�o da autoridade para um determinado
129
arquivo de zona. Este registro � opcional em zonas de arquivo CSV2; o registro n�o
130
deveria estar no arquivo de zona, MaraDNS sintetizar� um registro de SOA apropriado.
131
Este registro s� pode existir uma vez em um arquivo de zona: Como o primeiro registro
132
do arquivo de zona. Este registro tem sete campos: O nome da zona, o endere�o de e-mail
133
da pessoa respons�vel pela zona, e cinco campos num�ricos (serial, refresh, retry, expire e
134
minimum). Nota que o minimum do SOA <I>n�o</I> afeta outros TTLs em MaraDNS. Exemplo:
137
x.org. SOA x.org. email@x.org. 1 7200 3600 604800 1800
142
Um registro TXT armazena texto e/ou dados bin�rios arbitr�rio para um
143
determinado nome de host. Este registro tem um campo: Os dados de texto para o registro.
146
Um registro de texto b�sico pode ser armazenado colocando dados de ASCII
147
entre duas aspas �nicas, como segue:
151
example.com. TXT 'Este � um campo de texto de exemplo'
154
Qualquer dados bin�rio pode ser especificado; veja o man page <B>csv2_txt(5) </B>
159
O registro RAW � um meta-registro especial que permite qualquer
160
tipo de registro n�o suportado para ser armazenado em um
161
arquivo de zona de csv2. A sintaxe �:
165
RAW [numeric rtype] [data]
168
O rtype num�rico � um n�mero decimal.
171
O campo de dados pode, entre outras coisas, ter sequ�ncias de backslashed hex
172
fora das aspas, concatenadas por dados ASCII dentro das aspas, como
176
example.com. RAW 40 \x10\x01\x02'Kitchen sink'\x40' data'
179
O exemplo anterior � uma "Pia de cozinha" RR com um "significado" de 16,
180
uma "codifica��o" de 1, um "subcoding" de 2, e um fio de dados de "pia de
181
cozinha @ dados" (desde feiti�o c�digo 40 corresponde um @ em ASCII).
183
Nota que barras hexas fora das aspas s�o concatenado com dados ASCII
184
citados, e que espa�os em brancos est�o <I>somente</I> dentro de
188
O formato para um campo de dados em um registro RAW � quase id�ntico ao
189
formato para um campo de dados TXT. S�o descritos ambos os formatos por
190
completo no man pagen <B>csv2_txt(5)</B>.
193
<h1>ARQUIVO DE ZONA DE EXEMPLO</h1>
196
<include "../examples/example_csv2">
199
<h1>RETRATA��O LEGAL</h1>
200
THIS SOFTWARE IS PROVIDED BY THE AUTHORS ''AS IS'' AND ANY EXPRESS OR
201
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
202
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
203
ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE
204
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
205
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
206
GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
207
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
208
STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY
209
WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
213
Sam Trenholme <A href=http://www.samiam.org/>http://www.samiam.org/</a>
216
A tradu��o deste documento foi realizada por Daniel Zilli.