table of contents
other sections
UTIME(2) | Linux Programmer's Manual | UTIME(2) |
NOME¶
utime, utimes - cambia l'ultimo orario di accesso e di modifica di un fileSINTASSI¶
#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¶
La chiamata di sistema utime() cambia le date di accesso e modifica dell'inode specificato da filename rispettivamente con quelle contenute nei campi actime e modtime di times.struct utimbuf { time_t actime; /* ora di accesso */ time_t modtime; /* ora di modifica */ };
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.
VALORI RESTITUITI¶
In caso di successo viene restituito zero. In caso di errore viene restituito -1 e errno contiene il codice di errore verificatosi.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.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), futimesat(2), stat(2), futimes(3)COLOPHON¶
Questa pagina fa parte del rilascio 2.80 del progetto man-pages di Linux. Si può trovare una descrizione del progetto, e informazioni su come riportare bachi, presso http://www.kernel.org/doc/man-pages/. Per la traduzione in italiano si può fare riferimento a http://www.pluto.it/ildp/collaborare/23 maggio 2008 | Linux |