Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit e1a23d32 authored by Benedict Wong's avatar Benedict Wong Committed by Automerger Merge Worker
Browse files

Merge "Add additional javadoc for VcnManager" am: ba3f1179 

Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/1458805

MUST ONLY BE SUBMITTED BY AUTOMERGER

Change-Id: I1ff8fc52a979c2a4f68340f60e055323802182b0
parents dc69815d ba3f1179

core/java/android/net/vcn/VcnManager.java

+24 −0
Original line number Diff line number Diff line
@@ -30,6 +30,30 @@ import java.io.IOException; 
/**

 * VcnManager publishes APIs for applications to configure and manage Virtual Carrier Networks.

 *

 * <p>A VCN creates a virtualization layer to allow MVNOs to aggregate heterogeneous physical

 * networks, unifying them as a single carrier network. This enables infrastructure flexibility on

 * the part of MVNOs without impacting user connectivity, abstracting the physical network

 * technologies as an implementation detail of their public network.

 *

 * <p>Each VCN virtualizes an Carrier's network by building tunnels to a carrier's core network over

 * carrier-managed physical links and supports a IP mobility layer to ensure seamless transitions

 * between the underlying networks. Each VCN is configured based on a Subscription Group (see {@link

 * android.telephony.SubscriptionManager}) and aggregates all networks that are brought up based on

 * a profile or suggestion in the specified Subscription Group.

 *

 * <p>The VCN can be configured to expose one or more {@link android.net.Network}(s), each with

 * different capabilities, allowing for APN virtualization.

 *

 * <p>If a tunnel fails to connect, or otherwise encounters a fatal error, the VCN will attempt to

 * reestablish the connection. If the tunnel still has not reconnected after a system-determined

 * timeout, the VCN Safe Mode (see below) will be entered.

 *

 * <p>The VCN Safe Mode ensures that users (and carriers) have a fallback to restore system

 * connectivity to update profiles, diagnose issues, contact support, or perform other remediation

 * tasks. In Safe Mode, the system will allow underlying cellular networks to be used as default.

 * Additionally, during Safe Mode, the VCN will continue to retry the connections, and will

 * automatically exit Safe Mode if all active tunnels connect successfully.

 *

 * @hide

 */

@SystemService(Context.VCN_MANAGEMENT_SERVICE)