.\" -*- nroff -*-
.TH ZIC 8
.SH NOME
zic \- compilador de fusos horrios
.SH SINOPSE
.B zic
[
.B \-v
] [
.B \-d
.I diretrio
] [
.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 DESCRIO
.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 informaes de converso de tempo nesta entrada.
Se um
.I nome de arquivo

.BR \- ,
a entrada padro  lida.
.PP
Estas opes esto disponveis:
.TP
.BI "\-d diretrio"
Cria o arquivo de converso de tempo no diretrio nomeado ao invs do
diretrio padro nomeado abaixo.
.TP
.BI "\-l fuso horrio"
Usa o fuso horrio fornecido como hora local.
.I Zic
ir atuar como se a entrada contivesse uma linha de ligao na forma
.sp
.ti +.5i
Ligao	\fIfuso horrio\fP		hora local
.TP
.BI "\-p fuso horrio"
Usa a regra de fusos horrios fornecida quando est tratando com
as variveis de ambiente de fusos horrios no formato POSIX.
.I Zic
ir atuar como se a entrada contivesse uma linha de ligao na forma
.sp
.ti +.5i
Ligao	\fIfuso horrio\fP		regras posix
.TP
.BI "\-L nome do arquivo pula segundo"
L informao para pular o segundo com o nome do arquivo fornecido.
Se esta opo no  usada, nenhuma informao para pular segundo 
aparecer no arquivo de sada.
.TP
.B \-v
Reclama se um ano que aparee no arquivo de dados est fora do intervalo
de anos representveis pelos valores de
.IR time (2)
.
.TP
.B \-s
Limita os valores de tempo armazenados nos arquivos de sada a valores
que so os mesmos se so tomados com sinal ou sem sinal.
Voc pode usar esta opo para gerar arquivos compatveis com SVVS.
.TP
.BI "\-y " comando
Use o
.I comando
fornecido ao invs de
.B yearistype
quando estiver verificando os tipos de ano (veja abaixo).
.PP
As linhas de entrada so feitas de campos.
Campos so separados entre si por um nmero qualquer de caracteres espao.
O espao inicial e seguintes na linha de entrada sero ignorados.
Um caractere sem aspas (#) na entrada introduz um comentrio que se estende
at o fim da linha onde caractere (#) aparece novamente.
Caracteres espaos e (#) podem ser contidos por aspas duplas (") se eles so
usados com uma parte do campo. 
Qualquer linha que  vazia (depois de tirar seu comentrio)  ignorada.
Linhas que no so vazias devem ser de um dos trs tipos:
linha de regra, linha de fuso, e linha de ligao.
.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 so:
.TP "\w'LETTER/S'u"
.B NAME
Fornee o nome (arbitrrio) 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 calendrio Gregoriano
 assumido. A palavra
.B minimum
(ou uma abreviao) significa o menor ano representvel como um inteiro.
A palavra
.B maximum
(ou uma abreviao) significa o maior ano representvel como um inteiro.
Regras podem descrever tempos que no so representveis como valores de tempo,
com tempos no representveis ignorados; isto permite que regras possam ser portveis
entre computadores com diferentes tipos de valores de tempo.
.TP
.B TO
Fornee o ano final no qual a regra  aplicada.
Alm disso
.B minimum
e
.B maximum
(como acima),
a palavra
.B only
(ou uma abreviao)
pode ser usada para repetir o valor do campo
.B FROM.
.
.TP
.B TYPE
Fornee o tipo de ano no qual a regra  aplicada.
Se
.B TYPE

.B \-
ento a regra  aplicada em todos os anos entre
.B FROM
e
.B TO
inclusive.
Se
.B TYPE
for outra coisa, ento
.I zic
executa o comando
.ti +.5i
\fByearistype\fP \fIyear\fP \fItype\fP
.br
para verificar o tipo de um ano:
um status de sada zero significa que o ano  do tipo fornecido;
um status de sada um significa que o ano no  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
Fornee 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 ms
lastSun	o ltimo Domingo do ms
lastMon	a ltima Segunda do ms
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 no deve ter espaos dentro do campo
.B ON
.
.TP
.B AT
Fornee 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 ausncia de um indicador,
o tempo "wall clock"  assumido.
.TP
.B SAVE
Fornece a quantia de tempo a ser adicionada no tempo local padro 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
no so usados).
.TP
.B LETTER/S
Fornece a
.q "parte varivel"
(Por exemplo, os
.q S
ou
.q D
em
.q EST
ou
.q EDT )
das abreviaes dos fusos horrios para serem usadas quando a regra est
em efeito. Se este campo 
.BR \- ,
a parte varivel  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 so:
.TP "\w'GMTOFF'u"
.B NAME
O nome do fuso horrio.
Este  o nome usado na criao do arquivo de informao de converso de tempo
para o fuso.
.TP
.B GMTOFF
A quantia de tempo adionada ao UTC para fornecer o tempo padro 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 horrio ou, alternativamente,
uma quantia de tempo para adicionar no tempo local padro.
Se este campo 
.B \-
ento o tempo padro sempre aplica no fuso horrio.
.TP
.B FORMAT
O formato para a abreviao do fuso horrio neste fuso horrio.
O par de caracteres
.B %s
 usado para exibir onde a
.q "parte varivel"
da abreviao do fuso horrio vai.
Alternativamente,
a barra (/)
separa abreviaes padro e de luz do dia.
.TP
.B UNTIL
O tempo no qual o offset UTC ou as alteraes de regra(s) para uma localidade.
Ele  especificado como um ano, um ms, um dia, e uma hora do dia.
Se ele  especificado,
a informao do fuso horrio  gerada a partir
do offset UTC fornecido e a regra muda at o tempo especificado.
O ms, 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 prximo possvel das colunas faltantes.
.IP
A prxima linha deve ser uma linha de 
.q continuao
; esta possui a mesma forma que a linha de fuso exceto que a
cadeia
.q Zone
e o nome so omitidos, tanto a linha de continuao situar o incio da
informao no tempo especificado como o campo
.B UNTIL
na linha anterior no arquivo usado pela linha anterior.
Linhas de continuao podem conter um campo
.B UNTIL
, apenas como linhas de fuso fazem, indicando que a prxima linha  tambm uma
continuao.
.PP
Uma linha de ligao 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 continuao,
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 MS ,
.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.
.\" No  necessrio documentar o seguinte, uma vez que  imposvel para mais
.\" do que um salto de segundo ser includo ou excludo em uma vez.
.\" O padro 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 so adicionados
.\"	ou
.\"	.q --
.\"	se dois segundos so retirados.
O campo
.B R/S
deveria
ter (uma abreviao de)
.q Stationary
se o tempo do salto de segundo fornecido por outros campos deveria ser 
interpretado como UTC ou
(uma abreviao 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 padro no campo
.B AT
da regra de transio de tempo mais prxima para assegurar que
o tempo de transio mais prximo gravado no arquivo compilado est correto.
.SH ARQUIVO
Diretrio padro usado para arquivos criados /usr/local/etc/zoneinfo
.SH "VEJA TAMBM"
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> (traduo)\fR
\&\fR\&\f(CWXLeslie Harlley Watter <leslie@netpar.com.br> (reviso)\fR