1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142
|
.\" -*- nroff -*-
.TH TZFILE 5
.SH NOME
tzfile \- informao de fuso horrio
.SH SINOPSE
.B
#include <tzfile.h>
.SH DESCRIO
O arquivo de informaes sobre fusos horrio usado por
.IR tzset (3)
inicia com o caracter mgico "TZif" para identificar na mesma hora
como arquivos de informaes sobre fusos horrio, seguido por dezesseis
bytes reservados para uso futuro, seguido por seis valores de quatro bytes
do tipo
.BR long ,
escrito na ordem de bytes ''padro'' (o byte de mais alta ordem do valor
escrito primeiro.
Este valores so,
na ordem:
.TP
.I tzh_ttisgmtcnt
O nmero do indicador UTC/local armazenado no arquivo.
.TP
.I tzh_ttisstdcnt
O nmero do indicador padro/pareee armazenado no arquivo
.TP
.I tzh_leapcnt
O nmero do salto de segundos para qual dado armazenado no arquivo.
.TP
.I tzh_timecnt
O nmero de "transition times" para qual dado armazenado
no arquivo.
.TP
.I tzh_typecnt
O nmero de "local time types" para qual dado armazenado
no arquivo (no pode ser zero).
.TP
.I tzh_charcnt
O nmero de caracteres da "time zone abbreviation strings"
armazenado no arquivo.
.PP
O cabealho citado acima seguido por
.I tzh_timecnt
valores de quatro-bytes do tipo
.BR long ,
ordenados em ordem ascendente.
Estes valores so escritos na ordem ''padro''.
Cada um usado como um tempo de transio (como devolvido por
.IR time (2))
na regra para computar o tempo local alterada.
Depois chega
.I tzh_timecnt
valor de um byte do tipo
.BR "unsigned char" ;
cada um conta qual dos diferentes tipos de ''local time'' descritos
no arquivo associado com o tempo de translao como indexado.
Aqueles valores servem com indice dentro de um matriz de estrutura
.I ttinfo
que mostra-se prxima no arquivo;
estas estruturas so definidas com segue:
.in +.5i
.sp
.nf
.ta .5i +\w'unsigned int\0\0'u
struct ttinfo {
long tt_gmtoff;
int tt_isdst;
unsigned int tt_abbrind;
};
.in -.5i
.fi
.sp
Cada estrutura escrita com um valor de 4 bytes oara
.I tt_gmtoff
do tipo
.BR long ,
na ordem padro de bytes, seguida por um valor de um byte para
.I tt_isdst
e um valor de um byte para
.IR tt_abbrind .
Em cada estrutura,
.I tt_gmtoff
fornece o nmero de segundo para ser adicionado ao UTC,
.I tt_isdst
conta se
.I tm_isdst
dever se selecionado por
.I localtime (3)
e
.I tt_abbrind
tem funo de um indexador dentro da matriz de abreviao de caracteres defusos horrios
que seguem a(s) estrutura(s)
.I ttinfo
no arquivo.
.PP
Ento ali est o par
.I tzh_leapcnt
de valores de quatro bytes, escritos na ordem padro de byes;
o primeiro valor de cada para fornece o tempo
(como retornado por
.IR time(2))
no qual ocorre um salto de segundo;
o nmero de segundo fornecido
.I total
de saltos de segundo aplicados depois do tempo dado.
O par de valores so ordenados e ordem ascendente por time.
.PP
Ento ali esto
.I tzh_ttisstdcnt
indicadore padro/parede, cada um arqmazenado com um valor de um byte;
eles contam o tempo de transio associado com o tipo de tempo local
sendo especificado com um tempo local padro ou tempo do relgio de parede,
e so usado quando um arquivo de fuso horrio usado para tratamento de
variveis de ambiente no estilo POSIX de fuso horrios.
.PP
Finalmente ali esto
.I tzh_ttisgmtcnt
indicadores UTC/local, cada um armazenado como um valor de um byte;
eles contam o tempo de transio associado com o tipo de tempo local
sendo especificado como UTC ou tempo local,
e so usado quando um arquivo de fuso horrio usado para tratamento de
variveis de ambiente no estilo POSIX de fuso horrios.
.PP
.I Localtime
usar o primeiro tempo padro
.I ttinfo
estrutura no arquivo
(ou simplesmente a primeira
.I ttinfo
estrutura na ausncia de m estrutura padro de tempo)
se
.I tzh_timecnt
zero ou se o arguentp de tempo menor que o primeiro caractere de transio de tempo
gravado no arquivo.
.SH "VEJA TAMBM"
newctime(3)
.\" @(#)tzfile.5 7.11
.\" Este arquivo de domnio pblico, assim esclarescer como
.\" 1996-06-05 por Arthur David Olson (arthur_david_olson@nih.gov).
.SH TRADUZIDO POR LDP-BR em 21/08/2000.
\&\fR\&\f(CWAndr L. Fassone Canova <lonelywolf@blv.com.br> (traduo)\fR
\&\fR\&\f(CWCarlos Augusto Horylka <horylka@conectiva.com.br> (reviso)\fR
|