sun.tools.attach

Class SolarisAttachProvider

java.lang.Object

com.sun.tools.attach.spi.AttachProvider

sun.tools.attach.HotSpotAttachProvider

sun.tools.attach.SolarisAttachProvider

public class SolarisAttachProvider
extends HotSpotAttachProvider

Constructor Summary

Constructors

Constructor and Description
SolarisAttachProvider()

Method Summary

Modifier and Type	Method and Description
VirtualMachine	attachVirtualMachine(String vmid) Attaches to a Java virtual machine.
VirtualMachine	attachVirtualMachine(VirtualMachineDescriptor vmd) Attaches to a Java virtual machine.
String	name() Return this provider's name.
String	type() Return this provider's type.

Methods inherited from class sun.tools.attach.HotSpotAttachProvider

checkAttachPermission, listVirtualMachines

Methods inherited from class com.sun.tools.attach.spi.AttachProvider

providers

Methods inherited from class java.lang.Object

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

Constructor Detail

SolarisAttachProvider

public SolarisAttachProvider()

Method Detail

name

public String name()

Description copied from class: AttachProvider

Return this provider's name.

Specified by:

name in class AttachProvider

Returns:

The name of this provider

type

public String type()

Description copied from class: AttachProvider

Return this provider's type.

Specified by:

type in class AttachProvider

Returns:

The type of this provider

attachVirtualMachine

public VirtualMachine attachVirtualMachine(String vmid)
                                    throws AttachNotSupportedException,
                                           IOException

Description copied from class: AttachProvider

Attaches to a Java virtual machine.

A Java virtual machine is identified by an abstract identifier. The nature of this identifier is platform dependent but in many cases it will be the string representation of the process identifier (or pid).

This method parses the identifier and maps the identifier to a Java virtual machine (in an implementation dependent manner). If the identifier cannot be parsed by the provider then an AttachNotSupportedException is thrown. Once parsed this method attempts to attach to the Java virtual machine. If the provider detects that the identifier corresponds to a Java virtual machine that does not exist, or it corresponds to a Java virtual machine that does not support the attach mechanism implemented by this provider, or it detects that the Java virtual machine is a version to which this provider cannot attach, then an AttachNotSupportedException is thrown.

Specified by:

attachVirtualMachine in class AttachProvider

Parameters:

vmid - The abstract identifier that identifies the Java virtual machine.

Returns:

VirtualMachine representing the target virtual machine.

Throws:

AttachNotSupportedException - If the identifier cannot be parsed, or it corresponds to to a Java virtual machine that does not exist, or it corresponds to a Java virtual machine which this provider cannot attach.

IOException - If some other I/O error occurs

attachVirtualMachine

public VirtualMachine attachVirtualMachine(VirtualMachineDescriptor vmd)
                                    throws AttachNotSupportedException,
                                           IOException

Description copied from class: AttachProvider

Attaches to a Java virtual machine.

A Java virtual machine can be described using a VirtualMachineDescriptor. This method invokes the descriptor's provider() method to check that it is equal to this provider. It then attempts to attach to the Java virtual machine.

Overrides:

attachVirtualMachine in class AttachProvider

Parameters:

vmd - The virtual machine descriptor

Returns:

VirtualMachine representing the target virtual machine.

Throws:

AttachNotSupportedException - If the descriptor's provider() method returns a provider that is not this provider, or it does not correspond to a Java virtual machine to which this provider can attach.

IOException - If some other I/O error occurs