fuchsia.net.stackmigrationdeprecated

Provides facilities for migrating from Netstack2 to Netstack3.

This library provides the protocols necessary to conduct the network stack migration to the newer version. It will be removed as soon as migration is completed across all users, and it's not intended to be used beyond that.

At the time of its introduction there aren't platform-wide mechanisms to achieve this, so this one-off library was created to achieve the migration goals.

It should not be extended to serve other uses and, if there appears a central platform-wide mechanism to achieve this before migration is fully completed it might be deleted before then.

PROTOCOLS

Control

Defined in fuchsia.net.stackmigrationdeprecated/stackmigrationdeprecated.fidl

Provides access to controlling netstack migration configuration.

SetAutomatedNetstackVersion

Sets the automated target network stack version.

Takes effect on next boot.

• request version requested network stack version. If unset, the automated version preference is cleared.

Request

Name	Type
version	VersionSetting?

Response

<EMPTY>

SetUserNetstackVersion

Sets user selection target network stack version.

Takes effect on next boot.

If set, the user netstack version preference always takes precedence over the automated version selection.

• request version requested network stack version. If unset, the user version preference is cleared.

Request

Name	Type
version	VersionSetting?

Response

<EMPTY>

State

Defined in fuchsia.net.stackmigrationdeprecated/stackmigrationdeprecated.fidl

Provides access to reading netstack migration configuration.

GetNetstackVersion

Gets the target network stack version.

• response in_effect_version the configurations currently in effect.

Request

<EMPTY>

Response

Name	Type
in_effect_version	InEffectVersion

STRUCTS

InEffectVersion

Defined in fuchsia.net.stackmigrationdeprecated/stackmigrationdeprecated.fidl

Field	Type	Description	Default
current_boot	NetstackVersion	The value of the netstack version setting at boot time. This reflects the currently running netstack.	No default
automated	VersionSetting?	The automated netstack version selected. If set and no user version is set, it'll be applied on next boot. This reflects the last applied configuration through Control.SetAutomatedNetstackVersion.	No default
user	VersionSetting?	The user netstack version selected. If set, it'll be applied on next boot. The user version always takes predence over the automated version. This reflects the last applied configuration through Control.SetUserNetstackVersion.	No default

VersionSetting

Defined in fuchsia.net.stackmigrationdeprecated/stackmigrationdeprecated.fidl

A wrapper type around NetstackVersion providing optionality for Control methods.

Field	Type	Description	Default
version	NetstackVersion		No default

ENUMS

NetstackVersion strict

Type: uint32

Defined in fuchsia.net.stackmigrationdeprecated/stackmigrationdeprecated.fidl

Known Network Stack versions.

Name	Value	Description
NETSTACK2	1
NETSTACK3	2