adjtime(3) Library Functions Manual adjtime(3) NOME adjtime - corregge l'orario per sincronizzare l'orologio di sistema LIBRARY Standard C library (libc, -lc) SINTASSI #include int adjtime(const struct timeval *delta, struct timeval *olddelta); Macro per test di funzionalita per glibc (vedere feature_test_macros(7)): adjtime(): A partire da glibc 2.19: _DEFAULT_SOURCE glibc 2.19 e precedenti: _BSD_SOURCE DESCRIZIONE La funzione adjtime() regola in modo graduale l'orario di sistema (restituito da gettimeofday(2)). L'ammontare di tempo con cui regolare l'orologio e specificato nella struttura a cui punta delta. Questa struttura ha la forma seguente: struct timeval { time_t tv_sec; /* secondi */ suseconds_t tv_usec; /* microsecondi */ }; Se la regolazione di delta e positiva, l'orologio di sistema viene accelerato di qualche punto percentuale (per esempio aggiungendo una piccola quantita di tempo al valore dell'orario per ogni secondo) finche la regolazione non e stata completata. Se la regolazione di delta e negativa, l'orologio viene rallentato in maniera simile. Se si verifica una chiamata ad adjtime() mentre e in corso una regolazione dell'orario relativa ad una chiamata precedente di adjtime(), e delta non e NULL per l'ultima chiamata, la chiamata precedente viene terminata, senza pero scartare alcuna correzione gia completata. Se olddelta non e NULL, allora il buffer a cui punta viene usato per restituire l'ammontare di tempo rimanente dalle precedenti correzioni non ancora completate. VALORE RESTITUITO Se termina con successo, adjtime() restituisce 0. Se fallisce, viene restituito -1, e errno viene valorizzato per indicare l'errore. ERRORI EINVAL La correzione in delta e fuori dall'intervallo permesso. EPERM Il chiamante non ha privilegi sufficienti per correggere l'orario. Sotto Linux e richiesta l'abilitazione a CAP_SYS_TIME. ATTRIBUTI Per la spiegazione dei termini usati in questa sezione, vedere attributes(7). +--------------------------------------------+---------------+---------+ |Interfaccia | Attributo | Valore | +--------------------------------------------+---------------+---------+ |adjtime() | Thread safety | MT-Safe | +--------------------------------------------+---------------+---------+ STANDARDS None. STORIA 4.3BSD, System V. NOTE The adjustment that adjtime() makes to the clock is carried out in such a manner that the clock is always monotonically increasing. Using adjtime() to adjust the time prevents the problems that could be caused for certain applications (e.g., make(1)) by abrupt positive or negative jumps in the system time. adjtime() e stato progettato per effettuare piccole correzioni all'orario di sistema. Molti sistemi impongono un limite alla correzione, che puo essere specificato in delta. Nell'implementazione di glibc, delta dev'essere minore o uguale a (INT_MAX / 1000000 - 2) e maggiore o uguale a (INT_MIN / 1000000 + 2) (rispettivamente 2145 e -2145 secondi su i386). BUG Un bug di vecchia data faceva in modo che, se delta veniva valorizzato a NULL, a olddelta non veniva restituita alcuna informazione valida riguardo la correzione in sospeso dell'orologio. (In questo caso, adjtime() dovrebbe restituire la correzione dell'orario in sospeso, senza cambiarla.) Questo bug e stato risolto su sistemi con glibc versione 2.8 o successiva, e con kernel Linux versione 2.6.26 o successivo. VEDERE ANCHE adjtimex(2), gettimeofday(2), time(7) TRADUZIONE La traduzione italiana di questa pagina di manuale e stata creata da Elisabetta Galli e Marco Curreli 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.06 28 gennaio 2024 adjtime(3)