.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 2003, Walter Harms <walter.harms@informatik.uni-oldenburg.de>
.\" Copyright, the authors of the Linux man-pages project
.\"
.\" SPDX-License-Identifier: GPL-1.0-or-later
.\"
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH rtime 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
rtime \- الحصول على الوقت من جهاز بعيد
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <rpc/auth_des.h>\fP
.P
\fBint rtime(struct sockaddr_in *\fP\fIaddrp\fP\fB, struct rpc_timeval *\fP\fItimep\fP\fB,\fP
\fB          struct rpc_timeval *\fP\fItimeout\fP\fB);\fP
.fi
.SH الوصف
تستخدم هذه الدالة بروتوكول مخدم الوقت كما هو موصوف في RFC\ 868 للحصول على
الوقت من جهاز بعيد.
.P
يعطي بروتوكول مخدم الوقت الوقت بالثواني منذ 00:00:00 UTC، 1 يناير 1900،
وتطرح هذه الدالة الثابت المناسب لتحويل النتيجة إلى ثوانٍ منذ الحقبة،
1970\-01\-01 00:00:00 +0000 (UTC).
.P
عندما يكون \fItimeout\fP غير NULL، يُستخدم مقبس udp/time (المنفذ 37). وإلا،
يُستخدم مقبس tcp/time (المنفذ 37).
.SH "قيمة الإرجاع"
عند النجاح، يُعاد 0، وتُخزَّن قيمة الوقت 32\-بت التي تم الحصول عليها في
\fItimep\->tv_sec\fP. في حالة الخطأ، يُعاد \-1، ويُضبط \fIerrno\fP للإشارة إلى
الخطأ.
.SH الأخطاء
يمكن أن تحدث جميع أخطاء الدوال الأساسية (\fBsendto\fP(2)، \fBpoll\fP(2)،
\fBrecvfrom\fP(2)، \fBconnect\fP(2)، \fBread\fP(2)). بالإضافة إلى ذلك:
.TP 
\fBEIO\fP
عدد البايتات المُعادة ليس 4.
.TP 
\fBETIMEDOUT\fP
انتهى وقت الانتظار كما هو مُعرَّف في timeout.
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBrtime\fP()
T}	سلامة الخيوط	MT\-Safe
.TE
.SH ملاحظات
يُدعم IPv4 فقط.
.P
.\" .P
.\" Libc5 uses the prototype
.\" .P
.\" .nf
.\"    int rtime(struct sockaddr_in *, struct timeval *, struct timeval *);
.\" .fi
.\" .P
.\" and requires
.\" .I <sys/time.h>
.\" instead of
.\" .IR <rpc/auth_des.h> .
تدعم بعض إصدارات \fIin.timed\fP TCP فقط. جرب البرنامج المثال مع ضبط \fIuse_tcp\fP
إلى 1.
.SH العلل
لا تعمل \fBrtime\fP() في glibc 2.2.5 والإصدارات الأقدم بشكل صحيح على الأجهزة
64\-بت.
.SH أمثلة
يتطلب هذا المثال أن يكون المنفذ 37 قيد التشغيل ومفتوحًا. يمكنك التحقق من أن
إدخال الوقت داخل \fI/etc/inetd.conf\fP ليس معلقًا.
.P
يتصل البرنامج بجهاز يُدعى "linux". لا يعمل استخدام "localhost". النتيجة هي
التوقيت المحلي للجهاز "linux".
.P
.\" SRC BEGIN (rtime.c)
.EX
#include <errno.h>
#include <netdb.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <time.h>
\&
#include <rpc/auth_des.h>
\&
static int use_tcp = 0;
static const char servername[] = "linux";
\&
int
main(void)
{
    int                 ret;
    time_t              t;
    struct hostent      *hent;
    struct rpc_timeval  time1 = {0, 0};
    struct rpc_timeval  timeout = {1, 0};
    struct sockaddr_in  name;
\&
    memset(&name, 0, sizeof(name));
    sethostent(1);
    hent = gethostbyname(servername);
    memcpy(&name.sin_addr, hent\->h_addr, hent\->h_length);
\&
    ret = rtime(&name, &time1, use_tcp ? NULL : &timeout);
    if (ret < 0)
        perror("rtime error");
    else {
        t = time1.tv_sec;
        printf("%s\[rs]n", ctime(&t));
    }
\&
    exit(EXIT_SUCCESS);
}
.EE
.\" SRC END
.SH "انظر أيضًا"
.\" .BR netdate (1),
.\" .BR rdate (1),
\fBntpdate\fP(1), \fBinetd\fP(8)
.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 .