| /* |
| * Copyright (C) 2019 The Android Open Source Project |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| package android.net.util; |
| |
| import android.net.TetherStatsParcel; |
| import android.net.TetheringRequestParcel; |
| import android.util.Log; |
| |
| import androidx.annotation.NonNull; |
| |
| import com.android.networkstack.tethering.TetherStatsValue; |
| |
| import java.io.FileDescriptor; |
| import java.net.Inet6Address; |
| import java.net.SocketException; |
| import java.net.UnknownHostException; |
| import java.util.Arrays; |
| import java.util.Objects; |
| |
| /** |
| * The classes and the methods for tethering utilization. |
| * |
| * {@hide} |
| */ |
| public class TetheringUtils { |
| static { |
| System.loadLibrary("tetherutilsjni"); |
| } |
| |
| public static final byte[] ALL_NODES = new byte[] { |
| (byte) 0xff, 2, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1 |
| }; |
| |
| /** |
| * Configures a socket for receiving and sending ICMPv6 neighbor advertisments. |
| * @param fd the socket's {@link FileDescriptor}. |
| */ |
| public static native void setupNaSocket(FileDescriptor fd) |
| throws SocketException; |
| |
| /** |
| * Configures a socket for receiving and sending ICMPv6 neighbor solicitations. |
| * @param fd the socket's {@link FileDescriptor}. |
| */ |
| public static native void setupNsSocket(FileDescriptor fd) |
| throws SocketException; |
| |
| /** |
| * The object which records offload Tx/Rx forwarded bytes/packets. |
| * TODO: Replace the inner class ForwardedStats of class OffloadHardwareInterface with |
| * this class as well. |
| */ |
| public static class ForwardedStats { |
| public final long rxBytes; |
| public final long rxPackets; |
| public final long txBytes; |
| public final long txPackets; |
| |
| public ForwardedStats() { |
| rxBytes = 0; |
| rxPackets = 0; |
| txBytes = 0; |
| txPackets = 0; |
| } |
| |
| public ForwardedStats(long rxBytes, long txBytes) { |
| this.rxBytes = rxBytes; |
| this.rxPackets = 0; |
| this.txBytes = txBytes; |
| this.txPackets = 0; |
| } |
| |
| public ForwardedStats(long rxBytes, long rxPackets, long txBytes, long txPackets) { |
| this.rxBytes = rxBytes; |
| this.rxPackets = rxPackets; |
| this.txBytes = txBytes; |
| this.txPackets = txPackets; |
| } |
| |
| public ForwardedStats(@NonNull TetherStatsParcel tetherStats) { |
| rxBytes = tetherStats.rxBytes; |
| rxPackets = tetherStats.rxPackets; |
| txBytes = tetherStats.txBytes; |
| txPackets = tetherStats.txPackets; |
| } |
| |
| public ForwardedStats(@NonNull TetherStatsValue tetherStats) { |
| rxBytes = tetherStats.rxBytes; |
| rxPackets = tetherStats.rxPackets; |
| txBytes = tetherStats.txBytes; |
| txPackets = tetherStats.txPackets; |
| } |
| |
| public ForwardedStats(@NonNull ForwardedStats other) { |
| rxBytes = other.rxBytes; |
| rxPackets = other.rxPackets; |
| txBytes = other.txBytes; |
| txPackets = other.txPackets; |
| } |
| |
| /** Add Tx/Rx bytes/packets and return the result as a new object. */ |
| @NonNull |
| public ForwardedStats add(@NonNull ForwardedStats other) { |
| return new ForwardedStats(rxBytes + other.rxBytes, rxPackets + other.rxPackets, |
| txBytes + other.txBytes, txPackets + other.txPackets); |
| } |
| |
| /** Subtract Tx/Rx bytes/packets and return the result as a new object. */ |
| @NonNull |
| public ForwardedStats subtract(@NonNull ForwardedStats other) { |
| // TODO: Perhaps throw an exception if any negative difference value just in case. |
| final long rxBytesDiff = Math.max(rxBytes - other.rxBytes, 0); |
| final long rxPacketsDiff = Math.max(rxPackets - other.rxPackets, 0); |
| final long txBytesDiff = Math.max(txBytes - other.txBytes, 0); |
| final long txPacketsDiff = Math.max(txPackets - other.txPackets, 0); |
| return new ForwardedStats(rxBytesDiff, rxPacketsDiff, txBytesDiff, txPacketsDiff); |
| } |
| |
| /** Returns the string representation of this object. */ |
| @NonNull |
| public String toString() { |
| return String.format("ForwardedStats(rxb: %d, rxp: %d, txb: %d, txp: %d)", rxBytes, |
| rxPackets, txBytes, txPackets); |
| } |
| } |
| |
| /** |
| * Configures a socket for receiving ICMPv6 router solicitations and sending advertisements. |
| * @param fd the socket's {@link FileDescriptor}. |
| * @param ifIndex the interface index. |
| */ |
| public static native void setupRaSocket(FileDescriptor fd, int ifIndex) |
| throws SocketException; |
| |
| /** |
| * Read s as an unsigned 16-bit integer. |
| */ |
| public static int uint16(short s) { |
| return s & 0xffff; |
| } |
| |
| /** Check whether two TetheringRequestParcels are the same. */ |
| public static boolean isTetheringRequestEquals(final TetheringRequestParcel request, |
| final TetheringRequestParcel otherRequest) { |
| if (request == otherRequest) return true; |
| |
| return request != null && otherRequest != null |
| && request.tetheringType == otherRequest.tetheringType |
| && Objects.equals(request.localIPv4Address, otherRequest.localIPv4Address) |
| && Objects.equals(request.staticClientAddress, otherRequest.staticClientAddress) |
| && request.exemptFromEntitlementCheck == otherRequest.exemptFromEntitlementCheck |
| && request.showProvisioningUi == otherRequest.showProvisioningUi |
| && request.connectivityScope == otherRequest.connectivityScope; |
| } |
| |
| /** Get inet6 address for all nodes given scope ID. */ |
| public static Inet6Address getAllNodesForScopeId(int scopeId) { |
| try { |
| return Inet6Address.getByAddress("ff02::1", ALL_NODES, scopeId); |
| } catch (UnknownHostException uhe) { |
| Log.wtf("TetheringUtils", "Failed to construct Inet6Address from " |
| + Arrays.toString(ALL_NODES) + " and scopedId " + scopeId); |
| return null; |
| } |
| } |
| } |