ntp_gettime(3)

الاسم
ntp_gettime, ntp_gettimex - الحصول على معاملات الوقت (واجهة برنامج خادم NTP)

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

موجز
#include <sys/timex.h>

int ntp_gettime(struct ntptimeval *ntv);
int ntp_gettimex(struct ntptimeval *ntv);

الوصف
تعيد كلتا واجهتي البرمجة هاتين المعلومات إلى المستدعي عبر المعامل ntv، وهو بنية من النوع التالي:

    struct ntptimeval {
        struct timeval time;    /* الوقت الحالي */
        long maxerror;          /* الحد الأقصى للخطأ */
        long esterror;          /* الخطأ المقدر */
        long tai;               /* إزاحة TAI */

        /* بايتات حشو إضافية تسمح بالتوسع في المستقبل */
    };

حقول هذا الهيكل هي كالتالي:

time
    الوقت الحالي، معبر عنه كبنية timeval:

        struct timeval {
            time_t      tv_sec;   /* الثواني منذ حقبة يونكس (the Epoch) */
            suseconds_t tv_usec;  /* أجزاء من المليون من الثانية (Microseconds) */
        };

maxerror
    الخطأ الأقصى، بالميكروثواني. يمكن تهيئة هذه القيمة بواسطة ntp_adjtime(3)، وتُزاد دوريًا (على لينكس: كل ثانية)، لكنها تُثبَّت عند حد أعلى (ثابت النواة NTP_PHASE_MAX، بقيمة 16,000).

esterror
    الخطأ المقدر، بالميكروثواني. يمكن ضبط هذه القيمة عبر ntp_adjtime(3) لتحتوي على تقدير للفرق بين ساعة النظام والوقت الحقيقي. لا تُستخدم هذه القيمة داخل النواة.

tai إزاحة TAI (الوقت الذري الدولي).

تعيد ntp_gettime() بنية ntptimeval حيث تُملأ الحقول time وmaxerror وesterror.

تؤدي ntp_gettimex() نفس مهمة ntp_gettime()، لكنها تعيد أيضًا معلومات في الحقل tai.

قيمة الإرجاع
قيم الإرجاع لـ ntp_gettime() وntp_gettimex() هي كما في adjtimex(2). بمعامل مؤشر صحيح، تنجح هاتان الدالتان دائمًا.

السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).
الواجهة | السمة | القيمة
ntp_gettime(), ntp_gettimex() | سلامة الخيوط | MT-Safe

المعايير

ntp_gettime()
    واجهة برنامج تطبيق نواة NTP.

ntp_gettimex()
    GNU.

التاريخ

ntp_gettime()
    glibc 2.1.

ntp_gettimex()
    glibc 2.12.

انظر أيضًا
adjtimex(2)، ntp_adjtime(3)، time(7)

NTP "واجهة برمجة تطبيقات النواة" (http://www.slac.stanford.edu/comp/unix/package/rtems/src/ssrlApps/ntpNanoclock/api.htm)

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

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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