table of contents
other sections
GETTIMEOFDAY(2) | Manuel du programmeur Linux | GETTIMEOFDAY(2) |
NOM¶
gettimeofday, settimeofday - Lire/écrire l'heure actuelleSYNOPSIS¶
#include <sys/time.h> int gettimeofday(struct timeval *tv, struct timezone *tz); int settimeofday(const struct timeval *tv, const struct timezone *tz);
Exigences de macros de test de fonctionnalités pour la glibc (consultez feature_test_macros(7)) :
DESCRIPTION¶
Les fonctions gettimeofday() et settimeofday() servent à lire ou programmer l'heure ainsi que le fuseau horaire (timezone). L'argument tv est une structure timeval décrite dans <sys/time.h> :struct timeval { time_t tv_sec; /* secondes */ suseconds_t tv_usec; /* microsecondes */ };
struct timezone { int tz_minuteswest; /* minutes à l'ouest de Greenwich */ int tz_dsttime; /* type de changement horaire */ };
Si tv ou tz est nulle, la structure correspondante n'est ni remplie ni renvoyée. (Cependant, des avertissements à la compilation seront émis si tv est NULL. L'utilisation de la structure timezone est obsolète ; le paramètre tz doit normalement être NULL. Consultez la section NOTES ci-desous.
VALEUR RENVOYÉE¶
gettimeofday et settimeofday renvoient 0 s'ils réussissent, ou -1 s'ils échouent, auquel cas errno contient le code d'erreur.ERREURS¶
- EFAULT
- tv ou tz pointent en dehors de l'espace d'adressage autorisé.
- EINVAL
- Le fuseau horaire (ou autre chose) est invalide.
- EPERM
- Le processus appelant n'a pas les privilèges suffisant pour appeler settimeofday() ; sous Linux, la capacité CAP_SYS_TIME est nécessaire.
CONFORMITɶ
SVr4, BSD 4.3. POSIX.1-2001 décrit gettimeofday() mais pas settimeofday(). POSIX.1-2008 marque gettimeofday() comme étant obsolète, en recommandant d'utiliser clock_gettime(2) à la place.NOTES¶
L'heure renvoyée par gettimeofday(2) est concernée par les sauts discontinus de l'heure système (c'est-à-dire si l'administrateur modifie l'heure système lui-même). Si vous devez incrémenter l'horloge de façon monotone, consultez clock_gettime(2).DST_NONE /* Aucun */DST_USA /* USA */DST_AUST /* Australie */DST_WET /* Europe occidentale */DST_MET /* Europe centrale */DST_EET /* Europe Orientale */DST_CAN /* Canada */DST_GB /* Grande‐Bretagne et Irlande */DST_RUM /* Roumanie */DST_TUR /* Turquie */DST_AUSTALT /* 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.
VOIR AUSSI¶
date(1), adjtimex(2), clock_gettime(2), time(2), ctime(3), ftime(3), timeradd(3), capabilities(7), time(7)COLOPHON¶
Cette page fait partie de la publication 3.44 du projet man-pages Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse <http://www.kernel.org/doc/man-pages/>.TRADUCTION¶
Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>. Christophe Blaess <http://www.blaess.fr/christophe/> (1996-2003), Alain Portal <http://manpagesfr.free.fr/> (2003-2006). Julien Cristau et l'équipe francophone de traduction de Debian (2006-2009). Veuillez signaler toute erreur de traduction en écrivant à <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le paquet manpages-fr. Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C <section> <page_de_man> ».26 avril 2012 | Linux |