提供從 Netstack2 遷移至 Netstack3 所需的設施。
這個程式庫提供將網路堆疊遷移至較新版本所需的通訊協定。所有使用者的遷移作業完成後,我們就會立即移除 GCC,因此這份 API 不應用於他途。
這項功能推出時,由於沒有平台通用的機制來達成這個目標,因此我們建立了這個一次性程式庫來達成遷移目標。
不應擴充為提供其他用途;如果能在遷移作業完全完成前,透過中央平台機制達成此目標,則可能會在此之前刪除。
專家
控制選項
定義於 fuchsia.net.stackmigrationDeprecatedd/stackmigrationDeprecatedd.fidl
提供控管 netstack 遷移設定的權限。
設定 AutomatedNetstackVersion
設定自動目標網路堆疊版本。
會在下次開機時生效。
- 要求 version要求的網路堆疊版本。如未設定,系統會自動清除自動化版本偏好設定。
要求
| 名稱 | 類型 | 
|---|---|
| version | VersionSetting? | 
回應
<空白>
SetUserNetstackVersion
設定使用者選取的目標網路堆疊版本。
會在下次開機時生效。
如果已設定,則使用者 netstack 版本偏好設定的優先順序一律高於自動選取版本。
- 要求 version要求的網路堆疊版本。如果未設定,系統會清除使用者版本偏好設定。
要求
| 名稱 | 類型 | 
|---|---|
| version | VersionSetting? | 
回應
<空白>
狀態
定義於 fuchsia.net.stackmigrationDeprecatedd/stackmigrationDeprecatedd.fidl
提供 Netstack 遷移設定的讀取權限。
取得網路堆疊版本
取得目標網路堆疊版本。
- 回應 in_effect_version表示目前有效的設定。
要求
<空白>
回應
| 名稱 | 類型 | 
|---|---|
| in_effect_version | InEffectVersion | 
結構
作用版本
定義於 fuchsia.net.stackmigrationDeprecatedd/stackmigrationDeprecatedd.fidl
| 欄位 | 類型 | 說明 | 預設 | 
|---|---|---|---|
| current_boot | NetstackVersion | 啟動時的 netstack 版本設定值。這會反映目前執行的 netstack。 | 無預設 | 
| automated | VersionSetting? | 已選取自動化 Netstack 版本。如果已設定且未設定  | 無預設 | 
| user | VersionSetting? | 已選取使用者 Netstack 版本。設定完成後,系統會在下次啟動時套用。 | 無預設 | 
版本設定
定義於 fuchsia.net.stackmigrationDeprecatedd/stackmigrationDeprecatedd.fidl
NetstackVersion 周圍的包裝函式類型,為 Control 方法提供選用性。
| 欄位 | 類型 | 說明 | 預設 | 
|---|---|---|---|
| version | NetstackVersion | 無預設 | 
表情符號
NetstackVersion strict
類型:uint32
定義於 fuchsia.net.stackmigrationDeprecatedd/stackmigrationDeprecatedd.fidl
已知的網路堆疊版本。
| 名稱 | 值 | 說明 | 
|---|---|---|
| NETSTACK2 | 1 | |
| NETSTACK3 | 2 |