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)