https://github.com/hiwepy/sigar-native

基于sigar实现的类库和Sigar对象工厂
https://github.com/hiwepy/sigar-native

Last synced: 24 days ago
JSON representation

基于sigar实现的类库和Sigar对象工厂

• Host: GitHub
• URL: https://github.com/hiwepy/sigar-native
• Owner: hiwepy
• License: apache-2.0
• Created: 2017-06-20T13:34:22.000Z (over 7 years ago)
• Default Branch: master
• Last Pushed: 2019-12-30T14:37:07.000Z (about 5 years ago)
• Last Synced: 2023-07-26T21:57:55.495Z (over 1 year ago)
• Language: Java
• Size: 3.58 MB
• Stars: 0
• Watchers: 3
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        

Sigar（全称System Information Gatherer And Reporter，即系统信息收集报表器），它提供了一个开源的跨平台的收集计算机硬件和操作系统信息的API（该API底层接口用C语言编写）.

### Kamon Sigar Loader

Provides convenient self-contained [Sigar](https://github.com/hyperic/sigar) 

classes with native library deployment and provisioning mechanism with JDK-only dependencies

for the following common use cases:

* Java Agent: automatic extract/load at JVM start time

* Programmatically: embedded library extraction

* Framework Contract: OSGI bundle activation

#### To load as JVM java agent:

```

#

# Extract to default location: ${user.dir}/native

java -javaagent:/path/to/sigar-loader.jar ...

#

# Extract to provided library extract location.

java -javaagent:/path/to/sigar-loader.jar=kamon.sigar.folder=/path/to/library/extract/folder ...

```

Sigar loader agent can also be provided via

[JVM attach API](https://docs.oracle.com/javase/7/docs/jdk/api/attach/spec/com/sun/tools/attach/VirtualMachine.html)

#### To load programmatically from your code:

```

// Required imports.

		import java.io.File;

		import org.hyperic.sigar.Sigar;

		import kamon.sigar.SigarProvisioner;

// Extract to default location: ${user.dir}/native 

		SigarProvisioner.provision();

		final Sigar sigar = new Sigar();

// Extract to user provided library extract location.

		final File location = new File("target/native");

		SigarProvisioner.provision(location);

		final Sigar sigar = new Sigar();

```

#### To load during OSGI bundle activation:

```

karaf@root()> bundle:install mvn:io.kamon/sigar-loader/1.6.5-rev001

```

#### Default extract location

Default library extract location used by

* ```java -javaagent:/path/to/sigar-loader.jar``` and

* ```SigarProvisioner.provision()```

will be selected in the following priority order:

 1. environment variable ```KAMON_SIGAR_FOLDER```

 2. system property ```kamon.sigar.folder```

 3. hard coded ```${user.dir}/native```

#### Extract location in OSGI

Bundle activator will use framework persistent bundle storage location.

#### Repeated provision attempts

Sigar loader ensures that native library is loaded exactly once.