NOME
adjtime − corregge l’orario per sincronizzare l’orologio di sistema
SINTASSI
#include <sys/time.h>
int adjtime(const struct timeval *delta, struct timeval *olddelta);
Macro per test di funzionalità richieste per glibc (vedere feature_test_macros(7)):
adjtime(): _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 è 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 è positiva, l’orologio di sistema viene accellerato di qualche punto percentuale (per esempio aggiungendo una piccola quantità di tempo al valore dell’orario per ogni secondo) finché la regolazione non è stata completata. Se la regolazione di delta è negativa, l’orologio viene rallentato in maniera simile.
Se si verifica una chiamata ad adjtime() mentre è in corso una regolazione dell’orario relativa ad una chiamata precedente di adjtime(), e delta non è NULL per l’ultima chiamata, la chiamata precedente viene terminata, senza però scartare alcuna correzione già completata.
Se olddelta non è 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 è fuori dall’intervallo permesso. | ||
|
EPERM |
Il chiamante non ha privilegi sufficienti per correggere l’orario. Sotto Linux è richiesta l’abilitazione a CAP_SYS_TIME. |
ATTRIBUTI
Multithreading
(vedi pthreads(7))
La funzione adjtime() è thread-safe.
CONFORME A
4.3BSD, System V.
NOTE
La correzione che adjtime() effettua sull’orologio viene eseguita in modo che quest’ultimo venga sempre incrementato uniformemente. Usando adjtime() per correggere l’orario si evitano problemi di funzionamento per certe applicazioni (per esempio, make(1)) dovuti a improvvise variazioni positive o negative dell’orario di sistema.
adjtime() è stato progettato per effettuare piccole correzioni all’orario di sistema. Molti sistemi impongono un limite alla correzione, che può 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 è 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)
COLOPHON
Questa pagina fa parte del rilascio 3.73 del progetto Linux man-pages. Una descrizione del progetto, le istruzioni per la segnalazione degli errori, e l’ultima versione di questa pagina si trova su http://www.kernel.org/doc/man−pages/.
La versione
italiana fa parte del pacchetto man-pages-it v. 3.73,
a cura di: ILDP "Italian Linux Documentation
Project" http://www.pluto.it/ildp
Per la traduzione in italiano si può fare riferimento
a http://www.pluto.it/ildp/collaborare/
Segnalare eventuali errori di traduzione a
ildp [AT] pluto.it