SRP

Spécifie l'état d'un élément de client SRP (informations sur le service ou l'hôte).

Représente le mode d'adresse utilisé par le serveur SRP.

Le mode adresse spécifie la manière dont l'adresse et le numéro de port sont déterminés par le serveur SRP, ainsi que la manière dont ces informations sont publiées dans les données réseau Thread.

Représente l'état du serveur SRP.

Le type de pointeur définit le rappel utilisé par le client SRP pour avertir l'utilisateur lorsqu'il est démarré ou arrêté automatiquement.

Utilisé uniquement lorsque la fonctionnalité de démarrage automatique OPENTHREAD_CONFIG_SRP_CLIENT_AUTO_START_API_ENABLE est activée.

Ce rappel est invoqué lorsque le mode de démarrage automatique est activé et que le client SRP démarre ou s'arrête automatiquement.

Représente une entrée de pool de services client SRP.

Le type de pointeur définit le rappel utilisé par le client SRP pour avertir l'utilisateur des modifications, des événements ou des erreurs.

Ce rappel est invoqué lors de l'enregistrement réussi d'une mise à jour (ajout/suppression des informations sur l'hôte et/ou de certains services) auprès du serveur SRP, ou en cas d'échec ou d'erreur (par exemple, lorsque le serveur refuse une demande de mise à jour ou que le client expire en attendant la réponse, etc.).

En cas de réenregistrement réussi d'une mise à jour, le paramètre aError serait OT_ERROR_NONE. Les informations sur l'hôte et la liste complète des services sont fournies en tant que paramètres d'entrée du rappel. Notez que les informations et les services hôtes suivent chacun leur propre état dans la variable membre mState correspondante de la structure de données associée (état indiquant si les informations sur l'hôte/le service sont enregistrés ou supprimés, ou encore en cours d'ajout/suppression, etc.).

La liste des services supprimés est transmise via sa propre liste associée aRemovedServices dans le rappel. Notez que lorsque le rappel est appelé, le client SRP (implémentation d'OpenThread) utilise les instances de service supprimées répertoriées dans aRemovedServices et ne les suit plus/ne les stocke plus (par exemple, si à partir du rappel, nous appelons otSrpClientGetServices(), les services supprimés ne seront pas présents dans la liste renvoyée). Fournir une liste distincte des services supprimés dans le rappel permet d'indiquer à l'utilisateur quels éléments sont à présent supprimés et de lui permettre de revendiquer à nouveau les instances ou de les réutiliser.

Si le serveur refuse une demande de mise à jour SRP, le code de réponse DNS (RFC 2136) est mappé sur les erreurs suivantes:

• (0) NOERROR Réussite (aucune condition d'erreur) -> OT_ERROR_NONE
• (1) FORMERR impossible d'interpréter le serveur en raison d'une erreur de format -> OT_ERROR_PARSE
• (2) Une défaillance interne du serveur SERVFAIL s'est produite -> OT_ERROR_FAILED
• (3) Le nom NXDOMAIN qui devrait exister n'existe pas -> OT_ERROR_NOT_FOUND
• (4) Le serveur NOTIMP ne prend pas en charge le type de requête (OpCode) -> OT_ERROR_NOT_IMPLEMENTED.
• (5) Refus du serveur REFused pour des raisons de sécurité/règles -> OT_ERROR_ACTIVITY
• (6) YXDOMAIN Un nom qui ne devrait pas exister existe bien -> OT_ERROR_DUPLICATED
• (7) YXRRSET Certains RRset qui ne devraient pas exister existent -> OT_ERROR_DUPLICATED.
• (8) NXRRSET Un RRset qui devrait exister n'existe pas -> OT_ERROR_NOT_FOUND
• (9) Le service NOTAUTH ne fait pas autorité pour la zone -> OT_ERROR_ security
• (10) NOTZONE Le nom ne se trouve pas dans la zone -> OT_ERROR_PARSE.
• (20) BADNAME Nom incorrect -> OT_ERROR_PARSE
• (21) BADALG Algorithme incorrect -> OT_ERROR_ security
• (22) BADTRUN Troncation incorrecte -> OT_ERROR_PARSE
• Autres codes de réponse -> OT_ERROR_FAILED

Les erreurs suivantes sont également possibles:

• OT_ERROR_response_TIMEOUT : le délai a expiré dans l'attente de la réponse du serveur (le client continue à effectuer une nouvelle tentative).
• OT_ERROR_INVALID_ARGS : la structure du service fournie n'est pas valide (par exemple, nom de service incorrect ou otDnsTxtEntry).
• OT_ERROR_NO_BUFS : tampon insuffisant pour préparer ou envoyer le message de mise à jour.

Notez qu'en cas d'échec, le client poursuit l'opération, c'est-à-dire qu'il prépare et (re)transmet le message de mise à jour SRP au serveur, après un certain intervalle d'attente. L'intervalle d'attente avant une nouvelle tentative commence à partir de la valeur minimale. Il est augmenté du facteur de croissance à chaque échec jusqu'à la valeur maximale (pour en savoir plus, consultez le paramètre de configuration OPENTHREAD_CONFIG_SRP_CLIENT_MIN_RETRY_WAIT_INTERVAL et les paramètres associés).

Représente les informations d'un hôte de client SRP.

Représente un service client SRP.

Les valeurs de cette structure, y compris les tampons de chaîne pour les noms et les entrées d'enregistrement TXT, DOIVENT persister et rester constantes après qu'une instance de cette structure est transmise à OpenThread depuis otSrpClientAddService() ou otSrpClientRemoveService().

Les champs mState, mData et mNext ne sont utilisés/gérés que par les cœurs OT. Leur valeur est ignorée lorsqu'une instance de otSrpClientService est transmise dans otSrpClientAddService(), otSrpClientRemoveService() ou d'autres fonctions. L'appelant n'a pas besoin de définir ces champs.

Les champs mLease et mKeyLease spécifient les baux et les intervalles de bail de clés souhaités pour ce service. La valeur zéro indique que l'intervalle n'est pas spécifié. Les intervalles de bail ou de bail de clés par défaut de otSrpClientGetLeaseInterval() et otSrpClientGetKeyLeaseInterval() sont alors utilisés pour ce service. Si l'intervalle de bail de clés (défini explicitement ou déterminé par défaut) est plus court que l'intervalle de bail d'un service, le client SRP réutilisera la valeur de l'intervalle de bail de clés pour cet intervalle. Par exemple, si mLease est explicitement défini sur "2 jours" dans le service, que mKeyLease est défini sur zéro et que le bail de clés par défaut est de 1 jour, lors de l'enregistrement de ce service, le bail de clés demandé pour ce service sera également défini sur deux jours.

Représente le mode d'adresse utilisé par le serveur SRP.

Le mode adresse spécifie la manière dont l'adresse et le numéro de port sont déterminés par le serveur SRP, ainsi que la manière dont ces informations sont publiées dans les données réseau Thread.

Ce type opaque représente un hôte de service SRP.

Inclut les configurations "LEASE" et "KEY-LEASE" du serveur SRP.

Inclut les informations de bail de serveur SRP d'un hôte/d'un service.

Inclut les statistiques des réponses du serveur SRP.

Ce type opaque représente un service SRP.

Gère les mises à jour du service SRP.

est appelé par le serveur SRP pour avertir qu'un hôte SRP et éventuellement des services SRP sont en cours de mise à jour. Il est important que les mises à jour de la SRP ne soient pas validées tant que le gestionnaire n'a pas renvoyé le résultat en appelant otSrpServerHandleServiceUpdateResult ou avant l'expiration du délai après aTimeout.

Un observateur de service SRP doit toujours appeler otSrpServerHandleServiceUpdateResult avec le code d'erreur OT_ERROR_NONE immédiatement après avoir reçu les événements de mise à jour.

Un gestionnaire plus générique peut effectuer des validations sur les hôtes/services SRP et refuser les mises à jour SRP en cas d'échec d'une validation. Par exemple, un proxy publicitaire doit annoncer (ou supprimer) l'hôte et les services sur un lien compatible avec la multidiffusion et renvoyer un code d'erreur spécifique en cas d'échec.

ID d'une transaction de mise à jour du service SRP sur le serveur SRP.

Inclut les configurations TTL du serveur SRP.

Ajoute un service à enregistrer auprès du serveur.

Après un appel réussi à cette fonction, otSrpClientCallback est appelé pour indiquer l'état de l'ajout ou de l'enregistrement du service auprès du serveur SRP.

L'instance otSrpClientService vers laquelle aService pointe DOIT conserver et rester inchangée après le retour de cette fonction (avec OT_ERROR_NONE). OpenThread enregistrera le pointeur sur l'instance de service.

L'instance otSrpClientService n'est plus suivie par OpenThread et ne peut être récupérée que lorsque

• Elle est explicitement supprimée via un appel à otSrpClientRemoveService() ou supprimée avec d'autres services via un appel à otSrpClientRemoveHostAndServices() and only after theotSrpClientCallback` est appelé pour indiquer que le service a été supprimé. Ou
• Un appel à otSrpClientClearHostAndServices() qui supprime immédiatement l'hôte et tous les services associés.

Alloue une nouvelle entrée de service à partir du pool.

L'instance d'entrée de service renvoyée sera initialisée comme suit:

• mService.mName pointera vers un tampon de chaîne alloué qui peut être récupéré à l'aide de la fonction otSrpClientBuffersGetServiceEntryServiceNameString().
• mService.mInstanceName pointera vers un tampon de chaîne alloué qui peut être récupéré à l'aide de la fonction otSrpClientBuffersGetServiceEntryInstanceNameString().
• mService.mSubTypeLabels pointe vers un tableau renvoyé par otSrpClientBuffersGetSubTypeLabelsArray().
• mService.mTxtEntries pointera vers mTxtEntry.
• mService.mNumTxtEntries sera défini sur un.
• Les autres champs mService (port, priority, weight) sont définis sur zéro.
• mTxtEntry.mKey est défini sur NULL (la valeur est traitée comme déjà encodée).
• mTxtEntry.mValue pointera vers un tampon alloué qui peut être récupéré à l'aide de la fonction otSrpClientBuffersGetServiceEntryTxtBuffer().
• mTxtEntry.mValueLength est défini sur zéro.
• Tous les tampons et tableaux de données/chaînes associés sont effacés.

Libère toutes les entrées de service précédemment allouées.

Libère une entrée de service précédemment allouée.

Le aService DOIT être précédemment alloué à l'aide de otSrpClientBuffersAllocateService() et n'a pas encore été libéré. Sinon, le comportement de cette fonction n'est pas défini.

Récupère le tableau d'entrées d'adresses IPv6 à utiliser comme liste d'adresses d'hôte du client SRP.

Récupère le tampon de chaîne à utiliser pour le nom d'hôte du client SRP.

Récupère le tampon de chaîne pour le nom de l'instance de service à partir d'une entrée de service.

Récupère le tampon de chaîne pour le nom du service à partir d'une entrée de service.

Récupère le tampon pour l'enregistrement TXT à partir d'une entrée de service.

Récupère le tableau contenant les étiquettes de sous-type de service à partir de l'entrée de service.

Efface toutes les informations sur l'hôte et tous les services.

Contrairement à otSrpClientRemoveHostAndServices(), qui envoie un message de mise à jour au serveur pour supprimer toutes les informations, cette fonction efface toutes les informations immédiatement, sans aucune interaction avec le serveur.

Efface un service et le supprime immédiatement de la liste des services client.

Contrairement à otSrpClientRemoveService(), qui envoie un message de mise à jour au serveur pour supprimer le service, cette fonction efface le service de la liste des services du client sans aucune interaction avec le serveur. Lors d'un appel réussi à cette fonction, otSrpClientCallback n'est PAS appelé et l'entrée aService peut être récupérée et réutilisée par l'appelant immédiatement.

Peut être utilisé avec un appel ultérieur à otSrpClientAddService() (en réutilisant potentiellement la même entrée aService avec les mêmes noms de service et d'instance) pour mettre à jour certains des paramètres d'un service existant.

Désactive le mode de démarrage automatique.

Cette option n'est disponible que lorsque la fonctionnalité de démarrage automatique OPENTHREAD_CONFIG_SRP_CLIENT_AUTO_START_API_ENABLE est activée.

La désactivation du mode de démarrage automatique n'arrête pas le client s'il est déjà en cours d'exécution, mais il cesse de surveiller les données réseau Thread pour vérifier que le serveur SRP sélectionné y est toujours présent.

Notez qu'un appel à otSrpClientStop() désactive également le mode de démarrage automatique.

Active le mode d'adresse automatique de l'hôte.

Lorsque cette option est activée, les adresses IPv6 de l'hôte sont automatiquement définies par le client SRP à l'aide de toutes les adresses unicast privilégiées sur le netif Thread, à l'exception des adresses de liaison locale et du réseau maillé. S'il n'y a pas d'adresse préférée, l'adresse EID du réseau maillé est ajoutée. Le client SRP se réinscrit automatiquement lorsque des adresses sont mises à jour sur Thread Nettif (de nouvelles adresses sont ajoutées, ou des adresses existantes sont supprimées ou marquées comme non préférées).

Le mode d'adresse automatique de l'hôte peut être activé avant le démarrage ou pendant l'utilisation du client SRP, sauf lorsque les informations sur l'hôte sont en cours de suppression (le client est en train de traiter une demande de suppression d'un appel à otSrpClientRemoveHostAndServices(), et les informations sur l'hôte sont toujours à l'état STATE_TO_REMOVE ou STATE_REMOVING).

Une fois le mode d'adresse automatique de l'hôte activé, vous pouvez le désactiver en appelant otSrpClientSetHostAddresses() qui définit ensuite explicitement les adresses hôtes.

Active le mode de démarrage automatique.

Cette option n'est disponible que lorsque la fonctionnalité de démarrage automatique OPENTHREAD_CONFIG_SRP_CLIENT_AUTO_START_API_ENABLE est activée.

L'option de configuration OPENTHREAD_CONFIG_SRP_CLIENT_AUTO_START_DEFAULT_MODE spécifie le mode de démarrage automatique par défaut (qu'il soit activé ou désactivé au début de la pile OT).

Lorsque le démarrage automatique est activé, le client SRP surveille les données réseau Thread pour détecter les serveurs SRP et sélectionner le serveur préféré, puis démarrer et arrêter automatiquement le client lorsqu'un serveur SRP est détecté.

Trois catégories d'entrées de données réseau indiquent la présence d'un serveur SRP. Elles sont recommandées dans l'ordre suivant:

1) Entrées unicast privilégiées pour lesquelles l'adresse du serveur est incluse dans les données du service S'il existe plusieurs options, préférez celle dont l'adresse IPv6 numérique est la plus basse.

2) Entrées Anycast ayant chacune un numéro de séquence. Un numéro de séquence plus grand, au sens spécifié par la logique arithmétique du numéro de série dans le document RFC-1982, est considéré comme plus récent et donc privilégié. Il est préférable d'utiliser le plus grand nombre de suite en arithmétique des numéros de série s'il est bien défini (c'est-à-dire que le numéro de séquence est supérieur à tous les autres nombres seq). S'il n'est pas bien défini, il est préférable d'utiliser le chiffre suivant le plus grand nombre.

3) Entrées Unicast dont les informations d'adresse du serveur sont incluses dans les données du serveur S'il existe plusieurs options, préférez celle dont l'adresse IPv6 numérique est la plus basse.

En cas de modification des entrées de données réseau, le client vérifie que le serveur actuellement sélectionné est toujours présent dans les données réseau et reste le serveur privilégié. Sinon, le client basculera sur le nouveau serveur préféré ou s'arrêtera s'il n'y en a pas.

Lorsque le client SRP est explicitement démarré via un appel réussi à otSrpClientStart(), l'adresse du serveur SRP indiquée dans otSrpClientStart() continue d'être utilisée indépendamment de l'état du mode de démarrage automatique et de la découverte ou non de la même adresse de serveur SRP dans les données réseau Thread. Dans ce cas, seul un appel otSrpClientStop() explicite arrêtera le client.

Récupère le nom de domaine utilisé par le client SRP.

Nécessite l'activation de OPENTHREAD_CONFIG_SRP_CLIENT_DOMAIN_NAME_API_ENABLE.

Si le nom de domaine n'est pas défini, "default.service.arpa" est utilisé.

Récupère les informations sur l'hôte.

Récupère l'intervalle de bail de clés par défaut utilisé dans les requêtes de mise à jour de la SRP.

L'intervalle par défaut n'est utilisé que pour les instances otSrpClientService où la valeur mKeyLease est définie sur zéro.

Notez qu'il s'agit de la durée de location demandée par le client SRP. Le serveur peut choisir d'accepter un intervalle de bail différent.

Récupère l'intervalle de bail par défaut utilisé dans les requêtes de mise à jour de la SRP.

L'intervalle par défaut n'est utilisé que pour les instances otSrpClientService où la valeur mLease est définie sur zéro.

Notez qu'il s'agit de la durée de location demandée par le client SRP. Le serveur peut choisir d'accepter un intervalle de bail différent.

Récupère l'adresse de socket (adresse IPv6 et numéro de port) du serveur SRP utilisé par le client SRP.

Si le client n'est pas en cours d'exécution, l'adresse n'est pas spécifiée (toute zéro) et aucun numéro de port n'est indiqué.

Récupère la liste des services gérés par le client.

Récupère la valeur TTL de chaque enregistrement inclus dans les requêtes de mise à jour de la SRP.

Notez qu'il s'agit de la valeur TTL demandée par le client SRP. Le serveur peut choisir d'accepter une valeur TTL différente.

Par défaut, la valeur TTL est égale à l'intervalle du bail. Si vous transmettez 0 ou une valeur supérieure à l'intervalle de bail via otSrpClientSetTtl(), la valeur TTL sera également égale à l'intervalle du bail.

Indique l'état actuel du mode de démarrage automatique (activé ou désactivé).

Cette option n'est disponible que lorsque la fonctionnalité de démarrage automatique OPENTHREAD_CONFIG_SRP_CLIENT_AUTO_START_API_ENABLE est activée.

Indique si le client SRP est en cours d'exécution ou non.

Indique si le mode "Inclusion d'enregistrements de clés de service" est activé ou désactivé.

Disponible lorsque la configuration OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE est activée.

Convertit une valeur otSrpClientItemState en chaîne.

Lance le processus de suppression des informations sur l'hôte et de tous les services.

Une fois cette fonction renvoyée, otSrpClientCallback sera appelé pour signaler l'état de la demande de suppression auprès du serveur SRP.

Si les informations sur l'hôte doivent être définitivement supprimées du serveur, aRemoveKeyLease doit être défini sur true, ce qui supprime le bail de clé associé à l'hôte sur le serveur. Sinon, l'enregistrement du bail de clé est conservé comme auparavant, ce qui garantit que le serveur détient le nom d'hôte en réserve lorsque le client est à nouveau en mesure de fournir et d'enregistrer ses services.

aSendUnregToServer détermine le comportement lorsque les informations sur l'hôte ne sont pas encore enregistrées auprès du serveur. Si aSendUnregToServer est défini sur false (valeur par défaut/attendue), le client SRP supprime immédiatement les informations et les services hôtes sans envoyer de message de mise à jour au serveur (il n'est pas nécessaire de mettre à jour le serveur si rien n'est encore enregistré auprès de celui-ci). Si aSendUnregToServer est défini sur true, le client SRP envoie un message de mise à jour au serveur. Notez que si les informations sur l'hôte sont enregistrées, la valeur de aSendUnregToServer n'a pas d'importance et le client SRP envoie toujours un message de mise à jour au serveur demandant la suppression de toutes les informations.

aSendUnregToServer peut être utile lors de la réinitialisation ou du redémarrage de l'appareil. L'appelant peut vouloir supprimer tous les services précédemment enregistrés auprès du serveur. Dans ce cas, l'appelant peut otSrpClientSetHostName(), puis demander otSrpClientRemoveHostAndServices() avec aSendUnregToServer comme true.

Demande l'annulation de l'enregistrement d'un service auprès du serveur.

Après un appel réussi à cette fonction, otSrpClientCallback est appelé pour signaler l'état de la demande de suppression auprès du serveur SRP.

L'instance otSrpClientService vers laquelle aService pointe DOIT conserver et rester inchangée après le retour de cette fonction (avec OT_ERROR_NONE). OpenThread conservera l'instance de service pendant le processus de suppression. Seul l'appel de otSrpClientCallback indique que l'instance de service est supprimée de la liste des services client SRP et peut être libérée/réutilisée.

Définit le rappel pour avertir l'appelant des événements/modifications du client SRP.

Le client SRP autorise l'enregistrement d'un seul rappel. Ainsi, les appels consécutifs effectués vers cette fonction écraseront toutes les fonctions de rappel précédemment définies.

Définit le nom de domaine que le client SRP doit utiliser.

Nécessite l'activation de OPENTHREAD_CONFIG_SRP_CLIENT_DOMAIN_NAME_API_ENABLE.

Si cette règle n'est pas configurée, "default.service.arpa" est utilisé.

Le tampon de chaîne de nom vers lequel pointe aName DOIT persister et rester inchangé après le retour de cette fonction. OpenThread gardera le pointeur sur la chaîne.

Le nom de domaine peut être défini avant le démarrage du client ou après le démarrage, mais avant l'enregistrement des informations sur l'hôte auprès du serveur (les informations sur l'hôte doivent se trouver dans STATE_TO_ADD ou STATE_TO_REMOVE).

Définit/met à jour la liste des adresses IPv6 de l'hôte.

Les adresses IPv6 hôtes peuvent être définies/modifiées avant le démarrage ou pendant l'utilisation du client SRP (par exemple, pour ajouter/supprimer ou modifier une adresse hôte déjà enregistrée), sauf lorsque les informations sur l'hôte sont supprimées (le client traite une demande de suppression d'un appel précédent à otSrpClientRemoveHostAndServices(), et les informations sur l'hôte sont toujours à l'état STATE_TO_REMOVE ou STATE_REMOVING).

Le tableau d'adresses IPv6 hôte pointé par aIp6Addresses DOIT persister et rester inchangé après le renvoi de cette fonction (avec OT_ERROR_NONE). OpenThread enregistrera le pointeur dans le tableau.

Après un appel réussi à cette fonction, otSrpClientCallback est appelé pour indiquer l'état de l'enregistrement de l'adresse auprès du serveur SRP.

L'appel de cette fonction désactive le mode d'adresse automatique de l'hôte s'il a été activé lors d'un appel réussi à otSrpClientEnableAutoHostAddress().

Définit le libellé du nom d'hôte.

Après un appel réussi à cette fonction, otSrpClientCallback est appelé pour signaler l'état de l'enregistrement des informations de l'hôte auprès du serveur SRP.

Le tampon de chaîne de nom vers lequel pointe aName DOIT persister et rester inchangé après le retour de cette fonction. OpenThread gardera le pointeur sur la chaîne.

Le nom d'hôte peut être défini avant le démarrage du client ou après le démarrage, mais avant que les informations sur l'hôte soient enregistrées auprès du serveur (elles doivent se trouver dans STATE_TO_ADD ou STATE_REMOVED).

Définit l'intervalle de bail de clés par défaut utilisé dans les requêtes de mise à jour SRP.

L'intervalle par défaut n'est utilisé que pour les instances otSrpClientService où la valeur mKeyLease est définie sur zéro.

La modification de l'intervalle de bail n'a pas d'incidence sur l'intervalle de bail accepté pour les services/informations sur l'hôte déjà enregistrés. Elle n'a d'incidence que sur les futurs messages de mise à jour de la SRP (ajout de services et/ou actualisations de services existants, par exemple).

Définit l'intervalle de bail par défaut utilisé dans les requêtes de mise à jour SRP.

L'intervalle par défaut n'est utilisé que pour les instances otSrpClientService où la valeur mLease est définie sur zéro.

La modification de l'intervalle de bail n'a aucune incidence sur l'intervalle de bail accepté pour les services/informations sur l'hôte déjà enregistrés. Elle n'a d'incidence que sur les futurs messages de mise à jour de la SRP (par exemple, l'ajout de nouveaux services et/ou l'actualisation des services existants).

Active/désactive le mode "inclusion des enregistrements de clé de service".

Lorsque cette option est activée, le client SRP inclut l'enregistrement KEY dans les instructions de description du service dans les messages de mise à jour SRP qu'il envoie.

Disponible lorsque la configuration OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE est activée.

Définit la valeur TTL de chaque enregistrement inclus dans les demandes de mise à jour de la SRP.

La modification de la valeur TTL n'a aucune incidence sur la valeur TTL des services/informations sur l'hôte déjà enregistrés. Elle n'a d'incidence que sur les futurs messages de mise à jour de la SRP (ajout de services et/ou actualisations de services existants, par exemple).

Lance l'opération du client SRP.

Le client SRP prépare et envoie le message de mise à jour SRP au serveur SRP lorsque toutes les conditions suivantes sont remplies:

• Le client SRP démarre : otSrpClientStart() est appelé.
• Le nom d'hôte est défini : otSrpClientSetHostName() est appelé.
• Au moins une adresse IPv6 hôte est définie : otSrpClientSetHostName() est appelé.
• Au moins un service est ajouté : otSrpClientAddService() est appelé.

L'ordre d'appel de ces fonctions n'a pas d'importance. Lorsque toutes les conditions sont remplies, le client SRP attend un court délai avant de préparer un message de mise à jour SRP et de l'envoyer au serveur. Ce délai permet à l'utilisateur d'ajouter plusieurs services et/ou adresses IPv6 avant l'envoi du premier message de mise à jour de la SRP (en veillant à ce qu'une seule mise à jour de la SRP soit envoyée avec toutes les informations). La configuration OPENTHREAD_CONFIG_SRP_CLIENT_UPDATE_TX_DELAY spécifie l'intervalle de délai.

Arrête l'opération du client SRP.

Arrête toute autre interaction avec le serveur SRP. Notez que cela ne supprime ni n'efface les informations sur l'hôte et/ou la liste des services. Elle indique que tous les services doivent être ajoutés/supprimés à nouveau une fois que le client est (re)démarré.

Renvoie le mode d'adresse utilisé par le serveur SRP.

Renvoie le numéro de séquence utilisé avec le mode d'adresse Anycast.

Le numéro de séquence est inclus dans l'entrée "Adresse Anycast du service DNS/SRP" publiée dans les données réseau.

Renvoie le domaine autorisé au serveur SRP.

Si le domaine n'est pas défini par SetDomain, "default.service.arpa." s'affiche. Un point est toujours ajouté à la fin, même si le domaine est défini sans.

Renvoie les configurations LEASE et KEY-LEASE du serveur SRP.

Renvoie l'hôte enregistré suivant sur le serveur SRP.

Renvoie le port écouté par le serveur SRP.

Renvoie les compteurs de réponses du serveur SRP.

Renvoie l'état du serveur SRP.

Renvoie la configuration TTL du serveur SRP.

Indique le résultat du traitement d'une mise à jour de la SRP au serveur SRP.

Le gestionnaire de mises à jour du service doit appeler cette fonction pour renvoyer le résultat du traitement d'une mise à jour de la SRP.

Renvoie les adresses d'un hôte donné.

Renvoie le nom complet de l'hôte.

Renvoie les informations LEASE et KEY-LEASE d'un hôte donné.

Renvoie le service suivant de l'hôte donné.

Indique si l'hôte du service SRP a été supprimé.

Un hôte de service SRP peut être supprimé, mais conserve son nom pour une utilisation ultérieure. Dans ce cas, l'instance hôte n'est pas supprimée du serveur/registre SRP.

Indique si l'hôte correspond à un nom d'hôte donné.

Les correspondances de noms DNS sont effectuées à l'aide d'une comparaison de chaînes non sensibles à la casse (par exemple, "Abc" et "aBc" sont considérés comme identiques).

Indique si le mode d'activation automatique est activé ou désactivé.

Nécessite la fonctionnalité OPENTHREAD_CONFIG_BORDER_ROUTING_ENABLE.

Analyse le nom de service d'un sous-type (nom complet) et extrait le libellé du sous-type.

Le nom complet d'un sous-type de service suit "._sub...".

Renvoie l'hôte sur lequel réside l'instance de service.

Renvoie le libellé de l'instance de service (premier libellé du nom de l'instance) du service.

Renvoie le nom d'instance complet du service.

Renvoie les informations LEASE et KEY-LEASE d'un service donné.

Récupère le nombre de sous-types du service.

Renvoie le port de l'instance de service.

Renvoie la priorité de l'instance de service.

Renvoie le nom complet du service.

Récupère le nom de service du sous-type (nom complet) du service dans un index donné.

Le nom complet d'un sous-type de service suit "._sub...".

Renvoie la valeur TTL de l'instance de service.

Renvoie les données d'enregistrement TXT de l'instance de service.

Renvoie la pondération de l'instance de service.

Indique si le service possède un sous-type donné.

Les correspondances de noms DNS sont effectuées à l'aide d'une comparaison de chaînes non sensibles à la casse (par exemple, "Abc" et "aBc" sont considérés comme identiques).

Indique si le service SRP a été supprimé ou non.

Un service SRP peut être supprimé, mais conserve son nom pour une utilisation ultérieure. Dans ce cas, l'instance de service n'est pas supprimée du serveur/registre SRP. La suppression de tous les services est garantie si l'hôte est supprimé.

Indique si ce service correspond à un nom d'instance de service donné.

Les correspondances de noms DNS sont effectuées à l'aide d'une comparaison de chaînes non sensibles à la casse (par exemple, "Abc" et "aBc" sont considérés comme identiques).

Indique si ce service correspond à un nom de service donné.

Les correspondances de noms DNS sont effectuées à l'aide d'une comparaison de chaînes non sensibles à la casse (par exemple, "Abc" et "aBc" sont considérés comme identiques).

Définit le mode d'adresse que le serveur SRP doit utiliser.

Définit le numéro de séquence utilisé avec le mode d'adresse Anycast.

Active/désactive le mode d'activation automatique sur le serveur SRP.

Nécessite la fonctionnalité OPENTHREAD_CONFIG_BORDER_ROUTING_ENABLE.

Lorsque ce mode est activé, le gestionnaire de routage d'acheminement détermine si et quand activer ou désactiver le serveur SRP. Le serveur SRP est activé automatiquement si/quand le routage frontal est lancé, et avec le préfixe et les configurations de routage initiaux (lorsque les préfixes OMR et sur la liaison sont déterminés, annoncés dans un message d'annonce de routeur émis côté infrastructure et publié dans les données réseau Thread). Le serveur SRP est automatiquement désactivé si/quand le BR est arrêté (en cas de panne de l'interface réseau de l'infrastructure ou si le BR est dissocié, par exemple).

Ce mode peut être désactivé via un appel otSrpServerSetAutoEnableMode() avec aEnabled défini sur false, ou si le serveur SRP est explicitement activé ou désactivé par un appel à la fonction otSrpServerSetEnabled(). La désactivation du mode d'activation automatique à l'aide de otSrpServerSetAutoEnableMode(false) ne modifie pas l'état actuel du serveur SRP (par exemple, s'il est activé, il le reste).

Définit le domaine sur le serveur SRP.

Un point final sera ajouté à aDomain s'il n'est pas déjà présent. Ne doit être appelé qu'avant l'activation du serveur SRP.

Active/désactive le serveur SRP.

Sur un routeur de bordure, il est recommandé d'utiliser plutôt otSrpServerSetAutoEnableMode().

Définit les configurations LEASE et KEY-LEASE du serveur SRP.

Lorsqu'une durée de LEASE non nulle est demandée à un client, la valeur accordée est limitée dans la plage [aMinLease, aMaxLease] et une valeur KEY-LEASE non nulle est accordée dans la plage [aMinKeyLease, aMaxKeyLease]. Si vous n'avez pas le LEASE ou le MOINS de CLÉ, la valeur zéro est accordée.

Définit le gestionnaire de mises à jour du service SRP sur le serveur SRP.

Définit la configuration TTL du serveur SRP.

La valeur TTL accordée ne sera toujours pas supérieure à l'intervalle de bail maximal configuré via otSrpServerSetLeaseConfig(), quelle que soit la configuration TTL minimale et maximale.