بروتوكول أمان طبقة النقل (SNTP)

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

ملخّص

أنواع المحددات

otSntpQuery typedef
struct otSntpQuery
تنفيذ معلمات طلب البحث SNTP
otSntpResponseHandler)(void *aContext, uint64_t aTime, otError aResult) typedef
void(*
يتم استدعاء المؤشر عند تلقّي استجابة SNTP.

الدوال

otSntpClientQuery(otInstance *aInstance, const otSntpQuery *aQuery, otSntpResponseHandler aHandler, void *aContext)
إرسال طلب SNTP
otSntpClientSetUnixEra(otInstance *aInstance, uint32_t aUnixEra)
void
إعداد رقم عصر يونكس

هياكل

otSntpQuery

تنفيذ معلمات طلب البحث SNTP

أنواع المحددات

otSntpQuery

struct otSntpQuery otSntpQuery

تنفيذ معلمات طلب البحث SNTP

otSntpResponseHandler

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'-a-thath.
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 على 0. تبدأ الفترات اللاحقة بعد العام 2106.

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

وحدات ماكرو

OT_SNTP_DEFAULT_SERVER_IP

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

تحديد عنوان خادم SNTP التلقائي - خادم NTP من Google.

OT_SNTP_DEFAULT_SERVER_PORT

 OT_SNTP_DEFAULT_SERVER_PORT 123

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

الموارد

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