utime

Autres langues

Langue: fr

Version: 18 juillet 2003 (openSuse - 09/10/07)

Autres sections - même nom

Section: 2 (Appels système)

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, 1996-2003.