UTIME

Index

NOM
SYNOPSIS
DESCRIPTION
VALEUR RENVOYÉE
ERREURS
NOTES
BOGUES
CONFORMITÉ
VOIR AUSSI
TRADUCTION

NOM

utime, utimes - Changer la date d'accès ou de modification d'un inoeud

SYNOPSIS

#include <sys/types.h>


#include <utime.h>

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

#include <sys/time.h>

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

DESCRIPTION

utime() change les dates d'accès et de modification de l'inoeud indiqué par filename pour les valeurs contenues respectivement dans les champs actime et modtime de buf.
Si buf 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 (sous Linux : avoir la capacité CAP_FOWNER), soit l'UID effectif est égal à l'UID du fichier, soit buf 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 */
};

La fonction utime() permet des spécifications d'horodatage avec une résolution d'une seconde. La fonction utimes() est similaire mais permet un résolution d'une microseconde. Ici, times[0] fait référence à l'heure d'accès, et times[1] à l'heure de modification.
La structure timeval est la suivante :

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

VALEUR RENVOYÉE

En cas de réussite, zéro est renvoyé, sinon -1 est renvoyé et 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(2)), ou buf est nul et le processus n'a pas l'autorisation de modifier les horodatages (voir plus haut).
ENOENT: filename n'existe pas.
EPERM: buf n'est pas nul et le processus n'a pas l'autorisation de modifier les horodatages.
EROFS: path se trouve sur un système de fichiers en lecture seule.

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 marque utimes() comme déprécié, ce qui est étrange car cet appel fournit plus de fonctionnalités que utime().

BOGUES

Linux ne prend pas soin de distinguer les erreurs de retour EACCES et EPERM. D'un autre coté, POSIX.1-2001 est bogué dans sa description d'erreur pour utimes().

CONFORMITÉ

utime() : SVr4, POSIX.1-2001.
utimes() : BSD 4.3

VOIR AUSSI

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

TRADUCTION

Cette page de manuel a été traduite et mise à jour par Christophe Blaess <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par Alain Portal <aportal AT univ-montp2 DOT fr> jusqu'en 2006.
La traduction de cette page de manuel est basée sur les traductions disponibles sur http://manpagesfr.free.fr/, mais est gérée par l'équipe francophone de traduction de Debian au travers de la liste de discussion debian-l10n-french.
Veuillez signaler toute erreur de traduction 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> ».

Création : octobre 2007