UTIME(2)

NOM
utime, utimes - Modifier la date d'accès ou de modification d'un inœud

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() modifie 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 à la date 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'horodatage avec une résolution d'une seconde. L'appel système utimes() est similaire mais l'argument times fait référence à un tableau au lieu d'une structure. Les éléments de ce tableau sont des structures timeval, qui permettent 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, demanière analogue à utime(), les heures d'accès et modification du fichier sont définies à l'heure actuelle.

VALEUR RENVOYÉE
Ces appels renvoient 0 s'ils réussissent ou -1 s'ils échouent auquel cas errno contient le code d'erreur.

ERREURS

EACCES
    La permission de parcours est refusée pour l'un des répertoires du chemin path (voir 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.
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. POSIX.1-2001 considère utimes() comme un héritage du passé, ce qui est étrange puisque cet appel système fournit plus de fonctionnalités que utime().

VOIR AUSSI
chattr(1), futimesat(2), stat(2), futimes(3)

TRADUCTION

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 15 octobre 1996 et révisée le 2 juillet 2008.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 2 utime ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.