38  * Describes the properties of a network link.
40  * A link represents a connection to a network.
50     // The interface described by the network link.
65     // Stores the properties of links that are "stacked" above this link.
167      * Sets the interface name for this link.  All {@link RouteInfo} already set for this
170      * @param iface The name of the network interface used for this link.
183      * Gets the interface name for this link.  May be {@code null} if not set.
185      * @return The interface name set for this link or {@code null}.
204      * Returns all the addresses on this link.  We often think of a link having a single address,
206      * {@code LinkProperties} actually contains {@link LinkAddress} objects which also include
208      * {@link LinkProperties#getLinkAddresses}.
210      * @return An umodifiable {@link List} of {@link InetAddress} for this link.
222      * Returns all the addresses on this link and all the links stacked above it.
246      * Adds a {@link LinkAddress} to this {@code LinkProperties} if a {@link LinkAddress} of the
272      * Removes a {@link LinkAddress} from this {@code LinkProperties}.  Specifically, matches
273      * and {@link LinkAddress} with the same address and prefix.
275      * @param toRemove A {@link LinkAddress} specifying the address to remove.
289      * Returns all the {@link LinkAddress} on this link.  Typically a link will have
292      * @return An unmodifiable {@link List} of {@link LinkAddress} for this link.
299      * Returns all the addresses on this link and all the links stacked above it.
312      * Replaces the {@link LinkAddress} in this {@code LinkProperties} with
313      * the given {@link Collection} of {@link LinkAddress}.
315      * @param addresses The {@link Collection} of {@link LinkAddress} to set in this
327      * Adds the given {@link InetAddress} to the list of DNS servers, if not present.
329      * @param dnsServer The {@link InetAddress} to add to the list of DNS servers.
342      * Removes the given {@link InetAddress} from the list of DNS servers.
344      * @param dnsServer The {@link InetAddress} to remove from the list of DNS servers.
357      * the given {@link Collection} of {@link InetAddress} objects.
359      * @param addresses The {@link Collection} of DNS servers to set in this object.
370      * Returns all the {@link InetAddress} for DNS servers on this link.
372      * @return An umodifiable {@link List} of {@link InetAddress} for DNS servers on
373      *         this link.
380      * Sets the DNS domain search path used on this link.
382      * @param domains A {@link String} listing in priority order the comma separated
383      *                domains to search when resolving host names on this link.
391      * Get the DNS domains search path set for this link.
393      * @return A {@link String} containing the comma separated domains to search when resolving
394      *         host names on this link.
401      * Sets the Maximum Transmission Unit size to use on this link.  This should not be used
405      * @param mtu The MTU to use for this link.
413      * Gets any non-default MTU size set for this link.  Note that if the default is being used
416      * @return The mtu value set for this link.
424      * Sets the tcp buffers sizes to be used when this link is the system default.
438      * @return the tcp buffer sizes to use when this link is the system default.
455      * Adds a {@link RouteInfo} to this {@code LinkProperties}, if not present. If the
456      * {@link RouteInfo} had an interface name set and that differs from the interface set for this
457      * {@code LinkProperties} an {@link IllegalArgumentException} will be thrown.  The proper
458      * course is to add either un-named or properly named {@link RouteInfo}.
460      * @param route A {@link RouteInfo} to add to this object.
483      * Removes a {@link RouteInfo} from this {@code LinkProperties}, if present. The route must
498      * Returns all the {@link RouteInfo} set on this link.
500      * @return An unmodifiable {@link List} of {@link RouteInfo} for this link.
507      * Returns all the routes on this link and all the links stacked above it.
520      * Sets the recommended {@link ProxyInfo} to use on this link, or {@code null} for none.
524      * @param proxy A {@link ProxyInfo} defining the HTTP Proxy to use on this link.
532      * Gets the recommended {@link ProxyInfo} (or {@code null}) set on this link.
534      * @return The {@link ProxyInfo} set on this link
541      * Adds a stacked link.
543      * If there is already a stacked link with the same interfacename as link,
544      * that link is replaced with link. Otherwise, link is added to the list
545      * of stacked links. If link is null, nothing changes.
547      * @param link The link to add.
548      * @return true if the link was stacked, false otherwise.
551     public boolean addStackedLink(LinkProperties link) {
552         if (link != null && link.getInterfaceName() != null) {
553             mStackedLinks.put(link.getInterfaceName(), link);
560      * Removes a stacked link.
562      * If there is a stacked link with the given interface name, it is
565      * @param iface The interface name of the link to remove.
566      * @return true if the link was removed, false otherwise.
578      * Returns all the links stacked on top of this link.
586         for (LinkProperties link : mStackedLinks.values()) {
587             stacked.add(new LinkProperties(link));
644             for (LinkProperties link: mStackedLinks.values()) {
645                 stacked += " [" + link.toString() + " ],";
654      * Returns true if this link has an IPv4 address.
669      * Returns true if this link or any of its stacked interfaces has an IPv4 address.
681      * Returns true if this link has a global preferred IPv6 address.
696      * Returns true if this link has an IPv4 default route.
711      * Returns true if this link has an IPv6 default route.
726      * Returns true if this link has an IPv4 DNS server.
741      * Returns true if this link has an IPv6 DNS server.
756      * Returns true if this link is provisioned for global IPv4 connectivity.
759      * @return {@code true} if the link is provisioned, {@code false} otherwise.
769      * Returns true if this link is provisioned for global IPv6 connectivity.
772      * @return {@code true} if the link is provisioned, {@code false} otherwise.
782      * Returns true if this link is provisioned for global connectivity,
785      * @return {@code true} if the link is provisioned, {@code false} otherwise.
793      * Evaluate whether the {@link InetAddress} is considered reachable.
795      * @return {@code true} if the given {@link InetAddress} is considered reachable,
814                 // For now, just make sure link-local destinations have
819                 // For non-link-local destinations check that either the best route
964          * stacked interfaces are not so much a property of the link as a
979      * LinkProperties, examining only addresses on the base link.
1008      * LinkProperties, examining only DNS addresses on the base link.
1038      * examining both the the base link and all stacked links.
1067      * LinkProperties, examining both the the base link and all stacked links.

Indexes created Sun Sep 10 09:05:34 CEST 2017