Nom

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

Résumé

#include <sys/types.h> #include <utime.h> int utime(const char * filename , struct utimbuf * buf ); 2 #include <sys/time.h> int utimes(char * filename , struct timeval * tvp );

Description

utime change les dates d'accès et de modification de l'i-noeud 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 structure utimbuf est la suivante :

.nf struct utimbuf { time_t actime; /* access time */ time_t modtime; /* modification time */ }; .fi

Dans la bibliothèque DLL Linux 4.4.1 utimes est juste un recouvrement de utime : tvp [0]. tv_sec est égal à actime , et tvp [1]. tv_sec est égal à modtime . La structure timeval est la suivante :

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

Valeur renvoyée

utime et utimes renvoient 0 s'ils réussissent ou -1 s'ils échouent auquel cas errno contient le code d'erreur.

Erreurs

Plusieurs erreurs peuvent se produire, les plus courantes étant :
EACCES

L'accès en écriture au fichier est interdit.

ENOENT filename

n'existe pas.

Conformité

utime : SVr4, SVID, POSIX. SVr4 mentionne les conditions d'erreur supplémentaires EFAULT, EINTR, ELOOP, EMULTIHOP, ENAMETOOLONG, ENOLINK, ENOTDIR, EPERM, EROFS. utimes : BSD 4.3

Voir aussi

stat (2)

Traduction

Christophe Blaess, 1996-2003.