fuchsia.net.stackmigrationdepredd

提供從 Netstack2 遷移至 Netstack3 的功能。

這個程式庫提供必要的通訊協定，可將網路堆疊遷移至新版本。所有使用者完成遷移後，系統就會移除這項功能，不會再提供使用。

推出時，並沒有全平台機制可達成此目的，因此我們建立了這個一次性程式庫，以達成遷移目標。

不應擴充用於其他用途，且如果在遷移完全完成前，出現全平台適用的中央機制來達成此目的，則可能會在此之前刪除。

通訊協定

控管

定義於 fuchsia.net.stackmigrationdeprecated/stackmigrationdeprecated.fidl

可控管網路堆疊遷移設定。

SetAutomatedNetstackVersion

設定自動目標網路堆疊版本。

下次啟動時生效。

• 要求 version 要求的網路堆疊版本。如未設定，系統會清除自動版本偏好設定。

要求

名稱	類型
version	VersionSetting?

回應

<EMPTY>

SetUserNetstackVersion

設定使用者選取的目標網路堆疊版本。

下次啟動時生效。

如果設定，使用者網路堆疊版本偏好設定一律優先於自動版本選取。

• 要求 version 要求的網路堆疊版本。如未設定，系統會清除使用者版本偏好設定。

要求

名稱	類型
version	VersionSetting?

回應

<EMPTY>

狀態

定義於 fuchsia.net.stackmigrationdeprecated/stackmigrationdeprecated.fidl

可讀取網路堆疊遷移設定。

GetNetstackVersion

取得目標網路堆疊版本。

• 回應in_effect_version目前生效的設定。

要求

<EMPTY>

回應

名稱	類型
in_effect_version	InEffectVersion

STRUCTS

InEffectVersion

定義於 fuchsia.net.stackmigrationdeprecated/stackmigrationdeprecated.fidl

欄位	類型	說明	預設
current_boot	NetstackVersion	開機時的網路堆疊版本設定值。這反映了目前執行的網路堆疊。	無預設值
automated	VersionSetting?	選取的自動化網路堆疊版本。如果已設定，但未設定 user 版本，則會在下次啟動時套用。這會反映透過 Control.SetAutomatedNetstackVersion 套用的最新設定。	無預設值
user	VersionSetting?	使用者選取的網路堆疊版本。設定後，系統會在下次啟動時套用。user 版本的優先順序一律高於 automated 版本。這反映了上次透過 Control.SetUserNetstackVersion 套用的設定。	無預設值

VersionSetting

定義於 fuchsia.net.stackmigrationdeprecated/stackmigrationdeprecated.fidl

NetstackVersion 的包裝函式類型，提供 Control 方法的選用性。

欄位	類型	說明	預設
version	NetstackVersion		無預設值

列舉

NetstackVersion strict

類型：uint32

定義於 fuchsia.net.stackmigrationdeprecated/stackmigrationdeprecated.fidl

已知的網路堆疊版本。

名稱	值	說明
NETSTACK2	1
NETSTACK3	2