Verlaufstracker

Zeichnet den Verlauf verschiedener Ereignisse auf, z. B. RX- und TX-Nachrichten oder Änderungen der Netzwerkinformationen.

Zusammenfassung

Alle erfassten Einträge haben einen Zeitstempel.

Die Funktionen in diesem Modul sind verfügbar, wenn OPENTHREAD_CONFIG_HISTORY_TRACKER_ENABLE aktiviert ist.

Aufzählungen
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
} 		enum
Konstanten, die die Nachrichtenpriorität darstellen und in der Struktur otHistoryTrackerMessageInfo verwendet werden.
otHistoryTrackerAddressEvent{
  OT_HISTORY_TRACKER_ADDRESS_EVENT_ADDED = 0,
  OT_HISTORY_TRACKER_ADDRESS_EVENT_REMOVED = 1
} 		enum
Definiert die Ereignisse für eine IPv6-Adressinformation (Unicast oder Multicast) (z.B. ob eine Adresse hinzugefügt oder entfernt wird).
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
} 		enum
Definiert die Ereignisse in den Informationen zu den Nachbarn (z.B.
otHistoryTrackerNetDataEvent{
  OT_HISTORY_TRACKER_NET_DATA_ENTRY_ADDED = 0,
  OT_HISTORY_TRACKER_NET_DATA_ENTRY_REMOVED = 1
} 		enum
Definiert die Ereignisse für einen Netzwerkdateneintrag (d.h., ob ein Eintrag hinzugefügt oder entfernt wird).
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
} 		enum
Definiert die Ereignisse in den Routerinformationen (z.B.

Typedefs
otHistoryTrackerExternalRouteInfo typedef
Stellt externe Routeninformationen für Netzwerkdaten dar.
otHistoryTrackerIterator typedef
Stellt einen Iterator zum Durchlaufen einer Verlaufsliste dar.
otHistoryTrackerMessageInfo typedef
Stellt eine RX/TX-IPv6-Nachrichteninformationen dar.
otHistoryTrackerMulticastAddressInfo typedef
Stellt Informationen zu einer IPv6-Multicast-Adresse dar.
otHistoryTrackerNeighborInfo typedef
Stellt die Informationen zu einem Nachbarn dar.
otHistoryTrackerNetworkInfo typedef
Stellt Thread-Netzwerkinformationen dar.
otHistoryTrackerOnMeshPrefixInfo typedef
Stellt Netzwerkdaten in Informationen zum Mesh-Präfix dar.
otHistoryTrackerRouterInfo typedef
Stellt ein Ereignis eines Routertabelleneintrags dar.
otHistoryTrackerUnicastAddressInfo typedef
Stellt eine Unicast-IPv6-Adressinformationen dar.

Funktionen
otHistoryTrackerEntryAgeToString(uint32_t aEntryAge, char *aBuffer, uint16_t aSize)
void
Wandelt ein angegebenes Eingabealter in einen menschenlesbaren String um.
otHistoryTrackerInitIterator(otHistoryTrackerIterator *aIterator)
void
Initialisiert ein otHistoryTrackerIterator.
otHistoryTrackerIterateExternalRouteHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Iteriert über die Einträge in der Verlaufsliste der externen Routeneinträge von Netzwerkdaten.
otHistoryTrackerIterateMulticastAddressHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Durchläuft die Einträge in der Verlaufsliste der Multicast-Adressen.
otHistoryTrackerIterateNeighborHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Iteriert über die Einträge in der Nachbarverlaufsliste.
otHistoryTrackerIterateNetInfoHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Durchläuft die Einträge in der Verlaufsliste der Netzwerkinformationen.
otHistoryTrackerIterateOnMeshPrefixHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Iteriert über die Einträge in der Verlaufsliste der Netzwerkdaten des Mesh-Präfix-Eintrags.
otHistoryTrackerIterateRouterHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Durchläuft die Einträge im Routerverlauf.
otHistoryTrackerIterateRxHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Iteriert über die Einträge in der RX-Nachrichtenverlaufsliste.
otHistoryTrackerIterateTxHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Durchläuft die Einträge in der Liste des TX-Nachrichtenverlaufs.
otHistoryTrackerIterateUnicastAddressHistory(otInstance *aInstance, otHistoryTrackerIterator *aIterator, uint32_t *aEntryAge)
Durchläuft die Einträge in der Unicast-Adressverlaufsliste.

Strukturen
otHistoryTrackerExternalRouteInfo

Stellt externe Routeninformationen für Netzwerkdaten dar.

otHistoryTrackerIterator

Stellt einen Iterator zum Durchlaufen einer Verlaufsliste dar.

otHistoryTrackerMessageInfo

Stellt eine RX/TX-IPv6-Nachrichteninformationen dar.

otHistoryTrackerMulticastAddressInfo

Stellt Informationen zu einer IPv6-Multicast-Adresse dar.

otHistoryTrackerNeighborInfo

Stellt die Informationen zu einem Nachbarn dar.

otHistoryTrackerNetworkInfo

Stellt Thread-Netzwerkinformationen dar.

otHistoryTrackerOnMeshPrefixInfo

Stellt Netzwerkdaten in Informationen zum Mesh-Präfix dar.

otHistoryTrackerRouterInfo

Stellt ein Ereignis eines Routertabelleneintrags dar.

otHistoryTrackerUnicastAddressInfo

Stellt eine Unicast-IPv6-Adressinformationen dar.

Aufzählungen

Anonyme Aufzählung

 anonymous enum

Konstanten, die die Nachrichtenpriorität darstellen und in der Struktur otHistoryTrackerMessageInfo verwendet werden.

Attribute
OT_HISTORY_TRACKER_MSG_PRIORITY_HIGH

Hohe Prioritätsstufe.

OT_HISTORY_TRACKER_MSG_PRIORITY_LOW

Niedrige Prioritätsstufe.

OT_HISTORY_TRACKER_MSG_PRIORITY_NET

Prioritätsstufe der Netzwerksteuerung.

OT_HISTORY_TRACKER_MSG_PRIORITY_NORMAL

Normale Prioritätsstufe.

otHistoryTrackerAddressEvent

 otHistoryTrackerAddressEvent

Definiert die Ereignisse für eine IPv6-Adressinformation (Unicast oder Multicast) (z.B. ob eine Adresse hinzugefügt oder entfernt wird).

Attribute
OT_HISTORY_TRACKER_ADDRESS_EVENT_ADDED

Adresse wird hinzugefügt.

OT_HISTORY_TRACKER_ADDRESS_EVENT_REMOVED

Die Adresse wird entfernt.

otHistoryTrackerNeighborEvent

 otHistoryTrackerNeighborEvent

Definiert die Ereignisse in den Informationen zu den Nachbarn (z.B.

ob ein Nachbar hinzugefügt, entfernt oder geändert wird.

Das Ereignis OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING gilt nur für untergeordnete Nachbarn. Sie wird ausgelöst, nachdem das Gerät neu gestartet wurde, die vorherige untergeordnete Liste aus den nichtflüchtigen Einstellungen abgerufen wird und das Gerät versucht, die Verbindung wiederherzustellen.

Attribute
OT_HISTORY_TRACKER_NEIGHBOR_EVENT_ADDED

Nachbar wurde hinzugefügt.

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_CHANGED

Nachbar geändert (z.B. Gerätemodus-Flags geändert).

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_REMOVED

Nachbar wurde entfernt.

OT_HISTORY_TRACKER_NEIGHBOR_EVENT_RESTORING

Nachbar wird gerade wiederhergestellt (gilt nur für untergeordnete Elemente).

otHistoryTrackerNetDataEvent

 otHistoryTrackerNetDataEvent

Definiert die Ereignisse für einen Netzwerkdateneintrag (d.h., ob ein Eintrag hinzugefügt oder entfernt wird).

Attribute
OT_HISTORY_TRACKER_NET_DATA_ENTRY_ADDED

Der Netzwerkdateneintrag wird hinzugefügt.

OT_HISTORY_TRACKER_NET_DATA_ENTRY_REMOVED

Netzwerkdateneintrag wird entfernt.

otHistoryTrackerRouterEvent

 otHistoryTrackerRouterEvent

Definiert die Ereignisse in den Routerinformationen (z.B.

ob ein Router hinzugefügt, entfernt oder geändert wird.

Attribute
OT_HISTORY_TRACKER_ROUTER_EVENT_ADDED

Router wurde hinzugefügt (Router-ID zugewiesen).

OT_HISTORY_TRACKER_ROUTER_EVENT_COST_CHANGED

Die Kosten für den Routereintragspfad haben sich geändert (nächster Hop wie zuvor).

OT_HISTORY_TRACKER_ROUTER_EVENT_NEXT_HOP_CHANGED

Nächster Hop des Routereintrags und Kosten haben sich geändert.

OT_HISTORY_TRACKER_ROUTER_EVENT_REMOVED

Der Routereintrag wird entfernt (Router-ID freigegeben).

Typedefs

otHistoryTrackerExternalRouteInfo

struct otHistoryTrackerExternalRouteInfo otHistoryTrackerExternalRouteInfo

Stellt externe Routeninformationen für Netzwerkdaten dar.

otHistoryTrackerIterator

struct otHistoryTrackerIterator otHistoryTrackerIterator

Stellt einen Iterator zum Durchlaufen einer Verlaufsliste dar.

Die Felder in diesem Typ sind opak (zur Verwendung durch den OpenThread-Kern vorgesehen) und sollten daher nicht vom Aufrufer aufgerufen bzw. verwendet werden.

Vor der Verwendung MUSS er mit otHistoryTrackerInitIterator() initialisiert werden.

otHistoryTrackerMessageInfo

struct otHistoryTrackerMessageInfo otHistoryTrackerMessageInfo

Stellt eine RX/TX-IPv6-Nachrichteninformationen dar.

Einige Felder in dieser Struktur gelten nur für eine RX- oder TX-Nachricht, z.B. mAveRxRss ist der durchschnittliche RSS aller Fragment-Frames, die eine empfangene Nachricht bilden, und gilt nur für eine RX-Nachricht.

otHistoryTrackerMulticastAddressInfo

struct otHistoryTrackerMulticastAddressInfo otHistoryTrackerMulticastAddressInfo

Stellt Informationen zu einer IPv6-Multicast-Adresse dar.

otHistoryTrackerNeighborInfo

struct otHistoryTrackerNeighborInfo otHistoryTrackerNeighborInfo

Stellt die Informationen zu einem Nachbarn dar.

otHistoryTrackerNetworkInfo

struct otHistoryTrackerNetworkInfo otHistoryTrackerNetworkInfo

Stellt Thread-Netzwerkinformationen dar.

otHistoryTrackerOnMeshPrefixInfo

struct otHistoryTrackerOnMeshPrefixInfo otHistoryTrackerOnMeshPrefixInfo

Stellt Netzwerkdaten in Informationen zum Mesh-Präfix dar.

otHistoryTrackerRouterInfo

struct otHistoryTrackerRouterInfo otHistoryTrackerRouterInfo

Stellt ein Ereignis eines Routertabelleneintrags dar.

otHistoryTrackerUnicastAddressInfo

struct otHistoryTrackerUnicastAddressInfo otHistoryTrackerUnicastAddressInfo

Stellt eine Unicast-IPv6-Adressinformationen dar.

Funktionen

otHistoryTrackerEntryAgeToString

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

Wandelt ein angegebenes Eingabealter in einen menschenlesbaren String um.

Der Eingabe-Altersstring hat das Format "::." für Stunden, Minuten, Sekunden und Millisekunden (falls kürzer als ein Tag) oder "

Tage ::." (bei mehr als einem Tag).

Wenn der resultierende String nicht in aBuffer (innerhalb seiner aSize-Zeichen) passt, wird der String abgeschnitten, aber der ausgegebene String wird immer mit Null beendet.

Details
Parameter
[in] aEntryAge
Das Alter des Eintrags (Dauer in ms).
[out] aBuffer
Ein Zeiger auf ein char-Array, um den String auszugeben (DARF NICHT NULL sein).
[in] aSize
Die Größe von aBuffer. Die Verwendung von OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE wird empfohlen.

otHistoryTrackerInitIterator

void otHistoryTrackerInitIterator(
  otHistoryTrackerIterator *aIterator
)

Initialisiert ein otHistoryTrackerIterator.

Ein Iterator MUSS initialisiert werden, bevor er verwendet wird.

Ein Iterator kann erneut initialisiert werden, um am Anfang der Liste zu beginnen.

Wenn Sie über Einträge in einer Liste iterieren, wird das Alter relativ zum Zeitpunkt der Initialisierung des Iterators angegeben, d.h. das Alter des Eintrags wird als Dauer (in Millisekunden) vom Ereignis (wenn der Eintrag aufgezeichnet wurde) bis zur Initialisierungszeit des Iterators angegeben.

Details
Parameter
[in] aIterator
Ein Zeiger auf den zu initialisierenden Iterator (DARF NICHT NULL sein).

otHistoryTrackerIterateExternalRouteHistory

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

Iteriert über die Einträge in der Verlaufsliste der externen Routeneinträge von Netzwerkdaten.

Details
Parameter
[in] aInstance
Ein Zeiger auf die OpenThread-Instanz.
[in,out] aIterator
Ein Zeiger auf einen Iteration. MUSS initialisiert werden oder das Verhalten ist nicht definiert.
[out] aEntryAge
Ein Zeiger auf eine Variable, um das Alter des Eintrags auszugeben. DARF NICHT NULL sein. „Alter“ wird als Dauer (in Millisekunden) von der Aufzeichnung des Eintrags bis zur Initialisierungszeit aIterator angegeben. Er wird für Einträge, die älter als das Höchstalter sind, auf OT_HISTORY_TRACKER_MAX_AGE gesetzt.
Rückgabe
Den otHistoryTrackerExternalRouteInfo-Eintrag oder NULL, wenn keine weiteren Einträge in der Liste vorhanden sind

otHistoryTrackerIterateMulticastAddressHistory

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

Durchläuft die Einträge in der Verlaufsliste der Multicast-Adressen.

Details
Parameter
[in] aInstance
Ein Zeiger auf die OpenThread-Instanz.
[in,out] aIterator
Ein Zeiger auf einen Iteration. MUSS initialisiert werden oder das Verhalten ist nicht definiert.
[out] aEntryAge
Ein Zeiger auf eine Variable, um das Alter des Eintrags auszugeben. DARF NICHT NULL sein. „Alter“ wird als Dauer (in Millisekunden) von der Aufzeichnung des Eintrags bis zur Initialisierungszeit aIterator angegeben. Er wird für Einträge, die älter als das Höchstalter sind, auf OT_HISTORY_TRACKER_MAX_AGE gesetzt.
Rückgabe
Ein Zeiger auf den Eintrag otHistoryTrackerMulticastAddressInfo oder NULL, wenn keine weiteren Einträge in der Liste vorhanden sind.

otHistoryTrackerIterateNeighborHistory

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

Iteriert über die Einträge in der Nachbarverlaufsliste.

Details
Parameter
[in] aInstance
Ein Zeiger auf die OpenThread-Instanz.
[in,out] aIterator
Ein Zeiger auf einen Iteration. MUSS initialisiert werden oder das Verhalten ist nicht definiert.
[out] aEntryAge
Ein Zeiger auf eine Variable, um das Alter des Eintrags auszugeben. DARF NICHT NULL sein. „Alter“ wird als Dauer (in Millisekunden) von der Aufzeichnung des Eintrags bis zur Initialisierungszeit aIterator angegeben. Er wird für Einträge, die älter als das Höchstalter sind, auf OT_HISTORY_TRACKER_MAX_AGE gesetzt.
Rückgabe
Den otHistoryTrackerNeighborInfo-Eintrag oder NULL, wenn keine weiteren Einträge in der Liste vorhanden sind

otHistoryTrackerIterateNetInfoHistory

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

Durchläuft die Einträge in der Verlaufsliste der Netzwerkinformationen.

Details
Parameter
[in] aInstance
Ein Zeiger auf die OpenThread-Instanz.
[in,out] aIterator
Ein Zeiger auf einen Iteration. MUSS initialisiert werden oder das Verhalten ist nicht definiert.
[out] aEntryAge
Ein Zeiger auf eine Variable, um das Alter des Eintrags auszugeben. DARF NICHT NULL sein. „Alter“ wird als Dauer (in Millisekunden) von der Aufzeichnung des Eintrags bis zur Initialisierungszeit aIterator angegeben. Er wird für Einträge, die älter als das Höchstalter sind, auf OT_HISTORY_TRACKER_MAX_AGE gesetzt.
Rückgabe
Ein Zeiger auf den Eintrag otHistoryTrackerNetworkInfo oder NULL, wenn keine weiteren Einträge in der Liste vorhanden sind.

otHistoryTrackerIterateOnMeshPrefixHistory

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

Iteriert über die Einträge in der Verlaufsliste der Netzwerkdaten des Mesh-Präfix-Eintrags.

Details
Parameter
[in] aInstance
Ein Zeiger auf die OpenThread-Instanz.
[in,out] aIterator
Ein Zeiger auf einen Iteration. MUSS initialisiert werden oder das Verhalten ist nicht definiert.
[out] aEntryAge
Ein Zeiger auf eine Variable, um das Alter des Eintrags auszugeben. DARF NICHT NULL sein. „Alter“ wird als Dauer (in Millisekunden) von der Aufzeichnung des Eintrags bis zur Initialisierungszeit aIterator angegeben. Er wird für Einträge, die älter als das Höchstalter sind, auf OT_HISTORY_TRACKER_MAX_AGE gesetzt.
Rückgabe
Den otHistoryTrackerOnMeshPrefixInfo-Eintrag oder NULL, wenn keine weiteren Einträge in der Liste vorhanden sind

otHistoryTrackerIterateRouterHistory

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

Durchläuft die Einträge im Routerverlauf.

Details
Parameter
[in] aInstance
Ein Zeiger auf die OpenThread-Instanz.
[in,out] aIterator
Ein Zeiger auf einen Iteration. MUSS initialisiert werden oder das Verhalten ist nicht definiert.
[out] aEntryAge
Ein Zeiger auf eine Variable, um das Alter des Eintrags auszugeben. DARF NICHT NULL sein. „Alter“ wird als Dauer (in Millisekunden) von der Aufzeichnung des Eintrags bis zur Initialisierungszeit aIterator angegeben. Er wird für Einträge, die älter als das Höchstalter sind, auf OT_HISTORY_TRACKER_MAX_AGE gesetzt.
Rückgabe
Den otHistoryTrackerRouterInfo-Eintrag oder NULL, wenn keine weiteren Einträge in der Liste vorhanden sind

otHistoryTrackerIterateRxHistory

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

Iteriert über die Einträge in der RX-Nachrichtenverlaufsliste.

Details
Parameter
[in] aInstance
Ein Zeiger auf die OpenThread-Instanz.
[in,out] aIterator
Ein Zeiger auf einen Iteration. MUSS initialisiert werden oder das Verhalten ist nicht definiert.
[out] aEntryAge
Ein Zeiger auf eine Variable, um das Alter des Eintrags auszugeben. DARF NICHT NULL sein. „Alter“ wird als Dauer (in Millisekunden) von der Aufzeichnung des Eintrags bis zur Initialisierungszeit aIterator angegeben. Er wird für Einträge, die älter als das Höchstalter sind, auf OT_HISTORY_TRACKER_MAX_AGE gesetzt.
Rückgabe
Den otHistoryTrackerMessageInfo-Eintrag oder NULL, wenn keine weiteren Einträge in der Liste vorhanden sind

otHistoryTrackerIterateTxHistory

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

Durchläuft die Einträge in der Liste des TX-Nachrichtenverlaufs.

Details
Parameter
[in] aInstance
Ein Zeiger auf die OpenThread-Instanz.
[in,out] aIterator
Ein Zeiger auf einen Iteration. MUSS initialisiert werden oder das Verhalten ist nicht definiert.
[out] aEntryAge
Ein Zeiger auf eine Variable, um das Alter des Eintrags auszugeben. DARF NICHT NULL sein. „Alter“ wird als Dauer (in Millisekunden) von der Aufzeichnung des Eintrags bis zur Initialisierungszeit aIterator angegeben. Er wird für Einträge, die älter als das Höchstalter sind, auf OT_HISTORY_TRACKER_MAX_AGE gesetzt.
Rückgabe
Den otHistoryTrackerMessageInfo-Eintrag oder NULL, wenn keine weiteren Einträge in der Liste vorhanden sind

otHistoryTrackerIterateUnicastAddressHistory

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

Durchläuft die Einträge in der Unicast-Adressverlaufsliste.

Details
Parameter
[in] aInstance
Ein Zeiger auf die OpenThread-Instanz.
[in,out] aIterator
Ein Zeiger auf einen Iteration. MUSS initialisiert werden oder das Verhalten ist nicht definiert.
[out] aEntryAge
Ein Zeiger auf eine Variable, um das Alter des Eintrags auszugeben. DARF NICHT NULL sein. „Alter“ wird als Dauer (in Millisekunden) von der Aufzeichnung des Eintrags bis zur Initialisierungszeit aIterator angegeben. Er wird für Einträge, die älter als das Höchstalter sind, auf OT_HISTORY_TRACKER_MAX_AGE gesetzt.
Rückgabe
Ein Zeiger auf den Eintrag otHistoryTrackerUnicastAddressInfo oder NULL, wenn keine weiteren Einträge in der Liste vorhanden sind.

Makros

OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE

 OT_HISTORY_TRACKER_ENTRY_AGE_STRING_SIZE 21

Empfohlene Größe für die Darstellung eines Eintragsalters in Strings.

OT_HISTORY_TRACKER_INFINITE_PATH_COST

 OT_HISTORY_TRACKER_INFINITE_PATH_COST 0

Kosten unendlicher Pfad – verwendet in otHistoryTrackerRouterInfo.

OT_HISTORY_TRACKER_MAX_AGE

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

Diese Konstante gibt das maximale Alter von Einträgen an, also 49 Tage (in ms).

Einträge, die älter sind als das Höchstalter, erhalten diesen Wert als Alter.

OT_HISTORY_TRACKER_NO_NEXT_HOP

 OT_HISTORY_TRACKER_NO_NEXT_HOP 63

Kein nächster Hop - für mNextHop in otHistoryTrackerRouterInfo.

Ressourcen

OpenThread API-Referenzthemen stammen aus dem Quellcode, der auf GitHub verfügbar ist. Weitere Informationen finden Sie unter Ressourcen. Dort können Sie auch einen Beitrag zu unserer Dokumentation leisten.