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

تسجِّل سجلّ الأحداث المختلفة، مثل رسائل 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
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)
تكرار هذه الإدخالات في قائمة سجلّ عناوين يونيكود.

هياكل

otHistoryTrackerExternalPathInfo

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

otHistoryTrackerIterator

يمثل مكرّرًا لتكراره من خلال قائمة سجلّات.

otHistoryTrackerMessageInfo

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

otHistoryTrackerMulticastAddressInfo

قدِّم معلومات عنوان البث المتعدد IPv6.

otHistoryTrackerNeighborInfo

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

otHistoryTrackerNetworkInfo

يعرض معلومات شبكة Thread.

otHistoryTrackerOnMeshPrefixInfo

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

otHistoryTrackerrrInfo

يمثل حدث إدخال في جدول جهاز التوجيه.

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

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

otHistoryTrackerrrEvent

 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

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

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

otHistoryTrackerExternalPathInfo

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

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

otHistoryTrackerrrInfo

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
مؤشر إلى صفيف char لإخراج السلسلة (يجب ألا تكون القيمة NULL).
[in] aSize
حجم aBuffer. ننصح باستخدام OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE.

otHistoryTrackerInitIterator

void otHistoryTrackerInitIterator(
  otHistoryTrackerIterator *aIterator
)

لإعداد otHistoryTrackerIterator.

يجب إعداد المكرِّر قبل استخدامه.

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

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

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

otHistoryTrackerIterateExternalPathHistory

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 إذا لم يكن هناك المزيد من الإدخالات في القائمة.

otHistoryTrackerIterateOnMishPrefixHistory

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. للحصول على مزيد من المعلومات أو للمساهمة في المستندات، يمكنك الاطّلاع على المراجع.