بروتوكول النقل الآمن للملفات (SNTP)

تشمل هذه الوحدة وظائف تتحكم في اتصال SNTP.

الملخّص

مواقد الخط

otSntpQuery مَعلمة typetype
struct otSntpQuery
تؤدي هذه البنية إلى تنفيذ معلمات SNTP Query.
otSntpResponseHandler)(void *aContext, uint64_t aTime, otError aResult) مَعلمة typetype
void(*
يتم استدعاء مؤشر الدالة هذا عند تلقّي استجابة SNTP.

الدوال

otSntpClientQuery(otInstance *aInstance, const otSntpQuery *aQuery, otSntpResponseHandler aHandler, void *aContext)
ترسل هذه الدالة طلب SNTP.
otSntpClientSetUnixEra(otInstance *aInstance, uint32_t aUnixEra)
void
تحدّد هذه الدالة رقم الحقبة في نظام التشغيل Unix.

التشريعات

otSntpQuery

تؤدي هذه البنية إلى تنفيذ معلمات SNTP Query.

مواقد الخط

otSntpQuery

struct otSntpQuery otSntpQuery

تؤدي هذه البنية إلى تنفيذ معلمات SNTP Query.

معالج otSntpResponse

void(* otSntpResponseHandler)(void *aContext, uint64_t aTime, otError aResult)

يتم استدعاء مؤشر الدالة هذا عند تلقّي استجابة SNTP.

التفاصيل
المعلَمات
[in] aContext
مؤشر للسياق الخاص بالتطبيق.
[in] aTime
تحدّد هذه الوسيطة الوقت على الخادم عند ترك الاستجابة للعميل، بتوقيت UNIX.
[in] aResult
نتيجة لمعاملة SNTP.
قيم الإرجاع
OT_ERROR_NONE
تم استلام رد بنجاح وتم توفير الوقت في aTime.
OT_ERROR_ABORT
تم إلغاء معاملة SNTP بواسطة حِزمة بيانات.
OT_ERROR_BUSY
تم استلام حزمة Kiss-o-death.
OT_ERROR_RESPONSE_TIMEOUT
لم يتم استلام رد SNTP خلال المهلة.
OT_ERROR_FAILED
تم تلقّي ردّ ولكنه يحتوي على بيانات غير صحيحة.

الدوال

otSntpClientQuery

otError otSntpClientQuery(
  otInstance *aInstance,
  const otSntpQuery *aQuery,
  otSntpResponseHandler aHandler,
  void *aContext
)

ترسل هذه الدالة طلب SNTP.

هذه الدالة غير متوفرة إلا إذا تم تفعيل الميزة OPENTHREAD_CONFIG_SNTP_CLIENT_ENABLE.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aQuery
مؤشر لتحديد معلمات طلب بحث SNTP.
[in] aHandler
مؤشر دالة يتم استدعاؤه عند استقبال الردود أو انتهاء المهلة.
[in] aContext
مؤشر لمعلومات السياق العشوائية.

otSntpClientSetUnixEra

void otSntpClientSetUnixEra(
  otInstance *aInstance,
  uint32_t aUnixEra
)

تحدّد هذه الدالة رقم الحقبة في نظام التشغيل Unix.

يتم ضبط القيمة التلقائية لفترة Unix على 0. وتبدأ الحقبة اللاحقة بعد عام 2016.

التفاصيل
المعلَمات
[in] aInstance
مؤشر إلى مثيل OpenThread.
[in] aUnixEra
رقم Unix

وحدات ماكرو

OT_SNTP_DEFAULT_SERVER_IP

 OT_SNTP_DEFAULT_SERVER_IP "2001:4860:4806:8::"

يحدِّد هذا الإعداد عنوان خادم SNTP التلقائي - خادم Google NTP.

OT_SNTP_DEFAULT_SERVER_PORT

 OT_SNTP_DEFAULT_SERVER_PORT 123

لتحديد منفذ خادم SNTP التلقائي.

المراجع

تنشأ مواضيع واجهة برمجة التطبيقات المرجعية لـ OpenThread من رمز المصدر، المتوفر على GitHub. للاطّلاع على مزيد من المعلومات أو للمساهمة في مستنداتنا، يُرجى الرجوع إلى المراجع.