NOME

       utime, utimes - cambia l'ultimo orario di accesso e di modifica di un file

SINTASSI

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

       int utime(const char *filename, const struct utimbuf *times);

       #include <sys/time.h>

       int utimes(const char *filename, const struct timeval times[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 filename rispettivamente con quelle contenute nei campi actime e modtime di
       times.

       Se times è NULL, allora gli orari di accesso e modifica del file sono impostati  a  quelli
       correnti.

       Cambiare  le marcature orarie è permesso quando: o il processo ha i privilegi appropriati,
       o la user ID effettiva dell'utente è uguale alla user ID del file, o times  è  NULL  e  il
       processo ha permessi di scrittura sul file.

       La struttura utimbuf è 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() è 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 è 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 è 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 verrà
       impostato di conseguenza.

ERRORI

       EACCES Il permesso di ricerca è negato per una delle directory nel prefisso  del  percorso
              di path (vedere anche path_resolution(7)).

       EACCES times  è  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 capacità CAP_DAC_OVERRIDE o
              CAP_FOWNER).

       ENOENT filename non esiste.

       EPERM  times non è NULL, l'UID effettivo del chiamante non corrisponde al proprietario del
              file,  e  il  chiamante  non  ha  i  privilegi  necessari  (Linux:  non ha capacità
              CAP_FOWNER).

       EROFS  path risiede su un filesystem in sola lettura.

CONFORME A

       utime(): SVr4, POSIX.1-2001. POSIX.1-2008 marca utime() come obsoleto.

       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)

COLOPHON

       Questa pagina fa parte del rilascio 5.10 del progetto Linux man-pages. Una descrizione del
       progetto,  le  istruzioni  per la segnalazione degli errori, e l'ultima versione di questa
       pagina si trovano su https://www.kernel.org/doc/man-pages/.

TRADUZIONE

       La traduzione italiana di questa pagina di manuale è stata creata da  Goffredo  Baroncelli
       <kreijack@usa.net>,  Giulio  Daprelà  <giulio@pluto.it>,  Elisabetta  Galli <lab@kkk.it> e
       Marco Curreli <marcocurreli@tiscali.it>

       Questa traduzione è documentazione libera; leggere la GNU General Public License  Versione
       3 ⟨https://www.gnu.org/licenses/gpl-3.0.html⟩ o successiva per le condizioni di copyright.
       Non ci assumiamo alcuna responsabilità.

       Per segnalare errori nella traduzione di questa pagina di manuale inviare un  messaggio  a
       pluto-ildp@lists.pluto.it ⟨⟩.