bionic (2) utimes.2.gz

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)