NOM

       utime, utimes - Modifier la date d'accès ou de modification d'un fichier

SYNOPSIS

       #include <sys/types.h>
       #include <utime.h>

       int utime(const char *filename, const struct utimbuf *times);

       #include <sys/time.h>

       int utimes(const char *filename, const struct timeval times[2]);

DESCRIPTION

       L'appel système utime() change les dates d'accès et de modification de l'inœud indiqué par
       filename pour les valeurs contenues respectivement dans les champs actime  et  modtime  de
       times.

       Si times est NULL, les dates d'accès et de modification sont mises à l'heure actuelle.

       La  modification  des  horodatages  est permise lorsque soit le processus a les privilèges
       appropriés, soit l'UID effectif est égal à l'UID du fichier, soit  times  est  nul  et  le
       processus a la permission d'écriture sur le fichier.

       La structure utimbuf est la suivante :

           struct utimbuf {
               time_t actime;       /* heure d'accès  */
               time_t modtime;      /* heure de modification */
           };

       L'appel  système utime() permet des spécifications d'horodatages avec une résolution d'une
       seconde.

       L'appel système utimes() est similaire mais le paramètre times fait référence à un tableau
       au  lieu  d'une  structure.  Les  éléments  de ce tableau sont des structures timeval, qui
       permet une résolution d'une microseconde pour les horodatages. La structure timeval est la
       suivante :

           struct timeval {
               long tv_sec;        /* secondes      */
               long tv_usec;       /* microsecondes */
           };

       times[0]  indique  la  nouvelle  heure  d'accès,  et times[1] indique la nouvelle heure de
       modification. Si times est NULL, de manière analogue à  utime(),  les  heures  d'accès  et
       modification du fichier sont définies à l'heure actuelle.

VALEUR RENVOYÉE

       S'il  réussit, cet appel système renvoie 0. S'il échoue, il renvoie -1 et remplit errno en
       conséquence.

ERREURS

       EACCES La permission de parcours est refusée pour  un  des  répertoires  contenu  dans  le
              chemin path. (Consultez aussi path_resolution(7))

       EACCES times  est  NULL, l'UID effectif de l'appelant ne correspond pas au propriétaire du
              fichier, l'appelant n'a pas la permission d'écriture sur le fichier  et  l'appelant
              n'est  pas  privilégié (Linux : n'a ni la capacité CAP_DAC_OVERRIDE, ni la capacité
              CAP_FOWNER).

       ENOENT filename n'existe pas.

       EPERM  times  n'est  pas  NULL,  l'UID  effectif  de  l'appelant  ne  correspond  pas   au
              propriétaire  du  fichier  et  l'appelant  n'est pas privilégié (Linux : n'a pas la
              capacité CAP_FOWNER).

       EROFS  path se trouve sur un système de fichiers en lecture seule.

CONFORMITÉ

       utime() : SVr4, POSIX.1-2001. POSIX.1-2008 marque utime() comme étant obsolète.
       utimes() : BSD 4.3, POSIX.1-2001.

NOTES

       Linux n'autorise  pas  la  modification  d'horodatages  sur  les  fichiers  immuables,  ou
       l'horodatage avec autre chose que la date courante sur les fichiers en ajout seulement.

       Dans  libc4 et libc5, utimes() est juste une enveloppe à utime() et ne permet donc pas des
       résolutions inférieure à la seconde.

VOIR AUSSI

       chattr(1), futimesat(2), stat(2), utimensat(2), futimens(3), futimes(3)

COLOPHON

       Cette page fait partie de la publication 3.57 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> ».