.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 2016, Michael Kerrisk <mtk.manpages@gmail.com>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: Linux-man-pages-copyleft
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH ntp_gettime 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
ntp_gettime, ntp_gettimex \- الحصول على معاملات الوقت (واجهة برنامج خادم NTP)
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <sys/timex.h>\fP
.P
\fBint ntp_gettime(struct ntptimeval *\fP\fIntv\fP\fB);\fP
\fBint ntp_gettimex(struct ntptimeval *\fP\fIntv\fP\fB);\fP
.fi
.SH الوصف
تعيد كلتا واجهتي البرمجة هاتين المعلومات إلى المستدعي عبر المعامل \fIntv\fP،
وهو بنية من النوع التالي:
.P
.in +4n
.EX
struct ntptimeval {
    struct timeval time;    /* الوقت الحالي */
    long maxerror;          /* الحد الأقصى للخطأ */
    long esterror;          /* الخطأ المقدر */
    long tai;               /* إزاحة TAI */
\&
    /* بايتات حشو إضافية تسمح بالتوسع في المستقبل */
};
.EE
.in
.P
حقول هذا الهيكل هي كالتالي:
.TP 
\fItime\fP
الوقت الحالي، معبر عنه كبنية \fItimeval\fP:
.IP
.in +4n
.EX
struct timeval {
    time_t      tv_sec;   /* الثواني منذ حقبة يونكس (the Epoch) */
    suseconds_t tv_usec;  /* أجزاء من المليون من الثانية (Microseconds) */
};
.EE
.in
.TP 
\fImaxerror\fP
الخطأ الأقصى، بالميكروثواني. يمكن تهيئة هذه القيمة بواسطة \fBntp_adjtime\fP(3)،
وتُزاد دوريًا (على لينكس: كل ثانية)، لكنها تُثبَّت عند حد أعلى (ثابت النواة
\fBNTP_PHASE_MAX\fP، بقيمة 16,000).
.TP 
\fIesterror\fP
الخطأ المقدر، بالميكروثواني. يمكن ضبط هذه القيمة عبر \fBntp_adjtime\fP(3)
لتحتوي على تقدير للفرق بين ساعة النظام والوقت الحقيقي. لا تُستخدم هذه القيمة
داخل النواة.
.TP 
\fItai\fP
إزاحة TAI (الوقت الذري الدولي).
.P
تعيد \fBntp_gettime\fP() بنية \fIntptimeval\fP حيث تُملأ الحقول \fItime\fP
و\fImaxerror\fP و\fIesterror\fP.
.P
تؤدي \fBntp_gettimex\fP() نفس مهمة \fBntp_gettime\fP()، لكنها تعيد أيضًا معلومات
في الحقل \fItai\fP.
.SH "قيمة الإرجاع"
.\" FIXME . the info page incorrectly describes the return values.
قيم الإرجاع لـ \fBntp_gettime\fP() و\fBntp_gettimex\fP() هي كما في
\fBadjtimex\fP(2). بمعامل مؤشر صحيح، تنجح هاتان الدالتان دائمًا.
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBntp_gettime\fP(),
\fBntp_gettimex\fP()
T}	سلامة الخيوط	MT\-Safe
.TE
.SH المعايير
.TP 
\fBntp_gettime\fP()
واجهة برنامج تطبيق نواة NTP.
.TP 
\fBntp_gettimex\fP()
GNU.
.SH التاريخ
.TP 
\fBntp_gettime\fP()
glibc 2.1.
.TP 
\fBntp_gettimex\fP()
glibc 2.12.
.SH "انظر أيضًا"
\fBadjtimex\fP(2)، \fBntp_adjtime\fP(3)، \fBtime\fP(7)
.P
.ad l
.UR http:\://www.slac.stanford.edu/comp/unix/\:package/\:rtems/\:src/\:ssrlApps/\:ntpNanoclock/\:api.htm
NTP "واجهة برمجة تطبيقات النواة"
.UE
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .