Suchergebnisseite

Gibt den Status eines SRP-Clients (Dienst- oder Hostinformationen) an.

Stellt den vom SRP-Server verwendeten Adressmodus dar.

Der Adressmodus gibt an, wie die Adresse und Portnummer vom SRP-Server ermittelt und wie diese Informationen in den Thread-Netzwerkdaten veröffentlicht werden.

Stellt den Status des SRP-Servers dar.

Der Zeigertyp definiert den Callback, der vom SRP-Client verwendet wird, um den Nutzer zu benachrichtigen, wenn er automatisch gestartet oder beendet wird.

Wird nur verwendet, wenn die Autostart-Funktion „OPENTHREAD_CONFIG_SRP_CLIENT_AUTO_START_API_ENABLE“ aktiviert ist.

Dieser Callback wird aufgerufen, wenn der Autostart-Modus aktiviert ist und der SRP-Client entweder automatisch gestartet oder gestoppt wird.

Stellt einen Eintrag für einen SRP-Clientdienstpool-Eintrag dar.

Der Zeigertyp definiert den Callback, der vom SRP-Client verwendet wird, um den Nutzer über Änderungen/Ereignisse/Fehler zu informieren.

Dieser Callback wird bei erfolgreicher Registrierung einer Aktualisierung (d.h. Hinzufügen/Entfernen von Hostinformationen und/oder einigen Diensten) mit dem SRP-Server oder bei einem Fehler oder bei einem Fehler aufgerufen, z.B. wenn der Server eine Aktualisierungsanfrage ablehnt oder der Client beim Warten auf eine Antwort eine Zeitüberschreitung auftritt.

Bei einer erfolgreichen erneuten Registrierung eines Updates wäre der Parameter aError OT_ERROR_NONE und die Hostinformationen und die vollständige Liste der Dienste werden als Eingabeparameter für den Callback bereitgestellt. Hostinformationen und -dienste erfassen jeweils ihren eigenen Status in der entsprechenden mState-Mitgliedsvariablen der zugehörigen Datenstruktur (der Status, der angibt, ob die Hostinformationen/der Dienst registriert oder entfernt wird oder noch hinzugefügt/entfernt wird usw.).

Die Liste der entfernten Dienste wird im Callback als eigene verknüpfte Liste (aRemovedServices) übergeben. Wenn der Callback aufgerufen wird, erfolgt der SRP-Client (OpenThread-Implementierung) mit den entfernten Dienstinstanzen, die in aRemovedServices aufgeführt sind, und erfasst/speichert sie nicht mehr (d.h., wenn wir aus dem Callback otSrpClientGetServices() aufrufen, sind die entfernten Dienste nicht in der zurückgegebenen Liste enthalten). Durch die Bereitstellung einer separaten Liste der entfernten Dienste im Callback kann der Nutzer sehen, welche Elemente jetzt entfernt wurden, und die Instanzen können wieder beansprucht und wiederverwendet werden.

Wenn der Server eine Anfrage zur Aktualisierung der SRP-Seite ablehnt, wird der DNS-Antwortcode (RFC 2136) den folgenden Fehlern zugeordnet:

• (0) NOERROR Erfolgreich (keine Fehlerbedingung) -> OT_ERROR_NONE
• (1) FORMERR Server kann aufgrund eines Formatfehlers nicht interpretiert werden -> OT_ERROR_PARSE
• (2) SERVFAIL-Server hat einen internen Fehler festgestellt -> OT_ERROR_FAILED
• (3) NXDOMAIN-Name, der vorhanden sein sollte, existiert jedoch nicht -> OT_ERROR_NOT_FOUND
• (4) NOTIMP Server unterstützt nicht den Abfragetyp (OpCode) -> OT_ERROR_NOT_IMPLEMENTED
• (5) REFUSED Server abgelehnt aus Richtlinien-/Sicherheitsgründen -> OT_ERROR_SECURITY
• (6) YXDOMAIN Ein Name, der nicht vorhanden sein sollte, ist vorhanden -> OT_ERROR_DUPLICATED
• (7) YXRRSET Einige RRset-Werte, die nicht vorhanden sein sollten, ist vorhanden -> OT_ERROR_DUPLICATED
• (8) NXRRSET Einige RRset-Werte, die vorhanden sein sollten, ist nicht vorhanden -> OT_ERROR_NOT_FOUND
• (9) NOTAUTH-Dienst ist nicht autoritativ für Zone -> OT_ERROR_SECURITY
• (10) NOTZONE A Name ist nicht in der Zone enthalten -> OT_ERROR_PARSE
• (20) BADNAME Falscher Name -> OT_ERROR_PARSE
• (21) BADALG Schlechter Algorithmus -> OT_ERROR_SECURITY
• (22) BADTRUN Falsche Kürzung -> OT_ERROR_PARSE
• Andere Antwortcodes -> OT_ERROR_FAILED

Folgende Fehler können ebenfalls auftreten:

• OT_ERROR_ANSWER_TIMEOUT : Zeitüberschreitung beim Warten auf die Antwort des Servers. Der Client würde versuchen, den Vorgang fortzusetzen.
• OT_ERROR_INVALID_ARGS : Die angegebene Dienststruktur ist ungültig (z.B. falscher Dienstname oder otDnsTxtEntry).
• OT_ERROR_NO_BUFS : Nicht genügend Puffer zum Vorbereiten oder Senden der Aktualisierungsnachricht.

Bei einem Fehler setzt der Client den Vorgang fort, d.h. er bereitet die SRP-Aktualisierungsnachricht vor und (noch einmal) nach einem Warteintervall an den Server. Das Warteintervall für Wiederholungsversuche beginnt beim Mindestwert und wird bei jedem Fehler um den Wachstumsfaktor bis zum Maximalwert erhöht. Weitere Informationen finden Sie im Konfigurationsparameter OPENTHREAD_CONFIG_SRP_CLIENT_MIN_RETRY_WAIT_INTERVAL und in den zugehörigen Abschnitten.

Stellt Informationen zum SRP-Clienthost dar.

Stellt einen SRP-Clientdienst dar.

Die Werte in dieser Struktur, einschließlich der Stringpuffer für die Namen und TXT-Eintrageinträge, MÜSSEN beibehalten und konstant bleiben, nachdem eine Instanz dieser Struktur von otSrpClientAddService() oder otSrpClientRemoveService() an OpenThread übergeben wurde.

Die Felder mState, mData und mNext werden nur vom OT-Kern verwendet/verwaltet. Deren Wert wird ignoriert, wenn eine Instanz von otSrpClientService in otSrpClientAddService(), otSrpClientRemoveService() oder anderen Funktionen übergeben wird. Der Aufrufer muss diese Felder nicht festlegen.

In den Feldern mLease und mKeyLease werden die gewünschten Freigabe- und Schlüsselfreigabeintervalle für diesen Dienst angegeben. Ein Nullwert gibt an, dass das Intervall nicht angegeben ist. Dann werden für diesen Dienst die standardmäßigen Freigabe- oder Schlüsselfreigabeintervalle von otSrpClientGetLeaseInterval() und otSrpClientGetKeyLeaseInterval() verwendet. Wenn das Freigabeintervall (entweder explizit festgelegt oder anhand des Standardwerts bestimmt) kürzer als das Freigabeintervall für einen Dienst ist, verwendet der SRP-Client den Freigabeintervallwert auch für das Schlüsselfreigabeintervall. Beispiel: Wenn für den Dienst mLease ausdrücklich 2 Tage, für mKeyLease null und das standardmäßige Schlüssel-Lease auf 1 Tag festgelegt ist, wird bei der Registrierung dieses Dienstes auch die angeforderte Schlüsselfreigabe für diesen Dienst auf 2 Tage festgelegt.

Stellt den vom SRP-Server verwendeten Adressmodus dar.

Der Adressmodus gibt an, wie die Adresse und Portnummer vom SRP-Server ermittelt und wie diese Informationen in den Thread-Netzwerkdaten veröffentlicht werden.

Dieser intransparente Typ steht für einen SRP-Diensthost.

Umfasst SRP-Server-LEASE- und KEY-LEASE-Konfigurationen.

Enthält SRP-Server-Lease-Informationen eines Hosts/Dienstes.

Enthält die Statistiken der SRP-Serverantworten.

Dieser intransparente Typ steht für einen SRP-Dienst.

Verarbeitet SRP-Dienstaktualisierungen.

Wird vom SRP-Server aufgerufen, um zu informieren, dass ein SRP-Host und möglicherweise SRP-Dienste aktualisiert werden. Es ist wichtig, dass die SRP-Aktualisierungen erst festgeschrieben werden, wenn der Handler das Ergebnis durch Aufrufen von otSrpServerHandleServiceUpdateResult zurückgibt oder dass nach aTimeout eine Zeitüberschreitung auftritt.

Ein SRP-Dienstbeobachter sollte otSrpServerHandleServiceUpdateResult immer sofort nach Erhalt der Aktualisierungsereignisse mit dem Fehlercode OT_ERROR_NONE aufrufen.

Ein allgemeinerer Handler kann Validierungen für den SRP-Host bzw. die SRP-Dienste durchführen und die SRP-Updates ablehnen, wenn eine Validierung fehlschlägt. Ein Advertising Proxy sollte beispielsweise den Host und die Dienste über einen Multicast-fähigen Link anbieten (oder entfernen) und gibt einen spezifischen Fehlercode zurück, wenn ein Fehler auftritt.

Die ID einer Transaktion für die Aktualisierung des SRP-Dienstes auf dem SRP-Server.

Umfasst SRP-Server-TTL-Konfigurationen.

Fügt einen Dienst hinzu, der beim Server registriert werden soll.

Nach einem erfolgreichen Aufruf dieser Funktion wird otSrpClientCallback aufgerufen, um den Status des Hinzufügens bzw. Registrierens des Dienstes beim SRP-Server zu melden.

Die otSrpClientService-Instanz, auf die aService verweist, MUSS bestehen bleiben und bleibt nach der Rückkehr von dieser Funktion (mit OT_ERROR_NONE) unverändert. OpenThread speichert den Zeiger auf die Dienstinstanz.

Die Instanz otSrpClientService wird von OpenThread nicht mehr verfolgt und kann nur dann zurückgefordert werden, wenn

• Sie wird explizit durch einen Aufruf von otSrpClientRemoveService() entfernt oder zusammen mit anderen Diensten durch einen Aufruf von otSrpClientRemoveHostAndServices() and only after theotSrpClientCallback`, der angibt, dass der Dienst entfernt wurde. oder
• Ein Aufruf von otSrpClientClearHostAndServices(), durch den der Host und alle zugehörigen Dienste sofort entfernt werden.

Ordnet einen neuen Diensteintrag aus dem Pool zu.

Die zurückgegebene Diensteintragsinstanz wird so initialisiert:

• mService.mName verweist auf einen zugewiesenen Stringzwischenspeicher, der mit der Funktion otSrpClientBuffersGetServiceEntryServiceNameString() abgerufen werden kann.
• mService.mInstanceName verweist auf einen zugewiesenen Stringzwischenspeicher, der mit der Funktion otSrpClientBuffersGetServiceEntryInstanceNameString() abgerufen werden kann.
• mService.mSubTypeLabels verweist auf ein Array, das von otSrpClientBuffersGetSubTypeLabelsArray() zurückgegeben wird.
• mService.mTxtEntries verweist auf mTxtEntry.
• mService.mNumTxtEntries wird auf eins festgelegt.
• Andere mService-Felder (Port, Priorität, Gewichtung) sind auf null gesetzt.
• mTxtEntry.mKey ist auf NULL gesetzt (der Wert wird als bereits codiert behandelt).
• mTxtEntry.mValue verweist auf einen zugewiesenen Zwischenspeicher, der mit der Funktion otSrpClientBuffersGetServiceEntryTxtBuffer() abgerufen werden kann.
• mTxtEntry.mValueLength ist auf null gesetzt.
• Alle zugehörigen Daten-/Zeichenfolgenpuffer und Arrays werden auf null zurückgesetzt.

Gibt alle zuvor zugewiesenen Diensteinträge frei.

Gibt einen zuvor zugewiesenen Diensteintrag frei.

aService MUSS zuvor mit otSrpClientBuffersAllocateService() zugewiesen und noch nicht freigegeben werden. Andernfalls ist das Verhalten dieser Funktion nicht definiert.

Ruft das Array der IPv6-Adresseinträge ab, die als Liste der SRP-Client-Hostadressen verwendet werden sollen.

Ruft den Stringpuffer ab, der für den Hostnamen des SRP-Clients verwendet werden soll.

Ruft den Stringpuffer für den Dienstinstanznamen aus einem Diensteintrag ab.

Ruft den Stringpuffer für den Dienstnamen aus einem Diensteintrag ab.

Ruft den Puffer für den TXT-Eintrag aus einem Diensteintrag ab.

Ruft das Array für Dienstuntertyplabels aus dem Diensteintrag ab.

Löscht alle Hostinformationen und alle Dienste.

Im Gegensatz zu otSrpClientRemoveHostAndServices(), das eine Aktualisierungsnachricht an den Server sendet, um alle Informationen zu entfernen, löscht diese Funktion alle Informationen sofort und ohne Interaktion mit dem Server.

Löscht einen Dienst und entfernt ihn sofort aus der Liste der Dienstanbieter.

Im Gegensatz zu otSrpClientRemoveService(), das eine Aktualisierungsnachricht zum Entfernen des Dienstes an den Server sendet, löscht diese Funktion den Dienst ohne Interaktion mit dem Server aus der Dienstliste des Clients. Bei einem erfolgreichen Aufruf dieser Funktion wird otSrpClientCallback NICHT aufgerufen und der Eintrag aService kann sofort vom Aufrufer zurückgefordert und wiederverwendet werden.

Kann zusammen mit einem nachfolgenden Aufruf von otSrpClientAddService() verwendet werden, um einige Parameter in einem vorhandenen Dienst zu aktualisieren. Dabei kann es sich um denselben aService-Eintrag mit demselben Dienst und denselben Instanznamen handeln.

Deaktiviert den Autostart-Modus.

Diese Option ist nur verfügbar, wenn die automatische Startfunktion „OPENTHREAD_CONFIG_SRP_CLIENT_AUTO_START_API_ENABLE“ aktiviert ist.

Durch das Deaktivieren des automatischen Startmodus wird der Client nicht gestoppt, wenn er bereits ausgeführt wird. Der Client beendet jedoch die Überwachung der Thread-Netzwerkdaten, um zu prüfen, ob der ausgewählte SRP-Server noch darin vorhanden ist.

Durch einen Aufruf von otSrpClientStop() wird auch der Autostartmodus deaktiviert.

Aktiviert den Modus für die automatische Hostadresse.

Wenn diese Option aktiviert ist, werden Host-IPv6-Adressen automatisch vom SRP-Client unter Verwendung aller bevorzugten Unicast-Adressen im Thread-Netzwerk festgelegt, ausgenommen Link-Local- und Mesh-Local-Adressen. Wenn keine bevorzugte Adresse vorhanden ist, wird die lokale EID-Adresse des Mesh-Netzwerks hinzugefügt. Der SRP-Client wird automatisch neu registriert, wenn Adressen im Thread-Netif aktualisiert werden (neue Adressen werden hinzugefügt oder vorhandene Adressen werden entfernt oder als nicht bevorzugt markiert).

Der Modus für die automatische Hostadresse kann vor dem Start oder während des Betriebs des SRP-Clients aktiviert werden, es sei denn, die Hostinformationen werden entfernt, weil der Client gerade mit der Bearbeitung einer Anfrage zum Entfernen eines Aufrufs von otSrpClientRemoveHostAndServices() beschäftigt ist und die Hostinformationen sich noch im Status STATE_TO_REMOVE oder STATE_REMOVING befinden.

Nachdem der Modus für die automatische Hostadresse aktiviert wurde, kann er durch einen Aufruf von otSrpClientSetHostAddresses() deaktiviert werden, der dann explizit die Hostadressen festlegt.

Aktiviert den Autostartmodus.

Diese Option ist nur verfügbar, wenn die automatische Startfunktion „OPENTHREAD_CONFIG_SRP_CLIENT_AUTO_START_API_ENABLE“ aktiviert ist.

Die Konfigurationsoption OPENTHREAD_CONFIG_SRP_CLIENT_AUTO_START_DEFAULT_MODE gibt den Standard-Autostartmodus an, d. h., ob sie beim Start des OT-Stacks aktiviert oder deaktiviert ist.

Wenn „Auto-Start“ aktiviert ist, überwacht der SRP-Client die Thread-Netzwerkdaten, um SRP-Server zu erkennen, den bevorzugten Server auszuwählen und den Client automatisch zu starten und zu stoppen, wenn ein SRP-Server erkannt wird.

Es gibt drei Kategorien von Netzwerkdateneinträgen, die auf das Vorhandensein eines SRP-Servers hinweisen. Sie werden in der folgenden Reihenfolge bevorzugt:

1) Bevorzugte Unicast-Einträge, bei denen die Serveradresse in den Dienstdaten enthalten ist. Wenn mehrere Optionen vorhanden sind, wird die mit der numerisch niedrigsten IPv6-Adresse bevorzugt.

2) Anycast-Einträge, die jeweils eine Sequenznummer haben Eine größere Sequenznummer im Sinne der arithmetischen Logik der Seriennummer in RFC-1982 wird als aktueller angesehen und daher bevorzugt. Die größte Sequenznummer mit Seriennummernarithmetik wird bevorzugt, wenn sie klar definiert ist (d.h. die Seriennummer ist größer als alle anderen Sequenznummern). Wenn sie nicht klar definiert ist, wird die numerisch größte Sequenznummer vorgezogen.

3) Unicast-Einträge, bei denen die Serveradresseninformationen in den Serverdaten enthalten sind. Wenn mehrere Optionen vorhanden sind, wird die mit der numerisch niedrigsten IPv6-Adresse bevorzugt.

Wenn es eine Änderung in den Netzwerkdateneinträgen gibt, prüft der Client, ob der aktuell ausgewählte Server in den Netzwerkdaten noch vorhanden und immer noch der bevorzugte Server ist. Andernfalls wechselt der Client zum neuen bevorzugten Server oder wird beendet, falls keiner vorhanden ist.

Wenn der SRP-Client explizit durch einen erfolgreichen Aufruf von otSrpClientStart() gestartet wird, wird die angegebene SRP-Serveradresse in otSrpClientStart() weiterhin verwendet, unabhängig vom Status des Autostartmodus und davon, ob dieselbe SRP-Serveradresse in den Thread-Netzwerkdaten erkannt wird oder nicht. In diesem Fall wird der Client nur durch einen expliziten otSrpClientStop()-Aufruf gestoppt.

Ruft den vom SRP-Client verwendeten Domainnamen ab.

Hierfür muss OPENTHREAD_CONFIG_SRP_CLIENT_DOMAIN_NAME_API_ENABLE aktiviert sein.

Wenn kein Domainname festgelegt ist, wird „default.service.arpa“ verwendet.

Ruft die Hostinformationen ab.

Ruft das Standardintervall für die Schlüsselfreigabe ab, das in SRP-Aktualisierungsanfragen verwendet wird.

Das Standardintervall wird nur für otSrpClientService-Instanzen verwendet, bei denen mKeyLease auf null gesetzt ist.

Beachten Sie, dass dies die Lease-Dauer ist, die vom SRP-Client angefordert wird. Der Server kann ein anderes Freigabeintervall akzeptieren.

Ruft das standardmäßige Freigabeintervall ab, das in SRP-Aktualisierungsanfragen verwendet wird.

Das Standardintervall wird nur für otSrpClientService-Instanzen verwendet, bei denen mLease auf null gesetzt ist.

Beachten Sie, dass dies die Lease-Dauer ist, die vom SRP-Client angefordert wird. Der Server kann ein anderes Freigabeintervall akzeptieren.

Ruft die Socket-Adresse (IPv6-Adresse und Portnummer) des SRP-Servers ab, der vom SRP-Client verwendet wird.

Wenn der Client nicht ausgeführt wird, ist die Adresse nicht angegeben (alle Null) und die Portnummer null.

Ruft die Liste der Dienste ab, die vom Client verwaltet werden.

Ruft den TTL-Wert aus jedem Datensatz ab, der in SRP-Aktualisierungsanfragen enthalten ist.

Beachten Sie, dass dies die vom SRP-Client angeforderte TTL ist. Möglicherweise akzeptiert der Server eine andere TTL.

Standardmäßig entspricht die TTL dem Freigabeintervall. Wenn 0 oder ein Wert, der größer als das Freigabeintervall über otSrpClientSetTtl() ist, übergeben, entspricht die TTL ebenfalls dem Freigabeintervall.

Zeigt den aktuellen Status des Autostartmodus an (aktiviert oder deaktiviert).

Diese Option ist nur verfügbar, wenn die automatische Startfunktion „OPENTHREAD_CONFIG_SRP_CLIENT_AUTO_START_API_ENABLE“ aktiviert ist.

Gibt an, ob der SRP-Client ausgeführt wird oder nicht.

Gibt an, ob der Modus zum Einbinden des Dienstschlüssels aktiviert oder deaktiviert ist.

Ist verfügbar, wenn die OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE-Konfiguration aktiviert ist.

Wandelt einen otSrpClientItemState in einen String um.

Startet den Entfernungsprozess für die Hostinformationen und alle Dienste.

Nach der Rückkehr von dieser Funktion wird otSrpClientCallback aufgerufen, um den Status der Entfernungsanfrage an den SRP-Server zu melden.

Wenn die Hostinformationen dauerhaft vom Server entfernt werden sollen, sollte aRemoveKeyLease auf true gesetzt werden. Dadurch wird die mit dem Host auf dem Server verknüpfte Schlüsselfreigabe entfernt. Andernfalls wird der Schlüssel-Lease-Datensatz wie zuvor beibehalten, wodurch sichergestellt wird, dass der Server den Hostnamen in Reserve hält, wenn der Client seine Dienste wieder bereitstellen und registrieren kann.

aSendUnregToServer bestimmt das Verhalten, wenn die Hostinformationen noch nicht auf dem Server registriert sind. Wenn aSendUnregToServer auf false (Standard/erwarteter Wert) gesetzt ist, entfernt der SRP-Client sofort die Hostinformationen und -dienste, ohne eine Aktualisierungsnachricht an den Server zu senden. Der Server muss nicht aktualisiert werden, wenn noch nichts auf ihm registriert ist. Wenn aSendUnregToServer auf true gesetzt ist, sendet der SRP-Client eine Aktualisierungsnachricht an den Server. Wenn die Hostinformationen registriert sind, spielt der Wert von aSendUnregToServer keine Rolle. Der SRP-Client sendet dann immer eine Aktualisierungsnachricht an den Server, in der er darum bittet, alle Informationen zu entfernen.

Wenn aSendUnregToServer beim Zurücksetzen/Neustart des Geräts hilfreich sein kann, möchte der Aufrufer möglicherweise alle zuvor registrierten Dienste auf dem Server entfernen. In diesem Fall kann der Aufrufer otSrpClientSetHostName() und dann otSrpClientRemoveHostAndServices() mit aSendUnregToServer als true anfordern.

Fordert an, dass ein Dienst vom Server abgemeldet wird.

Nach einem erfolgreichen Aufruf dieser Funktion wird otSrpClientCallback aufgerufen, um den Status der Entfernungsanfrage an den SRP-Server zu melden.

Die otSrpClientService-Instanz, auf die aService verweist, MUSS bestehen bleiben und bleibt nach der Rückkehr von dieser Funktion (mit OT_ERROR_NONE) unverändert. OpenThread behält die Dienstinstanz während des Entfernens bei. Erst nach dem Aufruf von otSrpClientCallback gibt an, dass die Dienstinstanz aus der SRP-Clientdienstliste entfernt wurde und freigegeben/wiederverwendet werden kann.

Legt den Rückruf fest, um den Aufrufer über Ereignisse/Änderungen des SRP-Clients zu informieren.

Der SRP-Client lässt die Registrierung eines einzelnen Callbacks zu. Aufeinanderfolgende Aufrufe dieser Funktion überschreiben daher alle zuvor festgelegten Callback-Funktionen.

Legt den Domainnamen fest, der vom SRP-Client verwendet werden soll.

Hierfür muss OPENTHREAD_CONFIG_SRP_CLIENT_DOMAIN_NAME_API_ENABLE aktiviert sein.

Wenn nicht festgelegt, wird „default.service.arpa“ verwendet.

Der Zwischenspeicher für den Namensstring, auf den aName verweist, MUSS erhalten bleiben und bleibt nach der Rückgabe von dieser Funktion unverändert. OpenThread behält den Zeiger auf den String bei.

Der Domainname kann festgelegt werden, bevor der Client gestartet oder nach dem Start, aber bevor die Hostinformationen beim Server registriert werden (Hostinformationen sollten entweder in STATE_TO_ADD oder STATE_TO_REMOVE angegeben werden).

Legt die Liste der IPv6-Hostadresse fest bzw. aktualisiert sie.

Host-IPv6-Adressen können vor dem Start oder während des Betriebs des SRP-Clients festgelegt oder geändert werden (z.B. um eine zuvor registrierte Hostadresse hinzuzufügen, zu entfernen oder zu ändern), es sei denn, die Hostinformationen werden entfernt, da der Client gerade mit einer Entfernungsanfrage aus einem früheren Aufruf an otSrpClientRemoveHostAndServices() beschäftigt ist und die Hostinformationen sich noch im Status STATE_TO_REMOVE oder STATE_REMOVING befinden.

Das IPv6-Adressarray des Hosts, auf das aIp6Addresses verweist, MUSS bestehen bleiben und bleibt nach der Rückgabe von dieser Funktion (mit OT_ERROR_NONE) unverändert. OpenThread speichert den Zeiger im Array.

Nach einem erfolgreichen Aufruf dieser Funktion wird otSrpClientCallback aufgerufen, um den Status der Adressregistrierung beim SRP-Server zu melden.

Durch den Aufruf dieser Funktion wird der Modus für die automatische Hostadresse deaktiviert, wenn er zuvor durch einen erfolgreichen Aufruf von otSrpClientEnableAutoHostAddress() aktiviert wurde.

Legt das Label für den Hostnamen fest.

Nach einem erfolgreichen Aufruf dieser Funktion wird otSrpClientCallback aufgerufen, um den Status der Registrierung der Hostinformationen beim SRP-Server zu melden.

Der Zwischenspeicher für den Namensstring, auf den aName verweist, MUSS erhalten bleiben und bleibt nach der Rückgabe von dieser Funktion unverändert. OpenThread behält den Zeiger auf den String bei.

Der Hostname kann festgelegt werden, bevor der Client oder nach dem Start, aber bevor die Hostinformationen beim Server registriert werden (Hostinformationen sollten entweder in STATE_TO_ADD oder STATE_REMOVED angegeben werden).

Legt das Standardintervall für die Schlüsselfreigabe fest, das in SRP-Updateanfragen verwendet wird.

Das Standardintervall wird nur für otSrpClientService-Instanzen verwendet, bei denen mKeyLease auf null gesetzt ist.

Eine Änderung des Freigabeintervalls wirkt sich nicht auf das akzeptierte Freigabeintervall für bereits registrierte Dienste/Hostinformationen aus, sondern nur auf zukünftige SRP-Updates (z. B. Hinzufügen neuer Dienste und/oder Aktualisierungen vorhandener Dienste).

Legt das standardmäßige Freigabeintervall fest, das in SRP-Updateanfragen verwendet wird.

Das Standardintervall wird nur für otSrpClientService-Instanzen verwendet, bei denen mLease auf null gesetzt ist.

Eine Änderung des Freigabeintervalls wirkt sich nicht auf das akzeptierte Freigabeintervall für bereits registrierte Dienste/Hostinformationen aus, sondern nur auf zukünftige SRP-Update-Nachrichten (z. B. Hinzufügen neuer Dienste und/oder Aktualisierungen vorhandener Dienste).

Aktiviert/deaktiviert den Modus „Einschluss von Dienstschlüsseleinträgen“.

Wenn diese Option aktiviert ist, schließt der SRP-Client den KEY-Eintrag in den Anweisungen zur Dienstbeschreibung in den SRP-Update-Nachrichten ein, die er sendet.

Ist verfügbar, wenn die OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE-Konfiguration aktiviert ist.

Legt den TTL-Wert in jedem Datensatz fest, der in SRP-Aktualisierungsanfragen enthalten ist.

Das Ändern der TTL wirkt sich nicht auf die TTL der bereits registrierten Dienste/Hostinformationen aus, sondern nur auf zukünftige SRP-Updates (z. B. das Hinzufügen neuer Dienste und/oder Aktualisierungen vorhandener Dienste).

Startet den SRP-Clientvorgang.

Der SRP-Client bereitet die Nachricht „SRP-Update“ vor und sendet sie an den SRP-Server, sobald alle folgenden Bedingungen erfüllt sind:

• Der SRP-Client wurde gestartet – otSrpClientStart() wird aufgerufen.
• Hostname ist festgelegt – otSrpClientSetHostName() wird aufgerufen.
• Mindestens eine Host-IPv6-Adresse ist festgelegt – otSrpClientSetHostName() wird aufgerufen.
• Es wird mindestens ein Dienst hinzugefügt – otSrpClientAddService() wird aufgerufen.

Es spielt keine Rolle, in welcher Reihenfolge diese Funktionen aufgerufen werden. Wenn alle Bedingungen erfüllt sind, wartet der SRP-Client eine kurze Verzögerung, bevor er eine Nachricht zur SRP-Aktualisierung vorbereitet und an den Server sendet. Durch diese Verzögerung können Nutzer mehrere Dienste und/oder IPv6-Adressen hinzufügen, bevor die erste SRP-Update-Nachricht gesendet wird. Dadurch wird sichergestellt, dass ein einzelnes SRP-Update mit allen Informationen gesendet wird. Die Konfiguration OPENTHREAD_CONFIG_SRP_CLIENT_UPDATE_TX_DELAY gibt das Verzögerungsintervall an.

Beendet den Vorgang des SRP-Clients.

Beendet alle weiteren Interaktionen mit dem SRP-Server. Beachten Sie, dass dadurch keine Hostinformationen und/oder eine Liste von Diensten entfernt oder gelöscht werden. Damit werden alle Dienste gekennzeichnet, die nach dem (Neu-)Start des Clients wieder hinzugefügt bzw. entfernt werden müssen.

Gibt den vom SRP-Server verwendeten Adressmodus zurück.

Gibt die Sequenznummer zurück, die im Anycast-Adressmodus verwendet wird.

Die Sequenznummer ist im Eintrag „DNS/SRP Service Anycast Address“ (DNS-/SRP-Dienst-Anycast-Adresse) enthalten, der unter „Network Data“ veröffentlicht wurde.

Gibt die für den SRP-Server autorisierte Domain zurück.

Wenn die Domain nicht von SetDomain festgelegt wird, wird „default.service.arpa.“ zurückgegeben. Ein abschließender Punkt wird immer angehängt, auch wenn die Domain ohne ihn festgelegt wurde.

Gibt LEASE- und KEY-LEASE-Konfigurationen des SRP-Servers zurück.

Gibt den nächsten registrierten Host auf dem SRP-Server zurück

Gibt den Port zurück, den der SRP-Server überwacht.

Gibt die Antwortzähler des SRP-Servers zurück.

Gibt den Status des SRP-Servers zurück.

Gibt die TTL-Konfiguration des SRP-Servers zurück.

Meldet das Ergebnis der Verarbeitung einer SRP-Aktualisierung an den SRP-Server.

Der Handler für Dienstaktualisierungen sollte diese Funktion aufrufen, um das Ergebnis der Verarbeitung einer SRP-Aktualisierung zurückzugeben.

Gibt die Adressen des angegebenen Hosts zurück.

Gibt den vollständigen Namen des Hosts zurück

Gibt die LEASE- und KEY-LEASE-Informationen eines bestimmten Hosts zurück.

Gibt den nächsten Dienst des angegebenen Hosts zurück

Gibt an, ob der SRP-Diensthost gelöscht wurde.

Ein SRP-Diensthost kann gelöscht werden, behält aber seinen Namen für die zukünftige Verwendung. In diesem Fall wird die Hostinstanz nicht vom SRP-Server bzw. der SRP-Registry entfernt.

Gibt an, ob der Host mit einem bestimmten Hostnamen übereinstimmt.

Übereinstimmungen mit DNS-Namen werden anhand eines Stringvergleichs durchgeführt, bei dem die Groß- und Kleinschreibung nicht berücksichtigt wird (z.B. „Abc“ und „aBc“ werden als identisch betrachtet.

Gibt an, ob der Modus für die automatische Aktivierung aktiviert oder deaktiviert ist.

Erfordert die Funktion OPENTHREAD_CONFIG_BORDER_ROUTING_ENABLE.

Analysiert einen Dienstnamen des Untertyps (vollständiger Name) und extrahiert das Untertyplabel.

Der vollständige Dienstname für einen Untertyp-Dienst folgt auf "._sub...".

Gibt den Host zurück, auf dem sich die Dienstinstanz befindet.

Gibt das Dienstinstanzlabel (erstes Label im Instanznamen) des Dienstes zurück.

Gibt den vollständigen Dienstinstanznamen des Dienstes zurück

Gibt die LEASE- und KEY-LEASE-Informationen eines bestimmten Dienstes zurück.

Ruft die Anzahl der Untertypen des Dienstes ab.

Gibt den Port der Dienstinstanz zurück.

Gibt die Priorität der Dienstinstanz zurück.

Gibt den vollständigen Dienstnamen des Dienstes zurück

Ruft den Dienstuntertypnamen (vollständiger Name) des Dienstes bei einem bestimmten Index ab.

Der vollständige Dienstname für einen Untertyp-Dienst folgt auf "._sub...".

Gibt die TTL der Dienstinstanz zurück.

Gibt die TXT-Eintragdaten der Dienstinstanz zurück.

Gibt die Gewichtung der Dienstinstanz zurück.

Gibt an, ob der Dienst einen bestimmten Untertyp hat.

Übereinstimmungen mit DNS-Namen werden anhand eines Stringvergleichs durchgeführt, bei dem die Groß- und Kleinschreibung nicht berücksichtigt wird (z.B. „Abc“ und „aBc“ werden als identisch betrachtet.

Gibt an, ob der SRP-Dienst gelöscht wurde.

Ein SRP-Dienst kann gelöscht werden, behält aber seinen Namen für die zukünftige Verwendung. In diesem Fall wird die Dienstinstanz nicht vom SRP-Server bzw. der SRP-Registry entfernt. Es wird garantiert, dass alle Dienste gelöscht werden, wenn der Host gelöscht wird.

Gibt an, ob dieser Dienst mit einem bestimmten Dienstinstanznamen übereinstimmt.

Übereinstimmungen mit DNS-Namen werden anhand eines Stringvergleichs durchgeführt, bei dem die Groß- und Kleinschreibung nicht berücksichtigt wird (z.B. „Abc“ und „aBc“ werden als identisch betrachtet.

Gibt an, ob dieser Dienst mit einem bestimmten Dienstnamen übereinstimmt.

Übereinstimmungen mit DNS-Namen werden anhand eines Stringvergleichs durchgeführt, bei dem die Groß- und Kleinschreibung nicht berücksichtigt wird (z.B. „Abc“ und „aBc“ werden als identisch betrachtet.

Legt den Adressmodus fest, der vom SRP-Server verwendet werden soll.

Legt die Sequenznummer fest, die im Anycast-Adressmodus verwendet wird.

Aktiviert/deaktiviert den automatischen Aktivierungsmodus auf dem SRP-Server.

Erfordert die Funktion OPENTHREAD_CONFIG_BORDER_ROUTING_ENABLE.

Wenn dieser Modus aktiviert ist, steuert der Border Routing Manager, ob/wann der SRP-Server aktiviert oder deaktiviert wird. Der SRP-Server wird beim Start des Border Routing automatisch aktiviert. Dabei werden die anfänglichen Präfix- und Routenkonfigurationen verwendet, d. h., wenn die OMR- und On-Link-Präfixe bestimmt, in der Infrastrukturseite mit der ausgegebenen Router-Anzeige beworben und in den Thread-Netzwerkdaten veröffentlicht werden. Der SRP-Server wird automatisch deaktiviert, wenn der AF gestoppt wird, z.B. wenn die Netzwerkschnittstelle der Infrastruktur ausfällt oder der AF getrennt wird.

Dieser Modus kann durch einen otSrpServerSetAutoEnableMode()-Aufruf deaktiviert werden, bei dem aEnabled auf false gesetzt ist, oder wenn der SRP-Server durch einen Aufruf der Funktion otSrpServerSetEnabled() explizit aktiviert oder deaktiviert wird. Das Deaktivieren des automatischen Aktivierungsmodus mit otSrpServerSetAutoEnableMode(false) wirkt sich nicht auf den aktuellen Status des SRP-Servers aus. Wenn er beispielsweise aktiviert ist, bleibt er aktiviert.

Legt die Domain auf dem SRP-Server fest.

An aDomain wird ein abschließender Punkt angehängt, falls er noch nicht vorhanden ist. Sollte nur aufgerufen werden, bevor der SRP-Server aktiviert ist.

Aktiviert/deaktiviert den SRP-Server.

Bei einem Border-Router wird empfohlen, stattdessen otSrpServerSetAutoEnableMode() zu verwenden.

Legt die LEASE- und KEY-LEASE-Konfigurationen des SRP-Servers fest.

Wenn von einem Client eine LEASE-Zeit ungleich null angefordert wird, wird der gewährte Wert im Bereich [aMinLease, aMaxLease] begrenzt. Ein KEY-LEASE, der nicht null ist, wird im Bereich [aMinKeyLease, aMaxKeyLease] gewährt. Für keine LEASE- oder KEY-LEASE-Zeit werden null gewährt.

Legt den Handler für die Aktualisierung des SRP-Dienstes auf dem SRP-Server fest.

Legt die TTL-Konfiguration des SRP-Servers fest.

Die zugewiesene TTL ist immer nicht größer als das maximale Freigabeintervall, das über otSrpServerSetLeaseConfig() konfiguriert wurde, unabhängig von der Konfiguration für die minimale und maximale TTL.