提供从 Netstack2 迁移到 Netstack3 的工具。
此库提供了将网络栈迁移到较新版本所需的协议。一旦所有用户完成迁移,该功能就会被移除,并且不打算在此之后继续使用。
在该库推出时,尚无平台级机制来实现此目的,因此创建了此一次性库来实现迁移目标。
不应将其扩展到其他用途,如果在迁移完全完成之前出现实现此目的的中央平台级机制,则可能会在此之前将其删除。
协议
对照组
在 fuchsia.net.stackmigrationdeprecated/stackmigrationdeprecated.fidl 中定义
提供对控制网络堆栈迁移配置的访问权限。
SetAutomatedNetstackVersion
设置自动目标网络栈版本。
将在下次启动时生效。
- 请求
version请求的网络栈版本。如果未设置,则系统会清除自动化版本偏好设置。
请求
| 名称 | 类型 |
|---|---|
version |
VersionSetting?
|
响应
<EMPTY>
SetUserNetstackVersion
设置用户选择的目标网络栈版本。
将在下次启动时生效。
如果设置了此政策,用户的网络堆栈版本偏好设置始终优先于自动版本选择。
- 请求
version请求的网络栈版本。如果未设置,系统会清除用户版本偏好设置。
请求
| 名称 | 类型 |
|---|---|
version |
VersionSetting?
|
响应
<EMPTY>
状态
在 fuchsia.net.stackmigrationdeprecated/stackmigrationdeprecated.fidl 中定义
提供对读取 netstack 迁移配置的访问权限。
GetNetstackVersion
获取目标网络栈版本。
- 响应
in_effect_version当前生效的配置。
请求
<EMPTY>
响应
| 名称 | 类型 |
|---|---|
in_effect_version |
InEffectVersion
|
STRUCTS
InEffectVersion
在 fuchsia.net.stackmigrationdeprecated/stackmigrationdeprecated.fidl 中定义
| 字段 | 类型 | 说明 | 默认 |
|---|---|---|---|
current_boot |
NetstackVersion
|
启动时网络堆栈版本设置的值。这反映了当前正在运行的网络堆栈。 |
无默认应用 |
automated |
VersionSetting?
|
所选的自动化网络堆栈版本。如果设置了此政策,但未设置 |
无默认应用 |
user |
VersionSetting?
|
所选的用户网络栈版本。如果设置,则会在下次启动时应用。 |
无默认应用 |
VersionSetting
在 fuchsia.net.stackmigrationdeprecated/stackmigrationdeprecated.fidl 中定义
NetstackVersion 的封装容器类型,为 Control 方法提供可选性。
| 字段 | 类型 | 说明 | 默认 |
|---|---|---|---|
version |
NetstackVersion
|
无默认应用 |
枚举
NetstackVersion strict
类型:uint32
在 fuchsia.net.stackmigrationdeprecated/stackmigrationdeprecated.fidl 中定义
已知网络栈版本。
| 名称 | 值 | 说明 |
|---|---|---|
NETSTACK2 |
1 |
|
NETSTACK3 |
2 |