/* * Copyright (C) 2016 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.ip; import static android.net.util.NetworkConstants.RFC7421_PREFIX_LENGTH; import static android.net.util.TetheringUtils.getAllNodesForScopeId; import static android.system.OsConstants.AF_INET6; import static android.system.OsConstants.IPPROTO_ICMPV6; import static android.system.OsConstants.SOCK_RAW; import static android.system.OsConstants.SOL_SOCKET; import static android.system.OsConstants.SO_SNDTIMEO; import static com.android.net.module.util.NetworkStackConstants.ICMPV6_ND_OPTION_SLLA; import static com.android.net.module.util.NetworkStackConstants.ICMPV6_RA_HEADER_LEN; import static com.android.net.module.util.NetworkStackConstants.ICMPV6_ROUTER_ADVERTISEMENT; import static com.android.net.module.util.NetworkStackConstants.ICMPV6_ROUTER_SOLICITATION; import static com.android.net.module.util.NetworkStackConstants.IPV6_MIN_MTU; import static com.android.net.module.util.NetworkStackConstants.PIO_FLAG_AUTONOMOUS; import static com.android.net.module.util.NetworkStackConstants.PIO_FLAG_ON_LINK; import static com.android.net.module.util.NetworkStackConstants.TAG_SYSTEM_NEIGHBOR; import android.net.IpPrefix; import android.net.LinkAddress; import android.net.MacAddress; import android.net.TrafficStats; import android.net.util.InterfaceParams; import android.net.util.SocketUtils; import android.net.util.TetheringUtils; import android.system.ErrnoException; import android.system.Os; import android.system.StructTimeval; import android.util.Log; import com.android.internal.annotations.GuardedBy; import com.android.net.module.util.structs.Icmpv6Header; import com.android.net.module.util.structs.LlaOption; import com.android.net.module.util.structs.MtuOption; import com.android.net.module.util.structs.PrefixInformationOption; import com.android.net.module.util.structs.RaHeader; import com.android.net.module.util.structs.RdnssOption; import java.io.FileDescriptor; import java.io.IOException; import java.net.Inet6Address; import java.net.InetAddress; import java.net.InetSocketAddress; import java.net.SocketException; import java.nio.BufferOverflowException; import java.nio.ByteBuffer; import java.nio.ByteOrder; import java.util.HashMap; import java.util.HashSet; import java.util.Iterator; import java.util.Map; import java.util.Random; import java.util.Set; import java.util.concurrent.atomic.AtomicInteger; /** * Basic IPv6 Router Advertisement Daemon. * * TODO: * * - Rewrite using Handler (and friends) so that AlarmManager can deliver * "kick" messages when it's time to send a multicast RA. * * @hide */ public class RouterAdvertisementDaemon { private static final String TAG = RouterAdvertisementDaemon.class.getSimpleName(); // Summary of various timers and lifetimes. private static final int MIN_RTR_ADV_INTERVAL_SEC = 300; private static final int MAX_RTR_ADV_INTERVAL_SEC = 600; // In general, router, prefix, and DNS lifetimes are all advised to be // greater than or equal to 3 * MAX_RTR_ADV_INTERVAL. Here, we double // that to allow for multicast packet loss. // // This MAX_RTR_ADV_INTERVAL_SEC and DEFAULT_LIFETIME are also consistent // with the https://tools.ietf.org/html/rfc7772#section-4 discussion of // "approximately 7 RAs per hour". private static final int DEFAULT_LIFETIME = 6 * MAX_RTR_ADV_INTERVAL_SEC; // From https://tools.ietf.org/html/rfc4861#section-10 . private static final int MIN_DELAY_BETWEEN_RAS_SEC = 3; // Both initial and final RAs, but also for changes in RA contents. // From https://tools.ietf.org/html/rfc4861#section-10 . private static final int MAX_URGENT_RTR_ADVERTISEMENTS = 5; private static final int DAY_IN_SECONDS = 86_400; private final InterfaceParams mInterface; private final InetSocketAddress mAllNodes; // This lock is to protect the RA from being updated while being // transmitted on another thread (multicast or unicast). // // TODO: This should be handled with a more RCU-like approach. private final Object mLock = new Object(); @GuardedBy("mLock") private final byte[] mRA = new byte[IPV6_MIN_MTU]; @GuardedBy("mLock") private int mRaLength; @GuardedBy("mLock") private final DeprecatedInfoTracker mDeprecatedInfoTracker; @GuardedBy("mLock") private RaParams mRaParams; private volatile FileDescriptor mSocket; private volatile MulticastTransmitter mMulticastTransmitter; private volatile UnicastResponder mUnicastResponder; /** Encapsulate the RA parameters for RouterAdvertisementDaemon.*/ public static class RaParams { // Tethered traffic will have the hop limit properly decremented. // Consequently, set the hoplimit greater by one than the upstream // unicast hop limit. // // TODO: Dynamically pass down the IPV6_UNICAST_HOPS value from the // upstream interface for more correct behaviour. static final byte DEFAULT_HOPLIMIT = 65; public boolean hasDefaultRoute; public byte hopLimit; public int mtu; public HashSet prefixes; public HashSet dnses; public RaParams() { hasDefaultRoute = false; hopLimit = DEFAULT_HOPLIMIT; mtu = IPV6_MIN_MTU; prefixes = new HashSet(); dnses = new HashSet(); } public RaParams(RaParams other) { hasDefaultRoute = other.hasDefaultRoute; hopLimit = other.hopLimit; mtu = other.mtu; prefixes = (HashSet) other.prefixes.clone(); dnses = (HashSet) other.dnses.clone(); } /** * Returns the subset of RA parameters that become deprecated when * moving from announcing oldRa to announcing newRa. * * Currently only tracks differences in |prefixes| and |dnses|. */ public static RaParams getDeprecatedRaParams(RaParams oldRa, RaParams newRa) { RaParams newlyDeprecated = new RaParams(); if (oldRa != null) { for (IpPrefix ipp : oldRa.prefixes) { if (newRa == null || !newRa.prefixes.contains(ipp)) { newlyDeprecated.prefixes.add(ipp); } } for (Inet6Address dns : oldRa.dnses) { if (newRa == null || !newRa.dnses.contains(dns)) { newlyDeprecated.dnses.add(dns); } } } return newlyDeprecated; } } private static class DeprecatedInfoTracker { private final HashMap mPrefixes = new HashMap<>(); private final HashMap mDnses = new HashMap<>(); Set getPrefixes() { return mPrefixes.keySet(); } void putPrefixes(Set prefixes) { for (IpPrefix ipp : prefixes) { mPrefixes.put(ipp, MAX_URGENT_RTR_ADVERTISEMENTS); } } void removePrefixes(Set prefixes) { for (IpPrefix ipp : prefixes) { mPrefixes.remove(ipp); } } Set getDnses() { return mDnses.keySet(); } void putDnses(Set dnses) { for (Inet6Address dns : dnses) { mDnses.put(dns, MAX_URGENT_RTR_ADVERTISEMENTS); } } void removeDnses(Set dnses) { for (Inet6Address dns : dnses) { mDnses.remove(dns); } } boolean isEmpty() { return mPrefixes.isEmpty() && mDnses.isEmpty(); } private boolean decrementCounters() { boolean removed = decrementCounter(mPrefixes); removed |= decrementCounter(mDnses); return removed; } private boolean decrementCounter(HashMap map) { boolean removed = false; for (Iterator> it = map.entrySet().iterator(); it.hasNext();) { Map.Entry kv = it.next(); if (kv.getValue() == 0) { it.remove(); removed = true; } else { kv.setValue(kv.getValue() - 1); } } return removed; } } public RouterAdvertisementDaemon(InterfaceParams ifParams) { mInterface = ifParams; mAllNodes = new InetSocketAddress(getAllNodesForScopeId(mInterface.index), 0); mDeprecatedInfoTracker = new DeprecatedInfoTracker(); } /** Build new RA.*/ public void buildNewRa(RaParams deprecatedParams, RaParams newParams) { synchronized (mLock) { if (deprecatedParams != null) { mDeprecatedInfoTracker.putPrefixes(deprecatedParams.prefixes); mDeprecatedInfoTracker.putDnses(deprecatedParams.dnses); } if (newParams != null) { // Process information that is no longer deprecated. mDeprecatedInfoTracker.removePrefixes(newParams.prefixes); mDeprecatedInfoTracker.removeDnses(newParams.dnses); } mRaParams = newParams; assembleRaLocked(); } maybeNotifyMulticastTransmitter(); } /** Start router advertisement daemon. */ public boolean start() { if (!createSocket()) { return false; } mMulticastTransmitter = new MulticastTransmitter(); mMulticastTransmitter.start(); mUnicastResponder = new UnicastResponder(); mUnicastResponder.start(); return true; } /** Stop router advertisement daemon. */ public void stop() { closeSocket(); // Wake up mMulticastTransmitter thread to interrupt a potential 1 day sleep before // the thread's termination. maybeNotifyMulticastTransmitter(); mMulticastTransmitter = null; mUnicastResponder = null; } @GuardedBy("mLock") private void assembleRaLocked() { final ByteBuffer ra = ByteBuffer.wrap(mRA); ra.order(ByteOrder.BIG_ENDIAN); final boolean haveRaParams = (mRaParams != null); boolean shouldSendRA = false; try { putHeader(ra, haveRaParams && mRaParams.hasDefaultRoute, haveRaParams ? mRaParams.hopLimit : RaParams.DEFAULT_HOPLIMIT); putSlla(ra, mInterface.macAddr.toByteArray()); mRaLength = ra.position(); // https://tools.ietf.org/html/rfc5175#section-4 says: // // "MUST NOT be added to a Router Advertisement message // if no flags in the option are set." // // putExpandedFlagsOption(ra); if (haveRaParams) { putMtu(ra, mRaParams.mtu); mRaLength = ra.position(); for (IpPrefix ipp : mRaParams.prefixes) { putPio(ra, ipp, DEFAULT_LIFETIME, DEFAULT_LIFETIME); mRaLength = ra.position(); shouldSendRA = true; } if (mRaParams.dnses.size() > 0) { putRdnss(ra, mRaParams.dnses, DEFAULT_LIFETIME); mRaLength = ra.position(); shouldSendRA = true; } } for (IpPrefix ipp : mDeprecatedInfoTracker.getPrefixes()) { putPio(ra, ipp, 0, 0); mRaLength = ra.position(); shouldSendRA = true; } final Set deprecatedDnses = mDeprecatedInfoTracker.getDnses(); if (!deprecatedDnses.isEmpty()) { putRdnss(ra, deprecatedDnses, 0); mRaLength = ra.position(); shouldSendRA = true; } } catch (BufferOverflowException e) { // The packet up to mRaLength is valid, since it has been updated // progressively as the RA was built. Log an error, and continue // on as best as possible. Log.e(TAG, "Could not construct new RA: " + e); } // We have nothing worth announcing; indicate as much to maybeSendRA(). if (!shouldSendRA) { mRaLength = 0; } } private void maybeNotifyMulticastTransmitter() { final MulticastTransmitter m = mMulticastTransmitter; if (m != null) { m.hup(); } } private static byte asByte(int value) { return (byte) value; } private static short asShort(int value) { return (short) value; } private static void putHeader(ByteBuffer ra, boolean hasDefaultRoute, byte hopLimit) { // RFC 4191 "high" preference, iff. advertising a default route. final byte flags = hasDefaultRoute ? asByte(0x08) : asByte(0); final short lifetime = hasDefaultRoute ? asShort(DEFAULT_LIFETIME) : asShort(0); final Icmpv6Header icmpv6Header = new Icmpv6Header(asByte(ICMPV6_ROUTER_ADVERTISEMENT) /* type */, asByte(0) /* code */, asShort(0) /* checksum */); final RaHeader raHeader = new RaHeader(hopLimit, flags, lifetime, 0 /* reachableTime */, 0 /* retransTimer */); icmpv6Header.writeToByteBuffer(ra); raHeader.writeToByteBuffer(ra); } private static void putSlla(ByteBuffer ra, byte[] slla) { if (slla == null || slla.length != 6) { // Only IEEE 802.3 6-byte addresses are supported. return; } final ByteBuffer sllaOption = LlaOption.build(asByte(ICMPV6_ND_OPTION_SLLA), MacAddress.fromBytes(slla)); ra.put(sllaOption); } private static void putExpandedFlagsOption(ByteBuffer ra) { /** Router Advertisement Expanded Flags Option 0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Type | Length | Bit fields available .. +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ ... for assignment | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ */ final byte nd_option__efo = 26; final byte efo_num_8octets = 1; ra.put(nd_option__efo) .put(efo_num_8octets) .putShort(asShort(0)) .putInt(0); } private static void putMtu(ByteBuffer ra, int mtu) { final ByteBuffer mtuOption = MtuOption.build((mtu < IPV6_MIN_MTU) ? IPV6_MIN_MTU : mtu); ra.put(mtuOption); } private static void putPio(ByteBuffer ra, IpPrefix ipp, int validTime, int preferredTime) { final int prefixLength = ipp.getPrefixLength(); if (prefixLength != 64) { return; } if (validTime < 0) validTime = 0; if (preferredTime < 0) preferredTime = 0; if (preferredTime > validTime) preferredTime = validTime; final ByteBuffer pioOption = PrefixInformationOption.build(ipp, asByte(PIO_FLAG_ON_LINK | PIO_FLAG_AUTONOMOUS), validTime, preferredTime); ra.put(pioOption); } private static void putRio(ByteBuffer ra, IpPrefix ipp) { /** Route Information Option 0 1 2 3 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Type | Length | Prefix Length |Resvd|Prf|Resvd| +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Route Lifetime | +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ | Prefix (Variable Length) | . . . . +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ */ final int prefixLength = ipp.getPrefixLength(); if (prefixLength > 64) { return; } final byte nd_option_rio = 24; final byte rio_num_8octets = asByte( (prefixLength == 0) ? 1 : (prefixLength <= 8) ? 2 : 3); final byte[] addr = ipp.getAddress().getAddress(); ra.put(nd_option_rio) .put(rio_num_8octets) .put(asByte(prefixLength)) .put(asByte(0x18)) .putInt(DEFAULT_LIFETIME); // Rely upon an IpPrefix's address being properly zeroed. if (prefixLength > 0) { ra.put(addr, 0, (prefixLength <= 64) ? 8 : 16); } } private static void putRdnss(ByteBuffer ra, Set dnses, int lifetime) { final HashSet filteredDnses = new HashSet<>(); for (Inet6Address dns : dnses) { if ((new LinkAddress(dns, RFC7421_PREFIX_LENGTH)).isGlobalPreferred()) { filteredDnses.add(dns); } } if (filteredDnses.isEmpty()) return; final Inet6Address[] dnsesArray = filteredDnses.toArray(new Inet6Address[filteredDnses.size()]); final ByteBuffer rdnssOption = RdnssOption.build(lifetime, dnsesArray); // NOTE: If the full of list DNS servers doesn't fit in the packet, // this code will cause a buffer overflow and the RA won't include // this instance of the option at all. // // TODO: Consider looking at ra.remaining() to determine how many // DNS servers will fit, and adding only those. ra.put(rdnssOption); } private boolean createSocket() { final int send_timout_ms = 300; final int oldTag = TrafficStats.getAndSetThreadStatsTag(TAG_SYSTEM_NEIGHBOR); try { mSocket = Os.socket(AF_INET6, SOCK_RAW, IPPROTO_ICMPV6); // Setting SNDTIMEO is purely for defensive purposes. Os.setsockoptTimeval( mSocket, SOL_SOCKET, SO_SNDTIMEO, StructTimeval.fromMillis(send_timout_ms)); SocketUtils.bindSocketToInterface(mSocket, mInterface.name); TetheringUtils.setupRaSocket(mSocket, mInterface.index); } catch (ErrnoException | IOException e) { Log.e(TAG, "Failed to create RA daemon socket: " + e); return false; } finally { TrafficStats.setThreadStatsTag(oldTag); } return true; } private void closeSocket() { if (mSocket != null) { try { SocketUtils.closeSocket(mSocket); } catch (IOException ignored) { } } mSocket = null; } private boolean isSocketValid() { final FileDescriptor s = mSocket; return (s != null) && s.valid(); } private boolean isSuitableDestination(InetSocketAddress dest) { if (mAllNodes.equals(dest)) { return true; } final InetAddress destip = dest.getAddress(); return (destip instanceof Inet6Address) && destip.isLinkLocalAddress() && (((Inet6Address) destip).getScopeId() == mInterface.index); } private void maybeSendRA(InetSocketAddress dest) { if (dest == null || !isSuitableDestination(dest)) { dest = mAllNodes; } try { synchronized (mLock) { if (mRaLength < ICMPV6_RA_HEADER_LEN) { // No actual RA to send. return; } Os.sendto(mSocket, mRA, 0, mRaLength, 0, dest); } Log.d(TAG, "RA sendto " + dest.getAddress().getHostAddress()); } catch (ErrnoException | SocketException e) { if (isSocketValid()) { Log.e(TAG, "sendto error: " + e); } } } private final class UnicastResponder extends Thread { private final InetSocketAddress mSolicitor = new InetSocketAddress(0); // The recycled buffer for receiving Router Solicitations from clients. // If the RS is larger than IPV6_MIN_MTU the packets are truncated. // This is fine since currently only byte 0 is examined anyway. private final byte[] mSolicitation = new byte[IPV6_MIN_MTU]; @Override public void run() { while (isSocketValid()) { try { // Blocking receive. final int rval = Os.recvfrom( mSocket, mSolicitation, 0, mSolicitation.length, 0, mSolicitor); // Do the least possible amount of validation. if (rval < 1 || mSolicitation[0] != asByte(ICMPV6_ROUTER_SOLICITATION)) { continue; } } catch (ErrnoException | SocketException e) { if (isSocketValid()) { Log.e(TAG, "recvfrom error: " + e); } continue; } maybeSendRA(mSolicitor); } } } // TODO: Consider moving this to run on a provided Looper as a Handler, // with WakeupMessage-style messages providing the timer driven input. private final class MulticastTransmitter extends Thread { private final Random mRandom = new Random(); private final AtomicInteger mUrgentAnnouncements = new AtomicInteger(0); @Override public void run() { while (isSocketValid()) { try { Thread.sleep(getNextMulticastTransmitDelayMs()); } catch (InterruptedException ignored) { // Stop sleeping, immediately send an RA, and continue. } maybeSendRA(mAllNodes); synchronized (mLock) { if (mDeprecatedInfoTracker.decrementCounters()) { // At least one deprecated PIO has been removed; // reassemble the RA. assembleRaLocked(); } } } } public void hup() { // Set to one fewer that the desired number, because as soon as // the thread interrupt is processed we immediately send an RA // and mUrgentAnnouncements is not examined until the subsequent // sleep interval computation (i.e. this way we send 3 and not 4). mUrgentAnnouncements.set(MAX_URGENT_RTR_ADVERTISEMENTS - 1); interrupt(); } private int getNextMulticastTransmitDelaySec() { boolean deprecationInProgress = false; synchronized (mLock) { if (mRaLength < ICMPV6_RA_HEADER_LEN) { // No actual RA to send; just sleep for 1 day. return DAY_IN_SECONDS; } deprecationInProgress = !mDeprecatedInfoTracker.isEmpty(); } final int urgentPending = mUrgentAnnouncements.getAndDecrement(); if ((urgentPending > 0) || deprecationInProgress) { return MIN_DELAY_BETWEEN_RAS_SEC; } return MIN_RTR_ADV_INTERVAL_SEC + mRandom.nextInt( MAX_RTR_ADV_INTERVAL_SEC - MIN_RTR_ADV_INTERVAL_SEC); } private long getNextMulticastTransmitDelayMs() { return 1000 * (long) getNextMulticastTransmitDelaySec(); } } }