通訊協定
供應商
定義於 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
。
要求
<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 有多個標記網域,且每個網域均可分別擷取每個標記。
要求
名稱 | 類型 |
---|---|
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,則會清除繫結介面。
要求
名稱 | 類型 |
---|---|
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 有多個標記網域,且每個網域可分別設定。
要求
名稱 | 類型 |
---|---|
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
硬體的類型。
名稱 | 物超所值 | 說明 |
---|---|---|
NETWORK_ONLY |
1 |
僅在網路層運作的硬體;純 L3 介面。 這類硬體沒有 L2 標頭/位址。 |
皮革 |
2 |
透過乙太網路連結運作的硬體。 |
循環播放 |
3 |
循環封包的硬體。 |
種類:嚴格
類型:uint32
定義於 fuchsia.posix.socket.packet/socket.fidl
一種封包通訊端。
名稱 | 物超所值 | 說明 |
---|---|---|
網路 |
1 |
透過網路層封包運作的封包通訊端。 |
連結 |
2 |
透過連結層封包運作的封包通訊端。 當封包通訊端出現這種類型時,系統會在電線和用戶端之間傳遞未經修改的封包。 |
封包類型 嚴格
類型:uint32
定義於 fuchsia.posix.socket.packet/socket.fidl
封包的類型。
名稱 | 物超所值 | 說明 |
---|---|---|
主機 |
1 |
傳送至目的地的封包。 |
廣播 |
2 |
已廣播的封包。 |
多廣播 |
3 |
多點傳播的封包。 |
OTHER_HOST |
4 |
已抵達主機但非目的地的封包。 |
外出 |
5 |
無論傳送方式為何 (單點傳播、多點傳播、廣播),在本機介面傳送的封包。 |
資料表
RecvControlData
定義於 fuchsia.posix.socket.packet/socket.fidl
序數 | 廣闊 | 類型 | 說明 |
---|---|---|---|
1 |
socket |
fuchsia.posix.socket/SocketRecvControlData
|
通訊端層級的輔助資料。 |
SendControlData
定義於 fuchsia.posix.socket.packet/socket.fidl
序數 | 廣闊 | 類型 | 說明 |
---|---|---|---|
1 |
socket |
fuchsia.posix.socket/SocketSendControlData
|
通訊端層級的輔助資料。 |
Socket DescriptionResponse 資源
定義於 fuchsia.posix.socket.packet/socket.fidl
序數 | 廣闊 | 類型 | 說明 |
---|---|---|---|
1 |
event |
handle<eventpair>
|
傳送通訊端狀態的其他資訊,例如完備性或關閉狀態。 |
聯合國
BoundInterface 嚴格
定義於 fuchsia.posix.socket.packet/socket.fidl
序數 | Variant | 類型 | 說明 |
---|---|---|---|
1 |
all |
Empty
|
|
2 |
specified |
InterfaceProperties
|
BoundInterfaceId 嚴格
定義於 fuchsia.posix.socket.packet/socket.fidl
序數 | Variant | 類型 | 說明 |
---|---|---|---|
1 |
all |
Empty
|
|
2 |
specified |
fuchsia.net/InterfaceId
|
HardwareAddress 彈性
定義於 fuchsia.posix.socket.packet/socket.fidl
硬體位址。
序數 | Variant | 類型 | 說明 |
---|---|---|---|
1 |
none |
Empty
|
表示硬體不支援連結層定址。 |
2 |
eui48 |
fuchsia.net/MacAddress
|
EUI-48 地址。 |
通訊協定關聯嚴格
定義於 fuchsia.posix.socket.packet/socket.fidl
封包通訊端的通訊協定關聯。
序數 | Variant | 類型 | 說明 |
---|---|---|---|
1 |
all |
Empty
|
與所有通訊協定的關聯。 |
2 |
specified |
Protocol
|
與通訊協定的關聯。 |
Provider_Socket_Result 嚴格 資源
定義於 fuchsia.posix.socket.packet/socket.fidl
序數 | Variant | 類型 | 說明 |
---|---|---|---|
1 |
response |
Provider_Socket_Response
|
|
2 |
err |
fuchsia.posix/Errno
|
Socket_Bind_Result 嚴格
定義於 fuchsia.posix.socket.packet/socket.fidl
序數 | Variant | 類型 | 說明 |
---|---|---|---|
1 |
response |
Socket_Bind_Response
|
|
2 |
err |
fuchsia.posix/Errno
|
Socket_GetInfo_Result 嚴格
定義於 fuchsia.posix.socket.packet/socket.fidl
序數 | Variant | 類型 | 說明 |
---|---|---|---|
1 |
response |
Socket_GetInfo_Response
|
|
2 |
err |
fuchsia.posix/Errno
|
Socket_RecvMsg_Result 嚴格
定義於 fuchsia.posix.socket.packet/socket.fidl
序數 | Variant | 類型 | 說明 |
---|---|---|---|
1 |
response |
Socket_RecvMsg_Response
|
|
2 |
err |
fuchsia.posix/Errno
|
Socket_SendMsg_Result 嚴格
定義於 fuchsia.posix.socket.packet/socket.fidl
序數 | Variant | 類型 | 說明 |
---|---|---|---|
1 |
response |
Socket_SendMsg_Response
|
|
2 |
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 定義。 |