table of contents
other sections
ADJTIME(3) | Linux Programmer's Manual | ADJTIME(3) |
NOME¶
adjtime - corregge l'orario per sincronizzare l'orologio di sistemaSINTASSI¶
int adjtime(const struct timeval *delta, struct timeval *olddelta);
Test delle funzioni e requisiti delle macro per glibc (vedere feature_test_macros(7)):
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 in 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 in delta è negativa, l'orologio viene rallentato in maniera simile.
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. In Linux è richiesta l'abilitazione a CAP_SYS_TIME .
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.BUG¶
Attualmente, se delta viene valorizzato a NULL, a olddelta non viene 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 è il risultato di una limitazione del kernel.VEDERE ANCHE¶
adjtimex(2), gettimeofday(2), time(7)COLOPHON¶
Questa pagina fa parte del rilascio 2.75 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/26 luglio 2006 | Linux |