OpenJDK 27 · com.sun.tools.jdi.SunCommandLineLauncher

Field Summary

Modifier and Type	Field and Description
private static final String	ARG_HOME
private static final String	ARG_INIT_SUSPEND
private static final String	ARG_MAIN
private static final String	ARG_OPTIONS
private static final String	ARG_QUOTE
private static final String	ARG_VM_EXEC
private static final String	ARG_VM_INCLUDE_VTHREADS
pack-priv Transport	transport
pack-priv TransportService	transportService
pack-priv boolean	usingSharedMemory

Inherited from com.sun.tools.jdi.AbstractLauncher:: grp

Constructor Summary

Access	Constructor and Description
public	SunCommandLineLauncher()

Method Summary

Modifier and Type	Method and Description
public String	description() Implements abstract com.sun.tools.jdi.AbstractLauncher.description. Implements com.sun.jdi.connect.Connector.description. Returns a human-readable description of this connector and its purpose.
pack-priv static boolean	hasWhitespace(String string)
public VirtualMachine	launch(Map<String, ? extends Connector.Argument> arguments) Implements abstract com.sun.tools.jdi.AbstractLauncher.launch. Implements com.sun.jdi.connect.LaunchingConnector.launch. Launches an application and connects to its VM.
public String	name() Implements abstract com.sun.tools.jdi.AbstractLauncher.name. Implements com.sun.jdi.connect.Connector.name. Returns a short identifier for the connector.
public Transport	transport() Implements com.sun.jdi.connect.Connector.transport. Returns the transport mechanism used by this connector to establish connections with a target VM.
pack-priv TransportService	transportService()

Inherited from com.sun.tools.jdi.AbstractLauncher:: launch tokenizeCommand

Field Detail

ARG_HOME	back to summary
private static final String ARG_HOME

ARG_INIT_SUSPEND	back to summary
private static final String ARG_INIT_SUSPEND

ARG_MAIN	back to summary
private static final String ARG_MAIN

ARG_OPTIONS	back to summary
private static final String ARG_OPTIONS

ARG_QUOTE	back to summary
private static final String ARG_QUOTE

ARG_VM_EXEC	back to summary
private static final String ARG_VM_EXEC

ARG_VM_INCLUDE_VTHREADS	back to summary
private static final String ARG_VM_INCLUDE_VTHREADS

transport	back to summary
pack-priv Transport transport

transportService	back to summary
pack-priv TransportService transportService

usingSharedMemory	back to summary
pack-priv boolean usingSharedMemory

Constructor Detail

SunCommandLineLauncher	back to summary
public SunCommandLineLauncher()

Method Detail

description	back to summary
public String description() Implements abstract com.sun.tools.jdi.AbstractLauncher.description. Implements com.sun.jdi.connect.Connector.description. Doc from com.sun.jdi.connect.Connector.description. Returns a human-readable description of this connector and its purpose.

description

back to summary

public String description()

Implements abstract com.sun.tools.jdi.AbstractLauncher.description.

Implements com.sun.jdi.connect.Connector.description.

Doc from com.sun.jdi.connect.Connector.description.

Returns a human-readable description of this connector and its purpose.

hasWhitespace	back to summary
pack-priv static boolean hasWhitespace(String string)

launch back to summary

launch	back to summary
public VirtualMachine launch(Map<String, ? extends Connector.Argument> arguments) throws IOException, IllegalConnectorArgumentsException, VMStartException Implements abstract com.sun.tools.jdi.AbstractLauncher.launch. Implements com.sun.jdi.connect.LaunchingConnector.launch. Doc from com.sun.jdi.connect.LaunchingConnector.launch. Launches an application and connects to its VM. Properties of the launch (possibly including options, main class, and arguments) are specified in `arguments`. The argument map associates argument name strings to instances of `Connector.Argument`. The default argument map for a connector can be obtained through `Connector#defaultArguments`. Argument map values can be changed, but map entries should not be added or deleted. A target VM launched by a launching connector is not guaranteed to be stable until after the `VMStartEvent` has been received. Important Note If a target VM is launched through this funcctions, its output and error streams must be read as it executes. These streams are available through the `Process` object returned by `VirtualMachine#process`. If the streams are not periodically read, the target VM will stop executing when the buffers for these streams are filled. Exceptions IOException: when unable to launch. Specific exceptions are dependent on the Connector implementation in use. IllegalConnectorArgumentsException: when one of the connector arguments is invalid. VMStartException: when the VM was successfully launched, but terminated with an error before a connection could be established.

public VirtualMachine launch(Map<String, ? extends Connector.Argument> arguments) throws IOException, IllegalConnectorArgumentsException, VMStartException

Implements abstract com.sun.tools.jdi.AbstractLauncher.launch.

Implements com.sun.jdi.connect.LaunchingConnector.launch.

Doc from com.sun.jdi.connect.LaunchingConnector.launch.

Launches an application and connects to its VM. Properties of the launch (possibly including options, main class, and arguments) are specified in arguments. The argument map associates argument name strings to instances of Connector.Argument. The default argument map for a connector can be obtained through Connector#defaultArguments. Argument map values can be changed, but map entries should not be added or deleted.

A target VM launched by a launching connector is not guaranteed to be stable until after the VMStartEvent has been received.

Important Note

If a target VM is launched through this funcctions, its output and error streams must be read as it executes. These streams are available through the Process object returned by VirtualMachine#process. If the streams are not periodically read, the target VM will stop executing when the buffers for these streams are filled.

Exceptions

IOException:: when unable to launch. Specific exceptions are dependent on the Connector implementation in use.
IllegalConnectorArgumentsException:: when one of the connector arguments is invalid.
VMStartException:: when the VM was successfully launched, but terminated with an error before a connection could be established.

name	back to summary
public String name() Implements abstract com.sun.tools.jdi.AbstractLauncher.name. Implements com.sun.jdi.connect.Connector.name. Doc from com.sun.jdi.connect.Connector.name. Returns a short identifier for the connector. Connector implementors should follow similar naming conventions as are used with packages to avoid name collisions. For example, the Sun connector implementations have names prefixed with "com.sun.jdi.". Not intended for exposure to end-user.

name

back to summary

public String name()

Implements abstract com.sun.tools.jdi.AbstractLauncher.name.

Implements com.sun.jdi.connect.Connector.name.

Doc from com.sun.jdi.connect.Connector.name.

Returns a short identifier for the connector. Connector implementors should follow similar naming conventions as are used with packages to avoid name collisions. For example, the Sun connector implementations have names prefixed with "com.sun.jdi.". Not intended for exposure to end-user.

transport	back to summary
public Transport transport() Implements com.sun.jdi.connect.Connector.transport. Doc from com.sun.jdi.connect.Connector.transport. Returns the transport mechanism used by this connector to establish connections with a target VM.

transport

back to summary

public Transport transport()

Implements com.sun.jdi.connect.Connector.transport.

Doc from com.sun.jdi.connect.Connector.transport.

Returns the transport mechanism used by this connector to establish connections with a target VM.

transportService	back to summary
pack-priv TransportService transportService()

public Class SunCommandLineLauncher

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail