提供从 Netstack2 迁移到 Netstack3 的工具。
此库提供了将网络堆栈迁移到较新版本所需的协议。一旦所有用户完成迁移,系统就会立即移除此 ID,除此之外,此方案仅作用于其他用途。
在推出之时,没有任何平台范围的机制可以实现这一点,因此这个一次性库的创建目的就是为了实现迁移目标。
不应将其扩展以服务于其他用途。如果在迁移工作完全完成之前,存在一个平台级的集中机制来实现此目标,系统可能会在迁移完成之前将其删除。
协议
控制
在 fuchsia.net.stackmigrationDeprecated/stackmigrationdeprecation.fidl 中定义
提供控制 netstack 迁移配置的访问权限。
SetAutomaticNetstackVersion
设置自动目标网络堆栈版本。
在下次启动时生效。
- 请求
version
请求的网络堆栈版本。如果未设置,系统会清除自动版本偏好设置。
请求
名称 | 类型 |
---|---|
version |
VersionSetting?
|
回复
<空>
SetUserNetstackVersion
设置用户选择目标网络堆栈版本。
在下次启动时生效。
如果设置了此字段,则用户 netstack 版本偏好设置始终优先于自动版本选择。
- 请求
version
请求的网络堆栈版本。如果未设置,用户版本偏好设置将被清除。
请求
名称 | 类型 |
---|---|
version |
VersionSetting?
|
回复
<空>
状态
在 fuchsia.net.stackmigrationDeprecated/stackmigrationdeprecation.fidl 中定义
提供读取 netstack 迁移配置的权限。
GetNetstackVersion
获取目标网络堆栈版本。
- 响应
in_effect_version
当前有效的配置。
请求
<空>
回复
名称 | 类型 |
---|---|
in_effect_version |
InEffectVersion
|
结构
影响版本
在 fuchsia.net.stackmigrationDeprecated/stackmigrationdeprecation.fidl 中定义
字段 | 类型 | 说明 | 默认 |
---|---|---|---|
current_boot |
NetstackVersion
|
启动时 netstack 版本设置的值。它反映了当前正在运行的 netstack。 |
无默认值 |
automated |
VersionSetting?
|
所选的自动化 netstack 版本。如果此政策已设置,但未设置 |
无默认值 |
user |
VersionSetting?
|
选择的用户 netstack 版本。如果设置此参数,它将在下次启动时应用。 |
无默认值 |
版本设置
在 fuchsia.net.stackmigrationDeprecated/stackmigrationdeprecation.fidl 中定义
围绕 NetstackVersion 的封装容器类型,为 Control 方法提供可选性。
字段 | 类型 | 说明 | 默认 |
---|---|---|---|
version |
NetstackVersion
|
无默认值 |
枚举
NetstackVersion 严格
类型:uint32
在 fuchsia.net.stackmigrationDeprecated/stackmigrationdeprecation.fidl 中定义
已知的网络堆栈版本。
名称 | 值 | 说明 |
---|---|---|
NETSTACK2 |
1 |
|
NETSTACK3 |
2 |