الاسم¶

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.

ntp_gettimex()

GNU.

التاريخ¶

ntp_gettime()

glibc 2.1.

ntp_gettimex()

glibc 2.12.

انظر أيضًا¶

adjtimex(2)، ntp_adjtime(3)، time(7)

NTP "واجهة برمجة تطبيقات النواة"

ترجمة¶

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

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

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