ruby-libgtop2 0.1.0

data/CHANGELOG.txt

@@ -0,0 +1,30 @@
+2007-04-12 DATE Ken <itacchi@gmail.com>
+
+  * check & merge new features (libgtop 2.0.0 - 2.14.8)
+  * implement rb_glibtop_proc_open.c
+  * implement rb_glibtop_netlist.c
+
+2007-03-13 DATE Ken <itacchi@gmail.com>
+
+  * Licence re-changed (GPL to Ruby's)
+
+2004-09-27 DATE Ken <itacchi@gmail.com>
+
+  * setup.rb: updated 3.3.0
+  * Licence changed (Ruby's to GPL)
+
+2004-09-25 DATE Ken <itacchi@gmail.com>
+
+  * rb_glibtop_time.c: added xcpu_flags
+
+2004-09-21 DATE Ken <itacchi@gmail.com>
+
+  * rb_glibtop_cpu.c: remove debug statement
+
+2004-09-20 DATE Ken <itacchi@gmail.com>
+
+  * first release
+
+2004-09-19 DATE Ken <itacchi@gmail.com>
+
+  * just started

data/History.txt

@@ -0,0 +1,6 @@
+2007-04-12
+
+ * 0.1.0
+ * gem ready
+ * first version on rubyforge
+ * add LibGTop#proc_open_files and LibGTop#netlist

data/INSTALL.txt

@@ -0,0 +1,19 @@
+Ruby/LibGTop2 installation
+
+Requirements:
+ - Ruby-1.8.x
+ - libgtop-2.6 or later(*1)
+ - pkg-config (*2)
+
+Installaion:
+ $ ruby setup.rb config
+ $ ruby setup.rb setup
+ # ruby setup.rb install
+
+ or
+
+ # gem install ruby-libgtop2
+
+---
+*1 It possibly works with 2.0 (even 1.9?), but I tested only 2.6.
+*2 extconf.rb use it.

data/Manifest.txt

@@ -0,0 +1,53 @@
+CHANGELOG.txt
+History.txt
+INSTALL.txt
+Manifest.txt
+README.txt
+Rakefile
+TODO
+TUTORIAL.txt
+examples/README
+examples/first.rb
+examples/mountlist.rb
+examples/netload.rb
+examples/procmap.rb
+examples/second.rb
+examples/smp.rb
+examples/sysdeps.rb
+ext/libgtop/MANIFEST
+ext/libgtop/Makefile
+ext/libgtop/extconf.rb
+ext/libgtop/mkmf.log
+ext/libgtop/rb_glibtop.c
+ext/libgtop/rb_glibtop.h
+ext/libgtop/rb_glibtop_cpu.c
+ext/libgtop/rb_glibtop_fsusage.c
+ext/libgtop/rb_glibtop_init.c
+ext/libgtop/rb_glibtop_loadavg.c
+ext/libgtop/rb_glibtop_mem.c
+ext/libgtop/rb_glibtop_mountlist.c
+ext/libgtop/rb_glibtop_msg_limits.c
+ext/libgtop/rb_glibtop_netlist.c
+ext/libgtop/rb_glibtop_netload.c
+ext/libgtop/rb_glibtop_ppp.c
+ext/libgtop/rb_glibtop_proc_args.c
+ext/libgtop/rb_glibtop_proc_kernel.c
+ext/libgtop/rb_glibtop_proc_map.c
+ext/libgtop/rb_glibtop_proc_mem.c
+ext/libgtop/rb_glibtop_proc_open_files.c
+ext/libgtop/rb_glibtop_proc_segment.c
+ext/libgtop/rb_glibtop_proc_signal.c
+ext/libgtop/rb_glibtop_proc_state.c
+ext/libgtop/rb_glibtop_proc_time.c
+ext/libgtop/rb_glibtop_proc_uid.c
+ext/libgtop/rb_glibtop_proclist.c
+ext/libgtop/rb_glibtop_sem_limits.c
+ext/libgtop/rb_glibtop_shm_limits.c
+ext/libgtop/rb_glibtop_swap.c
+ext/libgtop/rb_glibtop_sysdeps.c
+ext/libgtop/rb_glibtop_uptime.c
+lib/libgtop.rb
+lib/libgtop/version.rb
+setup.rb
+test/ruby-libgtop2_test.rb
+test/test_helper.rb

data/README.txt

@@ -0,0 +1,21 @@
+Ruby/LibGTop2 README
+
+What is:
+ Ruby/LibGtop2 is a wrapper library of a GNOME libgtop version2.x for Ruby.
+
+Requirements:
+ - ruby-1.8.x: http://www.ruby-lang.org/
+ - libgtop-2.x: http://ftp.gnome.org/pub/gnome/sources/libgtop/
+ - pkg-config: http://www.freedesktop.org/Software/pkgconfig
+
+Installation:
+ see INSTALL.*
+
+Documentations:
+ see libgtop's info...
+
+License:
+ Ruby's
+
+References:
+ - ruby_libgtop: http://raa.ruby-lang.org/project/ruby_libgtop/

data/Rakefile

@@ -0,0 +1,59 @@
+require 'rubygems'
+require 'rake'
+require 'rake/clean'
+require 'rake/testtask'
+require 'rake/packagetask'
+require 'rake/gempackagetask'
+require 'rake/rdoctask'
+require 'rake/contrib/rubyforgepublisher'
+require 'fileutils'
+require 'hoe'
+include FileUtils
+require File.join(File.dirname(__FILE__), 'lib', 'libgtop', 'version')
+
+AUTHOR = "date"  # can also be an array of Authors
+EMAIL = "itacchi@gmail.com"
+DESCRIPTION = "Ruby bindings for GNOME libgtop version2.x. "
+GEM_NAME = "ruby-libgtop2" # what ppl will type to install your gem
+RUBYFORGE_PROJECT = "ruby-libgtop2" # The unix name for your project
+HOMEPATH = "http://#{RUBYFORGE_PROJECT}.rubyforge.org"
+
+
+NAME = "ruby-libgtop2"
+REV = File.read(".svn/entries")[/committed-rev="(d+)"/, 1] rescue nil
+VERS = ENV['VERSION'] || (LibGTop::VERSION::STRING + (REV ? ".#{REV}" : ""))
+                          CLEAN.include ['**/.*.sw?', '*.gem', '.config']
+RDOC_OPTS = ['--quiet', '--title', "ruby-libgtop2 documentation",
+    "--opname", "index.html",
+    "--line-numbers", 
+    "--main", "README",
+    "--inline-source"]
+
+class Hoe
+  def extra_deps 
+    @extra_deps.reject { |x| Array(x).first == 'hoe' } 
+  end 
+end
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+hoe = Hoe.new(GEM_NAME, VERS) do |p|
+  p.author = AUTHOR 
+  p.description = DESCRIPTION
+  p.email = EMAIL
+  p.summary = DESCRIPTION
+  p.url = HOMEPATH
+  p.rubyforge_name = RUBYFORGE_PROJECT if RUBYFORGE_PROJECT
+  p.test_globs = ["test/**/*_test.rb"]
+  p.clean_globs = CLEAN  #An array of file patterns to delete on clean.
+  
+  # == Optional
+  #p.changes        - A description of the release's latest changes.
+  #p.extra_deps     - An array of rubygem dependencies.
+  #p.spec_extras    - A hash of extra values to set in the gemspec.
+
+  p.rdoc_pattern = /^(lib|bin|ext)|txt$/
+  p.spec_extras = {
+    :extensions => ['ext/libgtop/extconf.rb']
+  }
+end

data/TODO

@@ -0,0 +1,4 @@
+* use Struct instead of Hash
+* documents
+* tests
+* add examples

data/TUTORIAL.txt

@@ -0,0 +1,28 @@
+Ruby/LibGTop2 tutorial
+
+1. install Ruby
+ You install Ruby the Object-Oriented Scripting Language.
+ Go http://www.ruby-lang.org/en/.
+
+2. install libgtop 2.x and pkg-config
+ * http://ftp.gnome.org/pub/gnome/sources/libgtop/
+ * http://pkgconfig.freedesktop.org/releases/
+
+2. install Ruby/LibGTop2 and other requirements
+ see INSTALL.*
+
+3. write code
+
+  # example code
+  # show mem info like as top(1)
+  require 'libgtop'
+  gtop = LibGTop.new
+  gtop.init
+  # get mem info
+  mem = gtop.mem
+  # all of results are Hash object
+  printf "Mem:    %uk total,    %uk used,    %uk free,    %uk buffers\n",
+         mem["total"] / 1024, mem["used"] / 1024,
+         mem["free"] / 1024, mem["buffer"] / 1024
+
+ See examples/ for more detail.

data/examples/README

@@ -0,0 +1 @@
+port of libgtop's example directory

data/examples/first.rb

@@ -0,0 +1,220 @@
+#!/usr/bin/env ruby
+
+$:.unshift('../ext/')
+require 'libgtop'
+
+def format(i)
+  "%u" % i
+end
+
+def data2str(data, ary, delimiter = ", ")
+  str =
+    ary.collect do |i|
+      Array(data[i]).flatten.join(delimiter)
+    end.join(delimiter)
+  sprintf "(0x%08x): #{str}", data["flags"]
+end
+
+def print_result(label, data, columns)
+  result = data2str(data, columns)
+  print "#{label}" + " " * (13 - label.size) + "#{result}\n"
+end
+
+def print_result_with_pid(label, pid, data, columns)
+  result = data2str(data, columns, " ")
+  print "#{label}" + " " * (13 - label.size) + "PID  #{pid} #{result}\n"
+end
+
+def print_result_with_ppid(label, ppid, data, columns)
+  result = data2str(data, columns, " ")
+  print "#{label}" + " " * (13 - label.size) + "PPID  #{ppid} #{result}\n"
+end
+
+def print_result_with_init(label, data, columns)
+  result = data2str(data, columns, " ")
+  print "#{label}" + " " * (13 - label.size) + "INIT  #{1} #{result}\n"
+end
+
+
+gtop = LibGTop.new
+
+gtop.init
+
+cpu = gtop.cpu
+ary = ["total", "user", "nice", "sys", "idle", "frequency"]
+print_result("CPU", cpu, ary)
+
+mem = gtop.mem
+ary = ["total", "used", "free", "shared", "buffer", "cached", "user", "locked"]
+print_result("Memory", mem, ary)
+
+
+swap = gtop.swap
+ary = ["total", "used", "free", "pagein", "pageout"]
+print_result("Swap", swap, ary)
+
+uptime = gtop.uptime
+ary = ["uptime", "idletime"]
+print_result("Uptime", uptime, ary)
+
+loadavg = gtop.loadavg
+ary = ["loadavg", "nr_running", "nr_tasks", "last_pid"]
+print_result("Loadavg", loadavg, ary)
+
+shm_limits = gtop.shm_limits
+ary = ["shmmax", "shmmin", "shmmni", "shmseg", "shmall"]
+print_result("Shm Limits", shm_limits, ary)
+
+msg_limits = gtop.msg_limits
+ary = ["msgpool", "msgmap", "msgmax", "msgmnb", "msgmni", "msgssz", "msgtql"]
+print_result("Msg Limits", msg_limits, ary)
+
+sem_limits = gtop.sem_limits
+ary = ["semmap", "semmni", "semmns", "semmnu", "semmsl", "semopm", "semume", "semusz", "semvmx", "semaem"]
+print_result("Sem Limits", sem_limits, ary)
+
+puts ""
+
+ppp = gtop.ppp(0)
+ary = ["state", "bytes_in", "bytes_out"]
+print_result("PPP", ppp, ary)
+
+puts ""
+
+sysdeps = gtop.sysdeps
+ary = ["cpu", "mem", "swap", "uptime", "loadavg", "shm_limits", "msg_limits",
+  "sem_limits", "proclist", "proc_state", "proc_uid", "proc_mem", "proc_time",
+  "proc_signal", "proc_kernel", "proc_segment", "proc_args", "proc_map",
+  "mountlist", "fsusage", "netload", "ppp"]
+print_result("Sysdeps", sysdeps, ary)
+
+puts ""
+
+proclist = gtop.proclist(0, 0)
+ary = ["number", "size", "total"]
+print_result("Proclist", proclist, ary)
+unless proclist["pids"].empty?
+  print "\nProcess: "
+  print proclist["pids"].join(", ")
+  puts ""
+end
+
+pid = Process.pid
+ppid = Process.ppid
+
+puts ""
+
+proc_state = gtop.proc_state(pid)
+ary = ["cmd", "state", "uid", "gid"]
+print_result_with_pid("Proc_State", pid, proc_state, ary)
+
+proc_uid = gtop.proc_uid(pid)
+ary = ["uid", "euid", "gid", "egid", "pid", "ppid", "pgrp", "session",
+  "tty", "tpgid", "priority", "nice"]
+print_result_with_pid("Proc_Uid", pid, proc_uid, ary)
+
+proc_mem = gtop.proc_mem(pid)
+ary = ["size", "vsize", "resident", "share", "rss", "rss_rlim"]
+print_result_with_pid("Proc_Mem", pid, proc_mem, ary)
+
+proc_segment = gtop.proc_segment(pid)
+ary = ["text_rss", "shlib_rss", "data_rss", "stack_rss", "dirty_size",
+  "start_code", "end_code", "start_stack"]
+print_result_with_pid("Prco_Segment", pid, proc_segment, ary)
+
+proc_time = gtop.proc_time(pid)
+ary = ["start_time", "rtime", "utime", "stime", "cutime", "cstime",
+  "timeout", "it_real_value", "frequency"]
+print_result_with_pid("Proc_Time", pid, proc_time, ary)
+
+proc_signal = gtop.proc_signal(pid)
+ary = ["signal", "blocked", "sigignore", "sigcatch"]
+print_result_with_pid("Proc_Signal", pid, proc_signal, ary)
+
+proc_kernel = gtop.proc_kernel(pid)
+ary = ["k_flags", "min_flt", "maj_flt", "cmin_flt", "cmaj_flt",
+  "kstk_esp", "kstk_eip", "nwchan", "wchan"]
+print_result_with_pid("Proc_Kernel", pid, proc_kernel, ary) 
+
+proc_args = gtop.proc_args(pid)
+ary = ["size", "args"]
+proc_args["args"] = proc_args["args"].split(/\000/, -1).join('|')
+print_result_with_ppid("Proc_Args", pid, proc_args, ary)
+
+puts ""
+
+proc_state = gtop.proc_state(ppid)
+ary = ["cmd", "state", "uid", "gid"]
+print_result_with_ppid("Proc_State", ppid, proc_state, ary)
+
+proc_uid = gtop.proc_uid(ppid)
+ary = ["uid", "euid", "gid", "egid", "pid", "ppid", "pgrp", "session",
+  "tty", "tpgid", "priority", "nice"]
+print_result_with_ppid("Proc_Uid", ppid, proc_uid, ary)
+
+proc_mem = gtop.proc_mem(ppid)
+ary = ["size", "vsize", "resident", "share", "rss", "rss_rlim"]
+print_result_with_ppid("Proc_Mem", ppid, proc_mem, ary)
+
+proc_segment = gtop.proc_segment(ppid)
+ary = ["text_rss", "shlib_rss", "data_rss", "stack_rss", "dirty_size",
+  "start_code", "end_code", "start_stack"]
+print_result_with_ppid("Prco_Segment", ppid, proc_segment, ary)
+
+proc_time = gtop.proc_time(ppid)
+ary = ["start_time", "rtime", "utime", "stime", "cutime", "cstime",
+  "timeout", "it_real_value", "frequency"]
+print_result_with_ppid("Proc_Time", ppid, proc_time, ary)
+
+proc_signal = gtop.proc_signal(ppid)
+ary = ["signal", "blocked", "sigignore", "sigcatch"]
+print_result_with_ppid("Proc_Signal", ppid, proc_signal, ary)
+
+proc_kernel = gtop.proc_kernel(ppid)
+ary = ["k_flags", "min_flt", "maj_flt", "cmin_flt", "cmaj_flt",
+  "kstk_esp", "kstk_eip", "nwchan", "wchan"]
+print_result_with_ppid("Proc_Kernel", ppid, proc_kernel, ary)
+
+proc_args = gtop.proc_args(ppid)
+ary = ["size", "args"]
+proc_args["args"] = proc_args["args"].split(/\000/, -1).join('|')
+print_result_with_ppid("Proc_Args", ppid, proc_args, ary)
+
+puts ""
+
+proc_state = gtop.proc_state(1)
+ary = ["cmd", "state", "uid", "gid"]
+print_result_with_init("Proc_State", proc_state, ary)
+
+proc_uid = gtop.proc_uid(1)
+ary = ["uid", "euid", "gid", "egid", "pid", "ppid", "pgrp", "session",
+  "tty", "tpgid", "priority", "nice"]
+print_result_with_init("Proc_Uid", proc_uid, ary)
+
+proc_mem = gtop.proc_mem(1)
+ary = ["size", "vsize", "resident", "share", "rss", "rss_rlim"]
+print_result_with_init("Proc_Mem", proc_mem, ary)
+
+proc_segment = gtop.proc_segment(1)
+ary = ["text_rss", "shlib_rss", "data_rss", "stack_rss", "dirty_size",
+  "start_code", "end_code", "start_stack"]
+print_result_with_init("Prco_Segment", proc_segment, ary)
+
+proc_time = gtop.proc_time(1)
+ary = ["start_time", "rtime", "utime", "stime", "cutime", "cstime",
+  "timeout", "it_real_value", "frequency"]
+print_result_with_init("Proc_Time", proc_time, ary)
+
+proc_signal = gtop.proc_signal(1)
+ary = ["signal", "blocked", "sigignore", "sigcatch"]
+print_result_with_init("Proc_Signal", proc_signal, ary)
+
+proc_kernel = gtop.proc_kernel(1)
+ary = ["k_flags", "min_flt", "maj_flt", "cmin_flt", "cmaj_flt",
+  "kstk_esp", "kstk_eip", "nwchan", "wchan"]
+print_result_with_init("Proc_Kernel", proc_kernel, ary)
+
+proc_args = gtop.proc_args(1)
+ary = ["size", "args"]
+proc_args["args"] = proc_args["args"].split(/\000/, -1).join('|')
+print_result_with_init("Proc_Args", proc_args, ary)