الاسم¶

gettimeofday, settimeofday - الحصول / ضبط الوقت

المكتبة¶

مكتبة سي المعيارية (libc، -lc)

موجز¶

#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():

    منذ glibc 2.19:


        _DEFAULT_SOURCE


    glibc 2.19 وما قبله:


        _BSD_SOURCE

الوصف¶

يمكن للدالتين gettimeofday() و settimeofday() الحصول على الوقت وضبطه بالإضافة إلى منطقة زمنية.

الوسيط tv هو struct timeval (كما هو محدد في <sys/time.h>):

struct timeval {


    time_t      tv_sec;     /* ثوانٍ */


    suseconds_t tv_usec;    /* ميكرو ثانية */
};

ويعطي عدد الثواني والميكروثواني منذ الحقبة (انظر time(2)).

الوسيط tz هو struct timezone:

struct timezone {


    int tz_minuteswest;     /* دقائق غرب غرينتش */


    int tz_dsttime;         /* نوع تصحيح التوقيت الصيفي */
};

إذا كان أي من tv أو tz NULL، فلن يتم ضبط البنية المقابلة أو إرجاعها. (ومع ذلك، ستنتج تحذيرات ترجمة إذا كان tv NULL.)

استخدام بنية timezone قديم؛ يجب عادةً تحديد وسيط tz كـ NULL. (انظر الملاحظات أدناه.)

تحت لينكس، هناك بعض دلالات "الساعة الملتوية" الغريبة المرتبطة باستدعاء النظام settimeofday() إذا كان في أول استدعاء (بعد الإقلاع) يحتوي على وسيط tz غير NULL، وكان الوسيط tv NULL وحقل tz_minuteswest غير صفري. (يجب أن يكون حقل tz_dsttime صفرًا لهذه الحالة.) في مثل هذه الحالة، يُفترض أن ساعة CMOS على التوقيت المحلي، ويجب زيادتها بهذا المقدار للحصول على وقت النظام العالمي (UTC). مما لا شك فيه أن استخدام هذه الميزة فكرة سيئة.

قيمة الإرجاع¶

ترجع gettimeofday() و settimeofday() 0 عند النجاح. عند الخطأ، يتم إرجاع -1 ويتم ضبط errno للإشارة إلى الخطأ.

الأخطاء¶

EFAULT

أشار أحد tv أو tz إلى خارج مساحة العنوان القابلة للوصول.

EINVAL

(settimeofday()): timezone غير صالح.

EINVAL

(settimeofday()): tv.tv_sec سالب أو tv.tv_usec خارج النطاق [0, 999,999].

EINVAL (منذ لينكس 4.3)

(settimeofday()): تمت محاولة ضبط الوقت على قيمة أقل من القيمة الحالية لساعة CLOCK_MONOTONIC (انظر clock_gettime(2)).

EPERM

لا تملك العملية المستدعية صلاحية كافية لاستدعاء settimeofday()؛ تحت لينكس، مطلوب القدرة CAP_SYS_TIME.

الإصدارات¶

المعايير¶

gettimeofday()

POSIX.1-2008 (قديم).

settimeofday()

لا شيء.

التاريخ¶

SVr4, 4.3BSD. يصف POSIX.1-2001 gettimeofday() ولكن ليس settimeofday(). يضع POSIX.1-2008 علامة على gettimeofday() كقديم، موصياً باستخدام clock_gettime(2) بدلاً من ذلك.

تقليديًا، كانت حقول struct timeval من النوع long.

DST_NONE     /* not on DST */
DST_USA      /* USA style DST */
DST_AUST     /* Australian style DST */
DST_WET      /* Western European DST */
DST_MET      /* Middle European DST */
DST_EET      /* Eastern European DST */
DST_CAN      /* Canada */
DST_GB       /* Great Britain and Eire */
DST_RUM      /* Romania */
DST_TUR      /* Turkey */
DST_AUSTALT  /* Australian style with shift in 1986 */

ملاحظات¶

الوقت الذي ترجعه gettimeofday() يتأثر بالقفزات غير المستمرة في وقت النظام (مثلًا، إذا قام مسؤول النظام بتغيير وقت النظام يدويًا). إذا كنت بحاجة إلى ساعة متزايدة بشكل رتيب، انظر clock_gettime(2).

الماكرو للتعامل مع بنى timeval موصوفة في timeradd(3).

انظر أيضًا¶

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

ترجمة¶

تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.