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
java.lang.IllegalArgumentException
java.io.FileNotFoundException
java.io.IOException
com.sun.tools.attach.AttachNotSupportedException
com.sun.tools.attach.AgentLoadException
com.sun.tools.attach.AgentInitializationException
public 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 © 2013. All Rights Reserved.