NOM

       gettimeofday, settimeofday - Lire/écrire l'heure actuelle

SYNOPSIS

       #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)) :

       settimeofday() : _BSD_SOURCE

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 */
           };

       et donne le nombre de secondes et microsecondes écoulées depuis l'époque (consultez time(2)).  L'argument
       tz est une structure timezone composée ainsi :

           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-dessous.

       Sous Linux, il existe une sémantique particulière associée à l'appel système settimeofday() si, durant la
       première invocation (après le boot), il a un argument tz non NULL,  un  argument  tv  NULL  et  un  champ
       tz_minuteswest  différent  de  zéro  (dans  ce  cas,  le champ tz_dsttime doit être nul). 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é.

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()  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).

       Les macros opérant sur les structures timeval sont décrites dans timeradd(3).

       Traditionnellement, les champs de la structure timeval étaient de type long.

       Le  champ  tz_dsttime  n'a  jamais  été utilisé sous Linux, c'est pourquoi le paragraphe ci-dessous n'est
       présent qu'à but historique.

       Sur d'anciens systèmes, le champ tz_dsttime 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 Time - DST) sont
       définis comme suit :

           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.65 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> ».