|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.jboss.byteman.agent.install.Install
public class Install
A program which uses the sun.com.tools.attach.VirtualMachine class to install the Byteman agent into a running JVM. This provides an alternative to using the -javaagent option to install the agent.
Method Summary | |
---|---|
static VMInfo[] |
availableVMs()
|
static java.lang.String |
getSystemProperty(java.lang.String id,
java.lang.String property)
attach to the virtual machine identified by id and return the value of the named property. |
static void |
install(java.lang.String pid,
boolean addToBoot,
java.lang.String host,
int port,
java.lang.String[] properties)
|
void |
locateAgentFromClasspath()
|
void |
locateAgentFromHomeDir(java.lang.String bmHome)
|
static void |
main(java.lang.String[] args)
main routine for use from command line Install [-h host] [-p port] [-b] pid see method usage(int) for details of the command syntax |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method Detail |
---|
public static void main(java.lang.String[] args)
usage(int)
for details of the command syntax
args
- the command optionspublic static void install(java.lang.String pid, boolean addToBoot, java.lang.String host, int port, java.lang.String[] properties) throws java.lang.IllegalArgumentException, java.io.FileNotFoundException, java.io.IOException, com.sun.tools.attach.AttachNotSupportedException, com.sun.tools.attach.AgentLoadException, com.sun.tools.attach.AgentInitializationException
pid
- the process id of the JVM into which the agent should be installed or 0 for this JVMaddToBoot
- true if the agent jar should be installed into the bootstrap classpathhost
- the hostname to be used by the agent listener or null for localhostport
- the port to be used by the agent listener or 0 for the default portproperties
- an array of System properties to be installed by the agent with optional values e.g.
values such as "org.jboss.byteman.verbose" or "org.jboss.byteman.dump.generated.classes.directory=./dump"
java.lang.IllegalArgumentException
- if any of the arguments is invalid
java.io.FileNotFoundException
- if the agent jar cannot be found using the environment variable BYTEMAN_HOME
or the System property org.jboss.byteman.home and cannot be located in the current classpath
java.io.IOException
- if the byteman jar cannot be opened or uploaded to the requested JVM
com.sun.tools.attach.AttachNotSupportedException
- if the requested JVM cannot be attached to
com.sun.tools.attach.AgentLoadException
- if an error occurs during upload of the agent into the JVM
com.sun.tools.attach.AgentInitializationException
- if the agent fails to initialize after loading. this almost always
indicates that the agent is already loaded into the JVMpublic static VMInfo[] availableVMs()
public static java.lang.String getSystemProperty(java.lang.String id, java.lang.String property)
id
- the id of the machine to attach toproperty
- the proeprty to be retrieved
public void locateAgentFromHomeDir(java.lang.String bmHome) throws java.io.IOException
java.io.IOException
public void locateAgentFromClasspath() throws java.io.IOException
java.io.IOException
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |