Google 致力于为黑人社区推动种族平等。查看具体举措。

此页面由 Cloud Translation API 翻译。

nl::Inet::RawEndPoint

#include <src/inet/RawEndPoint.h>

此类的对象表示原始 IP 网络端点。

摘要

Nest Inet 层封装了与 IP 网络端点（Linux 和 BSD 衍生系统上的 SOCK_RAW 套接字）或 LwIP 原始协议控制块（如果系统进行了相应配置）交互的方法。

继承

公共属性
`IPProto`	`IPProtocol` 互联网控制消息协议 (ICMP)
`IPVer`	`IPVersion` 互联网协议的版本。

公共函数
`Bind(IPAddressType addrType, IPAddress addr, InterfaceId intfId)`	`INET_ERROR` 将端点绑定到接口 IP 地址。
`BindIPv6LinkLocal(InterfaceId intf, IPAddress addr)`	`INET_ERROR` 将原始端点绑定到指定接口索引处的 IPv6 链路本地范围地址。
`BindInterface(IPAddressType addrType, InterfaceId intf)`	`INET_ERROR` 将端点绑定到网络接口。
`Close(void)`	`void` 关闭端点。
`Free(void)`	`void` 关闭端点并回收其内存。
`GetBoundInterface(void)`	`InterfaceId` 获取此端点上的绑定接口。
`Listen(void)`	`INET_ERROR` 准备端点以接收 ICMP 消息。
`SendMsg(const IPPacketInfo pktInfo, Weave::System::PacketBuffer msg, uint16_t sendFlags)`	`INET_ERROR` 向指定目的地发送 ICMP 消息。
`SendTo(IPAddress addr, Weave::System::PacketBuffer *msg, uint16_t sendFlags)`	`INET_ERROR` `SendTo(addr, INET_NULL_INTERFACEID, msg, sendFlags)` 的同义词。
`SendTo(IPAddress addr, InterfaceId intfId, Weave::System::PacketBuffer *msg, uint16_t sendFlags)`	`INET_ERROR` 向指定的目标地址发送 ICMP 消息。
`SetICMPFilter(uint8_t numICMPTypes, const uint8_t *aICMPTypes)`	`INET_ERROR` 在网络堆栈中设置 ICMP6 过滤器参数。

公共属性

IPProto

IPProtocol IPProto

互联网控制消息协议 (ICMP)

虽然此字段是可变类变量，但该类是不可修改的类的不变性。

IP 验证

IPVersion IPVer

互联网协议的版本。

虽然此字段是可变类变量，但该类是不可修改的类的不变性。

公共函数

绑定

INET_ERROR Bind(
  IPAddressType addrType,
  IPAddress addr,
  InterfaceId intfId
)

将端点绑定到接口 IP 地址。

将端点绑定到指定的网络接口 IP 地址。

详细信息

参数

`[in] addrType`	IP 地址的协议版本
`[in] addr`	IP 地址（必须是接口地址）
`[in] intfId`	可选的网络接口指示器

返回值

`INET_NO_ERROR`	成功：端点已绑定到地址
`INET_ERROR_INCORRECT_STATE`	端点之前
`INET_NO_MEMORY`	端点内存不足
`INET_ERROR_UNKNOWN_INTERFACE`	在某些平台上，选择性指定的接口不存在。
`INET_ERROR_WRONG_PROTOCOL_TYPE`	`addrType` 与 `IPVer` 不匹配。
`INET_ERROR_WRONG_ADDRESS_TYPE`	`addrType` 为 `kIPAddressType_Any`，或者 `addr` 的类型不等于 `addrType`。
`other`	其他系统或平台错误

在 LwIP 上，不得使用已获取的 LwIP 堆栈锁调用此方法。

BindIPv6LinkLocal

INET_ERROR BindIPv6LinkLocal(
  InterfaceId intf,
  IPAddress addr
)

将原始端点绑定到指定接口索引处的 IPv6 链路本地范围地址。

此外，还会设置各种 IPv6 套接字选项，适合在链路目的地与链路目的地之间传输数据包。

将端点绑定到 intf 所指示网络接口上的 IPv6 链路本地地址 addr。

详细信息

参数

`[in] intf`	用于标识地址范围的 InterfaceId。
`[in] addr`	IPv6 链路本地范围 IPAddress 对象。

参数

`[in] intf`	网络接口的指示器
`[in] addr`	IP 地址（必须是接口地址）

返回值

`INET_NO_ERROR`	成功：端点已绑定到地址
`INET_ERROR_INCORRECT_STATE`	端点之前
`INET_NO_MEMORY`	端点内存不足
`INET_ERROR_WRONG_PROTOCOL_TYPE`	`addrType` 与 `IPVer` 不匹配。
`INET_ERROR_WRONG_ADDRESS_TYPE`	`addr` 不是 IPv6 链路本地地址或 `intf` 为 `INET_NULL_INTERFACEID`。
`other`	其他系统或平台错误

返回值

INET_NO_ERROR（成功时）或映射的操作系统错误（失败时）。无效参数列表会导致 INET_ERROR_WRONG_ADDRESS_TYPE。如果原始端点已绑定或正在监听，则返回 INET_ERROR_INCORRECT_STATE。将端点绑定到接口 IPv6 链路本地地址。

在 LwIP 上，不得使用已获取的 LwIP 堆栈锁调用此方法。

BindInterface

INET_ERROR BindInterface(
  IPAddressType addrType,
  InterfaceId intf
)

将端点绑定到网络接口。

将端点绑定到指定的网络接口 IP 地址。

详细信息

参数

`[in] addrType`	IP 地址的协议版本。
`[in] intf`	网络接口的指示器

返回值

`INET_NO_ERROR`	成功：端点已绑定到地址
`INET_NO_MEMORY`	端点内存不足
`INET_ERROR_NOT_IMPLEMENTED`	系统实现未完成。
`INET_ERROR_UNKNOWN_INTERFACE`	在某些平台上，该接口不存在。
`other`	其他系统或平台错误

在 LwIP 上，不得使用已获取的 LwIP 堆栈锁调用此方法。

关闭

void Close(
  void
)

关闭端点。

如果为 mState != kState_Closed，则关闭端点，并将其从符合通信事件条件的一组端点中移除。

在 LwIP 系统中，不得使用已获取的 LwIP 堆栈锁调用此方法。

免费

void Free(
  void
)

关闭端点并回收其内存。

调用 Close 方法，然后调用 InetLayerBasis::Release 方法将对象返回到其内存池。

在 LwIP 系统中，不得使用已获取的 LwIP 堆栈锁调用此方法。

GetBoundInterface

InterfaceId GetBoundInterface(
  void
)

获取此端点上的绑定接口。

详细信息
返回值	InterfaceId。绑定的接口 ID。

收听

INET_ERROR Listen(
  void
)

准备端点以接收 ICMP 消息。

如果 mState 已经为 kState_Listening，则不执行任何操作，否则 mState 会设置为 kState_Listening，并且端点会根据平台的语义准备好接收 ICMPv6 消息。

详细信息

返回值

INET_NO_ERROR

始终返回。

在 LwIP 上，不得使用已获取的 LwIP 堆栈锁调用此方法

SendMsg

INET_ERROR SendMsg(
  const IPPacketInfo *pktInfo,
  Weave::System::PacketBuffer *msg,
  uint16_t sendFlags
)

向指定目的地发送 ICMP 消息。

 Send the ICMP message \c msg using the destination information given in \c addr.

 Where (sendFlags & kSendFlag_RetainBuffer) != 0, calls
 Weave::System::PacketBuffer::Free on behalf of the caller, otherwise this
 method deep-copies \c msg into a fresh object, and queues that for
 transmission, leaving the original \c msg available after return.

详细信息

参数

`[in] pktInfo`	邮件的目标位置信息
`[in] msg`	包含 UDP 消息的数据包缓冲区
`[in] sendFlags`	可选的传输选项标志

返回值

`INET_NO_ERROR`	成功：`msg` 已加入传输队列。
`INET_ERROR_NOT_SUPPORTED`	系统不支持请求的操作。
`INET_ERROR_WRONG_ADDRESS_TYPE`	目标地址和绑定的接口地址没有匹配的协议版本或地址类型。
`INET_ERROR_MESSAGE_TOO_LONG`	`msg` 不包含完整的 ICMP 消息。
`INET_ERROR_OUTBOUND_MESSAGE_TRUNCATED`	在一些平台上，只有 `msg` 的截断部分会排队等待传输。
`other`	其他系统或平台错误

SendTo

INET_ERROR SendTo(
  IPAddress addr,
  Weave::System::PacketBuffer *msg,
  uint16_t sendFlags
)

SendTo(addr, INET_NULL_INTERFACEID, msg, sendFlags) 的同义词。

SendTo

INET_ERROR SendTo(
  IPAddress addr,
  InterfaceId intfId,
  Weave::System::PacketBuffer *msg,
  uint16_t sendFlags
)

向指定的目标地址发送 ICMP 消息。

 Send the ICMP message in \c msg to the destination given in \c addr.

 Where (sendFlags & kSendFlag_RetainBuffer) != 0, calls
 Weave::System::PacketBuffer::Free on behalf of the caller, otherwise this
 method deep-copies \c msg into a fresh object, and queues that for
 transmission, leaving the original \c msg available after return.

详细信息

参数

`[in] addr`	目标 IP 地址
`[in] intfId`	可选的网络接口指示器
`[in] msg`	包含 UDP 消息的数据包缓冲区
`[in] sendFlags`	可选的传输选项标志

返回值

`INET_NO_ERROR`	成功：`msg` 已加入传输队列。
`INET_ERROR_NOT_SUPPORTED`	系统不支持请求的操作。
`INET_ERROR_WRONG_ADDRESS_TYPE`	目标地址和绑定的接口地址没有匹配的协议版本或地址类型。
`INET_ERROR_MESSAGE_TOO_LONG`	`msg` 不包含完整的 ICMP 消息。
`INET_ERROR_OUTBOUND_MESSAGE_TRUNCATED`	在一些平台上，只有 `msg` 的截断部分会排队等待传输。
`other`	其他系统或平台错误

SetICMPFilter

INET_ERROR SetICMPFilter(
  uint8_t numICMPTypes,
  const uint8_t *aICMPTypes
)

在网络堆栈中设置 ICMP6 过滤器参数。

将 aICMPTypes 中代码的 ICMPv6 过滤参数应用到系统网络堆栈中的底层端点。

详细信息

参数

`[in] numICMPTypes`	位于 `aICMPTypes` 的数组长度
`[in] aICMPTypes`	要过滤的 ICMPv6 类型代码集。

返回值

`INET_NO_ERROR`	成功：已设置过滤条件参数
`INET_ERROR_NOT_IMPLEMENTED`	系统未实现
`INET_ERROR_WRONG_ADDRESS_TYPE`	端点不是 IPv6 类型
`INET_ERROR_WRONG_PROTOCOL_TYPE`	端点不是 ICMP6 类型
`other`	其他系统或平台错误