#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]);

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 tableu au lieu d'une structure, et la structure 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, demanière analogue à utime(), les heures d'accès et modification du fichier sont définies à l'heure actuelle.  

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.

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 puisqu'il fournit plus de fonctionnalités que utime().  

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 6 juin 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.

NOM

SYNOPSIS

DESCRIPTION

VALEUR RENVOYÉE

ERREURS

CONFORMITÉ

NOTES

VOIR AUSSI

TRADUCTION