TZFILE(5)

NOME
tzfile - informação de fuso horário

SINOPSE
#include <tzfile.h>

DESCRIÇÃO
O arquivo de informações sobre fusos horário usado por tzset(3) inicia com o caracter mágico "TZif" para identificar na mesma hora como arquivos de informações sobre fusos horário, seguido por dezesseis bytes reservados para uso futuro, seguido por seis valores de quatro bytes do tipo long, escrito na ordem de bytes ''padrão'' (o byte de mais alta ordem do valor é escrito primeiro. Este valores são, na ordem:

tzh_ttisgmtcnt
    O número do indicador UTC/local armazenado no arquivo.

tzh_ttisstdcnt
    O número do indicador padrão/pareee armazenado no arquivo

tzh_leapcnt
    O número do salto de segundos para qual dado é armazenado no arquivo.

tzh_timecnt
    O número de "transition times" para qual dado é armazenado no arquivo.

tzh_typecnt
    O número de "local time types" para qual dado é armazenado no arquivo (não pode ser zero).

tzh_charcnt
    O número de caracteres da "time zone abbreviation strings" armazenado no arquivo.

O cabeçalho citado acima é seguido por tzh_timecnt valores de quatro-bytes do tipo long, ordenados em ordem ascendente. Estes valores são escritos na ordem ''padrão''. Cada um é usado como um tempo de transição (como devolvido por time(2)) na regra para computar o tempo local alterada. Depois chega tzh_timecnt valor de um byte do tipo unsigned char; cada um conta qual dos diferentes tipos de ''local time'' descritos no arquivo associado com o tempo de translação como indexado. Aqueles valores servem com indice dentro de um matriz de estrutura ttinfo que mostra-se próxima no arquivo; estas estruturas são definidas com segue:

struct ttinfo {
	long	tt_gmtoff;
	int	tt_isdst;
	unsigned int	tt_abbrind;
};

Cada estrutura é escrita com um valor de 4 bytes oara tt_gmtoff do tipo long, na ordem padrão de bytes, seguida por um valor de um byte para tt_isdst e um valor de um byte para tt_abbrind. Em cada estrutura, tt_gmtoff fornece o número de segundo para ser adicionado ao UTC, tt_isdst conta se tm_isdst deverá se selecionado por localtime (3) e tt_abbrind tem função de um indexador dentro da matriz de abreviação de caracteres defusos horários que seguem a(s) estrutura(s) ttinfo no arquivo.

Então ali está o par tzh_leapcnt de valores de quatro bytes, escritos na ordem padrão de byes; o primeiro valor de cada para fornece o tempo (como retornado por time(2)) no qual ocorre um salto de segundo; o número de segundo fornecido total de saltos de segundo aplicados depois do tempo dado. O par de valores são ordenados e ordem ascendente por time.

Então ali estão tzh_ttisstdcnt indicadore padrão/parede, cada um arqmazenado com um valor de um byte; eles contam o tempo de transição associado com o tipo de tempo local sendo especificado com um tempo local padrão ou tempo do relógio de parede, e são usado quando um arquivo de fuso horário é usado para tratamento de variáveis de ambiente no estilo POSIX de fuso horários.

Finalmente ali estão tzh_ttisgmtcnt indicadores UTC/local, cada um armazenado como um valor de um byte; eles contam o tempo de transição associado com o tipo de tempo local sendo especificado como UTC ou tempo local, e são usado quando um arquivo de fuso horário é usado para tratamento de variáveis de ambiente no estilo POSIX de fuso horários.

Localtime usar o primeiro tempo padrão ttinfo estrutura no arquivo (ou simplesmente a primeira ttinfo estrutura na ausência de m estrutura padrão de tempo) se tzh_timecnt é zero ou se o arguentp de tempo é menor que o primeiro caractere de transição de tempo gravado no arquivo.

VEJA TAMBÉM
newctime(3)

TRADUZIDO POR LDP-BR em 21/08/2000.
André L. Fassone Canova <lonelywolf@blv.com.br> (tradução) Carlos Augusto Horylka <horylka@conectiva.com.br> (revisão)