utimes(2) cambian los tiempos de acceso o modificación de un nodo-í

Other Alias

utime

SINOPSIS

#include <sys/types.h>
#include <utime.h>

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

#include <sys/time.h>

int utimes(char *nombrefichero, struct timeval *tvp);

DESCRIPCIÓN

utime cambia los tiempos de acceso y modificación del nodo-í especificado por nombrefichero a los campos actime y modtime de buf respectivamente. Si buf es NULL, entonces los tiempos de acceso y modificación del fichero se ponen al tiempo actual. La estructura utimbuf es:

struct utimbuf {
        time_t actime;  /* tiempo de acceso */
        time_t modtime; /* tiempo de modificación */
};

En las bibliotecas DLL 4.4.1 de Linux, utimes es simplemente un envoltorio para utime: tvp[0].tv_sec es actime, y tvp[1].tv_sec es modtime. La estructura timeval es:

struct timeval {
        long    tv_sec;         /* segundos */
        long    tv_usec;        /* microsegundos */
};

VALOR DEVUELTO

En caso de éxito se devuelve cero. En caso de error se devuelve -1 y se pone en errno un valor apropiado.

ERRORES

Pueden ocurrir otros errores.

EACCES
Permiso denegado para escribir en el fichero.
ENOENT
nombrefichero no existe.

CONFORME A

utime: SVr4, SVID, POSIX. SVr4 documenta las condiciones de error adicionales EFAULT, EINTR, ELOOP, EMULTIHOP, ENAMETOOLONG, ENOLINK, ENOTDIR, ENOLINK, ENOTDIR, EPERM y EROFS.
utimes: BSD 4.3