UTIME(2)

NOMBRE
utime, utimes - cambian los tiempos de acceso o modificación de un nodo-í

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

VÉASE TAMBIÉN
stat(2)