Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] gettimeofday, settimeofday - Lire / écrire l'heure actuelle. [size=18] [b]Résumé[/b] [/size] [b]#include <sys/time.h>[/b] [b][i]int gettimeofday(struct timeval * tv , struct timezone * tz );[/i][/b] [b][/b] [b][i]int settimeofday(const struct timeval * tv[/i][/b] [b][i], const struct timezone * tz );[/i][/b] [size=18] [b]Description[/b] [/size] Les fonctions [b]gettimeofday[/b] et [b]settimeofday[/b] servent à lire ou programmer l'heure ainsi que le fuseau horaire (timezone). L'argument [i]tv[/i] est une structure [b]timeval [/b] décrite dans /usr/include/sys/time.h : .nf struct timeval { .in +8 int tv_sec; /* secondes / int tv_usec; / microsecondes / .in -8 }; .fi et donne le nombre de secondes et microsecondes écoulées depuis le 1er janvier 1970 (voir [b]time (2)).[/b] L'argument [i]tz[/i] est une structure [b]timezone[/b] composée ainsi : .nf struct timezone { .in +8 int tz_minuteswest; / minutes à l'ouest de Greenwich / int tz_dsttime; / type de changement horaire / }; .in -8 .fi L'utilisation de la structure timezone est obsolète, le champ [i]tz_dsttime[/i] n'a jamais été utilisé sous Linux, il n'a jamais été géré, et ne le sera jamais par la libc ou glibc. Toute occurrence de ce champ dans les sources du noyau (sauf pour les déclarations) est un bug. Ainsi le paragraphe suivant n'a qu'un intérêt historique. Le champ [i]tz_dsttime[/i] contient une constante symbolique (dont les valeurs sont fournies ci-dessous) qui indique quelle partie du changement horaire annuel est en cours. (Remarque : Cette valeur est constante tout au long de l'année, elle n'indique pas réellement la valeur horaire en cours, elle sélectionne un algorithme). Les changements horaires (Daylight saving - DST) sont définis comme suit : .ta 14 [b]DST_NONE[/b] / Aucun / [b][/b] [b]DST_USA[/b] / USA / [b][/b] [b]DST_AUST[/b] / Australie / [b][/b] [b]DST_WET[/b] / Europe occidentale / [b][/b] [b]DST_MET[/b] / Europe centrale / [b][/b] [b]DST_EET[/b] / Europe Orientale / [b][/b] [b]DST_CAN[/b] / Canada / [b][/b] [b]DST_GB[/b] / Grande-Bretagne et Irlande / [b][/b] [b]DST_RUM[/b] / Roumanie / [b][/b] [b]DST_TUR[/b] / Turquie / [b][/b] [b]DST_AUSTALT[/b] / Australie avec décalage en 1986 */ Il est évident que le décalage horaire en cours ne peut pas être uniquement fourni par un algorithme par pays. Ce décalage dépend de décisions politiques imprévisibles. Ainsi cette méthode des fuseaux horaires a été abandonnée. Sous Linux, durant un appel à [b]settimeofday[/b] le champ [i]tz_dsttime[/i] doit être nul. Sous Linux, il existe une sémantique particulière associée à l'appel système [b]settimeofday[/b] si, durant la première invocation (après le boot), il a un argument [i]tz[/i] non-NULL, un argument [i]tv[/i] NULL et un champ [i]tz_minuteswest[/i] différent de zéro. Dans ce cas, on suppose que l'horloge CMOS de la machine est configurée sur le temps local, et que l'on doit l'augmenter de cette valeur pour obtenir le temps UTC. Bien entendu, il faut éviter autant que possible d'utiliser cette particularité. Les macros suivantes permettent de manipuler les structures timeval : [b][/b] .nf #define timerisset(tvp) .ti +8 ((tvp)->tv_sec \|\| (tvp)->tv_usec) #define timercmp(tvp, uvp, cmp) .in +8 ((tvp)->tv_sec cmp (uvp)->tv_sec \|\| (tvp)->tv_sec == (uvp)->tv_sec && (tvp)->tv_usec cmp (uvp)->tv_usec) .in -8 #define timerclear(tvp) .ti +8 ((tvp)->tv_sec = (tvp)->tv_usec = 0) .fi Si [i]tv[/i] ou [i]tz[/i] est nulle, la structure correspondante n'est ni programmée ni renvoyée. Seul le Super-User peut appeler [b]settimeofday .[/b] [size=18] [b]Valeur renvoyée[/b] [/size] [b]gettimeofday[/b] et [b]settimeofday[/b] renvoient 0 s'ils réussissent, ou -1 s'ils échouent, auquel cas [i]errno[/i] contient le code d'erreur. [size=18] [b]Erreurs[/b] [/size] [b]EPERM [/b] [b]settimeofday[/b] [table][row][col]    [/col][col]est appelé par quelqu'un d'autre que le Super-User[/col][/row][/table] [b]EINVAL[/b] [table][row][col]    [/col][col]le fuseau horaire (ou autre chose) est invalide. [b]EFAULT[/b] [i]tv[/i] ou [i]tz[/i] pointent en dehors de l'espace d'adressage autorisé.[/col][/row][/table] [size=18] [b]Note[/b] [/size] Le prototype de [b]settimeofday[/b] et les définitions de [b]timercmp ,[/b] [b]timerisset ,[/b] [b]timerclear ,[/b] [b]timeradd ,[/b] [b]timersub[/b] sont (depuis GlibC 2.2.2) disponibles uniquement si [b]_BSD_SOURCE[/b] est défini (explicitement ou implicitement en ne définissant pas _POSIX_SOURCE ou en utilisant l'option de compilation -ansi). [size=18] [b]Conformité[/b] [/size] SVr4, BSD 4.3 [size=18] [b]Voir aussi[/b] [/size] [b]date (1),[/b] [b]adjtimex (2),[/b] [b]time (2),[/b] [b]ctime (3),[/b] [b]ftime (3)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier