public class Install
extends java.lang.Object
Modifier and Type | Method and Description |
---|---|
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,
boolean setPolicy,
java.lang.String host,
int port,
java.lang.String[] properties) |
static void |
install(java.lang.String pid,
boolean addToBoot,
java.lang.String host,
int port,
java.lang.String[] properties)
compatability mode
|
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] [-s] [-Dorg.jboss.Byteman.xxx]* pid
see method
usage(int) for details of the command syntax |
public static void main(java.lang.String[] args)
usage(int)
for details of the command syntaxargs
- 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 invalidjava.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 classpathjava.io.IOException
- if the byteman jar cannot be opened or uploaded to the requested JVMcom.sun.tools.attach.AttachNotSupportedException
- if the requested JVM cannot be attached tocom.sun.tools.attach.AgentLoadException
- if an error occurs during upload of the agent into the JVMcom.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 void install(java.lang.String pid, boolean addToBoot, boolean setPolicy, 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 classpathsetPolicy
- true if the agent jar should set an access-all-areas securityPolicyhost
- 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 invalidjava.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 classpathjava.io.IOException
- if the byteman jar cannot be opened or uploaded to the requested JVMcom.sun.tools.attach.AttachNotSupportedException
- if the requested JVM cannot be attached tocom.sun.tools.attach.AgentLoadException
- if an error occurs during upload of the agent into the JVMcom.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 retrievedpublic void locateAgentFromHomeDir(java.lang.String bmHome) throws java.io.IOException
java.io.IOException
public void locateAgentFromClasspath() throws java.io.IOException
java.io.IOException
Copyright © 2015. All Rights Reserved.