.\" -*- nroff -*-
.TH ZIC 8
.SH NOME
zic \- compilador de fusos horários
.SH SINOPSE
.B zic
[
.B \-v
] [
.B \-d
.I diretório
] [
.B \-l
.I hora local
] [
.B \-p
.I regras posix
] [
.B \-L
.I nome do arquivo pula segundo
] [
.B \-s
] [
.B \-y
.I comando
] [
.I nome do arquivo
\&... ]
.SH DESCRIÇÃO
.if t .ds lq ``
.if t .ds rq ''
.if n .ds lq \&"\"
.if n .ds rq \&"\"
.de q
\\$3\*(lq\\$1\*(rq\\$2
..
.I Zic
lê o texto oriundo do(s) arquivo(s) nomeado na linha de comando
e cria um arquivo especificado com informações de conversão de tempo nesta entrada.
Se um
.I nome de arquivo
é
.BR \- ,
a entrada padrão é lida.
.PP
Estas opções estão disponíveis:
.TP
.BI "\-d diretório"
Cria o arquivo de conversão de tempo no diretório nomeado ao invés do
diretório padrão nomeado abaixo.
.TP
.BI "\-l fuso horário"
Usa o fuso horário fornecido como hora local.
.I Zic
irá atuar como se a entrada contivesse uma linha de ligação na forma
.sp
.ti +.5i
Ligação	\fIfuso horário\fP		hora local
.TP
.BI "\-p fuso horário"
Usa a regra de fusos horários fornecida quando está tratando com
as variáveis de ambiente de fusos horários no formato POSIX.
.I Zic
irá atuar como se a entrada contivesse uma linha de ligação na forma
.sp
.ti +.5i
Ligação	\fIfuso horário\fP		regras posix
.TP
.BI "\-L nome do arquivo pula segundo"
Lê informação para pular o segundo com o nome do arquivo fornecido.
Se esta opção não é usada, nenhuma informação para pular segundo 
aparecerá no arquivo de saída.
.TP
.B \-v
Reclama se um ano que apareçe no arquivo de dados está fora do intervalo
de anos representáveis pelos valores de
.IR time (2)
.
.TP
.B \-s
Limita os valores de tempo armazenados nos arquivos de saída a valores
que são os mesmos se são tomados com sinal ou sem sinal.
Você pode usar esta opção para gerar arquivos compatíveis com SVVS.
.TP
.BI "\-y " comando
Use o
.I comando
fornecido ao invés de
.B yearistype
quando estiver verificando os tipos de ano (veja abaixo).
.PP
As linhas de entrada são feitas de campos.
Campos são separados entre si por um número qualquer de caracteres espaço.
O espaço inicial e seguintes na linha de entrada serão ignorados.
Um caractere sem aspas (#) na entrada introduz um comentário que se estende
até o fim da linha onde caractere (#) aparece novamente.
Caracteres espaços e (#) podem ser contidos por aspas duplas (") se eles são
usados com uma parte do campo. 
Qualquer linha que é vazia (depois de tirar seu comentário) é ignorada.
Linhas que não são vazias devem ser de um dos três tipos:
linha de regra, linha de fuso, e linha de ligação.
.PP
Uma linha de regra tem a forma
.nf
.ti +.5i
.ta \w'Rule\0\0'u +\w'NAME\0\0'u +\w'FROM\0\0'u +\w'1973\0\0'u +\w'TYPE\0\0'u +\w'Apr\0\0'u +\w'lastSun\0\0'u +\w'2:00\0\0'u +\w'SAVE\0\0'u
.sp
Rule	NAME	FROM	TO	TYPE	IN	ON	AT	SAVE	LETTER/S
.sp
Por exemplo:
.ti +.5i
.sp
Rule	US	1967	1973	\-	Apr	lastSun	2:00	1:00	D
.sp
.fi
Os campos que constituem uma linha de regra são:
.TP "\w'LETTER/S'u"
.B NAME
Forneçe o nome (arbitrário) do conjunto de regras do qual esta faz parte.
.TP
.B FROM
Fornece o primeiro ano no qual a regra é aplicada.
Qualquer ano na forma inteira pode ser fornecido; o calendário Gregoriano
é assumido. A palavra
.B minimum
(ou uma abreviação) significa o menor ano representável como um inteiro.
A palavra
.B maximum
(ou uma abreviação) significa o maior ano representável como um inteiro.
Regras podem descrever tempos que não são representáveis como valores de tempo,
com tempos não representáveis ignorados; isto permite que regras possam ser portáveis
entre computadores com diferentes tipos de valores de tempo.
.TP
.B TO
Forneçe o ano final no qual a regra é aplicada.
Além disso
.B minimum
e
.B maximum
(como acima),
a palavra
.B only
(ou uma abreviação)
pode ser usada para repetir o valor do campo
.B FROM.
.
.TP
.B TYPE
Forneçe o tipo de ano no qual a regra é aplicada.
Se
.B TYPE
é
.B \-
então a regra é aplicada em todos os anos entre
.B FROM
e
.B TO
inclusive.
Se
.B TYPE
for outra coisa, então
.I zic
executa o comando
.ti +.5i
\fByearistype\fP \fIyear\fP \fItype\fP
.br
para verificar o tipo de um ano:
um status de saída zero significa que o ano é do tipo fornecido;
um status de saída um significa que o ano não é do tipo fornecido.
.TP
.B IN
Nome dos meses nos quais a regra tem efeito.
Os nomes dos meses podem ser abreviados.
.TP
.B ON
Forneçe o dia em que as regras tem efeito.
Formas reconhecidas incluem:
.nf
.in +.5i
.sp
.ta \w'Sun<=25\0\0'u
5	o quinto dia do mês
lastSun	o último Domingo do mês
lastMon	a última Segunda do mês
Sun>=8	o primeiro Domingo no oitavo dia ou depois
Sun<=25	o último Domingo no dia 25 ou antes
.fi
.in -.5i
.sp
Nomes de dias da semana podem ser abreviados ou soletrados por inteiro.
Note que não deve ter espaços dentro do campo
.B ON
.
.TP
.B AT
Forneçe a hora do dia na qual a regra tem efeito.
Formas reconhecidas incluem:
.nf
.in +.5i
.sp
.ta \w'1:28:13\0\0'u
2	tempo em horas
2:00	tempo em horas e minutos
15:00	tempo no formato de 24 houras
1:28:14	tempo em horas, minutos, e segundos
.fi
.in -.5i
.sp
aonde a hora 0 é meia-noite e inicia o dia,
e a hora 24 é meia-noite e encerra o dia.
Qualquer uma dessas formas pode ser seguida pela letra
.B w
se o tempo fornecido é o tempo local
.q "wall clock",

.B s
se o tempo fornecido é o tempo local
.q "standard"
, ou
.B u
(ou
.B g
ou
.BR z )
se o tempo fornecido é o tempo "universal";
na ausência de um indicador,
o tempo "wall clock" é assumido.
.TP
.B SAVE
Fornece a quantia de tempo a ser adicionada no tempo local padrão quando
a regra está em efeito.
Este campo tem formato igual ao campo
.B AT
(ainda que, claro, os
sufixos
.B w
e
.B s
não são usados).
.TP
.B LETTER/S
Fornece a
.q "parte variável"
(Por exemplo, os
.q S
ou
.q D
em
.q EST
ou
.q EDT )
das abreviações dos fusos horários para serem usadas quando a regra está
em efeito. Se este campo é
.BR \- ,
a parte variável é nula.
.PP
Uma linha de fuso tem a forma
.sp
.nf
.ti +.5i
.ta \w'Zone\0\0'u +\w'Australia/Adelaide\0\0'u +\w'GMTOFF\0\0'u +\w'RULES/SAVE\0\0'u +\w'FORMAT\0\0'u
Zone	NAME	GMTOFF	RULES/SAVE	FORMAT	[UNTIL]
.sp
Por exemplo:
.sp
.ti +.5i
Zone	Australia/Adelaide	9:30	Aus	CST	1971 Oct 31 2:00
.sp
.fi
Os campos que constituem uma linha de fuso são:
.TP "\w'GMTOFF'u"
.B NAME
O nome do fuso horário.
Este é o nome usado na criação do arquivo de informação de conversão de tempo
para o fuso.
.TP
.B GMTOFF
A quantia de tempo adionada ao UTC para fornecer o tempo padrão neste fuso.
O campo tem o mesmo formato que os campos
.B AT
e
.B SAVE
da linha de regra;
inicie o campo com um sinal de menos se o tempo deve ser subtraido do UTC.
.TP
.B RULES/SAVE
O nome da regra(s) que aplicada no fuso horário ou, alternativamente,
uma quantia de tempo para adicionar no tempo local padrão.
Se este campo é
.B \-
então o tempo padrão sempre aplica no fuso horário.
.TP
.B FORMAT
O formato para a abreviação do fuso horário neste fuso horário.
O par de caracteres
.B %s
é usado para exibir onde a
.q "parte variável"
da abreviação do fuso horário vai.
Alternativamente,
a barra (/)
separa abreviações padrão e de luz do dia.
.TP
.B UNTIL
O tempo no qual o offset UTC ou as alterações de regra(s) para uma localidade.
Ele é especificado como um ano, um mês, um dia, e uma hora do dia.
Se ele é especificado,
a informação do fuso horário é gerada a partir
do offset UTC fornecido e a regra muda até o tempo especificado.
O mês, dia e a hora do dia tem que ter o formato como nas colunas IN, ON, e AT
de uma regra; colunas seguintes podem ser omitidas, e padronizads para o valor
mais próximo possível das colunas faltantes.
.IP
A próxima linha deve ser uma linha de 
.q continuação
; esta possui a mesma forma que a linha de fuso exceto que a
cadeia
.q Zone
e o nome são omitidos, tanto a linha de continuação situará o início da
informação no tempo especificado como o campo
.B UNTIL
na linha anterior no arquivo usado pela linha anterior.
Linhas de continuação podem conter um campo
.B UNTIL
, apenas como linhas de fuso fazem, indicando que a próxima linha é também uma
continuação.
.PP
Uma linha de ligação tem a forma
.sp
.nf
.ti +.5i
.ta \w'Link\0\0'u +\w'Europe/Istanbul\0\0'u
Link	LINK-FROM	LINK-TO
.sp
Por exemplo:
.sp
.ti +.5i
Link	Europe/Istanbul	Asia/Istanbul
.sp
.fi
O campo
.B LINK-FROM
deveria aparecer como o campo
.B NAME
em alguma linha de fuso;
e o campo
.B LINK-TO
é usado como um nome alternativo para aquele fuso.
.PP
Exceto para linhas de continuação,
linhas podem aparecer em qualquer ordem na entrada.
.PP
Linhas no arquivo que descreve salto de segundos tem a seguinte formato:
.nf
.ti +.5i
.ta \w'Leap\0\0'u +\w'YEAR\0\0'u +\w'MONTH\0\0'u +\w'DAY\0\0'u +\w'HH:MM:SS\0\0'u +\w'CORR\0\0'u
.sp
Leap	YEAR	MONTH	DAY	HH:MM:SS	CORR	R/S
.sp
Por exemplo:
.ti +.5i
.sp
Leap	1974	Dec	31	23:59:60	+	S
.sp
.fi
Os campos
.BR ANO ,
.BR MÊS ,
.BR DIA ,
e
.B HH:MM:SS
contam quando o salto do segundo ocorre.
O campo
.B CORR
deveria
ter
.q +
se um segundo fosse adicionado
ou
.q -
se um segundo fosse retirado.
.\" Não é necessário documentar o seguinte, uma vez que é imposível para mais
.\" do que um salto de segundo ser incluído ou excluído em uma vez.
.\" O padrão C erra ao sugerir a possibilidade.
.\" Veja Terry J Quinn, The BIPM and the accurate measure of time,
.\" Proc IEEE 79, 7 (July 1991), 894-905.
.\"	ou
.\"	.q ++
.\"	se dois segundos são adicionados
.\"	ou
.\"	.q --
.\"	se dois segundos são retirados.
O campo
.B R/S
deveria
ter (uma abreviação de)
.q Stationary
se o tempo do salto de segundo fornecido por outros campos deveria ser 
interpretado como UTC ou
(uma abreviação de)
.q Rolling
se o tempo do salto de segundo fornecido por outros campos deveria ser
interpretado como um tempo local "wall clock".
.SH NOTA
Para áreas com mais que dois tipos de tempo local,
você pode precisar usar tempo local padrão no campo
.B AT
da regra de transição de tempo mais próxima para assegurar que
o tempo de transição mais próximo gravado no arquivo compilado está correto.
.SH ARQUIVO
Diretório padrão usado para arquivos criados /usr/local/etc/zoneinfo
.SH "VEJA TAMBÉM"
newctime(3), tzfile(5), zdump(8)
.SH TRADUZIDO POR LDP-BR em 21/08/2000.
\&\fR\&\f(CWAndré L. Fassone Canova <lonelywolf@blv.com.br> (tradução)\fR
\&\fR\&\f(CWXLeslie Harlley Watter <leslie@netpar.com.br> (revisão)\fR