Nested and Inner Type Summary

Modifier and Type	Class and Description
private static class	ConnectorBootstrap.AccessFileCheckerAuthenticator This JMXAuthenticator wraps the JMXPluggableAuthenticator and verifies that at least one of the principal names contained in the authenticated Subject is present in the access file.
public static interface	ConnectorBootstrap.DefaultValues Default values for JMX configuration properties.
private static class	ConnectorBootstrap.HostAwareSocketFactory
private static class	ConnectorBootstrap.HostAwareSslSocketFactory
private static class	ConnectorBootstrap.JMXConnectorServerData JMXConnectorServer associated data.
private static class	ConnectorBootstrap.PermanentExporter Prevents our RMI server objects from keeping the JVM alive.
public static interface	ConnectorBootstrap.PropertyNames Names of JMX configuration properties.
private static class	ConnectorBootstrap.SslServerSocket

Field Summary

Modifier and Type	Field and Description
private static final System.Logger	logger
private static Registry	registry

Constructor Summary

Access	Constructor and Description
private	ConnectorBootstrap() This class cannot be instantiated.

Method Summary

Modifier and Type	Method and Description
private static void	checkAccessFile(String accessFileName)
private static void	checkPasswordFile(String passwordFileName)
private static void	checkRestrictedFile(String restrictedFileName)
private static void	config(String func, String msg)
private static void	config(String func, Throwable t)
private static void	config(String func, String msg, Throwable t)
private static SslRMIServerSocketFactory	createSslRMIServerSocketFactory(String sslConfigFileName, String[] enabledCipherSuites, String[] enabledProtocols, boolean sslNeedClientAuth, String bindAddress)
private static ConnectorBootstrap.JMXConnectorServerData	exportMBeanServer(MBeanServer mbs, int port, int rmiPort, boolean useSsl, boolean useRegistrySsl, String sslConfigFileName, String[] enabledCipherSuites, String[] enabledProtocols, boolean sslNeedClientAuth, boolean useAuthentication, String loginConfigName, String passwordFileName, boolean shouldHashPasswords, String accessFileName, String bindAddress, String jmxRmiFilter)
private static String	Returns: ${JRE}/conf/management/${basename} getDefaultFileName(String basename (with extension) of the default file. basename) Compute the full path name for a default file.
public static synchronized JMXConnectorServer	initialize() Initializes and starts the JMX Connector Server.
public static synchronized JMXConnectorServer	initialize(String portStr, Properties props) This method is used by some jtreg tests.
public static JMXConnectorServer	startLocalConnectorServer()
public static synchronized JMXConnectorServer	startRemoteConnectorServer(String portStr, Properties props) Initializes and starts a JMX Connector Server for remote monitoring and management.
public static void	unexportRegistry()

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

logger	back to summary
private static final System.Logger logger

registry	back to summary
private static Registry registry

Constructor Detail

ConnectorBootstrap	back to summary
private ConnectorBootstrap() This class cannot be instantiated.

Method Detail

checkAccessFile	back to summary
private static void checkAccessFile(String accessFileName)

checkPasswordFile	back to summary
private static void checkPasswordFile(String passwordFileName)

checkRestrictedFile	back to summary
private static void checkRestrictedFile(String restrictedFileName)

config	back to summary
private static void config(String func, String msg)

config	back to summary
private static void config(String func, Throwable t)

config	back to summary
private static void config(String func, String msg, Throwable t)

createSslRMIServerSocketFactory	back to summary
private static SslRMIServerSocketFactory createSslRMIServerSocketFactory(String sslConfigFileName, String[] enabledCipherSuites, String[] enabledProtocols, boolean sslNeedClientAuth, String bindAddress)

exportMBeanServer	back to summary
private static ConnectorBootstrap.JMXConnectorServerData exportMBeanServer(MBeanServer mbs, int port, int rmiPort, boolean useSsl, boolean useRegistrySsl, String sslConfigFileName, String[] enabledCipherSuites, String[] enabledProtocols, boolean sslNeedClientAuth, boolean useAuthentication, String loginConfigName, String passwordFileName, boolean shouldHashPasswords, String accessFileName, String bindAddress, String jmxRmiFilter) throws IOException, MalformedURLException

exportMBeanServer

back to summary

private static ConnectorBootstrap.JMXConnectorServerData exportMBeanServer(MBeanServer mbs, int port, int rmiPort, boolean useSsl, boolean useRegistrySsl, String sslConfigFileName, String[] enabledCipherSuites, String[] enabledProtocols, boolean sslNeedClientAuth, boolean useAuthentication, String loginConfigName, String passwordFileName, boolean shouldHashPasswords, String accessFileName, String bindAddress, String jmxRmiFilter) throws IOException, MalformedURLException

getDefaultFileName	back to summary
private static String getDefaultFileName(String basename) Compute the full path name for a default file. Parameters basename:String basename (with extension) of the default file. Returns:String ${JRE}/conf/management/${basename}

getDefaultFileName

back to summary

private static String getDefaultFileName(String basename)

Compute the full path name for a default file.

Parameters

basename:String: basename (with extension) of the default file.

Returns:String

${JRE}/conf/management/${basename}

initialize	back to summary
public static synchronized JMXConnectorServer initialize() Initializes and starts the JMX Connector Server. If the com.sun.management.jmxremote.port property is not defined, simply returns. Otherwise, attempts to load the config file, and then calls `startRemoteConnectorServer(java.lang.String, java.util.Properties)`. This method is used by some jtreg tests.

initialize back to summary

initialize	back to summary
public static synchronized JMXConnectorServer initialize(String portStr, Properties props) This method is used by some jtreg tests. See Also `startRemoteConnectorServer(String portStr, Properties props)`

public static synchronized JMXConnectorServer initialize(String portStr, Properties props)

This method is used by some jtreg tests.

See Also: startRemoteConnectorServer(String portStr, Properties props)

startLocalConnectorServer	back to summary
public static JMXConnectorServer startLocalConnectorServer()

startRemoteConnectorServer	back to summary
public static synchronized JMXConnectorServer startRemoteConnectorServer(String portStr, Properties props) Initializes and starts a JMX Connector Server for remote monitoring and management.

unexportRegistry	back to summary
public static void unexportRegistry()

sun.management.jmxremote back to summary

private Class ConnectorBootstrap.AccessFileCheckerAuthenticator

Class Inheritance

extends Object
implements JMXAuthenticator

java.lang.Object
sun.management.jmxremote.ConnectorBootstrap.AccessFileCheckerAuthenticator

All Implemented Interfaces

javax.management.remote.JMXAuthenticator

This JMXAuthenticator wraps the JMXPluggableAuthenticator and verifies that at least one of the principal names contained in the authenticated Subject is present in the access file.

Field Summary

Modifier and Type	Field and Description
private final String	accessFile
private final Map<String, Object>	environment
private final Properties	properties

Constructor Summary

Access	Constructor and Description
public	AccessFileCheckerAuthenticator(Map<String, Object> env)

Method Summary

Modifier and Type	Method and Description
public Subject	authenticate(Object credentials) Implements javax.management.remote.JMXAuthenticator.authenticate. Authenticates the `MBeanServerConnection` client with the given client credentials.
private void	checkAccessFileEntries(Subject subject)
private static Properties	propertiesFromFile(String fname)

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

accessFile	back to summary
private final String accessFile

environment	back to summary
private final Map<String, Object> environment

properties	back to summary
private final Properties properties

Constructor Detail

AccessFileCheckerAuthenticator	back to summary
public AccessFileCheckerAuthenticator(Map<String, Object> env) throws IOException

Method Detail

authenticate back to summary

authenticate	back to summary
public Subject authenticate(Object credentials) Implements javax.management.remote.JMXAuthenticator.authenticate. Doc from javax.management.remote.JMXAuthenticator.authenticate. Authenticates the `MBeanServerConnection` client with the given client credentials.

public Subject authenticate(Object credentials)

Implements javax.management.remote.JMXAuthenticator.authenticate.

Doc from javax.management.remote.JMXAuthenticator.authenticate.

Authenticates the MBeanServerConnection client with the given client credentials.

checkAccessFileEntries	back to summary
private void checkAccessFileEntries(Subject subject)

propertiesFromFile	back to summary
private static Properties propertiesFromFile(String fname) throws IOException

sun.management.jmxremote back to summary

public Interface ConnectorBootstrap.DefaultValues

Default values for JMX configuration properties.

Field Summary

Modifier and Type	Field and Description
public static final String	ACCESS_FILE_NAME
public static final String	CONFIG_FILE_NAME
public static final String	HASH_PASSWORDS
public static final String	PASSWORD_FILE_NAME
public static final String	PORT
public static final String	SSL_NEED_CLIENT_AUTH
public static final String	USE_AUTHENTICATION
public static final String	USE_LOCAL_ONLY
public static final String	USE_REGISTRY_SSL
public static final String	USE_SSL

Field Detail

ACCESS_FILE_NAME	back to summary
public static final String ACCESS_FILE_NAME

CONFIG_FILE_NAME	back to summary
public static final String CONFIG_FILE_NAME

HASH_PASSWORDS	back to summary
public static final String HASH_PASSWORDS

PASSWORD_FILE_NAME	back to summary
public static final String PASSWORD_FILE_NAME

PORT	back to summary
public static final String PORT

SSL_NEED_CLIENT_AUTH	back to summary
public static final String SSL_NEED_CLIENT_AUTH

USE_AUTHENTICATION	back to summary
public static final String USE_AUTHENTICATION

USE_LOCAL_ONLY	back to summary
public static final String USE_LOCAL_ONLY

USE_REGISTRY_SSL	back to summary
public static final String USE_REGISTRY_SSL

USE_SSL	back to summary
public static final String USE_SSL

sun.management.jmxremote back to summary

private Class ConnectorBootstrap.HostAwareSocketFactory

Class Inheritance

extends Object
implements RMIServerSocketFactory

java.lang.Object
sun.management.jmxremote.ConnectorBootstrap.HostAwareSocketFactory

All Implemented Interfaces

java.rmi.server.RMIServerSocketFactory

Field Summary

Modifier and Type	Field and Description
private final String	bindAddress

Constructor Summary

Access	Constructor and Description
private	HostAwareSocketFactory(String bindAddress)

Method Summary

Modifier and Type	Method and Description
public ServerSocket	createServerSocket(int port) Implements java.rmi.server.RMIServerSocketFactory.createServerSocket. Create a server socket on the specified port (port 0 indicates an anonymous port).

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

bindAddress	back to summary
private final String bindAddress

Constructor Detail

HostAwareSocketFactory	back to summary
private HostAwareSocketFactory(String bindAddress)

Method Detail

createServerSocket	back to summary
public ServerSocket createServerSocket(int port) throws IOException Implements java.rmi.server.RMIServerSocketFactory.createServerSocket. Doc from java.rmi.server.RMIServerSocketFactory.createServerSocket. Create a server socket on the specified port (port 0 indicates an anonymous port). Annotations @Override Exceptions IOException: if an I/O error occurs during server socket creation

createServerSocket

back to summary

public ServerSocket createServerSocket(int port) throws IOException

Implements java.rmi.server.RMIServerSocketFactory.createServerSocket.

Doc from java.rmi.server.RMIServerSocketFactory.createServerSocket.

Create a server socket on the specified port (port 0 indicates an anonymous port).

Annotations

@Override

Exceptions

IOException:: if an I/O error occurs during server socket creation

sun.management.jmxremote back to summary

private Class ConnectorBootstrap.HostAwareSslSocketFactory

Class Inheritance

extends SslRMIServerSocketFactory

java.lang.Object
javax.rmi.ssl.SslRMIServerSocketFactory
sun.management.jmxremote.ConnectorBootstrap.HostAwareSslSocketFactory

Field Summary

Modifier and Type	Field and Description
private final String	bindAddress
private final SSLContext	context Hides javax.rmi.ssl.SslRMIServerSocketFactory.context.

Constructor Summary

Access	Constructor and Description
private	HostAwareSslSocketFactory(String[] enabledCipherSuites, String[] enabledProtocols, boolean sslNeedClientAuth, String bindAddress)
private	HostAwareSslSocketFactory(SSLContext ctx, String[] enabledCipherSuites, String[] enabledProtocols, boolean sslNeedClientAuth, String bindAddress)

Method Summary

Modifier and Type	Method and Description
private static void	checkValues(SSLContext context, String[] enabledCipherSuites, String[] enabledProtocols)
public ServerSocket	createServerSocket(int port) Overrides javax.rmi.ssl.SslRMIServerSocketFactory.createServerSocket. Implements java.rmi.server.RMIServerSocketFactory.createServerSocket. Creates a server socket that accepts SSL connections configured according to this factory's SSL socket configuration parameters.

Inherited from javax.rmi.ssl.SslRMIServerSocketFactory:: equals getEnabledCipherSuites getEnabledProtocols getNeedClientAuth hashCode

Field Detail

bindAddress	back to summary
private final String bindAddress

context	back to summary
private final SSLContext context Hides javax.rmi.ssl.SslRMIServerSocketFactory.context.

Constructor Detail

HostAwareSslSocketFactory	back to summary
private HostAwareSslSocketFactory(String[] enabledCipherSuites, String[] enabledProtocols, boolean sslNeedClientAuth, String bindAddress) throws IllegalArgumentException

HostAwareSslSocketFactory	back to summary
private HostAwareSslSocketFactory(SSLContext ctx, String[] enabledCipherSuites, String[] enabledProtocols, boolean sslNeedClientAuth, String bindAddress) throws IllegalArgumentException

Method Detail

checkValues	back to summary
private static void checkValues(SSLContext context, String[] enabledCipherSuites, String[] enabledProtocols) throws IllegalArgumentException

createServerSocket

back to summary

public ServerSocket createServerSocket(int port) throws IOException

Overrides javax.rmi.ssl.SslRMIServerSocketFactory.createServerSocket.

Implements java.rmi.server.RMIServerSocketFactory.createServerSocket.

Doc from javax.rmi.ssl.SslRMIServerSocketFactory.createServerSocket.

Creates a server socket that accepts SSL connections configured according to this factory's SSL socket configuration parameters.

Annotations

@Override

Exceptions

IOException:

Doc from java.rmi.server.RMIServerSocketFactory.createServerSocket.

if an I/O error occurs during server socket creation

sun.management.jmxremote back to summary

private Class ConnectorBootstrap.JMXConnectorServerData

Class Inheritance

extends Object

java.lang.Object
sun.management.jmxremote.ConnectorBootstrap.JMXConnectorServerData

JMXConnectorServer associated data.

Field Summary

Modifier and Type	Field and Description
pack-priv JMXConnectorServer	jmxConnectorServer
pack-priv JMXServiceURL	jmxRemoteURL

Constructor Summary

Access	Constructor and Description
public	JMXConnectorServerData(JMXConnectorServer jmxConnectorServer, JMXServiceURL jmxRemoteURL)

Method Summary

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

jmxConnectorServer	back to summary
pack-priv JMXConnectorServer jmxConnectorServer

jmxRemoteURL	back to summary
pack-priv JMXServiceURL jmxRemoteURL

Constructor Detail

JMXConnectorServerData	back to summary
public JMXConnectorServerData(JMXConnectorServer jmxConnectorServer, JMXServiceURL jmxRemoteURL)

sun.management.jmxremote back to summary

private Class ConnectorBootstrap.PermanentExporter

Class Inheritance

extends Object
implements RMIExporter

java.lang.Object
sun.management.jmxremote.ConnectorBootstrap.PermanentExporter

All Implemented Interfaces

com.sun.jmx.remote.internal.rmi.RMIExporter

Prevents our RMI server objects from keeping the JVM alive.

We use a private interface in Sun's JMX Remote API implementation that allows us to specify how to export RMI objects. We do so using UnicastServerRef, a class in Sun's RMI implementation. This is all non-portable, of course, so this is only valid because we are inside Sun's JRE.

Objects are exported using UnicastServerRef#exportObject(Remote, Object, boolean). The boolean parameter is called permanent and means both that the object is not eligible for Distributed Garbage Collection, and that its continued existence will not prevent the JVM from exiting. It is the latter semantics we want (we already have the former because of the way the JMX Remote API works). Hence the somewhat misleading name of this class.

Field Summary

Modifier and Type	Field and Description
pack-priv Remote	firstExported

Constructor Summary

Access	Constructor and Description
private	PermanentExporter()

Method Summary

Modifier and Type	Method and Description
public Remote	exportObject(Remote obj, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf, ObjectInputFilter filter) Implements com.sun.jmx.remote.internal.rmi.RMIExporter.exportObject.
public boolean	unexportObject(Remote obj, boolean force) Implements com.sun.jmx.remote.internal.rmi.RMIExporter.unexportObject.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

firstExported	back to summary
pack-priv Remote firstExported

Constructor Detail

PermanentExporter	back to summary
private PermanentExporter()

Method Detail

exportObject	back to summary
public Remote exportObject(Remote obj, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf, ObjectInputFilter filter) throws RemoteException Implements com.sun.jmx.remote.internal.rmi.RMIExporter.exportObject.

unexportObject	back to summary
public boolean unexportObject(Remote obj, boolean force) throws NoSuchObjectException Implements com.sun.jmx.remote.internal.rmi.RMIExporter.unexportObject.

sun.management.jmxremote back to summary

public Interface ConnectorBootstrap.PropertyNames

Names of JMX configuration properties.

Field Summary

Modifier and Type	Field and Description
public static final String	ACCESS_FILE_NAME
public static final String	CONFIG_FILE_NAME
public static final String	HASH_PASSWORDS
public static final String	HOST
public static final String	LOCAL_PORT
public static final String	LOGIN_CONFIG_NAME
public static final String	PASSWORD_FILE_NAME
public static final String	PORT
public static final String	RMI_PORT
public static final String	SERIAL_FILTER_PATTERN
public static final String	SSL_CONFIG_FILE_NAME
public static final String	SSL_ENABLED_CIPHER_SUITES
public static final String	SSL_ENABLED_PROTOCOLS
public static final String	SSL_NEED_CLIENT_AUTH
public static final String	USE_AUTHENTICATION
public static final String	USE_LOCAL_ONLY
public static final String	USE_REGISTRY_SSL
public static final String	USE_SSL

Field Detail

ACCESS_FILE_NAME	back to summary
public static final String ACCESS_FILE_NAME

CONFIG_FILE_NAME	back to summary
public static final String CONFIG_FILE_NAME

HASH_PASSWORDS	back to summary
public static final String HASH_PASSWORDS

HOST	back to summary
public static final String HOST

LOCAL_PORT	back to summary
public static final String LOCAL_PORT

LOGIN_CONFIG_NAME	back to summary
public static final String LOGIN_CONFIG_NAME

PASSWORD_FILE_NAME	back to summary
public static final String PASSWORD_FILE_NAME

PORT	back to summary
public static final String PORT

RMI_PORT	back to summary
public static final String RMI_PORT

SERIAL_FILTER_PATTERN	back to summary
public static final String SERIAL_FILTER_PATTERN

SSL_CONFIG_FILE_NAME	back to summary
public static final String SSL_CONFIG_FILE_NAME

SSL_ENABLED_CIPHER_SUITES	back to summary
public static final String SSL_ENABLED_CIPHER_SUITES

SSL_ENABLED_PROTOCOLS	back to summary
public static final String SSL_ENABLED_PROTOCOLS

SSL_NEED_CLIENT_AUTH	back to summary
public static final String SSL_NEED_CLIENT_AUTH

USE_AUTHENTICATION	back to summary
public static final String USE_AUTHENTICATION

USE_LOCAL_ONLY	back to summary
public static final String USE_LOCAL_ONLY

USE_REGISTRY_SSL	back to summary
public static final String USE_REGISTRY_SSL

USE_SSL	back to summary
public static final String USE_SSL

sun.management.jmxremote back to summary

private Class ConnectorBootstrap.SslServerSocket

Class Inheritance

extends ServerSocket

java.lang.Object
java.net.ServerSocket
sun.management.jmxremote.ConnectorBootstrap.SslServerSocket

Field Summary

Modifier and Type	Field and Description
private final SSLContext	context
private static SSLSocketFactory	defaultSSLSocketFactory
private final String[]	enabledCipherSuites
private final String[]	enabledProtocols
private final boolean	needClientAuth

Constructor Summary

Access	Constructor and Description
private	SslServerSocket(int port, SSLContext ctx, String[] enabledCipherSuites, String[] enabledProtocols, boolean needClientAuth)
private	SslServerSocket(int port, int backlog, InetAddress bindAddr, SSLContext ctx, String[] enabledCipherSuites, String[] enabledProtocols, boolean needClientAuth)

Method Summary

Modifier and Type	Method and Description
public Socket	accept() Overrides java.net.ServerSocket.accept. Listens for a connection to be made to this socket and accepts it.
private static synchronized SSLSocketFactory	getDefaultSSLSocketFactory()

Field Detail

context	back to summary
private final SSLContext context

defaultSSLSocketFactory	back to summary
private static SSLSocketFactory defaultSSLSocketFactory

enabledCipherSuites	back to summary
private final String[] enabledCipherSuites

enabledProtocols	back to summary
private final String[] enabledProtocols

needClientAuth	back to summary
private final boolean needClientAuth

Constructor Detail

SslServerSocket	back to summary
private SslServerSocket(int port, SSLContext ctx, String[] enabledCipherSuites, String[] enabledProtocols, boolean needClientAuth) throws IOException

SslServerSocket	back to summary
private SslServerSocket(int port, int backlog, InetAddress bindAddr, SSLContext ctx, String[] enabledCipherSuites, String[] enabledProtocols, boolean needClientAuth) throws IOException

Method Detail

accept back to summary

public Socket accept() throws IOException

Overrides java.net.ServerSocket.accept.

Doc from java.net.ServerSocket.accept.

Listens for a connection to be made to this socket and accepts it. The method blocks until a connection is made.

This method is interruptible in the following circumstances:

The socket is associated with a ServerSocketChannel. In that case, interrupting a thread accepting a connection will close the underlying channel and cause this method to throw java.nio.channels.ClosedByInterruptException with the thread's interrupted status set.
The socket uses the system-default socket implementation and a virtual thread is accepting a connection. In that case, interrupting the virtual thread will cause it to wakeup and close the socket. This method will then throw SocketException with the thread's interrupted status set.

Annotations

@Override

Exceptions

IOException:: if an I/O error occurs when waiting for a connection, the socket is not bound or the socket is closed.

getDefaultSSLSocketFactory	back to summary
private static synchronized SSLSocketFactory getDefaultSSLSocketFactory()

public final Class ConnectorBootstrap

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class ConnectorBootstrap.AccessFileCheckerAuthenticator

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Interface ConnectorBootstrap.DefaultValues

Field Summary

Field Detail

private Class ConnectorBootstrap.HostAwareSocketFactory

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class ConnectorBootstrap.HostAwareSslSocketFactory

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private Class ConnectorBootstrap.JMXConnectorServerData

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

private Class ConnectorBootstrap.PermanentExporter

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

public Interface ConnectorBootstrap.PropertyNames

Field Summary

Field Detail

private Class ConnectorBootstrap.SslServerSocket

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail