NUME¶

gettimeofday, settimeofday - obține / reglează ora

BIBLIOTECA¶

Biblioteca C standard (libc, -lc)

SINOPSIS¶

#include <sys/time.h>

int gettimeofday(struct timeval *restrict tv,
                 struct timezone *_Nullable restrict tz);
int settimeofday(const struct timeval *tv,
                 const struct timezone *_Nullable tz);

settimeofday():

    Începând cu glibc 2.19:


        _DEFAULT_SOURCE


    glibc 2.19 și versiunile anterioare:


        _BSD_SOURCE

DESCRIERE¶

Funcțiile gettimeofday() și settimeofday() pot obține și regla ora, precum și un fus orar.

Argumentul tv este o structură struct timeval (după cum se specifică în <sys/time.h>):

struct timeval {


    time_t      tv_sec;     /* secunde */


    suseconds_t tv_usec;    /* microsecunde */
};

și oferă numărul de secunde și microsecunde de la Epocă (a se vedea time(2)).

Argumentul tz este o structură struct timezone:

struct timezone {


    int tz_minuteswest;     /* minute la vest de Greenwich  */


    int tz_dsttime;         /* tipul de corecție a orei de vară */
};

Dacă tv sau tz este NULL, structura corespunzătoare nu este definită sau returnată; (cu toate acestea, vor apărea avertismente de compilare dacă tv este NULL).

Utilizarea structurii timezone este învechită; argumentul tz ar trebui în mod normal să fie specificat ca NULL. A se vedea secțiunea NOTE de mai jos.

În Linux, există o semantică ciudată de „ceas de deformare” asociată cu apelul de sistem settimeofday() dacă la primul apel (după pornire) care are un argument tz non-NULL, argumentul tv este NULL și câmpul tz_minuteswest este diferit de zero; (câmpul tz_dsttime ar trebui să fie zero pentru acest caz). Într-un astfel de caz, se presupune că ceasul CMOS este la ora locală și că trebuie să fie incrementat cu această valoare pentru a obține ora sistemului UTC. Fără îndoială, este o idee proastă să folosiți această caracteristică.

VALOAREA RETURNATö

gettimeofday() și settimeofday() returnează 0 pentru succes. În caz de eroare, se returnează -1, iar errno este configurată pentru a indica eroarea.

ERORI-IEȘIRE¶

EFAULT

Unul dintre argumente tv sau tz a indicat în afara spațiului de adrese accesibil.

EINVAL

(settimeofday()): timezone nu este valid.

EINVAL

(settimeofday()): tv.tv_sec este negativ sau tv.tv_usec este în afara intervalului [0, 999,999].

EINVAL (începând cu Linux 4.3)

(settimeofday()): S-a încercat reglarea orei la o valoare mai mică decât valoarea curentă a ceasului CLOCK_MONOTONIC (consultați clock_gettime(2)).

EPERM

Procesul apelant nu are privilegii suficiente pentru a apela settimeofday(); sub Linux este necesară capacitatea CAP_SYS_TIME.

VERSIUNI¶

STANDARDE¶

gettimeofday()

POSIX.1-2008 (obsolet).

settimeofday()

Niciunul.

ISTORIC¶

SVr4, 4.3BSD. POSIX.1-2001 descrie gettimeofday(), dar nu și settimeofday(). POSIX.1-2008 marchează gettimeofday() ca fiind depășit, recomandând utilizarea în schimb a clock_gettime(2).

În mod tradițional, câmpurile din struct timeval erau de tip long.

DST_NONE     /* nu la ora de vară */
DST_USA      /* ora de vară în stil SUA */
DST_AUST     /* ora de vară în stil australian */
DST_WET      /* ora de vară în stil Europa de vest */
DST_MET      /* ora de vară în stil Europa de vest */
DST_EET      /* ora de vară în stil Europa centrală */
DST_CAN      /* Canada */
DST_GB       /* Marea Britaie și Irlanda */
DST_RUM      /* România */
DST_TUR      /* Turcia */
DST_AUSTALT  /* Stil australian cu schimbare în 1986 */

NOTE¶

Ora returnată de gettimeofday() este afectată de salturi discontinue în ora sistemului (de exemplu, dacă administratorul sistemului modifică manual ora sistemului). Dacă aveți nevoie de un ceas care crește monoton, consultați clock_gettime(2).

Macrocomenzile pentru operarea structurilor timeval sunt descrise în timeradd(3).

CONSULTAȚI ȘI¶

date(1), adjtimex(2), clock_gettime(2), time(2), ctime(3), ftime(3), timeradd(3), capabilities(7), time(7), vdso(7), hwclock(8)

TRADUCERE¶

Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>

Această traducere este documentație gratuită; citiți Licența publică generală GNU Versiunea 3 sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE.

Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la translation-team-ro@lists.sourceforge.net.