Esta página foi traduzida pela API Cloud Translation.

IPv6

Este módulo inclui funções que controlam a comunicação IPv6.

Resumo

Enumerações
`anonymous enum { OT_ADDRESS_ORIGIN_THREAD = 0, OT_ADDRESS_ORIGIN_SLAAC = 1, OT_ADDRESS_ORIGIN_DHCPV6 = 2, OT_ADDRESS_ORIGIN_MANUAL = 3 }`	enumerar Origens do endereço IPv6.
`anonymous enum { OT_ECN_NOT_CAPABLE = 0x0, OT_ECN_CAPABLE_0 = 0x2, OT_ECN_CAPABLE_1 = 0x1, OT_ECN_MARKED = 0x3 }`	enumerar Status ECN, representados como no cabeçalho IP.
`anonymous enum { OT_IP6_PROTO_HOP_OPTS = 0, OT_IP6_PROTO_TCP = 6, OT_IP6_PROTO_UDP = 17, OT_IP6_PROTO_IP6 = 41, OT_IP6_PROTO_ROUTING = 43, OT_IP6_PROTO_FRAGMENT = 44, OT_IP6_PROTO_ICMP6 = 58, OT_IP6_PROTO_NONE = 59, OT_IP6_PROTO_DST_OPTS = 60 }`	enumerar Números de protocolo da Internet.

Typedefs
`otIp6Address`	typedef `struct otIp6Address` Essa estrutura representa um endereço IPv6.
`otIp6AddressCallback )(const otIp6AddressInfo aAddressInfo, bool aIsAdded, void aContext)`	typedef `void(*` Esse ponteiro de função é chamado quando um endereço IPv6 interno é adicionado ou removido.
`otIp6AddressComponents`	typedef `struct otIp6AddressComponents` Essa estrutura representa os componentes de um endereço IPv6.
`otIp6AddressInfo`	typedef `struct otIp6AddressInfo`
`otIp6InterfaceIdentifier`	typedef `struct otIp6InterfaceIdentifier` Essa estrutura representa o Identificador de Interface de um endereço IPv6.
`otIp6NetworkPrefix`	typedef `struct otIp6NetworkPrefix` Essa estrutura representa o prefixo de rede de um endereço IPv6 (64 bits mais significativos do endereço).
`otIp6Prefix`	typedef `struct otIp6Prefix` Essa estrutura representa um prefixo IPv6.
`otIp6ReceiveCallback )(otMessage aMessage, void aContext)`	typedef `void(*` Este ponteiro de função é chamado quando um datagrama IPv6 é recebido.
`otIp6RegisterMulticastListenersCallback )(void aContext, otError aError, uint8_t aMlrStatus, const otIp6Address aFailedAddresses, uint8_t aFailedAddressNum)`	typedef `void(*` Esse ponteiro de função é chamado com resultados de `otIp6RegisterMulticastListeners` .
`otIp6SlaacPrefixFilter )(otInstance aInstance, const otIp6Prefix aPrefix)`	typedef `bool(*` Este ponteiro de função permite ao usuário filtrar prefixos e não permitir que um endereço SLAAC baseado em um prefixo seja adicionado.
`otMessageInfo`	typedef `struct otMessageInfo` Essa estrutura representa os endereços de soquete IPv6 locais e de mesmo nível.
`otNetifAddress`	typedef `struct otNetifAddress` Essa estrutura representa um endereço unicast de interface de rede IPv6.
`otNetifMulticastAddress`	typedef `struct otNetifMulticastAddress` Essa estrutura representa um endereço multicast de interface de rede IPv6.
`otSockAddr`	typedef `struct otSockAddr` Essa estrutura representa um endereço de soquete IPv6.

Variáveis
`OT_TOOL_PACKED_END`	`OT_TOOL_PACKED_BEGIN struct otIp6InterfaceIdentifier`

Funções
`otIp6AddUnicastAddress ( otInstance aInstance, const otNetifAddress aAddress)`	`otError` Adicione um endereço de interface de rede à interface de thread.
`otIp6AddUnsecurePort ( otInstance *aInstance, uint16_t aPort)`	`otError` Esta função adiciona uma porta à lista de portas não seguras permitidas.
`otIp6AddressFromString (const char aString, otIp6Address aAddress)`	`otError` Essa função converte uma string de endereço IPv6 legível por humanos em uma representação binária.
`otIp6AddressToString (const otIp6Address aAddress, char aBuffer, uint16_t aSize)`	`void` Esta função converte um determinado endereço IPv6 em uma string legível.
`otIp6ArePrefixesEqual (const otIp6Prefix aFirst, const otIp6Prefix aSecond)`	`bool` Teste se dois prefixos IPv6 são iguais.
`otIp6GetMulticastAddresses ( otInstance *aInstance)`	`const otNetifMulticastAddress *` Obtenha a lista de endereços multicast IPv6 inscritos na interface Thread.
`otIp6GetUnicastAddresses ( otInstance *aInstance)`	`const otNetifAddress *` Obtenha a lista de endereços IPv6 atribuídos à interface Thread.
`otIp6GetUnsecurePorts ( otInstance aInstance, uint8_t aNumEntries)`	`const uint16_t *` Esta função retorna um ponteiro para a lista de portas não seguras.
`otIp6IsAddressEqual (const otIp6Address aFirst, const otIp6Address aSecond)`	`bool` Teste se dois endereços IPv6 são iguais.
`otIp6IsAddressUnspecified (const otIp6Address *aAddress)`	`bool` Esta função indica se um determinado endereço IPv6 é ou não o endereço não especificado.
`otIp6IsEnabled ( otInstance *aInstance)`	`bool` Esta função indica se a interface IPv6 está ativa ou não.
`otIp6IsMulticastPromiscuousEnabled ( otInstance *aInstance)`	`bool` Verifique se o modo promíscuo multicast está habilitado na interface Thread.
`otIp6IsReceiveFilterEnabled ( otInstance *aInstance)`	`bool` Esta função indica se o tráfego de controle de thread é ou não filtrado ao entregar datagramas IPv6 por meio do retorno de chamada especificado em otIp6SetReceiveCallback() .
`otIp6IsSlaacEnabled ( otInstance *aInstance)`	`bool` Esta função indica se o módulo SLAAC está habilitado ou não.
`otIp6NewMessage ( otInstance aInstance, const otMessageSettings aSettings)`	`otMessage *` Aloque um novo buffer de mensagem para enviar uma mensagem IPv6.
`otIp6NewMessageFromBuffer ( otInstance aInstance, const uint8_t aData, uint16_t aDataLength, const otMessageSettings *aSettings)`	`otMessage *` Aloque um novo buffer de mensagem e grave o datagrama IPv6 no buffer de mensagem para enviar uma mensagem IPv6.
`otIp6PrefixMatch (const otIp6Address aFirst, const otIp6Address aSecond)`	`uint8_t` Esta função retorna o comprimento de correspondência de prefixo (bits) para dois endereços IPv6.
`otIp6PrefixToString (const otIp6Prefix aPrefix, char aBuffer, uint16_t aSize)`	`void` Esta função converte um determinado prefixo IPv6 em uma string legível.
`otIp6ProtoToString (uint8_t aIpProto)`	`const char *` Esta função converte um determinado número de protocolo IP em uma string legível.
`otIp6RegisterMulticastListeners ( otInstance aInstance, const otIp6Address aAddresses, uint8_t aAddressNum, const uint32_t aTimeout, otIp6RegisterMulticastListenersCallback aCallback, void aContext)`	`otError` Esta função registra ouvintes de multicast no roteador de backbone primário.
`otIp6RemoveAllUnsecurePorts ( otInstance *aInstance)`	`void` Esta função remove todas as portas da lista de portas não seguras permitidas.
`otIp6RemoveUnicastAddress ( otInstance aInstance, const otIp6Address aAddress)`	`otError` Remova um endereço de interface de rede da interface de thread.
`otIp6RemoveUnsecurePort ( otInstance *aInstance, uint16_t aPort)`	`otError` Esta função remove uma porta da lista de portas não seguras permitidas.
`otIp6SelectSourceAddress ( otInstance aInstance, otMessageInfo aMessageInfo)`	`otError` Esta função executa a seleção de endereço de origem OpenThread.
`otIp6Send ( otInstance aInstance, otMessage aMessage)`	`otError` Esta função envia um datagrama IPv6 através da interface Thread.
`otIp6SetAddressCallback ( otInstance aInstance, otIp6AddressCallback aCallback, void aCallbackContext)`	`void` Esta função registra um retorno de chamada para notificar as alterações de endereços IPv6 internos.
`otIp6SetEnabled ( otInstance *aInstance, bool aEnabled)`	`otError` Esta função ativa/desativa a interface IPv6.
`otIp6SetMeshLocalIid ( otInstance aInstance, const otIp6InterfaceIdentifier aIid)`	`otError` Esta função define o IID local da malha (para fins de teste).
`otIp6SetMulticastPromiscuousEnabled ( otInstance *aInstance, bool aEnabled)`	`void` Habilite o modo promíscuo multicast na interface Thread.
`otIp6SetReceiveCallback ( otInstance aInstance, otIp6ReceiveCallback aCallback, void aCallbackContext)`	`void` Esta função registra um retorno de chamada para fornecer datagramas IPv6 recebidos.
`otIp6SetReceiveFilterEnabled ( otInstance *aInstance, bool aEnabled)`	`void` Essa função define se o tráfego de controle de thread é filtrado ou não ao entregar datagramas IPv6 por meio do retorno de chamada especificado em otIp6SetReceiveCallback() .
`otIp6SetSlaacEnabled ( otInstance *aInstance, bool aEnabled)`	`void` Esta função habilita/desabilita o módulo SLAAC.
`otIp6SetSlaacPrefixFilter ( otInstance *aInstance, otIp6SlaacPrefixFilter aFilter)`	`void` Esta função define o manipulador de filtro do módulo SLAAC.
`otIp6SockAddrToString (const otSockAddr aSockAddr, char aBuffer, uint16_t aSize)`	`void` Essa função converte um determinado endereço de soquete IPv6 em uma string legível.
`otIp6SubscribeMulticastAddress ( otInstance aInstance, const otIp6Address aAddress)`	`otError` Assine a interface Thread para um endereço de multicast de interface de rede.
`otIp6UnsubscribeMulticastAddress ( otInstance aInstance, const otIp6Address aAddress)`	`otError` Cancele a assinatura da interface Thread para um endereço multicast de interface de rede.

Estruturas
otIp6Address	Essa estrutura representa um endereço IPv6.
otIp6AddressComponents	Essa estrutura representa os componentes de um endereço IPv6.
otIp6AddressInfo	Essa estrutura representa informações de endereço IPv6.
otIp6InterfaceIdentifier	Essa estrutura representa o Identificador de Interface de um endereço IPv6.
otIp6NetworkPrefix	Essa estrutura representa o prefixo de rede de um endereço IPv6 (64 bits mais significativos do endereço).
otIp6Prefix	Essa estrutura representa um prefixo IPv6.
otMessageInfo	Essa estrutura representa os endereços de soquete IPv6 locais e de mesmo nível.
otNetifAddress	Essa estrutura representa um endereço unicast de interface de rede IPv6.
otNetifMulticastAddress	Essa estrutura representa um endereço multicast de interface de rede IPv6.
otSockAddr	Essa estrutura representa um endereço de soquete IPv6.

Sindicatos
otIp6InterfaceIdentifier:: OT_TOOL_PACKED_FIELD

Enumerações

enumeração anônima

 anonymous enum

Origens do endereço IPv6.

Propriedades
`OT_ADDRESS_ORIGIN_DHCPV6`	Endereço atribuído DHCPv6.
`OT_ADDRESS_ORIGIN_MANUAL`	Endereço atribuído manualmente.
`OT_ADDRESS_ORIGIN_SLAAC`	Endereço atribuído SLAAC.
`OT_ADDRESS_ORIGIN_THREAD`	Endereço atribuído à thread (ALOC, RLOC, MLEID, etc.)

enumeração anônima

 anonymous enum

Status ECN, representados como no cabeçalho IP.

Propriedades
`OT_ECN_CAPABLE_0`	ECT(0)
`OT_ECN_CAPABLE_1`	ECT(1)
`OT_ECN_MARKED`	Congestionamento encontrado (CE)
`OT_ECN_NOT_CAPABLE`	Não ECT.

enumeração anônima

 anonymous enum

Números de protocolo da Internet.

Propriedades
`OT_IP6_PROTO_DST_OPTS`	Opções de destino para IPv6.
`OT_IP6_PROTO_FRAGMENT`	Cabeçalho de fragmento para IPv6.
`OT_IP6_PROTO_HOP_OPTS`	Opção IPv6 Hop-by-Hop.
`OT_IP6_PROTO_ICMP6`	ICMP para IPv6.
`OT_IP6_PROTO_IP6`	Encapsulamento IPv6.
`OT_IP6_PROTO_NONE`	Sem próximo cabeçalho para IPv6.
`OT_IP6_PROTO_ROUTING`	Cabeçalho de roteamento para IPv6.
`OT_IP6_PROTO_TCP`	Protocolo de Controle de Transmissão.
`OT_IP6_PROTO_UDP`	Datagrama do usuário.

Typedefs

otIp6Address

struct otIp6Address otIp6Address

Essa estrutura representa um endereço IPv6.

otIp6AddressCallback

void(* otIp6AddressCallback)(const otIp6AddressInfo *aAddressInfo, bool aIsAdded, void *aContext)

Esse ponteiro de função é chamado quando um endereço IPv6 interno é adicionado ou removido.

Detalhes

Parâmetros

`[in] aAddressInfo`	Um ponteiro para as informações de endereço IPv6.
`[in] aIsAdded`	TRUE se o `aAddress` foi adicionado, FALSE se `aAddress` foi removido.
`[in] aContext`	Um ponteiro para o contexto específico do aplicativo.

otIp6AddressComponents

struct otIp6AddressComponents otIp6AddressComponents

Essa estrutura representa os componentes de um endereço IPv6.

otIp6AddressInfo

struct otIp6AddressInfo otIp6AddressInfo

otIp6InterfaceIdentifier

struct otIp6InterfaceIdentifier otIp6InterfaceIdentifier

Essa estrutura representa o Identificador de Interface de um endereço IPv6.

otIp6NetworkPrefix

struct otIp6NetworkPrefix otIp6NetworkPrefix

Essa estrutura representa o prefixo de rede de um endereço IPv6 (64 bits mais significativos do endereço).

otIp6Prefix

struct otIp6Prefix otIp6Prefix

Essa estrutura representa um prefixo IPv6.

otIp6ReceiveCallback

void(* otIp6ReceiveCallback)(otMessage *aMessage, void *aContext)

Este ponteiro de função é chamado quando um datagrama IPv6 é recebido.

Detalhes

Parâmetros

`[in] aMessage`	Um ponteiro para o buffer de mensagem que contém o datagrama IPv6 recebido. Essa função transfere a propriedade do `aMessage` para o destinatário do retorno de chamada. A mensagem deve ser liberada pelo receptor do retorno de chamada após ser processada (consulte otMessageFree() ).
`[in] aContext`	Um ponteiro para o contexto específico do aplicativo.

otIp6RegisterMulticastOuvintesCallback

void(* otIp6RegisterMulticastListenersCallback)(void *aContext, otError aError, uint8_t aMlrStatus, const otIp6Address *aFailedAddresses, uint8_t aFailedAddressNum)

Esse ponteiro de função é chamado com resultados de otIp6RegisterMulticastListeners .

Detalhes

Parâmetros

`[in] aContext`	Um ponteiro para o contexto do usuário.
`[in] aError`	OT_ERROR_NONE quando enviou com êxito MLR.req e recebeu MLR.rsp, OT_ERROR_RESPONSE_TIMEOUT quando falhou ao receber MLR.rsp, OT_ERROR_PARSE quando falhou ao analisar MLR.rsp.
`[in] aMlrStatus`	O status do Registro do Ouvinte de Multicast quando `aError` é OT_ERROR_NONE.
`[in] aFailedAddresses`	Um ponteiro para os endereços IPv6 com falha quando `aError` é OT_ERROR_NONE.
`[in] aFailedAddressNum`	O número de endereços IPv6 com falha quando `aError` é OT_ERROR_NONE.

Veja também:
otIp6RegisterMulticastListeners

otIp6SlaacPrefixFilter

bool(* otIp6SlaacPrefixFilter)(otInstance *aInstance, const otIp6Prefix *aPrefix)

Este ponteiro de função permite ao usuário filtrar prefixos e não permitir que um endereço SLAAC baseado em um prefixo seja adicionado.

otIp6SetSlaacPrefixFilter() pode ser usado para definir o manipulador de filtro. O manipulador de filtro é invocado pelo módulo SLAAC quando está prestes a adicionar um endereço SLAAC baseado em um prefixo. Seu valor de retorno booleano determina se o endereço é filtrado (não adicionado) ou não.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aPrefix`	Um ponteiro para prefixo para o qual o endereço SLAAC está prestes a ser adicionado.

Valores de retorno

`TRUE`	Indica que o endereço SLAAC baseado no prefixo deve ser filtrado e NÃO adicionado.
`FALSE`	Indica que o endereço SLAAC baseado no prefixo deve ser adicionado.

otMessageInfo

struct otMessageInfo otMessageInfo

Essa estrutura representa os endereços de soquete IPv6 locais e de mesmo nível.

otNetifAddress

struct otNetifAddress otNetifAddress

Essa estrutura representa um endereço unicast de interface de rede IPv6.

otNetifMulticastAddress

struct otNetifMulticastAddress otNetifMulticastAddress

Essa estrutura representa um endereço multicast de interface de rede IPv6.

otSockAddr

struct otSockAddr otSockAddr

Essa estrutura representa um endereço de soquete IPv6.

Variáveis

OT_TOOL_PACKED_END

OT_TOOL_PACKED_BEGIN struct otIp6InterfaceIdentifier OT_TOOL_PACKED_END

Funções

otIp6AddUnicastAddress

otError otIp6AddUnicastAddress(
  otInstance *aInstance,
  const otNetifAddress *aAddress
)

Adicione um endereço de interface de rede à interface de thread.

A instância aAddress é copiada pela interface Thread. A interface Thread suporta apenas um número fixo de endereços unicast adicionados externamente. Consulte OPENTHREAD_CONFIG_IP6_MAX_EXT_UCAST_ADDRS.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aAddress`	Um ponteiro para um endereço de interface de rede.

Valores de retorno

`OT_ERROR_NONE`	Adicionado com sucesso (ou atualizado) o endereço de interface de rede.
`OT_ERROR_INVALID_ARGS`	O endereço IP indicado por `aAddress` é um endereço interno.
`OT_ERROR_NO_BUFS`	A Interface de Rede já está armazenando o máximo de endereços externos permitidos.

otIp6AddUnsecurePort

otError otIp6AddUnsecurePort(
  otInstance *aInstance,
  uint16_t aPort
)

Esta função adiciona uma porta à lista de portas não seguras permitidas.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aPort`	O valor da porta.

Valores de retorno

`OT_ERROR_NONE`	A porta foi adicionada com sucesso à lista de portas não seguras permitidas.
`OT_ERROR_INVALID_ARGS`	A porta é inválida (o valor 0 é reservado para uso interno).
`OT_ERROR_NO_BUFS`	A lista de portas não seguras está cheia.

otIp6AddressFromString

otError otIp6AddressFromString(
  const char *aString,
  otIp6Address *aAddress
)

Essa função converte uma string de endereço IPv6 legível por humanos em uma representação binária.

Detalhes

Parâmetros

`[in] aString`	Um ponteiro para uma string terminada em NULL.
`[out] aAddress`	Um ponteiro para um endereço IPv6.

Valores de retorno

`OT_ERROR_NONE`	A string foi analisada com sucesso.
`OT_ERROR_INVALID_ARGS`	Falha ao analisar a string.

otIp6AddressToString

void otIp6AddressToString(
  const otIp6Address *aAddress,
  char *aBuffer,
  uint16_t aSize
)

Esta função converte um determinado endereço IPv6 em uma string legível.

A string de endereço IPv6 é formatada como 16 valores hexadecimais separados por ':' (ou seja, "%x:%x:%x:...:%x").

Se a string resultante não couber em aBuffer (dentro de seus caracteres aSize ), a string será truncada, mas a string de saída será sempre terminada em nulo.

Detalhes

Parâmetros

`[in] aAddress`	Um ponteiro para um endereço IPv6 (NÃO DEVE ser NULL).
`[out] aBuffer`	Um ponteiro para um array char para a saída da string (NÃO DEVE ser NULL).
`[in] aSize`	O tamanho de um `aBuffer` (em bytes). Recomendado para usar `OT_IP6_ADDRESS_STRING_SIZE` .

otIp6ArePrefixesEqual

bool otIp6ArePrefixesEqual(
  const otIp6Prefix *aFirst,
  const otIp6Prefix *aSecond
)

Teste se dois prefixos IPv6 são iguais.

Detalhes

Parâmetros

`[in] aFirst`	Um ponteiro para o primeiro prefixo IPv6 a ser comparado.
`[in] aSecond`	Um ponteiro para o segundo prefixo IPv6 a ser comparado.

Valores de retorno

`TRUE`	Os dois prefixos IPv6 são os mesmos.
`FALSE`	Os dois prefixos IPv6 não são os mesmos.

otIp6GetMulticastAddresses

const otNetifMulticastAddress * otIp6GetMulticastAddresses(
  otInstance *aInstance
)

Obtenha a lista de endereços multicast IPv6 inscritos na interface Thread.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Devoluções

Um ponteiro para o primeiro endereço multicast da interface de rede.

otIp6GetUnicastAddresses

const otNetifAddress * otIp6GetUnicastAddresses(
  otInstance *aInstance
)

Obtenha a lista de endereços IPv6 atribuídos à interface Thread.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Devoluções

Um ponteiro para o primeiro endereço de interface de rede.

otIp6GetUnsecurePorts

const uint16_t * otIp6GetUnsecurePorts(
  otInstance *aInstance,
  uint8_t *aNumEntries
)

Esta função retorna um ponteiro para a lista de portas não seguras.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[out] aNumEntries`	O número de entradas na lista.

Devoluções

Um ponteiro para a lista de portas não seguras.

otIp6IsAddressEqual

bool otIp6IsAddressEqual(
  const otIp6Address *aFirst,
  const otIp6Address *aSecond
)

Teste se dois endereços IPv6 são iguais.

Detalhes

Parâmetros

`[in] aFirst`	Um ponteiro para o primeiro endereço IPv6 a ser comparado.
`[in] aSecond`	Um ponteiro para o segundo endereço IPv6 a ser comparado.

Valores de retorno

`TRUE`	Os dois endereços IPv6 são os mesmos.
`FALSE`	Os dois endereços IPv6 não são os mesmos.

otIp6IsAddressUnspecified

bool otIp6IsAddressUnspecified(
  const otIp6Address *aAddress
)

Esta função indica se um determinado endereço IPv6 é ou não o endereço não especificado.

Detalhes

Parâmetros

[in] aAddress

Um ponteiro para um endereço IPv6.

Valores de retorno

`TRUE`	Se o endereço IPv6 for o endereço não especificado.
`FALSE`	Se o endereço IPv6 não for o endereço não especificado.

otIp6IsEnabled

bool otIp6IsEnabled(
  otInstance *aInstance
)

Esta função indica se a interface IPv6 está ativa ou não.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Valores de retorno

`TRUE`	A interface IPv6 está habilitada.
`FALSE`	A interface IPv6 está desabilitada.

otIp6IsMulticastPromiscuousEnabled

bool otIp6IsMulticastPromiscuousEnabled(
  otInstance *aInstance
)

Verifique se o modo promíscuo multicast está habilitado na interface Thread.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Veja também:
otIp6SetMulticastPromiscuousEnabled

otIp6IsReceiveFilterEnabled

bool otIp6IsReceiveFilterEnabled(
  otInstance *aInstance
)

Esta função indica se o tráfego de controle de thread é ou não filtrado ao entregar datagramas IPv6 por meio do retorno de chamada especificado em otIp6SetReceiveCallback() .

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

Devoluções

TRUE se o tráfego de controle de thread for filtrado, FALSE caso contrário.

Veja também:
otIp6SetReceiveCallback
otIp6SetReceiveFilterEnabled

otIp6IsSlaacEnabled

bool otIp6IsSlaacEnabled(
  otInstance *aInstance
)

Esta função indica se o módulo SLAAC está habilitado ou não.

Esta função requer que o recurso de tempo de construção OPENTHREAD_CONFIG_IP6_SLAAC_ENABLE esteja habilitado.

Detalhes

Valores de retorno

`TRUE`	O módulo SLAAC está habilitado.
`FALSE`	O módulo SLAAC está desabilitado.

otIp6NewMessage

otMessage * otIp6NewMessage(
  otInstance *aInstance,
  const otMessageSettings *aSettings
)

Aloque um novo buffer de mensagem para enviar uma mensagem IPv6.

Nota: Se aSettings for 'NULL', a segurança da camada de link será habilitada e a prioridade da mensagem será definida como OT_MESSAGE_PRIORITY_NORMAL por padrão.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aSettings`	Um ponteiro para as configurações de mensagem ou NULL para definir as configurações padrão.

Devoluções

Um ponteiro para o buffer de mensagem ou NULL se nenhum buffer de mensagem estiver disponível ou os parâmetros forem inválidos.

Veja também:
otMessageFree

otIp6NewMessageFromBuffer

otMessage * otIp6NewMessageFromBuffer(
  otInstance *aInstance,
  const uint8_t *aData,
  uint16_t aDataLength,
  const otMessageSettings *aSettings
)

Aloque um novo buffer de mensagem e grave o datagrama IPv6 no buffer de mensagem para enviar uma mensagem IPv6.

Nota: Se aSettings for NULL, a segurança da camada de link é habilitada e a prioridade da mensagem é obtida da própria mensagem IPv6. Se aSettings não for NULL, aSetting->mPriority será ignorado e obtido da própria mensagem IPv6.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aData`	Um ponteiro para o buffer de datagrama IPv6.
`[in] aDataLength`	O tamanho do buffer de datagrama IPv6 apontado por `aData` .
`[in] aSettings`	Um ponteiro para as configurações de mensagem ou NULL para definir as configurações padrão.

Devoluções

Um ponteiro para a mensagem ou NULL se o cabeçalho IPv6 malformado ou buffers de mensagem insuficientes estiverem disponíveis.

Veja também:
otMessageFree

otIp6PrefixMatch

uint8_t otIp6PrefixMatch(
  const otIp6Address *aFirst,
  const otIp6Address *aSecond
)

Esta função retorna o comprimento de correspondência de prefixo (bits) para dois endereços IPv6.

Detalhes

Parâmetros

`[in] aFirst`	Um ponteiro para o primeiro endereço IPv6.
`[in] aSecond`	Um ponteiro para o segundo endereço IPv6.

Devoluções

O prefixo corresponde ao comprimento em bits.

otIp6PrefixToString

void otIp6PrefixToString(
  const otIp6Prefix *aPrefix,
  char *aBuffer,
  uint16_t aSize
)

Esta função converte um determinado prefixo IPv6 em uma string legível.

A cadeia de endereços IPv6 é formatada como "%x:%x:%x:...[::]/plen".

Se a string resultante não couber em aBuffer (dentro de seus caracteres aSize ), a string será truncada, mas a string de saída será sempre terminada em nulo.

Detalhes

Parâmetros

`[in] aPrefix`	Um ponteiro para um prefixo IPv6 (NÃO DEVE ser NULL).
`[out] aBuffer`	Um ponteiro para um array char para a saída da string (NÃO DEVE ser NULL).
`[in] aSize`	O tamanho de um `aBuffer` (em bytes). Recomendado usar `OT_IP6_PREFIX_STRING_SIZE` .

otIp6ProtoToString

const char * otIp6ProtoToString(
  uint8_t aIpProto
)

Esta função converte um determinado número de protocolo IP em uma string legível.

Detalhes

Parâmetros

[in] aIpProto

Um número de protocolo IP (enumeração OT_IP6_PROTO_* ).

Devoluções

Uma string representando aIpProto .

otIp6RegisterMulticastListeners

otError otIp6RegisterMulticastListeners(
  otInstance *aInstance,
  const otIp6Address *aAddresses,
  uint8_t aAddressNum,
  const uint32_t *aTimeout,
  otIp6RegisterMulticastListenersCallback aCallback,
  void *aContext
)

Esta função registra ouvintes de multicast no roteador de backbone primário.

Observação: disponível apenas quando OPENTHREAD_CONFIG_TMF_PROXY_MLR_ENABLE e OPENTHREAD_CONFIG_COMMISSIONER_ENABLE estiverem ativados)

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aAddresses`	Um array de endereços multicast para registrar.
`[in] aAddressNum`	O número de Endereço Multicast a ser registrado (0 se `aAddresses` for NULL).
`[in] aTimeout`	Um ponteiro para o valor de tempo limite (em segundos) a ser incluído no MLR.req. Um valor de tempo limite de 0 remove o Multicast Listener correspondente. Se NULL, MLR.req não teria Timeout Tlv por padrão.
`[in] aCallback`	Um ponteiro para a função de retorno de chamada.
`[in] aContext`	Um ponteiro para o contexto do usuário.

Valores de retorno

`OT_ERROR_NONE`	MLR.req enviado com sucesso. O `aCallback` será chamado se este método retornar OT_ERROR_NONE.
`OT_ERROR_BUSY`	Se um registro anterior estava em andamento.
`OT_ERROR_INVALID_ARGS`	Se um ou mais argumentos forem inválidos.
`OT_ERROR_INVALID_STATE`	Se o dispositivo não estava em um estado válido para enviar MLR.req (por exemplo, comissário não iniciado, roteador de backbone primário não encontrado).
`OT_ERROR_NO_BUFS`	Se houver buffers de mensagens insuficientes disponíveis.

Veja também:
otIp6RegisterMulticastOuvintesCallback

otIp6RemoveAllUnsecurePorts

void otIp6RemoveAllUnsecurePorts(
  otInstance *aInstance
)

Esta função remove todas as portas da lista de portas não seguras permitidas.

Detalhes

Parâmetros

[in] aInstance

Um ponteiro para uma instância OpenThread.

otIp6RemoveUnicastAddress

otError otIp6RemoveUnicastAddress(
  otInstance *aInstance,
  const otIp6Address *aAddress
)

Remova um endereço de interface de rede da interface de thread.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aAddress`	Um ponteiro para um endereço IP.

Valores de retorno

`OT_ERROR_NONE`	Removido com sucesso o endereço da interface de rede.
`OT_ERROR_INVALID_ARGS`	O endereço IP indicado por `aAddress` é um endereço interno.
`OT_ERROR_NOT_FOUND`	O endereço IP indicado por `aAddress` não foi encontrado.

otIp6RemoveUnsecurePort

otError otIp6RemoveUnsecurePort(
  otInstance *aInstance,
  uint16_t aPort
)

Esta função remove uma porta da lista de portas não seguras permitidas.

Nota: Esta função remove aPort substituindo aPort pelo elemento após aPort na lista de portas internas. Tenha cuidado ao chamar otIp6GetUnsecurePorts() seguido de otIp6RemoveUnsecurePort() para remover portas não seguras.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aPort`	O valor da porta.

Valores de retorno

`OT_ERROR_NONE`	A porta foi removida com sucesso da lista de portas não seguras permitidas.
`OT_ERROR_INVALID_ARGS`	A porta é inválida (o valor 0 é reservado para uso interno).
`OT_ERROR_NOT_FOUND`	A porta não foi encontrada na lista de portas não seguras.

otIp6SelectSourceAddress

otError otIp6SelectSourceAddress(
  otInstance *aInstance,
  otMessageInfo *aMessageInfo
)

Esta função executa a seleção de endereço de origem OpenThread.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in,out] aMessageInfo`	Um ponteiro para as informações da mensagem.

Valores de retorno

`OT_ERROR_NONE`	Encontrou um endereço de origem e é preenchido em mSockAddr de `aMessageInfo` .
`OT_ERROR_NOT_FOUND`	Nenhum endereço de origem foi encontrado e `aMessageInfo` não foi alterado.

otIp6Send

otError otIp6Send(
  otInstance *aInstance,
  otMessage *aMessage
)

Esta função envia um datagrama IPv6 através da interface Thread.

O chamador transfere a propriedade de aMessage ao fazer esta chamada. O aMessage liberará uma mensagem quando o processamento for concluído, inclusive quando um valor diferente de OT_ERROR_NONE for retornado.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aMessage`	Um ponteiro para o buffer de mensagem que contém o datagrama IPv6.

Valores de retorno

`OT_ERROR_NONE`	A mensagem foi processada com sucesso.
`OT_ERROR_DROP`	A mensagem foi bem formada, mas não totalmente processada devido às regras de processamento de pacotes.
`OT_ERROR_NO_BUFS`	Não foi possível alocar os buffers de mensagem necessários ao processar o datagrama.
`OT_ERROR_NO_ROUTE`	Sem rota para hospedar.
`OT_ERROR_INVALID_SOURCE_ADDRESS`	O endereço de origem é inválido, por exemplo, um endereço anycast ou um endereço multicast.
`OT_ERROR_PARSE`	Encontrou um cabeçalho malformado ao processar a mensagem.

otIp6SetAddressCallback

void otIp6SetAddressCallback(
  otInstance *aInstance,
  otIp6AddressCallback aCallback,
  void *aCallbackContext
)

Esta função registra um retorno de chamada para notificar as alterações de endereços IPv6 internos.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aCallback`	Um ponteiro para uma função que é chamada quando um endereço IPv6 interno é adicionado ou removido. NULL para desabilitar o retorno de chamada.
`[in] aCallbackContext`	Um ponteiro para o contexto específico do aplicativo.

otIp6SetEnabled

otError otIp6SetEnabled(
  otInstance *aInstance,
  bool aEnabled
)

Esta função ativa/desativa a interface IPv6.

Chame esta função para ativar/desativar a comunicação IPv6.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aEnabled`	TRUE para habilitar IPv6, FALSE caso contrário.

Valores de retorno

`OT_ERROR_NONE`	Trouxe com sucesso a interface IPv6 para cima/baixo.
`OT_ERROR_INVALID_STATE`	A interface IPv6 não está disponível porque o dispositivo está operando no modo raw-link (aplicável somente quando o recurso `OPENTHREAD_CONFIG_LINK_RAW_ENABLE` está habilitado).

otIp6SetMeshLocalIid

otError otIp6SetMeshLocalIid(
  otInstance *aInstance,
  const otIp6InterfaceIdentifier *aIid
)

Esta função define o IID local da malha (para fins de teste).

Disponível apenas quando OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE está habilitado.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aIid`	Um ponteiro para o IID local da malha a ser definido.

Valores de retorno

`OT_ERROR_NONE`	Defina com êxito o IID local da malha.
`OT_ERROR_INVALID_STATE`	Os protocolos de thread estão ativados.

otIp6SetMulticastPromiscuousEnabled

void otIp6SetMulticastPromiscuousEnabled(
  otInstance *aInstance,
  bool aEnabled
)

Habilite o modo promíscuo multicast na interface Thread.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aEnabled`	TRUE para habilitar o modo Multicast Promíscuo, FALSE caso contrário.

Veja também:
otIp6IsMulticastPromiscuousEnabled

otIp6SetReceiveCallback

void otIp6SetReceiveCallback(
  otInstance *aInstance,
  otIp6ReceiveCallback aCallback,
  void *aCallbackContext
)

Esta função registra um retorno de chamada para fornecer datagramas IPv6 recebidos.

Por padrão, esse retorno de chamada não passa o tráfego de controle de thread. Consulte otIp6SetReceiveFilterEnabled() para alterar a configuração do filtro de tráfego de controle de thread.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aCallback`	Um ponteiro para uma função que é chamada quando um datagrama IPv6 é recebido ou NULL para desabilitar o retorno de chamada.
`[in] aCallbackContext`	Um ponteiro para o contexto específico do aplicativo.

Veja também:
otIp6IsReceiveFilterEnabled
otIp6SetReceiveFilterEnabled

otIp6SetReceiveFilterEnabled

void otIp6SetReceiveFilterEnabled(
  otInstance *aInstance,
  bool aEnabled
)

Essa função define se o tráfego de controle de thread é filtrado ou não ao entregar datagramas IPv6 por meio do retorno de chamada especificado em otIp6SetReceiveCallback() .

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aEnabled`	TRUE se o tráfego de controle de thread for filtrado, FALSE caso contrário.

Veja também:
otIp6SetReceiveCallback
otIsReceiveIp6FilterEnabled

otIp6SetSlaacEnabled

void otIp6SetSlaacEnabled(
  otInstance *aInstance,
  bool aEnabled
)

Esta função habilita/desabilita o módulo SLAAC.

Esta função requer que o recurso de tempo de construção OPENTHREAD_CONFIG_IP6_SLAAC_ENABLE esteja habilitado.

Quando o módulo SLAAC está habilitado, os endereços SLAAC (com base em prefixos em malha em Dados de rede) são adicionados à interface. Quando o módulo SLAAC é desabilitado, qualquer endereço SLAAC adicionado anteriormente é removido.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aEnabled`	TRUE para habilitar, FALSE para desabilitar.

otIp6SetSlaacPrefixFilter

void otIp6SetSlaacPrefixFilter(
  otInstance *aInstance,
  otIp6SlaacPrefixFilter aFilter
)

Esta função define o manipulador de filtro do módulo SLAAC.

Esta função requer que o recurso de tempo de construção OPENTHREAD_CONFIG_IP6_SLAAC_ENABLE esteja habilitado.

O manipulador de filtro é chamado pelo módulo SLAAC quando está prestes a adicionar um endereço SLAAC baseado em um prefixo para decidir se o endereço deve ser adicionado ou não.

Um manipulador de filtro NULL desabilita a filtragem e permite que todos os endereços SLAAC sejam adicionados.

Se esta função não for chamada, o filtro padrão usado pelo módulo SLAAC será NULL (a filtragem está desabilitada).

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aFilter`	Um ponteiro para o manipulador de filtro de prefixo SLAAC ou NULL para desabilitar a filtragem.

otIp6SockAddrToString

void otIp6SockAddrToString(
  const otSockAddr *aSockAddr,
  char *aBuffer,
  uint16_t aSize
)

Essa função converte um determinado endereço de soquete IPv6 em uma string legível.

A string de endereço de soquete IPv6 é formatada como "[

]: " onde `

é mostrado como 16 valores hexadecimais separados por ':' e é o número da porta em formato decimal (ou seja, "[%x:%x:...:%x]:%u")

Se a string resultante não couber em aBuffer (dentro de seus caracteres aSize ), a string será truncada, mas a string de saída será sempre terminada em nulo.

Detalhes

Parâmetros

`[in] aSockAddr`	Um ponteiro para um endereço de soquete IPv6 (NÃO DEVE ser NULL).
`[out] aBuffer`	Um ponteiro para um array char para a saída da string (NÃO DEVE ser NULL).
`[in] aSize`	O tamanho de um `aBuffer` (em bytes). Recomendado usar `OT_IP6_SOCK_ADDR_STRING_SIZE` .

otIp6SubscribeMulticastAddress

otError otIp6SubscribeMulticastAddress(
  otInstance *aInstance,
  const otIp6Address *aAddress
)

Assine a interface Thread para um endereço de multicast de interface de rede.

O aAddress passado na instância será copiado pela interface Thread. A interface Thread suporta apenas um número fixo de endereços multicast adicionados externamente. Consulte OPENTHREAD_CONFIG_IP6_MAX_EXT_MCAST_ADDRS.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aAddress`	Um ponteiro para um endereço IP.

Valores de retorno

`OT_ERROR_NONE`	Assinado com sucesso para o endereço multicast da interface de rede.
`OT_ERROR_ALREADY`	O endereço multicast já está inscrito.
`OT_ERROR_INVALID_ARGS`	O endereço IP indicado por `aAddress` é um endereço multicast inválido.
`OT_ERROR_REJECTED`	O endereço IP indicado por `aAddress` é um endereço multicast interno.
`OT_ERROR_NO_BUFS`	A Interface de Rede já está armazenando o máximo de endereços multicast externos permitidos.

otIp6UnsubscribeMulticastAddress

otError otIp6UnsubscribeMulticastAddress(
  otInstance *aInstance,
  const otIp6Address *aAddress
)

Cancele a assinatura da interface Thread para um endereço multicast de interface de rede.

Detalhes

Parâmetros

`[in] aInstance`	Um ponteiro para uma instância OpenThread.
`[in] aAddress`	Um ponteiro para um endereço IP.

Valores de retorno

`OT_ERROR_NONE`	A assinatura do endereço multicast da interface de rede foi cancelada com êxito.
`OT_ERROR_REJECTED`	O endereço IP indicado por `aAddress` é um endereço interno.
`OT_ERROR_NOT_FOUND`	O endereço IP indicado por `aAddress` não foi encontrado.

Macros

OT_IP6_ADDRESS_SIZE

 OT_IP6_ADDRESS_SIZE 16

Tamanho de um endereço IPv6 (bytes)

OT_IP6_ADDRESS_STRING_SIZE

 OT_IP6_ADDRESS_STRING_SIZE 40

Tamanho recomendado para representação de string de um endereço IPv6.

OT_IP6_IID_SIZE

 OT_IP6_IID_SIZE 8

Tamanho de um identificador de interface IPv6 (bytes)

OT_IP6_PREFIX_BITSIZE

 OT_IP6_PREFIX_BITSIZE (OT_IP6_PREFIX_SIZE * 8)

Tamanho de um prefixo IPv6 (bits)

OT_IP6_PREFIX_SIZE

 OT_IP6_PREFIX_SIZE 8

Tamanho de um prefixo IPv6 (bytes)

OT_IP6_PREFIX_STRING_SIZE

 OT_IP6_PREFIX_STRING_SIZE 45

Tamanho recomendado para representação de string de um prefixo IPv6.

OT_IP6_SOCK_ADDR_STRING_SIZE

 OT_IP6_SOCK_ADDR_STRING_SIZE 48

Tamanho recomendado para representação de string de um endereço de soquete IPv6.

Recursos

Os tópicos de referência da API OpenThread se originam do código-fonte, disponível no GitHub . Para obter mais informações ou contribuir com nossa documentação, consulte Recursos .

IPv6

Resumo

Enumerações

Typedefs

Variáveis

Funções

Estruturas

Sindicatos

Enumerações

enumeração anônima

enumeração anônima

enumeração anônima

Typedefs

otIp6Address

otIp6AddressCallback

otIp6AddressComponents

otIp6AddressInfo

otIp6InterfaceIdentifier

otIp6NetworkPrefix

otIp6Prefix

otIp6ReceiveCallback

otIp6RegisterMulticastOuvintesCallback

otIp6SlaacPrefixFilter

otMessageInfo

otNetifAddress

otNetifMulticastAddress

otSockAddr

Variáveis

OT_TOOL_PACKED_END

Funções

otIp6AddUnicastAddress

otIp6AddUnsecurePort

otIp6AddressFromString

otIp6AddressToString

otIp6ArePrefixesEqual

otIp6GetMulticastAddresses

otIp6GetUnicastAddresses

otIp6GetUnsecurePorts

otIp6IsAddressEqual

otIp6IsAddressUnspecified

otIp6IsEnabled

otIp6IsMulticastPromiscuousEnabled

otIp6IsReceiveFilterEnabled

otIp6IsSlaacEnabled

otIp6NewMessage

otIp6NewMessageFromBuffer

otIp6PrefixMatch

otIp6PrefixToString

otIp6ProtoToString

otIp6RegisterMulticastListeners

otIp6RemoveAllUnsecurePorts

otIp6RemoveUnicastAddress

otIp6RemoveUnsecurePort

otIp6SelectSourceAddress

otIp6Send

otIp6SetAddressCallback

otIp6SetEnabled

otIp6SetMeshLocalIid

otIp6SetMulticastPromiscuousEnabled

otIp6SetReceiveCallback

otIp6SetReceiveFilterEnabled

otIp6SetSlaacEnabled

otIp6SetSlaacPrefixFilter

otIp6SockAddrToString

otIp6SubscribeMulticastAddress

otIp6UnsubscribeMulticastAddress

Macros

OT_IP6_ADDRESS_SIZE

OT_IP6_ADDRESS_STRING_SIZE

OT_IP6_IID_SIZE

OT_IP6_PREFIX_BITSIZE

OT_IP6_PREFIX_SIZE

OT_IP6_PREFIX_STRING_SIZE

OT_IP6_SOCK_ADDR_STRING_SIZE

Recursos