專家
狀態
定義於 fuchsia.net.interfaces/interfaces.fidl
網路介面狀態檢查與觀察。
GetWatcher
初始化介面狀態監看工具。
伺服器會將介面新增、刪除和屬性變更排入佇列,接著您可以透過管道的通訊協定擷取這些異動。
- 要求
options
會指定監看工具的行為。 - 要求
watcher
將存取權授予「Watcher」。如果伺服器無法分配佇列或佇列已滿,則會關閉佇列。
要求
名稱 | 類型 |
---|---|
options |
WatcherOptions
|
watcher |
server_end<Watcher>
|
Watcher
定義於 fuchsia.net.interfaces/interfaces.fidl
用於變更網路介面的觀測器通訊協定 (新增、刪除及介面屬性變更)。
觀看
請稍候,進行介面新增/刪除變更。
用戶端一次只能呼叫此方法;如果呼叫尚在待處理作業期間,再次呼叫這個方法,便會關閉通訊協定的伺服器端。
如果通訊協定的伺服器端初始化時存在 N 個介面,則此方法的第一個 N 叫用會傳回 Event.existing,後面接著單一 Event.idle,表示所有現有介面皆已傳送。如果要回報的變更,後續的呼叫會立即傳回,或是封鎖直到變更發生為止。
伺服器可能會選擇隱藏屬性變更事件,例如發生多個獨立的屬性變更時。因此,用戶端不能假設他們觀察介面變更的順序,就是變更發生的順序。
- 回應
event
介面變更事件。
要求
<EMPTY>
回應
名稱 | 類型 |
---|---|
event |
Event
|
結構
空白
定義於 fuchsia.net.interfaces/interfaces.fidl
<EMPTY>
表情符號
AddressAssignmentState 嚴格
類型:uint32
定義於 fuchsia.net.interfaces/interfaces.fidl
IP 位址的指派狀態。
名稱 | 值 | 說明 |
---|---|---|
帳篷 |
1 |
指派位址正在進行中,例如:執行重複的位址偵測。無法在這個狀態下使用位址 (目前無法繫結至該位址或接收目的地為該位址的封包)。 重複地址偵測機制的說明請參閱 RFC 4862 的第 5.4 節。 |
已指派 |
2 |
系統會將地址指派給介面。 |
無法使用 |
3 |
無法使用位址,例如保留位址的介面處於離線狀態。 |
資料表
地址
定義於 fuchsia.net.interfaces/interfaces.fidl
序數 | 欄位 | 類型 | 說明 |
---|---|---|---|
1 |
addr |
fuchsia.net/Subnet
|
位址和前置字串長度。 必填。 |
2 |
valid_until |
zx/Time
|
該時間過後,地址就會失效。 其值必須大於 0。如果值為 這個值是 選填;系統可能會因為不感興趣而省略。 |
3 |
preferred_lifetime_info |
PreferredLifetimeInfo
|
偏好的生命週期資訊。 選填;系統可能會因為不感興趣而省略。 已新增:9
|
4 |
assignment_state |
AddressAssignmentState
|
地址的指派狀態。 必填。 已新增:HEAD
|
屬性
定義於 fuchsia.net.interfaces/interfaces.fidl
網路介面的屬性。
序數 | 欄位 | 類型 | 說明 |
---|---|---|---|
1 |
id |
fuchsia.net/InterfaceId
|
介面的不透明 ID。即使裝置已移除再重新加入,也不會重複使用該值。無法變更。 |
2 |
addresses |
vector<Address>
|
介面目前安裝的位址。 地址會在 Address.addr 上排序,且兩個位址不能有相同的 除非將 WatcherOptions.include_non_assigned_addresses 設為 |
3 |
online |
bool
|
裝置已啟用,且裝置已連上網路。 |
4 |
device_class |
DeviceClass
|
介面的裝置類別。無法變更。 |
5 |
has_default_ipv4_route |
bool
|
是否有通過這個介面的預設 IPv4 路徑。 |
6 |
has_default_ipv6_route |
bool
|
是否有通過這個介面的預設 IPv6 路徑。 |
7 |
name |
Name
|
介面的名稱。無法變更。 |
WatcherOptions
定義於 fuchsia.net.interfaces/interfaces.fidl
序數 | 欄位 | 類型 | 說明 |
---|---|---|---|
1 |
address_properties_interest |
AddressPropertiesInterest
|
用來註冊位址屬性的位元欄位。 選用;如果沒有,則會解讀為所有位元都會設為 0。 已新增:HEAD
|
2 |
include_non_assigned_addresses |
bool
|
判斷是否只傳回指派的地址 (指派狀態為 AddressAssignmentState::Assigned) 或所有地址的標記。 選用;如果沒有,則解讀為 false。 已新增:HEAD
|
聯合國
DeviceClass 嚴格
定義於 fuchsia.net.interfaces/interfaces.fidl
序數 | Variant | 類型 | 說明 |
---|---|---|---|
1 |
loopback |
Empty
|
介面是回送。 |
2 |
device |
fuchsia.hardware.network/DeviceClass
|
介面的網路裝置類別。 |
活動嚴格
定義於 fuchsia.net.interfaces/interfaces.fidl
序數 | Variant | 類型 | 說明 |
---|---|---|---|
1 |
existing |
Properties
|
開始觀看時出現的介面屬性。 已設定所有相關欄位和 Properties.id。 |
2 |
added |
Properties
|
觀看時新增的介面屬性。 已設定所有相關欄位和 Properties.id。 |
3 |
removed |
fuchsia.net/InterfaceId
|
觀看時遭到移除的介面 ID。 |
4 |
changed |
Properties
|
觀看影片時變更的介面屬性。 只有 Properties.id 和已變更的欄位,才會設為新值。 |
5 |
idle |
Empty
|
PreferredLifetimeInfo 嚴格
定義於 fuchsia.net.interfaces/interfaces.fidl
有關 IP 位址或委派前置字串的偏好生命週期資訊。
序數 | Variant | 類型 | 說明 |
---|---|---|---|
1 |
preferred_until |
zx/Time
|
偏好的生命週期結束。 如果 偏好的位址生命週期定義請參閱 RFC 4862 的第 2 節。 根據 RFC 8415 第 6.3 節的規定,使用委派前置字串設定的地址的偏好生命週期必須不超過該前置字串的效期。 (必須大於 0)。如果設為 |
2 |
deprecated |
Empty
|
地址/前置字元已淘汰。 除非有明確要求,或沒有指派其他未淘汰的位址 (如 RFC 4862 第 1 節所述),否則不應再使用已淘汰的位址來啟動新的連線。 使用已淘汰的委派前置字串設定的地址也必須根據 RFC 8415 第 6.3 節淘汰。 如果其偏好的生命週期延長,位址/前置字元可能會變成未淘汰的項目。 |
節拍
AddressPropertiesInterest 彈性
類型:uint64
定義於 fuchsia.net.interfaces/interfaces.fidl
名稱 | 值 | 說明 |
---|---|---|
VALID_UNTIL |
1 | |
PREFERRED_LIFETIME_INFO |
2 |
場景
名稱 | 值 | 類型 | 說明 |
---|---|---|---|
INTERFACE_NAME_LENGTH |
15
|
uint8 |
介面名稱的長度上限。 |
別名
名稱 | 值 | 說明 |
---|---|---|
名稱 |
string [INTERFACE_NAME_LENGTH ] |
以位元組序列表示的介面名稱。 |