بروتوكول النقل الآمن للملفات (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
تم استلام حزمة قبلة الموت.
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 التلقائي، خادم Google NTP.

OT_SNTP_DEFAULT_SERVER_PORT

 OT_SNTP_DEFAULT_SERVER_PORT 123

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

المراجِع

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