File: tzfile.5

package info (click to toggle)
manpages-pt 20040726
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 2,940 kB
  • ctags: 5
  • sloc: makefile: 49
file content (142 lines) | stat: -rw-r--r-- 4,199 bytes parent folder | download | duplicates (6)
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