Go to file
Shirou WAKAYAMA 5ed730e5d0 Merge branch 'master' of github.com:shirou/gopsutil 2014-04-24 19:14:41 +09:00
.gitignore initial import. 2014-04-18 16:34:47 +09:00
LICENSE update README and add LICENSE file. 2014-04-22 12:31:36 +09:00
README.rst update README 2014-04-24 00:31:57 +09:00
common.go go fmt 2014-04-23 10:33:55 +09:00
common_freebsd.go go fmt 2014-04-22 12:43:31 +09:00
common_windows.go implement Boot_time on windows. But something is wrong. the returned value is not correct. 2014-04-22 22:10:13 +09:00
cpu.go gm fmt 2014-04-24 17:20:12 +09:00
cpu_freebsd.go change uint64 to float32. 2014-04-24 16:15:57 +09:00
cpu_linux.go change uint64 to float32. 2014-04-24 16:15:57 +09:00
cpu_test.go remove each metrics top struct such as CPU, all functions become flat. 2014-04-22 10:02:01 +09:00
cpu_windows.go change uint64 to float32. 2014-04-24 16:15:57 +09:00
disk.go remove each metrics top struct such as CPU, all functions become flat. 2014-04-22 10:02:01 +09:00
disk_freebsd.go separete struct defs to architecture specific files. 2014-04-23 10:35:27 +09:00
disk_freebsd_amd64.go separete struct defs to architecture specific files. 2014-04-23 10:35:27 +09:00
disk_linux.go separete struct defs to architecture specific files. 2014-04-23 10:35:27 +09:00
disk_test.go remove each metrics top struct such as CPU, all functions become flat. 2014-04-22 10:02:01 +09:00
disk_unix.go implements disk_partitions on freebsd. 2014-04-22 19:25:28 +09:00
disk_windows.go fix windows 2014-04-22 21:39:18 +09:00
host.go implements users() on linux. 2014-04-22 17:38:47 +09:00
host_freebsd.go separete struct defs to architecture specific files. 2014-04-23 10:35:27 +09:00
host_freebsd_amd64.go separete struct defs to architecture specific files. 2014-04-23 10:35:27 +09:00
host_linux.go separete struct defs to architecture specific files. 2014-04-23 10:35:27 +09:00
host_linux_amd64.go separete struct defs to architecture specific files. 2014-04-23 10:35:27 +09:00
host_test.go go fmt 2014-04-22 17:40:01 +09:00
host_windows.go change to use procGetTickCount.Call() instead of syscall. 2014-04-23 22:04:27 +09:00
load.go remove each metrics top struct such as CPU, all functions become flat. 2014-04-22 10:02:01 +09:00
load_freebsd.go go fmt 2014-04-22 12:43:31 +09:00
load_linux.go remove each metrics top struct such as CPU, all functions become flat. 2014-04-22 10:02:01 +09:00
load_test.go remove each metrics top struct such as CPU, all functions become flat. 2014-04-22 10:02:01 +09:00
load_windows.go fix windows 2014-04-22 21:39:18 +09:00
mem.go remove each metrics top struct such as CPU, all functions become flat. 2014-04-22 10:02:01 +09:00
mem_freebsd.go syscall.SysInfo not exists in FreeBSD. use sysctl instead. 2014-04-22 11:58:03 +09:00
mem_linux.go linux file still exists. rename it. 2014-04-22 12:04:16 +09:00
mem_test.go remove each metrics top struct such as CPU, all functions become flat. 2014-04-22 10:02:01 +09:00
mem_windows.go fix windows 2014-04-22 21:39:18 +09:00
net.go first commit of process in linux. 2014-04-23 17:57:47 +09:00
process.go posix function move to process_posix.go 2014-04-24 18:28:45 +09:00
process_freebsd.go remove Refresh func. 2014-04-24 00:23:21 +09:00
process_freebsd_amd64.go add initial placeholder of process functions. 2014-04-23 12:26:21 +09:00
process_linux.go implements Create_time of process_linux. 2014-04-24 19:08:07 +09:00
process_linux_amd64.go fix CLOCK_TICKS 2014-04-24 19:07:34 +09:00
process_posix.go cast rdev to uint64 2014-04-24 19:14:00 +09:00
process_test.go change test pid if windows 2014-04-24 01:07:15 +09:00
process_windows.go start to get windows process information 2014-04-24 01:07:38 +09:00

README.rst

gopsutil: psutil for golang
==============================

This is a port of psutil(http://pythonhosted.org/psutil/). This
challenges porting all psutil functions on some architectures.

Available archtectures
------------------------------------

- FreeBSD/amd64
- Linux/amd64
- Windows/amd64

(I do not have a darwin machine)


All works are implemented without cgo by porting c struct to golang struct.


usage
---------

::

  import (
      "github.com/shirou/gopsutil"
      "fmt"
      "encoding/json"
  )

  func main(){
      v, _ := gopsutil.Virtual_memory()

      // return value is struct
      fmt.Printf("Total: %v, Free:%v, UsedPercent:%f%%\n", v.Total, v.Free, v.UsedPercent)

      // convert to JSON
      d, _ := json.Marshal(v)
      fmt.Printf("%s\n", d)
  }

The output is below.

::

  Total: 3179569152, Free:284233728, UsedPercent:84.508194%
  {"total":3179569152,"available":492572672,"used":2895335424,"usedPercent":84.50819439828305, (snip)}


Document
----------

see http://godoc.org/github.com/shirou/gopsutil


Current Status
------------------

- done

  - cpu_times (linux, freebsd)
  - cpu_count (linux, freebsd, windows)
  - virtual_memory (linux, windows)
  - swap_memory (linux)
  - disk_partitions (freebsd, windows)
  - disk_usage (linux, freebsd, windows)
  - boot_time (linux, freebsd, windows(but little broken))
  - users (linux, freebsd)
  - pids (linux, freebsd)
  - pid_exists (linux, freebsd)

- not yet

  - cpu_percent
  - cpu_times_percent
  - disk_io_counters
  - net_io_counters
  - net_connections
  - Process class

- future work

  - process_iter
  - wait_procs



License
------------

New BSD License (same as psutil)


Related works
-----------------------

So many thanks!

- psutil: http://pythonhosted.org/psutil/
- dstat: https://github.com/dagwieers/dstat
- gosiger: https://github.com/cloudfoundry/gosigar/
- goprocinfo: https://github.com/c9s/goprocinfo
- go-ps: https://github.com/mitchellh/go-ps