Provided by:
manpages-fr-dev_3.32d0.2p4-1_all 
NOM
utime, utimes - Modifier la date d'acces ou de modification d'un
fichier
SYNOPSIS
#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]);
DESCRIPTION
L'appel systeme utime() change les dates d'acces et de modification de
l'inoeud indique par filename pour les valeurs contenues respectivement
dans les champs actime et modtime de times.
Si times est NULL, les dates d'acces et de modification sont mises a
l'heure actuelle.
La modification des horodatages est permise lorsque soit le processus a
les privileges appropries, soit l'UID effectif est egal a l'UID du
fichier, soit times est nul et le processus a la permission d'ecriture
sur le fichier.
La structure utimbuf est la suivante :
struct utimbuf {
time_t actime; /* heure d'acces */
time_t modtime; /* heure de modification */
};
L'appel systeme utime() permet des specifications d'horodatages avec
une resolution d'une seconde.
L'appel systeme utimes() est similaire mais le parametre times fait
reference a un tableau au lieu d'une structure. Les elements de ce
tableau sont des structures timeval, qui permet une resolution 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'acces, et times[1] indique la
nouvelle heure de modification. Si times est NULL, de maniere analogue
a utime(), les heures d'acces et modification du fichier sont definies
a l'heure actuelle.
VALEUR RENVOY'EE
S'il reussit, cet appel systeme renvoie 0. S'il echoue, il renvoie -1
et remplit errno en consequence.
ERREURS
EACCES La permission de parcours est refusee pour un des repertoires
contenu dans le chemin path. (Consultez aussi
path_resolution(7))
EACCES times est NULL, l'UID effectif de l'appelant ne correspond pas
au proprietaire du fichier, l'appelant n'a pas la permission
d'ecriture sur le fichier et l'appelant n'est pas privilegie
(Linux : n'a ni la capacite CAP_DAC_OVERRIDE, ni la capacite
CAP_FOWNER).
ENOENT filename n'existe pas.
EPERM times n'est pas NULL, l'UID effectif de l'appelant ne correspond
pas au proprietaire du fichier et l'appelant n'est pas
privilegie (Linux : n'a pas la capacite CAP_FOWNER).
EROFS path se trouve sur un systeme de fichiers en lecture seule.
CONFORMIT'E
utime() : SVr4, POSIX.1-2001. POSIX.1-2008 marque utime() comme etant
obsolete.
utimes() : BSD 4.3, POSIX.1-2001.
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 a utime() et ne
permet donc pas des resolutions inferieure a la seconde.
VOIR AUSSI
chattr(1), futimesat(2), stat(2), utimensat(2), futimens(3), futimes(3)
COLOPHON
Cette page fait partie de la publication 3.32 du projet man-pages
Linux. Une description du projet et des instructions pour signaler des
anomalies peuvent etre trouvees a l'adresse
<URL:http://www.kernel.org/doc/man-pages/>.
TRADUCTION
Depuis 2010, cette traduction est maintenue a l'aide de l'outil po4a
<URL:http://po4a.alioth.debian.org/> par l'equipe de traduction
francophone au sein du projet perkamon
<URL:http://perkamon.alioth.debian.org/>.
Christophe Blaess <URL:http://www.blaess.fr/christophe/> (1996-2003),
Alain Portal <URL:http://manpagesfr.free.fr/> (2003-2006). Julien
Cristau et l'equipe francophone de traduction de Debian (2006-2009).
Veuillez signaler toute erreur de traduction en ecrivant a
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet manpages-fr.
Vous pouvez toujours avoir acces a la version anglaise de ce document
en utilisant la commande << man -L C <section> <page_de_man> >>.
Linux 6 aout 2008 UTIME(2)