Class NetworkAdmin

java.lang.Object

com.biglybt.core.networkmanager.admin.NetworkAdmin

Direct Known Subclasses:

NetworkAdminImpl

public abstract class NetworkAdmin
extends Object

Field Summary

Fields

Modifier and Type	Field	Description
static final String	DNS_SPI_TEST_HOST
static final int	IP_PROTOCOL_VERSION_AUTO
static final int	IP_PROTOCOL_VERSION_REQUIRE_V4
static final int	IP_PROTOCOL_VERSION_REQUIRE_V6
static final String	PR_ADDITIONAL_SERVICE_ADDRESS
static final String	PR_AS
static final String	PR_DEFAULT_BIND_ADDRESS
static final String[]	PR_NAMES
static final String	PR_NETWORK_INTERFACES

Constructor Summary

Constructors

Constructor	Description
NetworkAdmin()

Method Summary

Modifier and Type	Method	Description
abstract void	addAndFirePropertyChangeListener(NetworkAdminPropertyChangeListener listener)
abstract void	addPropertyChangeListener(NetworkAdminPropertyChangeListener listener)
abstract boolean	canTraceRoute()
abstract String	classifyRoute(InetAddress address)
abstract NetworkAdminProtocol	createInboundProtocol(Core core, int type, int port)
abstract NetworkAdminSocksProxy	createSocksProxy(String host, int port, String username, String password)
abstract void	generateDiagnostics(IndentWriter iw)
abstract InetAddress[]	getAllBindAddresses(boolean include_wildcard)
abstract InetAddress	getAlternativeProtocolBindAddress(InetAddress address)
abstract InetAddress[]	getBindableAddresses()	Returns the list of current addresses that can successfully be bound to with an ephemeral port
abstract int	getBindablePort(int preferred_port)
abstract String	getBindStatus()
abstract NetworkAdminASN	getCurrentASN()
abstract InetAddress	getDefaultPublicAddress()
abstract InetAddress	getDefaultPublicAddress(boolean peek)
abstract InetAddress	getDefaultPublicAddressV6()
abstract NetworkAdminHTTPProxy	getHTTPProxy()
abstract List<Inet6Address>	getIgnoredTemporaryIPv6()
abstract NetworkAdminProtocol[]	getInboundProtocols(Core core)
abstract Object[]	getInterfaceForAddress(InetAddress address)
abstract NetworkAdminNetworkInterface[]	getInterfaces()
abstract InetAddress	getLoopbackAddress()
abstract InetAddress	getMultiHomedOutgoingRoundRobinBindAddress(InetAddress target)
abstract InetAddress[]	getMultiHomedServiceBindAddresses(boolean forNIO)
abstract NetworkAdminNATDevice[]	getNATDevices(Core core)
String	getNetworkInterfacesAsString()
abstract String	getNetworkInterfacesAsString(boolean only_with_addresses)
abstract NetworkAdminProtocol[]	getOutboundProtocols(Core core)
InetAddress	getSingleHomedServiceBindAddress()
abstract InetAddress	getSingleHomedServiceBindAddress(int protocolVersion)
abstract InetAddress[]	getSingleHomedServiceBinding(String host)	Selects a bind address based on available host address and bind protocol families
abstract List<InetAddress[]>	getSingleHomedServiceBindings(String host)
static NetworkAdmin	getSingleton()
abstract NetworkAdminSocksProxy[]	getSocksProxies()
abstract InetAddress	guessRoutableBindAddress()
abstract boolean	hasDHTIPV4()
abstract boolean	hasDHTIPV6()
abstract boolean	hasIPV4Potential()
boolean	hasIPV6Potential()
abstract boolean	hasIPV6Potential(boolean forNIO)
abstract boolean	hasMissingForcedBind()
abstract boolean	isIgnoredBindAddress(InetAddress ia)
abstract boolean	isIPV6Enabled()
abstract boolean	isRecentPublicIPAddress(InetAddress address)
abstract boolean	isSocksActive()
abstract void	logNATStatus(IndentWriter iw)
abstract NetworkAdminASN	lookupASN(InetAddress address)	ad-hoc query
abstract void	lookupASN(InetAddress address, NetworkAdminASNListener listener)
abstract NetworkAdminASN	lookupCurrentASN(InetAddress address)	Only call if the supplied address is believed to be the current public address
abstract boolean	mustBind()
abstract void	removePropertyChangeListener(NetworkAdminPropertyChangeListener listener)
abstract InetAddress[]	resolveBindAddresses(String bind_to)	Given an interface name etc this will return the corresponding ip addresses
abstract void	runInitialChecks(Core core)
abstract InetAddress	testProtocol(NetworkAdminProtocol protocol)

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

PR_NETWORK_INTERFACES

public static final String PR_NETWORK_INTERFACES

See Also:

• Constant Field Values

PR_DEFAULT_BIND_ADDRESS

public static final String PR_DEFAULT_BIND_ADDRESS

See Also:

• Constant Field Values

PR_ADDITIONAL_SERVICE_ADDRESS

public static final String PR_ADDITIONAL_SERVICE_ADDRESS

See Also:

• Constant Field Values

PR_AS

public static final String PR_AS

See Also:

• Constant Field Values

IP_PROTOCOL_VERSION_AUTO

public static final int IP_PROTOCOL_VERSION_AUTO

See Also:

• Constant Field Values

IP_PROTOCOL_VERSION_REQUIRE_V4

public static final int IP_PROTOCOL_VERSION_REQUIRE_V4

See Also:

• Constant Field Values

IP_PROTOCOL_VERSION_REQUIRE_V6

public static final int IP_PROTOCOL_VERSION_REQUIRE_V6

See Also:

• Constant Field Values

PR_NAMES

public static final String[] PR_NAMES

DNS_SPI_TEST_HOST

public static final String DNS_SPI_TEST_HOST

See Also:

• Constant Field Values

Constructor Details

NetworkAdmin

public NetworkAdmin()

Method Details

getSingleton

public static NetworkAdmin getSingleton()

getSingleHomedServiceBindAddress

public InetAddress getSingleHomedServiceBindAddress()

getSingleHomedServiceBindAddress

public abstract InetAddress getSingleHomedServiceBindAddress(int protocolVersion)
                                                      throws UnsupportedAddressTypeException

Throws:

UnsupportedAddressTypeException - when no address matching the v4/v6 requirements is found, always returns an address when auto is selected

getSingleHomedServiceBinding

public abstract InetAddress[] getSingleHomedServiceBinding(String host)
                                                    throws UnknownHostException,
UnsupportedAddressTypeException

Selects a bind address based on available host address and bind protocol families

Parameters:

host -

Returns:

Array with 2 entries, first is selected host address, second is selected bind address (possibly null of course)

Throws:

UnknownHostException

UnsupportedAddressTypeException

getSingleHomedServiceBindings

public abstract List<InetAddress[]> getSingleHomedServiceBindings(String host)
                                                           throws UnknownHostException,
UnsupportedAddressTypeException

Throws:

UnknownHostException

UnsupportedAddressTypeException

getMultiHomedServiceBindAddresses

public abstract InetAddress[] getMultiHomedServiceBindAddresses(boolean forNIO)

getMultiHomedOutgoingRoundRobinBindAddress

public abstract InetAddress getMultiHomedOutgoingRoundRobinBindAddress(InetAddress target)

getNetworkInterfacesAsString

public String getNetworkInterfacesAsString()

getNetworkInterfacesAsString

public abstract String getNetworkInterfacesAsString(boolean only_with_addresses)

getAllBindAddresses

public abstract InetAddress[] getAllBindAddresses(boolean include_wildcard)

resolveBindAddresses

public abstract InetAddress[] resolveBindAddresses(String bind_to)

Given an interface name etc this will return the corresponding ip addresses

Parameters:

bind_to -

Returns:

guessRoutableBindAddress

public abstract InetAddress guessRoutableBindAddress()

getAlternativeProtocolBindAddress

public abstract InetAddress getAlternativeProtocolBindAddress(InetAddress address)

getBindableAddresses

public abstract InetAddress[] getBindableAddresses()

Returns the list of current addresses that can successfully be bound to with an ephemeral port

Returns:

getBindablePort

public abstract int getBindablePort(int preferred_port)
                             throws IOException

Throws:

IOException

mustBind

public abstract boolean mustBind()

hasMissingForcedBind

public abstract boolean hasMissingForcedBind()

getBindStatus

public abstract String getBindStatus()

isIgnoredBindAddress

public abstract boolean isIgnoredBindAddress(InetAddress ia)

getIgnoredTemporaryIPv6

public abstract List<Inet6Address> getIgnoredTemporaryIPv6()

getInterfaces

public abstract NetworkAdminNetworkInterface[] getInterfaces()

hasIPV4Potential

public abstract boolean hasIPV4Potential()

isIPV6Enabled

public abstract boolean isIPV6Enabled()

hasIPV6Potential

public boolean hasIPV6Potential()

hasIPV6Potential

public abstract boolean hasIPV6Potential(boolean forNIO)

getLoopbackAddress

public abstract InetAddress getLoopbackAddress()

getOutboundProtocols

public abstract NetworkAdminProtocol[] getOutboundProtocols(Core core)

getInboundProtocols

public abstract NetworkAdminProtocol[] getInboundProtocols(Core core)

createInboundProtocol

public abstract NetworkAdminProtocol createInboundProtocol(Core core,
 int type,
 int port)

testProtocol

public abstract InetAddress testProtocol(NetworkAdminProtocol protocol)
                                  throws NetworkAdminException

Throws:

NetworkAdminException

createSocksProxy

public abstract NetworkAdminSocksProxy createSocksProxy(String host,
 int port,
 String username,
 String password)

isSocksActive

public abstract boolean isSocksActive()

getSocksProxies

public abstract NetworkAdminSocksProxy[] getSocksProxies()

getHTTPProxy

public abstract NetworkAdminHTTPProxy getHTTPProxy()

getNATDevices

public abstract NetworkAdminNATDevice[] getNATDevices(Core core)

lookupCurrentASN

public abstract NetworkAdminASN lookupCurrentASN(InetAddress address)
                                          throws NetworkAdminException

Only call if the supplied address is believed to be the current public address

Parameters:

address -

Returns:

Throws:

NetworkAdminException

getCurrentASN

public abstract NetworkAdminASN getCurrentASN()

lookupASN

public abstract NetworkAdminASN lookupASN(InetAddress address)
                                   throws NetworkAdminException

ad-hoc query

Parameters:

address -

Returns:

Throws:

NetworkAdminException

lookupASN

public abstract void lookupASN(InetAddress address,
 NetworkAdminASNListener listener)

classifyRoute

public abstract String classifyRoute(InetAddress address)

canTraceRoute

public abstract boolean canTraceRoute()

isRecentPublicIPAddress

public abstract boolean isRecentPublicIPAddress(InetAddress address)

getDefaultPublicAddress

public abstract InetAddress getDefaultPublicAddress()

getDefaultPublicAddress

public abstract InetAddress getDefaultPublicAddress(boolean peek)

getDefaultPublicAddressV6

public abstract InetAddress getDefaultPublicAddressV6()

hasDHTIPV4

public abstract boolean hasDHTIPV4()

hasDHTIPV6

public abstract boolean hasDHTIPV6()

getInterfaceForAddress

public abstract Object[] getInterfaceForAddress(InetAddress address)

Parameters:

address -

Returns:

{ NetworkInterface, InetAddress (best intf address)}, {NetworkInterface} or {InetAddress (nomatch, same as arg)}

addPropertyChangeListener

public abstract void addPropertyChangeListener(NetworkAdminPropertyChangeListener listener)

addAndFirePropertyChangeListener

public abstract void addAndFirePropertyChangeListener(NetworkAdminPropertyChangeListener listener)

removePropertyChangeListener

public abstract void removePropertyChangeListener(NetworkAdminPropertyChangeListener listener)

runInitialChecks

public abstract void runInitialChecks(Core core)

logNATStatus

public abstract void logNATStatus(IndentWriter iw)

generateDiagnostics

public abstract void generateDiagnostics(IndentWriter iw)