أداة تتبُّع السجلّ

لتسجيل سجلّ الأحداث المختلفة، مثل رسائل RX وTX أو التغييرات في معلومات الشبكة.

ملخّص

جميع الإدخالات التي يتم تتبعها ذات طابع زمني.

تتوفر الدوالّ في هذه الوحدة عند تفعيل "OPENTHREAD_CONFIG_HISTORY_TRACKER_ENABLE".

عمليات التعداد
anonymous enum{
  OT_HISTORY_TRACKER_MSG_PRIORITY_LOW = OT_MESSAGE_PRIORITY_LOW,
  OT_HISTORY_TRACKER_MSG_PRIORITY_NORMAL = OT_MESSAGE_PRIORITY_NORMAL,
  OT_HISTORY_TRACKER_MSG_PRIORITY_HIGH = OT_MESSAGE_PRIORITY_HIGH,
  OT_HISTORY_TRACKER_MSG_PRIORITY_NET = OT_MESSAGE_PRIORITY_HIGH + 1
} 		تعداد
الثوابت التي تمثّل أولوية الرسالة المستخدَمة في بنية otHistoryTrackerMessageInfo
otHistoryTrackerAddressEvent{
  OT_HISTORY_TRACKER_ADDRESS_EVENT_ADDED = 0,
  OT_HISTORY_TRACKER_ADDRESS_EVENT_REMOVED = 1
} 		تعداد
تُحدِّد أحداث معلومات عنوان IPv6 (البث الأحادي أو المتعدد) (أي ما إذا تمت إضافة العنوان أو إزالته).
otHistoryTrackerNeighborEvent{
  OT_HISTORY_TRACKER_NEIGHBOR_EVENT_ADDED = 0,
  OT_HISTORY_TRACKER_NEIGHBOR_EVENT_REMOVED = 1,
  OT_HISTORY_TRACKER_NEIGHBOR_EVENT_CHANGED = 2,
  OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING = 3
} 		تعداد
تحديد الأحداث في معلومات الجار (أي
otHistoryTrackerNetDataEvent{
  OT_HISTORY_TRACKER_NET_DATA_ENTRY_ADDED = 0,
  OT_HISTORY_TRACKER_NET_DATA_ENTRY_REMOVED = 1
} 		تعداد
تُحدِّد أحداث إدخال بيانات الشبكة (أي ما إذا تمت إضافة إدخال أو إزالته).
otHistoryTrackerRouterEvent{
  OT_HISTORY_TRACKER_ROUTER_EVENT_ADDED = 0,
  OT_HISTORY_TRACKER_ROUTER_EVENT_REMOVED = 1,
  OT_HISTORY_TRACKER_ROUTER_EVENT_NEXT_HOP_CHANGED = 2,
  OT_HISTORY_TRACKER_ROUTER_EVENT_COST_CHANGED = 3
} 		تعداد
تحدّد الأحداث في معلومات جهاز التوجيه (أي

تحديدات النوع
otHistoryTrackerExternalRouteInfo typedef
أن تمثِّل معلومات المسار الخارجي لبيانات الشبكة.
otHistoryTrackerIterator typedef
تمثّل هذه السمة المكرّر للتكرار خلال قائمة سابقة.
otHistoryTrackerMessageInfo typedef
يُمثِّل معلومات رسالة RX/TX IPv6.
otHistoryTrackerMulticastAddressInfo typedef
تمثيل معلومات عنوان البث المتعدد IPv6
otHistoryTrackerNeighborInfo typedef
يمثل معلومات الجار.
otHistoryTrackerNetworkInfo typedef
يمثّل هذا الإعداد معلومات شبكة Thread.
otHistoryTrackerOnMeshPrefixInfo typedef
تمثيل بيانات الشبكة على معلومات بادئة الشبكة المتداخلة
otHistoryTrackerRouterInfo typedef
يشير إلى حدث إدخال جدول في جهاز التوجيه.
otHistoryTrackerUnicastAddressInfo typedef
تمثيل معلومات عنوان IPv6 أحادي البث

الدوال
otHistoryTrackerEntryAgeToString(uint32_t aEntryAge, char *aBuffer, uint16_t aSize)
void
تحوِّل عمر إدخال معيّن إلى سلسلة يمكن لشخص عادي قراءتها.
otHistoryTrackerInitIterator(otHistoryTrackerIterator *aIterator)
void
يبدأ تشغيل otHistoryTrackerIterator.
otHistoryTrackerIterateExternalRouteHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
التكرار على الإدخالات الموجودة في قائمة سِجلّ إدخال المسار الخارجي لبيانات الشبكة.
otHistoryTrackerIterateMulticastAddressHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
التكرار على الإدخالات في قائمة محفوظات عناوين البث المتعدد
otHistoryTrackerIterateNeighborHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
التكرار فوق الإدخالات الموجودة في قائمة سجل الجيران.
otHistoryTrackerIterateNetInfoHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
يتكرر الإدخالات في قائمة سجلّ معلومات الشبكة.
otHistoryTrackerIterateOnMeshPrefixHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
التكرار على الإدخالات في قائمة "بيانات الشبكة" في قائمة سجلّ إدخال بادئة الشبكة المتداخلة.
otHistoryTrackerIterateRouterHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
التكرار على الإدخالات في قائمة محفوظات جهاز التوجيه.
otHistoryTrackerIterateRxHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
التكرار فوق الإدخالات في قائمة سجلّ رسائل RX.
otHistoryTrackerIterateTxHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
التكرار فوق الإدخالات في قائمة سجلّ رسائل TX.
otHistoryTrackerIterateUnicastAddressHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
التكرار على الإدخالات في قائمة سجلّ العناوين الأحادي

الهياكل
otHistoryTrackerExternalRouteInfo

أن تمثِّل معلومات المسار الخارجي لبيانات الشبكة.

otHistoryTrackerIterator

تمثّل هذه السمة المكرّر للتكرار خلال قائمة سابقة.

otHistoryTrackerMessageInfo

يُمثِّل معلومات رسالة RX/TX IPv6.

otHistoryTrackerMulticastAddressInfo

تمثيل معلومات عنوان البث المتعدد IPv6

otHistoryTrackerNeighborInfo

يمثل معلومات الجار.

otHistoryTrackerNetworkInfo

يمثّل هذا الإعداد معلومات شبكة Thread.

otHistoryTrackerOnMeshPrefixInfo

تمثيل بيانات الشبكة على معلومات بادئة الشبكة المتداخلة

otHistoryTrackerRouterInfo

يشير إلى حدث إدخال جدول في جهاز التوجيه.

otHistoryTrackerUnicastAddressInfo

تمثيل معلومات عنوان IPv6 أحادي البث

عمليات التعداد

تعداد مجهول

 anonymous enum

الثوابت التي تمثّل أولوية الرسالة المستخدَمة في بنية otHistoryTrackerMessageInfo

أماكن إقامة
OT_HISTORY_TRACKER_MSG_PRIORITY_HIGH

مستوى أولوية عالية.

OT_HISTORY_TRACKER_MSG_PRIORITY_LOW

مستوى أولوية منخفضة.

OT_HISTORY_TRACKER_MSG_PRIORITY_NET

مستوى أولوية التحكم في الشبكة.

OT_HISTORY_TRACKER_MSG_PRIORITY_NORMAL

مستوى الأولوية العادي.

otHistoryTrackerAddressEvent

 otHistoryTrackerAddressEvent

تُحدِّد أحداث معلومات عنوان IPv6 (البث الأحادي أو المتعدد) (أي ما إذا تمت إضافة العنوان أو إزالته).

أماكن إقامة
OT_HISTORY_TRACKER_ADDRESS_EVENT_ADDED

تمّت إضافة العنوان.

OT_HISTORY_TRACKER_ADDRESS_EVENT_REMOVED

تمت إزالة العنوان.

otHistoryTrackerNeighborEvent

 otHistoryTrackerNeighborEvent

تحديد الأحداث في معلومات الجار (أي

سواء تمت إضافة الجار أو إزالته أو تغييره).

لا ينطبق الحدث OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING إلا على الجيران الأطفال فقط. يتم تشغيله بعد إعادة تشغيل الجهاز وعندما يتم استرداد قائمة الأطفال السابقة من الإعدادات غير المتغيّرة ويحاول الجهاز استعادة الاتصال بها.

أماكن إقامة
OT_HISTORY_TRACKER_NEIGHBOR_EVENT_ADDED

تمت إضافة الجار.

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_CHANGED

تم تغيير الجار (على سبيل المثال، تم تغيير علامات وضع الجهاز).

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_REMOVED

تمت إزالة الجار.

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING

جارٍ استعادة الجار (ينطبق على الطفل فقط).

otHistoryTrackerNetDataEvent

 otHistoryTrackerNetDataEvent

تُحدِّد أحداث إدخال بيانات الشبكة (أي ما إذا تمت إضافة إدخال أو إزالته).

أماكن إقامة
OT_HISTORY_TRACKER_NET_DATA_ENTRY_ADDED

تمت إضافة إدخال بيانات الشبكة.

OT_HISTORY_TRACKER_NET_DATA_ENTRY_REMOVED

تمت إزالة إدخال بيانات الشبكة.

otHistoryTrackerRouterEvent

 otHistoryTrackerRouterEvent

تحدّد الأحداث في معلومات جهاز التوجيه (أي

سواء تمت إضافة جهاز توجيه أو إزالته أو تغييره).

أماكن إقامة
OT_HISTORY_TRACKER_ROUTER_EVENT_ADDED

تمت إضافة جهاز التوجيه (تم تخصيص رقم تعريف جهاز التوجيه).

OT_HISTORY_TRACKER_ROUTER_EVENT_COST_CHANGED

تم تغيير تكلفة مسار دخول جهاز التوجيه (قفزة تالية كما في السابق).

OT_HISTORY_TRACKER_ROUTER_EVENT_NEXT_HOP_CHANGED

تم تغيير إدخال جهاز التوجيه والتكلفة التالية.

OT_HISTORY_TRACKER_ROUTER_EVENT_REMOVED

تمت إزالة إدخال جهاز التوجيه (تم إصدار رقم تعريف جهاز التوجيه).

تحديدات النوع

otHistoryTrackerExternalRouteInfo

struct otHistoryTrackerExternalRouteInfo otHistoryTrackerExternalRouteInfo

أن تمثِّل معلومات المسار الخارجي لبيانات الشبكة.

otHistoryTrackerIterator

struct otHistoryTrackerIterator otHistoryTrackerIterator

تمثّل هذه السمة المكرّر للتكرار خلال قائمة سابقة.

الحقول في هذا النوع هي معتمة (مخصصة للاستخدام بواسطة OpenThread الأساسي) وبالتالي يجب ألا يصل/يستخدمها المتصل.

قبل استخدام المكرر، يجب تهيئته باستخدام otHistoryTrackerInitIterator()،

otHistoryTrackerMessageInfo

struct otHistoryTrackerMessageInfo otHistoryTrackerMessageInfo

يُمثِّل معلومات رسالة RX/TX IPv6.

تنطبق بعض الحقول في هذا الهيكل على رسالة RX أو رسالة TX فقط، على سبيل المثال: mAveRxRss هو متوسط خلاصة RSS لجميع الإطارات المُجزأة التي تشكّل رسالة مُستلَمة ولا ينطبق إلا على رسالة RX.

otHistoryTrackerMulticastAddressInfo

struct otHistoryTrackerMulticastAddressInfo otHistoryTrackerMulticastAddressInfo

تمثيل معلومات عنوان البث المتعدد IPv6

otHistoryTrackerNeighborInfo

struct otHistoryTrackerNeighborInfo otHistoryTrackerNeighborInfo

يمثل معلومات الجار.

otHistoryTrackerNetworkInfo

struct otHistoryTrackerNetworkInfo otHistoryTrackerNetworkInfo

يمثّل هذا الإعداد معلومات شبكة Thread.

otHistoryTrackerOnMeshPrefixInfo

struct otHistoryTrackerOnMeshPrefixInfo otHistoryTrackerOnMeshPrefixInfo

تمثيل بيانات الشبكة على معلومات بادئة الشبكة المتداخلة

otHistoryTrackerRouterInfo

struct otHistoryTrackerRouterInfo otHistoryTrackerRouterInfo

يشير إلى حدث إدخال جدول في جهاز التوجيه.

otHistoryTrackerUnicastAddressInfo

struct otHistoryTrackerUnicastAddressInfo otHistoryTrackerUnicastAddressInfo

تمثيل معلومات عنوان IPv6 أحادي البث

الدوال

otHistoryTrackerEntryAgeToString

void otHistoryTrackerEntryAgeToString(
  uint32_t aEntryAge,
  char *aBuffer,
  uint16_t aSize
)

تحوِّل عمر إدخال معيّن إلى سلسلة يمكن لشخص عادي قراءتها.

تتبع سلسلة عمر الإدخال التنسيق "::." للساعات والدقائق والثواني والملي ثانية (إذا كانت أقصر من يوم واحد) أو "

يوم ::." (إذا كانت أطول من يوم واحد).

إذا كانت السلسلة الناتجة لا تتوافق مع aBuffer (ضمن أحرف aSize)، سيتم اقتطاع السلسلة، ولكن يتم دائمًا إبقاء قيمة السلسلة فارغة.

التفاصيل
المَعلمات
[in] aEntryAge
عمر الإدخال (المدة بالملي ثانية).
[out] aBuffer
مؤشر إلى صفيف أحرف لإخراج السلسلة (يجب ألا تكون فارغة).
[in] aSize
مقاس aBuffer يُنصح باستخدام "OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE".

otHistoryTrackerInitIterator

void otHistoryTrackerInitIterator(
  otHistoryTrackerIterator *aIterator
)

يبدأ تشغيل otHistoryTrackerIterator.

"يجب" تهيئة المكرر قبل استخدامه.

يمكن تهيئة المكرر مرة أخرى للبدء من بداية القائمة.

عند التكرار على الإدخالات في قائمة، ولضمان تناسق أعمار الإدخال، يتم منح العمر نسبةً إلى وقت إعداد المكرّر، على سبيل المثال، يتم توفير عمر الإدخال كمدة (بالمللي ثانية) من الحدث (عندما تم تسجيل الإدخال) إلى وقت إعداد المكرّر.

التفاصيل
المَعلمات
[in] aIterator
مؤشر يشير إلى المكرّر للتهيئة (يجب ألا يكون فارغًا).

otHistoryTrackerIterateExternalRouteHistory

const otHistoryTrackerExternalRouteInfo * otHistoryTrackerIterateExternalRouteHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

التكرار على الإدخالات الموجودة في قائمة سِجلّ إدخال المسار الخارجي لبيانات الشبكة.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in,out] aIterator
مؤشر يشير إلى مكرّر. يجب تهيئة أو أن يكون السلوك غير محدد.
[out] aEntryAge
مؤشر إلى متغيّر لإخراج عمر الإدخال. يجب ألا يكون فارغًا. يتم تحديد العمر كالمدة (بالمللي ثانية) من وقت تسجيل الإدخال إلى وقت إعداد aIterator. ويتم ضبطه على OT_HISTORY_TRACKER_MAX_AGE للإدخالات الأقدم من الحد الأقصى للعمر.
المرتجعات
الإدخال otHistoryTrackerExternalRouteInfo أو NULL إذا لم يكن هناك المزيد من الإدخالات في القائمة

otHistoryTrackerIterateMulticastAddressHistory

const otHistoryTrackerMulticastAddressInfo * otHistoryTrackerIterateMulticastAddressHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

التكرار على الإدخالات في قائمة محفوظات عناوين البث المتعدد

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in,out] aIterator
مؤشر يشير إلى مكرّر. يجب تهيئة أو أن يكون السلوك غير محدد.
[out] aEntryAge
مؤشر إلى متغيّر لإخراج عمر الإدخال. يجب ألا يكون فارغًا. يتم تحديد العمر كالمدة (بالمللي ثانية) من وقت تسجيل الإدخال إلى وقت إعداد aIterator. ويتم ضبطه على OT_HISTORY_TRACKER_MAX_AGE للإدخالات الأقدم من الحد الأقصى للعمر.
المرتجعات
مؤشر يشير إلى إدخال otHistoryTrackerMulticastAddressInfo أو NULL إذا لم يتم توفير أي إدخالات أخرى في القائمة

otHistoryTrackerIterateNeighborHistory

const otHistoryTrackerNeighborInfo * otHistoryTrackerIterateNeighborHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

التكرار فوق الإدخالات الموجودة في قائمة سجل الجيران.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in,out] aIterator
مؤشر يشير إلى مكرّر. يجب تهيئة أو أن يكون السلوك غير محدد.
[out] aEntryAge
مؤشر إلى متغيّر لإخراج عمر الإدخال. يجب ألا يكون فارغًا. يتم تحديد العمر كالمدة (بالمللي ثانية) من وقت تسجيل الإدخال إلى وقت إعداد aIterator. ويتم ضبطه على OT_HISTORY_TRACKER_MAX_AGE للإدخالات الأقدم من الحد الأقصى للعمر.
المرتجعات
الإدخال otHistoryTrackerNeighborInfo أو NULL إذا لم يكن هناك المزيد من الإدخالات في القائمة

otHistoryTrackerIterateNetInfoHistory

const otHistoryTrackerNetworkInfo * otHistoryTrackerIterateNetInfoHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

يتكرر الإدخالات في قائمة سجلّ معلومات الشبكة.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in,out] aIterator
مؤشر يشير إلى مكرّر. يجب تهيئة أو أن يكون السلوك غير محدد.
[out] aEntryAge
مؤشر إلى متغيّر لإخراج عمر الإدخال. يجب ألا يكون فارغًا. يتم تحديد العمر كالمدة (بالمللي ثانية) من وقت تسجيل الإدخال إلى وقت إعداد aIterator. ويتم ضبطه على OT_HISTORY_TRACKER_MAX_AGE للإدخالات الأقدم من الحد الأقصى للعمر.
المرتجعات
مؤشر يشير إلى إدخال otHistoryTrackerNetworkInfo أو NULL إذا لم يتم توفير أي إدخالات أخرى في القائمة

otHistoryTrackerIterateOnMeshPrefixHistory

const otHistoryTrackerOnMeshPrefixInfo * otHistoryTrackerIterateOnMeshPrefixHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

التكرار على الإدخالات في قائمة "بيانات الشبكة" في قائمة سجلّ إدخال بادئة الشبكة المتداخلة.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in,out] aIterator
مؤشر يشير إلى مكرّر. يجب تهيئة أو أن يكون السلوك غير محدد.
[out] aEntryAge
مؤشر إلى متغيّر لإخراج عمر الإدخال. يجب ألا يكون فارغًا. يتم تحديد العمر كالمدة (بالمللي ثانية) من وقت تسجيل الإدخال إلى وقت إعداد aIterator. ويتم ضبطه على OT_HISTORY_TRACKER_MAX_AGE للإدخالات الأقدم من الحد الأقصى للعمر.
المرتجعات
الإدخال otHistoryTrackerOnMeshPrefixInfo أو NULL إذا لم يكن هناك المزيد من الإدخالات في القائمة

otHistoryTrackerIterateRouterHistory

const otHistoryTrackerRouterInfo * otHistoryTrackerIterateRouterHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

التكرار على الإدخالات في قائمة محفوظات جهاز التوجيه.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in,out] aIterator
مؤشر يشير إلى مكرّر. يجب تهيئة أو أن يكون السلوك غير محدد.
[out] aEntryAge
مؤشر إلى متغيّر لإخراج عمر الإدخال. يجب ألا يكون فارغًا. يتم تحديد العمر كالمدة (بالمللي ثانية) من وقت تسجيل الإدخال إلى وقت إعداد aIterator. ويتم ضبطه على OT_HISTORY_TRACKER_MAX_AGE للإدخالات الأقدم من الحد الأقصى للعمر.
المرتجعات
الإدخال otHistoryTrackerRouterInfo أو NULL إذا لم يكن هناك المزيد من الإدخالات في القائمة

otHistoryTrackerIterateRxHistory

const otHistoryTrackerMessageInfo * otHistoryTrackerIterateRxHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

التكرار فوق الإدخالات في قائمة سجلّ رسائل RX.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in,out] aIterator
مؤشر يشير إلى مكرّر. يجب تهيئة أو أن يكون السلوك غير محدد.
[out] aEntryAge
مؤشر إلى متغيّر لإخراج عمر الإدخال. يجب ألا يكون فارغًا. يتم تحديد العمر كالمدة (بالمللي ثانية) من وقت تسجيل الإدخال إلى وقت إعداد aIterator. ويتم ضبطه على OT_HISTORY_TRACKER_MAX_AGE للإدخالات الأقدم من الحد الأقصى للعمر.
المرتجعات
الإدخال otHistoryTrackerMessageInfo أو NULL إذا لم يكن هناك المزيد من الإدخالات في القائمة

otHistoryTrackerIterateTxHistory

const otHistoryTrackerMessageInfo * otHistoryTrackerIterateTxHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

التكرار فوق الإدخالات في قائمة سجلّ رسائل TX.

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in,out] aIterator
مؤشر يشير إلى مكرّر. يجب تهيئة أو أن يكون السلوك غير محدد.
[out] aEntryAge
مؤشر إلى متغيّر لإخراج عمر الإدخال. يجب ألا يكون فارغًا. يتم تحديد العمر كالمدة (بالمللي ثانية) من وقت تسجيل الإدخال إلى وقت إعداد aIterator. ويتم ضبطه على OT_HISTORY_TRACKER_MAX_AGE للإدخالات الأقدم من الحد الأقصى للعمر.
المرتجعات
الإدخال otHistoryTrackerMessageInfo أو NULL إذا لم يكن هناك المزيد من الإدخالات في القائمة

otHistoryTrackerIterateUnicastAddressHistory

const otHistoryTrackerUnicastAddressInfo * otHistoryTrackerIterateUnicastAddressHistory(
  otInstance *aInstance,
  otHistoryTrackerIterator *aIterator,
  uint32_t *aEntryAge
)

التكرار على الإدخالات في قائمة سجلّ العناوين الأحادي

التفاصيل
المَعلمات
[in] aInstance
يشير هذا المصطلح إلى مؤشر لمثيل OpenThread.
[in,out] aIterator
مؤشر يشير إلى مكرّر. يجب تهيئة أو أن يكون السلوك غير محدد.
[out] aEntryAge
مؤشر إلى متغيّر لإخراج عمر الإدخال. يجب ألا يكون فارغًا. يتم تحديد العمر كالمدة (بالمللي ثانية) من وقت تسجيل الإدخال إلى وقت إعداد aIterator. ويتم ضبطه على OT_HISTORY_TRACKER_MAX_AGE للإدخالات الأقدم من الحد الأقصى للعمر.
المرتجعات
مؤشر يشير إلى إدخال otHistoryTrackerUnicastAddressInfo أو NULL إذا لم يتم توفير أي إدخالات أخرى في القائمة

وحدات ماكرو

OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE

 OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE 21

الحجم المُقترَح لتمثيل السلسلة لعمر الإدخال.

OT_HISTORY_TRACKER_INFINITE_PATH_COST

 OT_HISTORY_TRACKER_INFINITE_PATH_COST 0

تكلفة مسار لانهائي - تُستخدم في otHistoryTrackerRouterInfo.

OT_HISTORY_TRACKER_MAX_AGE

 OT_HISTORY_TRACKER_MAX_AGE (49 * 24 * 60 * 60 * 1000u)

ويحدد هذا الثابت الحد الأقصى لعمر الإدخالات وهو 49 يومًا (بالمللي ثانية).

أمّا الإدخالات التي تتجاوز الحدّ الأقصى للعمر، فسيتم اعتبارها عمرها.

OT_HISTORY_TRACKER_NO_NEXT_HOP

 OT_HISTORY_TRACKER_NO_NEXT_HOP 63

ما مِن قفز تالٍ - لـ mNextHop في otHistoryTrackerRouterInfo.

المراجِع

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