kamon.sigar

Class SigarProvisioner

java.lang.Object

kamon.sigar.SigarProvisioner

public class SigarProvisioner
extends java.lang.Object

Sigar native library extractor and loader. To provision sigar native library at the given folder location:

 SigarProvisioner.provision(new File(location));
 

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DEFAULT_LOCATION Hard coded value which provides sigar extract location.
static java.lang.String	ENVIRONMENT_VARIABLE Environment variable which provides sigar extract location.
static java.lang.String	LIB_DIR Location of native libraries.
static java.lang.String	SYSTEM_PROPERTY System property which provides sigar extract location.

Constructor Summary

Constructors

Constructor and Description
SigarProvisioner()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	discoverLocation(java.lang.String options) Discover sigar library extract location.
static boolean	isNativeLoaded() Verify if sigar native library is loaded and operational.
static void	provision() Extract and load native sigar library in the default folder.
static void	provision(java.io.File folder) Extract and load native sigar library in the provided folder.
static void	transfer(java.io.InputStream input, java.io.OutputStream output) Perform stream copy.

Methods inherited from class java.lang.Object

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

Field Detail

LIB_DIR

public static final java.lang.String LIB_DIR

Location of native libraries.

 when stored in loader.jar:     /${LIB_DIR}/libsigar-xxx.so
 after default load/extract:    ${user.dir}/${LIB_DIR}/libsigar-xxx.so
 

See Also:

Constant Field Values

ENVIRONMENT_VARIABLE

public static final java.lang.String ENVIRONMENT_VARIABLE

Environment variable which provides sigar extract location.

See Also:

Constant Field Values

SYSTEM_PROPERTY

public static final java.lang.String SYSTEM_PROPERTY

System property which provides sigar extract location.

See Also:

Constant Field Values

DEFAULT_LOCATION

public static final java.lang.String DEFAULT_LOCATION

Hard coded value which provides sigar extract location.

Constructor Detail

SigarProvisioner

public SigarProvisioner()

Method Detail

discoverLocation

public static java.lang.String discoverLocation(java.lang.String options)

Discover sigar library extract location.
Priority 1) user provided command line agent options.
Priority 2) user provided o/s environment variable.
Priority 3) user provided java system property.
Priority 4) hard coded location in ${user.dir}/native.

Parameters:

options - Command line agent options.

Returns:

Discovered sigar library extract location.

isNativeLoaded

public static boolean isNativeLoaded()

Verify if sigar native library is loaded and operational.

Returns:

true, if is native library loaded.

provision

public static void provision()
                      throws java.lang.Exception

Extract and load native sigar library in the default folder.

Throws:

java.lang.Exception - The provisioning failure exception.

provision

public static void provision(java.io.File folder)
                      throws java.lang.Exception

Extract and load native sigar library in the provided folder.

Parameters:

folder - Library extraction folder.

Throws:

java.lang.Exception - The provisioning failure exception.

transfer

public static void transfer(java.io.InputStream input,
                            java.io.OutputStream output)
                     throws java.lang.Exception

Perform stream copy.

Parameters:

input - The input stream.

output - The output stream.

Throws:

java.lang.Exception - The stream copy failure exception.