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

NOM

       utime,  utimes  -  Modifier  la  date  d'acces  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 systeme utime() change les dates d'acces et de modification  de
       l'inoeud indique par filename pour les valeurs contenues respectivement
       dans les champs actime et modtime de times.

       Si times est NULL, les dates d'acces et de modification  sont  mises  a
       l'heure actuelle.

       La modification des horodatages est permise lorsque soit le processus a
       les privileges appropries, soit l'UID effectif  est  egal  a  l'UID  du
       fichier,  soit times est nul et le processus a la permission d'ecriture
       sur le fichier.

       La structure utimbuf est la suivante :

           struct utimbuf {
               time_t actime;       /* heure d'acces  */
               time_t modtime;      /* heure de modification */
           };

       L'appel systeme utime() permet des  specifications  d'horodatages  avec
       une resolution d'une seconde.

       L'appel  systeme  utimes()  est  similaire mais le parametre times fait
       reference a un tableau au lieu d'une  structure.  Les  elements  de  ce
       tableau  sont  des  structures timeval, qui permet une resolution 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'acces, et times[1] indique la
       nouvelle heure de modification. Si times est NULL, de maniere  analogue
       a  utime(), les heures d'acces et modification du fichier sont definies
       a l'heure actuelle.

VALEUR RENVOY'EE

       S'il reussit, cet appel systeme renvoie 0. S'il echoue, il  renvoie  -1
       et remplit errno en consequence.

ERREURS

       EACCES La  permission  de  parcours est refusee pour un des repertoires
              contenu    dans    le    chemin    path.    (Consultez     aussi
              path_resolution(7))

       EACCES times  est  NULL, l'UID effectif de l'appelant ne correspond pas
              au proprietaire du fichier, l'appelant  n'a  pas  la  permission
              d'ecriture  sur  le  fichier  et l'appelant n'est pas privilegie
              (Linux : n'a ni la capacite  CAP_DAC_OVERRIDE,  ni  la  capacite
              CAP_FOWNER).

       ENOENT filename n'existe pas.

       EPERM  times n'est pas NULL, l'UID effectif de l'appelant ne correspond
              pas  au  proprietaire  du  fichier  et  l'appelant   n'est   pas
              privilegie (Linux : n'a pas la capacite CAP_FOWNER).

       EROFS  path se trouve sur un systeme de fichiers en lecture seule.

CONFORMIT'E

       utime() :  SVr4,  POSIX.1-2001. POSIX.1-2008 marque utime() comme etant
       obsolete.
       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 a utime()  et  ne
       permet donc pas des resolutions inferieure a 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       etre       trouvees      a      l'adresse
       <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION

       Depuis 2010, cette traduction est maintenue a l'aide  de  l'outil  po4a
       <URL:http://po4a.alioth.debian.org/>   par   l'equipe   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'equipe francophone de traduction de Debian (2006-2009).

       Veuillez   signaler   toute   erreur   de   traduction  en  ecrivant  a
       <debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
       paquet manpages-fr.

       Vous  pouvez  toujours avoir acces a la version anglaise de ce document
       en utilisant la commande << man -L C <section> <page_de_man> >>.

Linux                             6 aout 2008                         UTIME(2)