Provided by: manpages-fr-dev_3.32d0.2p4-1_all bug

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.32 du projet man-pages
       Linux. Une description du projet et des instructions pour signaler  des
       anomalies       peuvent       être       trouvées      à      l'adresse
       <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION

       Depuis 2010, cette traduction est maintenue à l'aide  de  l'outil  po4a
       <URL:http://po4a.alioth.debian.org/>   par   l'équipe   de   traduction
       francophone       au       sein        du        projet        perkamon
       <URL:http://perkamon.alioth.debian.org/>.

       Christophe  Blaess  <URL:http://www.blaess.fr/christophe/> (1996-2003),
       Alain  Portal  <URL: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> ».