Fonctions du
système (section 2) utime
Nom
utime, utimes - Changer la date d'accès ou de modification d'un i-noeud.Synopsis
#include <sys/types.h>#include <utime.h>
int utime(const char *filename, struct utimbuf *buf);
#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 :
struct utimbuf { time_t actime; /* access time */ time_t modtime; /* modification time */ };
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 :
struct timeval { long tv_sec; /* secondes */ long tv_usec; /* microsecondes */ };
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, 1997.