utime(2) System Calls Manual utime(2) NOME utime, utimes - cambia l'ultimo orario di accesso e di modifica di un file LIBRERIA Libreria C standard (libc, -lc) SINTASSI #include int utime(const char *path, const struct utimbuf *_Nullable times); #include int utimes(const char *path, const struct timeval times[_Nullable 2]); DESCRIZIONE Nota: le applicaizoni moderne potrebbero preferire le interfacce descritte in utimensat(2). La chiamata di sistema utime() cambia gli orari di accesso e di modifica dell'inode specificato da path rispettivamente con i valori dei campi actime e modtime di times. L'orario di modifica dello stato (ctime) verra impostato all'orario corrente anche se gli altri orari rimangono invariati. Se times e NULL, allora gli orari di accesso e modifica del file sono impostati a quelli correnti. Cambiare le marcature orarie e permesso quando: o il processo ha i privilegi appropriati, o la user ID effettiva dell'utente e uguale alla user ID del file, o times e NULL e il processo ha permessi di scrittura sul file. La struttura utimbuf e la seguente: struct utimbuf { time_t actime; /* ora di accesso */ time_t modtime; /* ora di modifica */ }; La chiamata di sistema utime() permette di specificare le marcature orarie con una risoluzione di 1 secondo. La chiamata di sistema utimes() e simile, ma gli argomenti di times fanno riferimento ad un array, non a una struttura. Gli elementi di questo array sono strutture timeval, che permettono una precisione di 1 microsecondo nello specificare data e ora. La struttura timeval e la seguente: struct timeval { long tv_sec; /* secondi */ long tv_usec; /* microsecondi */ }; times[0] specifica la nuova ora di accesso, e times[1] specifica la nuova ora di modifica. Se times e NULL, analogamente a utime(), le date di accesso e modifica del file sono impostate a quelle correnti. VALORE RESTITUITO In caso di successo restituisce zero. In caso di errore restituisce -1, e errno verra impostato per indicare l'errore. ERRORI EACCES Il permesso di ricerca e negato per una delle directory nel prefisso del percorso di path (vedere anche path_resolution(7)). EACCES times e NULL, l'ID effettivo dell'utente chiamante non corrisponde a quello del proprietario del file, il chiamante non ha accesso in scrittura al file, e il chiamante non ha i privilegi necessari (Linux: non ha capacita CAP_DAC_OVERRIDE o CAP_FOWNER). EFAULT path punta ad un indirizzo non valido. ENOENT path non esiste. EPERM times non e NULL, l'UID effettivo del chiamante non corrisponde al proprietario del file, e il chiamante non ha i privilegi necessari (Linux: non ha capacita CAP_FOWNER). EROFS path risiede su un filesystem in sola lettura. CONFORME A utime() Nulla. utimes() POSIX.1-2024. STORIA utime() SVr4, POSIX.1-2001. POSIX.1-2008 lo segnala come obsoleto. Rimosso in POSIX.1-2024. utimes() 4.3BSD, POSIX.1-2001. NOTE Linux non permette di cambiare data e ora su un file immutabile, o di impostarle a qualcosa di diverso dall'ora corrente in un file di tipo append-only. VEDERE ANCHE chattr(1), touch(1), futimesat(2), stat(2), utimensat(2), futimens(3), futimes(3), inode(7) TRADUZIONE La traduzione italiana di questa pagina di manuale e stata creata da Goffredo Baroncelli , Giulio Daprela , Elisabetta Galli , Marco Curreli e Giuseppe Sacco Questa traduzione e documentazione libera; leggere la GNU General Public License Versione 3 o successiva per le condizioni di copyright. Non ci assumiamo alcuna responsabilita. Per segnalare errori nella traduzione di questa pagina di manuale inviare un messaggio a . Linux man-pages 6.17 8 febbraio 2026 utime(2)