fuchsia.posix.socket.packet

新增時間：11 張

通訊協定

供應商

定義於 fuchsia.posix.socket.packet/socket.fidl

封包通訊端供應商。

通訊端

要求封包通訊端。

  • 要求 kind 要建立的封包種類。
  • 回應 socket。

要求

名稱類型
kind Kind

回應

名稱類型
payload Provider_Socket_Result

通訊端

定義於 fuchsia.posix.socket.packet/socket.fidl

封包通訊端。

這個介面基本上是 POSIX。

這個類型的所有方法都是非封鎖方法；其確切行為與 Linux 對應項目相符。

警告：這個通訊協定尚未準備好直接供用戶端使用。用戶端應改用 BSD 通訊端 API 與通訊端互動。 我們計劃大幅變更此通訊協定，且與此通訊協定直接結合的用戶端會讓這些變更更加困難。

裝訂

將通訊端繫結至通訊協定和/或介面。

  • 要求 protocol 通訊端的新通訊協定關聯。
  • 要求 bound_interface_id 通訊端的新介面繫結。

要求

名稱類型
protocol ProtocolAssociation?
bound_interface_id BoundInterfaceId

回應

名稱類型
payload Socket_Bind_Result

Clone2

要求

名稱類型
request server_end<fuchsia.unknown/Cloneable>

關閉

終止連線。

呼叫 Close 後，用戶端不得傳送任何其他要求。

伺服器在傳送狀態回應後，無論狀態為何或不傳送連續指令，都應關閉連線。

關閉管道的用戶端，在語意上應等同於呼叫 Close，且不知道關閉程序何時完成或狀態。

要求

<EMPTY>

回應

名稱類型
payload fuchsia.unknown/Closeable_Close_Result

說明

要求

<EMPTY>

回應

名稱類型
payload SocketDescribeResponse

GetAcceptConn

取得 SOL_SOCKET -> SO_ACCEPTCONN。

要求

<EMPTY>

回應

名稱類型
payload fuchsia.posix.socket/BaseSocket_GetAcceptConn_Result

GetBindToDevice

取得 SOL_SOCKET -> SO_BINDTODEVICE。

要求

<EMPTY>

回應

名稱類型
payload fuchsia.posix.socket/BaseSocket_GetBindToDevice_Result

GetBindToInterfaceIndex

取得 SOL_SOCKET -> SO_BINDTOIFINDEX。

新增日期：20 位

要求

<EMPTY>

回應

名稱類型
payload fuchsia.posix.socket/BaseSocket_GetBindToInterfaceIndex_Result

GetBroadcast

取得 SOL_SOCKET -> SO_BROADCAST。

要求

<EMPTY>

回應

名稱類型
payload fuchsia.posix.socket/BaseSocket_GetBroadcast_Result

GetError

取得 SOL_SOCKET -> SO_ERROR。如果通訊端設定錯誤，則傳回最後一個錯誤。

要求

<EMPTY>

回應

名稱類型
payload fuchsia.posix.socket/BaseSocket_GetError_Result

GetInfo

傳回通訊端的屬性。

  • 回應 kind 通訊端的 Kind。
  • 回應 protocol 通訊端的通訊協定關聯 (如有相關)。
  • 通訊端介面繫結的回應 bound_interface 屬性。

要求

<EMPTY>

回應

名稱類型
payload Socket_GetInfo_Result

GetKeepAlive

取得 SOL_SOCKET -> SO_KEEPALIVE。

要求

<EMPTY>

回應

名稱類型
payload fuchsia.posix.socket/BaseSocket_GetKeepAlive_Result

GetLinger

取得 SOL_SOCKET -> SO_LINGER。

要求

<EMPTY>

回應

名稱類型
payload fuchsia.posix.socket/BaseSocket_GetLinger_Result

GetMark

例如獲得 SOL_SOCKET -> SO_MARK。主要的差別在於，與標準 SO_MARK 不同的是，這個 API 有多個標記網域，且每個網域均可分別擷取每個標記。

已新增：HEAD

要求

名稱類型
domain fuchsia.posix.socket/MarkDomain

回應

名稱類型
payload fuchsia.posix.socket/BaseSocket_GetMark_Result

GetNoCheck

取得 SOL_SOCKET -> SO_NO_CHECK。

要求

<EMPTY>

回應

名稱類型
payload fuchsia.posix.socket/BaseSocket_GetNoCheck_Result

GetOutOfBandInline

取得 SOL_SOCKET -> SO_OOBINLINE。

要求

<EMPTY>

回應

名稱類型
payload fuchsia.posix.socket/BaseSocket_GetOutOfBandInline_Result

GetReceiveBuffer

取得 SOL_SOCKET -> SO_RCVBUF。

要求

<EMPTY>

回應

名稱類型
payload fuchsia.posix.socket/BaseSocket_GetReceiveBuffer_Result

GetReuseAddress

取得 SOL_SOCKET -> SO_REUSEADDR。

要求

<EMPTY>

回應

名稱類型
payload fuchsia.posix.socket/BaseSocket_GetReuseAddress_Result

GetReusePort

取得 SOL_SOCKET -> SO_REUSEPORT。

要求

<EMPTY>

回應

名稱類型
payload fuchsia.posix.socket/BaseSocket_GetReusePort_Result

GetSendBuffer

取得 SOL_SOCKET -> SO_SNDBUF。

要求

<EMPTY>

回應

名稱類型
payload fuchsia.posix.socket/BaseSocket_GetSendBuffer_Result

GetTimestamp

取得 SOL_SOCKET -> SO_TIMESTAMP 或 SO_TIMESTAMPNS。

要求

<EMPTY>

回應

名稱類型
payload fuchsia.posix.socket/BaseSocket_GetTimestamp_Result

查詢

要求

<EMPTY>

回應

名稱類型
protocol vector<uint8>

RecvMsg

接收來自通訊端的訊息。

  • 要求 want_packet_info 要求傳回封包的相關資訊。
  • 要求 data_len 回應資料緩衝區的長度上限。
  • 要求 want_control 要求傳回輔助資料。
  • 要求 flags 旗標。
  • 封包相關 packet_info 資訊 (如果系統要求的話)。
  • 回覆 data 訊息。
  • 回應 control 控制訊息 (如有要求)。
  • 回應 truncated 會指出傳回的訊息是否遭到截斷。

要求

名稱類型
want_packet_info bool
data_len uint32
want_control bool
flags fuchsia.posix.socket/RecvMsgFlags

回應

名稱類型
payload Socket_RecvMsg_Result

SendMsg

透過通訊端傳送訊息。

  • 要求有關封包的 packet_info 資訊。
  • 要求 data 訊息。
  • 要求 control 輔助資料。
  • 要求 flags 旗標。

要求

名稱類型
packet_info PacketInfo?
data vector<uint8>
control SendControlData
flags fuchsia.posix.socket/SendMsgFlags

回應

名稱類型
payload Socket_SendMsg_Result

SetBindToDevice

設定 SOL_SOCKET -> SO_BINDTODEVICE。

要求

名稱類型
value fuchsia.net.interfaces/Name

回應

名稱類型
payload fuchsia.posix.socket/BaseSocket_SetBindToDevice_Result

SetBindToInterfaceIndex

設定 SOL_SOCKET -> SO_BINDTOIFINDEX。如果 value 為 0，則會清除繫結介面。

新增日期：20 位

要求

名稱類型
value fuchsia.net/InterfaceId

回應

名稱類型
payload fuchsia.posix.socket/BaseSocket_SetBindToInterfaceIndex_Result

SetBroadcast

設定 SOL_SOCKET -> SO_BROADCAST。

要求

名稱類型
value bool

回應

名稱類型
payload fuchsia.posix.socket/BaseSocket_SetBroadcast_Result

SetKeepAlive

設定 SOL_SOCKET -> SO_KEEPALIVE。

要求

名稱類型
value bool

回應

名稱類型
payload fuchsia.posix.socket/BaseSocket_SetKeepAlive_Result

SetLinger

設定 SOL_SOCKET -> SO_LINGER。

要求

名稱類型
linger bool
length_secs uint32

回應

名稱類型
payload fuchsia.posix.socket/BaseSocket_SetLinger_Result

SetMark

例如設定 SOL_SOCKET -> SO_MARK 設定。主要差別在於，與標準 SO_MARK 不同的是，這個 API 有多個標記網域，且每個網域可分別設定。

已新增：HEAD

要求

名稱類型
domain fuchsia.posix.socket/MarkDomain
mark fuchsia.posix.socket/OptionalUint32

回應

名稱類型
payload fuchsia.posix.socket/BaseSocket_SetMark_Result

SetNoCheck

設定 SOL_SOCKET -> SO_NO_CHECK。

要求

名稱類型
value bool

回應

名稱類型
payload fuchsia.posix.socket/BaseSocket_SetNoCheck_Result

SetOutOfBandInline

設定 SOL_SOCKET -> SO_OOBINLINE。

要求

名稱類型
value bool

回應

名稱類型
payload fuchsia.posix.socket/BaseSocket_SetOutOfBandInline_Result

SetReceiveBuffer

設定 SOL_SOCKET -> SO_RCVBUF。

要求

名稱類型
value_bytes uint64

回應

名稱類型
payload fuchsia.posix.socket/BaseSocket_SetReceiveBuffer_Result

SetReuseAddress

設定 SOL_SOCKET -> SO_REUSEADDR。

要求

名稱類型
value bool

回應

名稱類型
payload fuchsia.posix.socket/BaseSocket_SetReuseAddress_Result

SetReusePort

設定 SOL_SOCKET -> SO_REUSEPORT。

要求

名稱類型
value bool

回應

名稱類型
payload fuchsia.posix.socket/BaseSocket_SetReusePort_Result

SetSendBuffer

設定 SOL_SOCKET -> SO_SNDBUF。

要求

名稱類型
value_bytes uint64

回應

名稱類型
payload fuchsia.posix.socket/BaseSocket_SetSendBuffer_Result

SetTimestamp

設定 SOL_SOCKET -> SO_TIMESTAMP 或 SO_TIMESTAMPNS。

要求

名稱類型
value fuchsia.posix.socket/TimestampOption

回應

名稱類型
payload fuchsia.posix.socket/BaseSocket_SetTimestamp_Result

結構化

空白

定義於 fuchsia.posix.socket.packet/socket.fidl

<EMPTY>

InterfaceProperties

定義於 fuchsia.posix.socket.packet/socket.fidl

介面的屬性。

廣闊類型說明預設
id fuchsia.net/InterfaceId

介面的 ID。

 無預設
addr HardwareAddress

介面的硬體位址。

 無預設
type HardwareType

介面的硬體類型。

 無預設

PacketInfo

定義於 fuchsia.posix.socket.packet/socket.fidl

封包相關資訊。

廣闊類型說明預設
protocol Protocol 無預設
interface_id fuchsia.net/InterfaceId 無預設
addr HardwareAddress 無預設

Provider_Socket_Response 資源

定義於 fuchsia.posix.socket.packet/socket.fidl

廣闊類型說明預設
socket Socket 無預設

RecvPacketInfo

定義於 fuchsia.posix.socket.packet/socket.fidl

廣闊類型說明預設
packet_info PacketInfo 無預設
packet_type PacketType 無預設
interface_type HardwareType 無預設

Socket_Bind_Response

定義於 fuchsia.posix.socket.packet/socket.fidl

<EMPTY>

Socket_GetInfo_Response

定義於 fuchsia.posix.socket.packet/socket.fidl

廣闊類型說明預設
kind Kind 無預設
protocol ProtocolAssociation? 無預設
bound_interface BoundInterface 無預設

Socket_RecvMsg_Response

定義於 fuchsia.posix.socket.packet/socket.fidl

廣闊類型說明預設
packet_info RecvPacketInfo? 無預設
data vector<uint8> 無預設
control RecvControlData 無預設
truncated uint32 無預設

Socket_SendMsg_Response

定義於 fuchsia.posix.socket.packet/socket.fidl

<EMPTY>

ENUMS

HardwareType strict

類型：uint32

定義於 fuchsia.posix.socket.packet/socket.fidl

硬體的類型。

名稱物超所值說明
1

僅在網路層運作的硬體；純 L3 介面。

這類硬體沒有 L2 標頭/位址。
2

透過乙太網路連結運作的硬體。
3

循環封包的硬體。

種類：嚴格

類型：uint32

定義於 fuchsia.posix.socket.packet/socket.fidl

一種封包通訊端。

名稱物超所值說明
1

透過網路層封包運作的封包通訊端。

封包類型 嚴格

類型：uint32

定義於 fuchsia.posix.socket.packet/socket.fidl

封包的類型。

名稱物超所值說明
1

傳送至目的地的封包。
2

已廣播的封包。
3

多點傳播的封包。
4

已抵達主機但非目的地的封包。
5

無論傳送方式為何 (單點傳播、多點傳播、廣播)，在本機介面傳送的封包。

資料表

RecvControlData

定義於 fuchsia.posix.socket.packet/socket.fidl

序數廣闊類型說明
socket fuchsia.posix.socket/SocketRecvControlData

通訊端層級的輔助資料。

SendControlData

定義於 fuchsia.posix.socket.packet/socket.fidl

序數廣闊類型說明
socket fuchsia.posix.socket/SocketSendControlData

通訊端層級的輔助資料。

Socket DescriptionResponse 資源

定義於 fuchsia.posix.socket.packet/socket.fidl

序數廣闊類型說明
event handle<eventpair>

傳送通訊端狀態的其他資訊，例如完備性或關閉狀態。

聯合國

BoundInterface 嚴格

定義於 fuchsia.posix.socket.packet/socket.fidl

序數Variant類型說明
all Empty
specified InterfaceProperties

BoundInterfaceId 嚴格

定義於 fuchsia.posix.socket.packet/socket.fidl

序數Variant類型說明
all Empty
specified fuchsia.net/InterfaceId

HardwareAddress 彈性

定義於 fuchsia.posix.socket.packet/socket.fidl

硬體位址。

序數Variant類型說明
none Empty

表示硬體不支援連結層定址。
eui48 fuchsia.net/MacAddress

EUI-48 地址。

通訊協定關聯嚴格

定義於 fuchsia.posix.socket.packet/socket.fidl

封包通訊端的通訊協定關聯。

序數Variant類型說明
all Empty

與所有通訊協定的關聯。
specified Protocol

與通訊協定的關聯。

Provider_Socket_Result 嚴格 資源

定義於 fuchsia.posix.socket.packet/socket.fidl

序數Variant類型說明
response Provider_Socket_Response
err fuchsia.posix/Errno

Socket_Bind_Result 嚴格

定義於 fuchsia.posix.socket.packet/socket.fidl

序數Variant類型說明
response Socket_Bind_Response
err fuchsia.posix/Errno

Socket_GetInfo_Result 嚴格

定義於 fuchsia.posix.socket.packet/socket.fidl

序數Variant類型說明
response Socket_GetInfo_Response
err fuchsia.posix/Errno

Socket_RecvMsg_Result 嚴格

定義於 fuchsia.posix.socket.packet/socket.fidl

序數Variant類型說明
response Socket_RecvMsg_Response
err fuchsia.posix/Errno

Socket_SendMsg_Result 嚴格

定義於 fuchsia.posix.socket.packet/socket.fidl

序數Variant類型說明
response Socket_SendMsg_Response
err fuchsia.posix/Errno

業者

名稱物超所值類型說明
SOCKET_PROTOCOL_NAME fuchsia.posix.socket.packet/Socket String

別名

名稱物超所值說明
通訊協定 uint16

網路層通訊協定 (連結層上方)。

值由 https://www.iana.org/assignments/ieee-802-numbers/ieee-802-numbers.xhtml 定義。