sys-uptime 0.5.4-universal-linux

data/CHANGES

@@ -0,0 +1,144 @@
+== 0.5.4 - 26-Jul-2011
+* Refactored and updated Rakefile and gemspec.
+* Some internal file reorganization and renaming.
+* License changed to Artistic 2.0.
+
+== 0.5.3 - 7-May-2009
+* Altered the Uptime.seconds implementation on Linux so that it works with
+  both Ruby 1.8.x and 1.9.x. Thanks go to Alexey Chebotar for the spot.
+
+== 0.5.2 - 13-Dec-2008
+* Fixed a date/time issue in the Windows version caused by Ruby itself.
+* Fixed the Uptime.seconds, Uptime.minutes and Uptime.hours methods on MS
+  Windows.
+* Renamed the test file to 'test_sys_uptime.rb'.
+* Some minor updates to the Rakefile.
+
+== 0.5.1 - 26-Jul-2007
+* Fixed bug in the MS Windows version caused by incorrect parsing of an
+  MS specific date format (caused by a bug in Ruby 1.8.6). Thanks go to
+  Robert H. for the spot.
+* Inlined the Rake installation tasks, so the install.rb file has been
+  removed.
+* Added an 'install_gem' Rake task, and updated the README installation
+  instructions.
+
+== 0.5.0 - 30-Mar-2007
+* For platforms that use C code, the code now always uses the sysctl()
+  function if supported by your system. This replaces the platform specific
+  checks I was doing for the various BSD flavors.
+* Fix for OS X - the Uptime.boot_time method now works.
+* UptimeError is now Uptime::Error.
+* Improved RDoc in the uptime.c source code.
+* Added a Rakefile - users should now use the 'test' and 'install' rake tasks.
+* Updates to the MANIFEST, README and uptime.txt files.
+
+== 0.4.5 - 19-Nov-2006
+* Internal layout changes, minor doc updates and gemspec improvements.
+* No code changes.
+
+== 0.4.4 - 30-Jun-2006
+* Added inline rdoc documentation to the source files.
+* Added a gemspec.
+
+== 0.4.3 - 18-Dec-2005
+* Changed the Linux version to pure Ruby.  The current method of determining
+  uptime in unix.c does not work in Linux kernel 2.6+.  So, from now on it
+  reads out of /proc/uptime.
+
+== 0.4.2 - 6-May-2005
+* Fixed a potential boot_time bug.
+* Removed the version.h file.  It's no longer needed since the Windows
+  version is pure Ruby.
+* NetBSD 2.x and FreeBSD 5.x now supported.
+* Removed the INSTALL file.  Installation instructions are now in
+  the README file.
+* Removed the uptime.rd file.  You can generate html documentation by
+  running rdoc over the uptime.txt file.
+* Made most documents rdoc friendly.
+* Moved project to RubyForge.
+
+== 0.4.1 - 14-Dec-2004
+* Moved freebsd code into unix.c file.
+* Should now work past 249 days (2**31) on systems that have utmpx.h.
+* Fixed a bug with regards to boot_time, where it was possible that it would
+  simply be empty.
+
+== 0.4.0 - 8-Jul-2004
+* Removed all reference to the CLK_TCK constant, as per documentation from
+  Richard Stevens that it is deprecated and that sysconf() should be used
+  instead (well, I knew about this, but ignored it until now).
+* Scrapped the C version for Windows in favor of a pure Ruby version that
+  uses win32ole + WMI.
+* Added a boot_time method for Unix systems (Windows already had this).
+* Added an UptimeError class on Unix systems (and replaced UptimeException
+  on Windows).
+* Modified an internal function to raise an UptimeError if the times()
+  function fails.  Also, it now returns an unsigned long instead of a plain
+  long.
+* Replaced the two different test suites with a single, unified test suite.
+* Cleaned up the extconf.rb script.  I now assume that TestUnit is installed.
+* Removed the load_avg method (which was never advertised and which I hope
+  you weren't using).  You can find a load_avg method in the sys-cpu package.
+* Changed uptime.rd2 to uptime.rd to be consistent with my other packages.
+* Removed the uptime.html file - you may generate that on your own.
+* Added warranty and license info.
+
+== 0.3.2 - 30-Dec-2003
+* Cleaned up some warnings that showed up with -Wall on some unix platforms
+  (int vs long format, explicit include)
+* Minor test suite and extconf.rb changes
+
+== 0.3.1 - 25-Jun-2003
+* Modified test files to handle HP-UX extensions
+* Minor doc updates
+* Added the dhms() method.  Actually, this was in the 0.3.0
+  release, I just forgot to mention it in this file :)
+
+== 0.3.0 - 22-Jun-2003
+* Added OS X support - thanks go to Mike Hall for the patch
+* Fixed incorrect values in FreeBSD (again Mike Hall)
+* Modified tc_unix.rb test suite to handle OS X, along with a bit
+* of minor cleanup
+* Removed VERSION class method.  Use the constant instead
+* Separated FreeBSD/OS X source into its own file (freebsd.c).
+  The #ifdefs were starting to get too ugly for me
+
+== 0.2.1 - 13-May-2003
+* Fixed bug in extconf.rb file, and made some major changes
+* Modified test.rb for those without TestUnit
+* Modified TestUnit tests - some bogus tests were removed
+* Added a README file with some additional info
+* Created a version.h file, so that I can keep the VERSION number
+  in one place
+* Docs automatically included in doc directory (i.e. no more interactive
+  document creation)
+
+== 0.2.0 - 13-Mar-2003
+* Added MS Windows support
+* Added a VERSION constant
+* Added a test suite (for those with TestUnit installed)
+* Internal directory layout change
+* uptime.c is now split into unix.c and windows.c (and linked appropriately)
+* Changelog and Manifest are now CHANGES and MANIFEST, respectively
+* Many changes to extconf.rb
+
+== 0.1.3 - 6-Jan-2003
+* Added a VERSION class method
+* Added a copyright notice
+* Fixed up the docs a bit and moved them to the doc directory
+* Changed the tarball name to match the RAA package name
+* Modified test.rb script to make it better
+* Changed install instructions slightly
+
+== 0.1.2 - 25-Aug-2002
+* Slight change to preprocessor commands to avoid redefining CLK_TCK on
+  those systems that define it in time.h
+* Added an INSTALL file
+
+== 0.1.1 - 21-Jun-2002
+* The CLK_TCK constant wasn't necessarily being set correctly, which could
+  lead to some odd results.  This has been fixed.
+
+== 0.1.0 - 17-Jun-2002
+* Initial release

data/MANIFEST

@@ -0,0 +1,12 @@
+* CHANGES
+* MANIFEST
+* Rakefile
+* README
+* sys-uptime.gemspec
+* doc/uptime.txt
+* examples/sys_uptime_example.rb
+* ext/extconf.rb
+* ext/sys/uptime.c
+* lib/linux/sys/uptime.rb
+* lib/windows/sys/uptime.rb
+* test/test_sys_uptime.rb

data/README

@@ -0,0 +1,14 @@
+= Description
+   A Ruby interface for getting system uptime information.
+
+= Prerequisites
+   Ruby 1.8.0 or later.
+   Ruby 1.8.2 or later is recommended on MS Windows.
+   A C compiler, except for MS Windows.
+
+= Installation
+   rake test (optional)
+   rake install (non-gem) or rake install_gem (gem).
+
+== Notes
+   For additional documentation see doc/uptime.txt.

data/Rakefile

@@ -0,0 +1,87 @@
+require 'rake'
+require 'rake/clean'
+require 'rake/testtask'
+require 'rbconfig'
+include Config
+
+CLEAN.include(
+  '**/*.gem',                # Gem files
+  '**/*.rbc',                # Rubinius
+  '**/*.o',                  # C object file
+  '**/*.log',                # Ruby extension build log
+  '**/Makefile',             # C Makefile
+  '**/conftest.dSYM',        # OS X build directory
+  "**/*.#{CONFIG['DLEXT']}", # C shared object
+  'lib/sys/uptime.rb'        # Renamed source file
+)
+
+desc "Build the sys-uptime library on UNIX systems"
+task :build => [:clean] do
+  Dir.chdir('ext') do
+    unless Config::CONFIG['host_os'] =~ /windows|mswin|win32|mingw|cygwin|dos|linux/i
+      ruby 'extconf.rb'
+      sh 'make'
+      cp "uptime." + CONFIG['DLEXT'], "sys"
+    end
+  end
+end
+
+namespace :gem do
+  desc "Create the gem for the sys-uptime library"
+  task :create => [:clean] do
+    spec = eval(IO.read('sys-uptime.gemspec'))
+
+    case Config::CONFIG['host_os']
+      when /windows|win32|cygwin|mingw|dos|mswin/
+        spec.platform = Gem::Platform::CURRENT
+        spec.platform.cpu = 'universal'
+        spec.require_paths = ['lib', 'lib/windows'] 
+      when /linux/
+        spec.platform = Gem::Platform.new('universal-linux')
+        spec.require_paths = ['lib', 'lib/linux'] 
+      else
+        spec.platform = Gem::Platform::RUBY
+        spec.extensions = ['ext/extconf.rb']
+        spec.extra_rdoc_files << 'ext/sys/uptime.c'
+    end
+
+    Gem::Builder.new(spec).build
+  end
+
+  desc "Install the sys-uptime library"
+  task :install => [:create] do
+    gem_name = Dir['*.gem'].first
+    sh "gem install #{gem_name}"
+  end
+end
+
+task :example => [:build] do
+  case Config::CONFIG['host_os']
+    when /windows|win32|cygwin|mingw|dos|mswin/
+      path = 'lib/windows'
+    when /linux/
+      path = 'lib/linux'
+    else
+      path = 'ext'
+  end
+  sh "ruby -I#{path} examples/sys_uptime_example.rb" 
+end
+
+desc "Run the test suite"
+Rake::TestTask.new("test") do |t|
+  task :test => :build
+  t.libs << 'test' << '.'
+  t.warning = true
+  t.verbose = true
+
+  case Config::CONFIG['host_os']
+    when /windows|win32|cygwin|mingw|dos|mswin/
+      t.libs << 'lib/windows'
+    when /linux/
+      t.libs << 'lib/linux'
+    else
+      t.libs << 'ext'
+  end
+end
+
+task :default => :test

data/doc/uptime.txt

@@ -0,0 +1,98 @@
+== Description
+  The sys-uptime library provides uptime and boot time information, similar
+  to the 'uptime' Unix command.
+
+== Synopsis
+  require 'sys/uptime'
+  include Sys
+
+  p Uptime.days
+  p Uptime.hours
+  p Uptime.minutes
+  p Uptime.seconds
+  p Uptime.dhms.join(', ')
+  p Uptime.uptime
+  p Uptime.boot_time
+    
+== Constants
+VERSION
+  Returns the current version number of this library.
+    
+== Class Methods
+Uptime.boot_time
+  Returns the boot time as a Time object.
+    
+Uptime.days
+  Returns the total number of days the system has been up.
+    
+Uptime.hours
+  Returns the total number of hours the system has been up.
+    
+Uptime.minutes
+  Returns the total number of minutes the system has been up.
+    
+Uptime.seconds
+  Returns the total number of seconds the system has been up.
+    
+Uptime.dhms
+  Calculates and returns the number of days, hours, minutes and
+  seconds the system has been running as a four-element Array.
+    
+Uptime.uptime
+  Calculates and returns the number of days, hours, minutes and
+  seconds the system has been running as a colon-separated string.
+    
+== Exceptions
+Uptime::Error
+  Raised if something goes wrong. On Unix, this would likely mean a
+  failure of the times() function. That would be highly unusual.
+   
+  On Windows, it probably means you failed to connect to WMI properly. The
+  mostly likely reason would be that the WMI service wasn't running.
+    
+== Notes
+  On MS Windows each of the class methods optionally takes a host name as
+  a single argument. The default is localhost (or whatever the result of
+  Socket.gethostname returns).
+
+  The current time, users and load average are NOT included in this
+  module, even though you may be used to seeing them with the command
+  line version of 'uptime'.  This is because these things have
+  absolutely nothing to do with uptime. At least, not as I logically
+  think of uptime.
+    
+  This library was tested successfully on a Solaris system with over 1600
+  days of uptime.
+    
+== Known Bugs
+  None that I am aware of.  Please log any bugs you find on the project
+  website at http://www.rubyforge.org/projects/sysutils.
+
+== Questions
+  "Doesn't Struct::Tms do this?" - No.
+    
+== License
+  Artistic 2.0
+    
+== Copyright
+  Copyright 2002-2011, Daniel J. Berger
+
+  All Rights Reserved. This module is free software. It may be used,
+  redistributed and/or modified under the same terms as Ruby itself.
+    
+== Warranty
+  This library is provided "as is" and without any express or
+  implied warranties, including, without limitation, the implied
+  warranties of merchantability and fitness for a particular purpose.
+
+== Acknowledgements
+  Mike Hall for help with the BSD side of things.
+  Ola Eriksson, whose source code I shamelessly plagiarized to get a better
+  implementation for systems that have the utmpx.h header file.
+
+== Authors
+  Daniel J. Berger
+  Mike Hall
+    
+== See Also
+  uptime(1)

data/examples/sys_uptime_example.rb

@@ -0,0 +1,21 @@
+###########################################################
+# sys_uptime_example.rb
+#
+# A generic test script for general futzing. You can run
+# this script via the 'rake example' task.
+###########################################################
+require 'sys/uptime'
+include Sys
+
+print "\nGENERIC TEST SCRIPT FOR SYS-UPTIME\n\n"
+puts 'VERSION: ' + Uptime::VERSION
+
+puts "Days: " + Uptime.days.to_s
+puts "Hours: " + Uptime.hours.to_s
+puts "Minutes: " + Uptime.minutes.to_s
+puts "Seconds: " + Uptime.seconds.to_s
+puts "Uptime: " + Uptime.uptime
+puts "DHMS: " + Uptime.dhms.join(', ')
+puts "Boot Time: " + Uptime.boot_time.to_s
+
+print "\nTest successful\n"

data/ext/extconf.rb

@@ -0,0 +1,28 @@
+##########################################################################
+# extconf.rb
+#
+# Configuration & build script for sys-uptime. Generally speaking you
+# should build sys-uptime with the 'rake build' task instead of running
+# this script manually.
+##########################################################################
+require 'mkmf'
+require 'fileutils'
+
+if RUBY_PLATFORM =~ /windows|win32|cygwin|mingw|dos|linux/i
+  STDERR.puts "Do not compile on this platform. Run 'rake gem:install' instead."
+  exit
+end
+
+dir_config('uptime')
+
+have_header('sys/loadavg.h')
+
+if have_func('sysctl')
+  have_header('sys/param.h')
+  have_header('sys/time.h')
+  have_header('sys/types.h')
+else
+  have_header('utmpx.h')
+end
+
+create_makefile('sys/uptime', 'sys')

data/ext/sys/uptime.c

@@ -0,0 +1,250 @@
+/******************************************************************************
+ * uptime.c
+ *
+ * Authors:
+ *    Daniel Berger
+ *    Mike Hall
+ *
+ * sys-uptime source code for most *nix platforms
+ *****************************************************************************/
+#include <ruby.h>
+#include <string.h>
+#include <errno.h>
+
+#ifdef HAVE_SYSCTL
+
+#include <sys/sysctl.h>
+
+#ifdef HAVE_SYS_PARAM_H
+#include <sys/param.h>
+#endif
+
+#ifdef HAVE_SYS_TIME_H
+#include <sys/time.h>
+#endif
+
+#ifdef HAVE_SYS_TYPES_H
+#include <sys/types.h>
+#endif
+
+#else
+
+#include <sys/times.h>
+#include <unistd.h>
+#include <time.h>
+
+#ifdef HAVE_UTMPX_H
+#include <utmpx.h>
+#endif
+
+#ifdef _SC_CLK_TCK
+#define TICKS sysconf(_SC_CLK_TCK)
+#else
+#define TICKS sysconf(CLOCKS_PER_SEC)
+#endif
+
+#endif
+
+#ifdef HAVE_SYS_LOADAVG_H
+#include <sys/loadavg.h>
+#endif
+
+#define MAXSTRINGSIZE 32 /* reasonable limit */
+
+#define SYS_UPTIME_VERSION "0.5.4"
+
+VALUE cUptimeError;
+
+unsigned long get_uptime_secs()
+{
+#ifdef HAVE_SYSCTL
+   struct timeval tv;
+   size_t tvlen = sizeof(tv);
+   int mib[2];
+
+   mib[0] = CTL_KERN;
+   mib[1] = KERN_BOOTTIME;
+
+   if(sysctl(mib, 2, &tv, &tvlen, NULL, 0))
+      rb_raise(cUptimeError, "sysctl() call failed %s", strerror(errno));
+
+   return time(NULL) - tv.tv_sec;
+#else
+   struct tms tms;
+   unsigned long seconds;
+   seconds = times(&tms) / TICKS;
+
+   if(-1 == seconds)
+      rb_raise(cUptimeError, "times() function failed: %s", strerror(errno));
+
+   if(seconds < 0)
+      rb_raise(cUptimeError, "value returned larger than type could handle");
+
+   return seconds;
+#endif
+}
+
+/*
+ * call-seq:
+ *    Uptime.seconds
+ *
+ * Returns the total number of seconds the system has been up.
+ */
+static VALUE uptime_seconds()
+{
+   return UINT2NUM(get_uptime_secs());
+}
+
+/*
+ * call-seq:
+ *    Uptime.minutes
+ *
+ * Returns the total number of minutes the system has been up.
+ */
+static VALUE uptime_minutes()
+{
+   return UINT2NUM(get_uptime_secs() / 60);
+}
+
+/*
+ * call-seq:
+ *    Uptime.hours
+ *
+ * Returns the total number of hours the system has been up.
+ */
+static VALUE uptime_hours()
+{
+   return UINT2NUM(get_uptime_secs() / 3600);
+}
+
+/*
+ * call-seq:
+ *    Uptime.days
+ *
+ * Returns the total number of days the system has been up.
+ */
+static VALUE uptime_days()
+{
+   return UINT2NUM(get_uptime_secs() / 86400);
+}
+
+/*
+ * call-seq:
+ *    Uptime.uptime
+ *
+ * Calculates and returns the number of days, hours, minutes and
+ * seconds the system has been running as a colon-separated string.
+ */
+static VALUE uptime_uptime()
+{
+   char c_string[MAXSTRINGSIZE];
+   long seconds, days, hours, minutes;
+
+   seconds = get_uptime_secs();
+   days = seconds/86400;
+   seconds -= days*86400;
+   hours = seconds/3600;
+   seconds -= hours*3600;
+   minutes = seconds/60;
+   seconds -= minutes*60;
+
+   sprintf(c_string, "%ld:%ld:%ld:%ld", days, hours, minutes, seconds);
+
+   return rb_str_new2(c_string);
+}
+
+/*
+ * call-seq:
+ *    Uptime.dhms
+ *
+ * Calculates and returns the number of days, hours, minutes and
+ * seconds the system has been running as a four-element Array.
+ */
+static VALUE uptime_dhms()
+{
+   VALUE a = rb_ary_new2(4);
+   long s, m, h, d;
+
+   s = get_uptime_secs();
+   d =  s                / (24*60*60);
+   h = (s -= d*24*60*60) / (   60*60);
+   m = (s -= h*   60*60) /        60;
+   s      -= m*      60;
+
+   rb_ary_push(a, INT2FIX(d));
+   rb_ary_push(a, INT2FIX(h));
+   rb_ary_push(a, INT2FIX(m));
+   rb_ary_push(a, INT2FIX(s));
+
+   return a;
+}
+
+/*
+ * call-seq:
+ *    Uptime.boot_time
+ *
+ * Returns the boot time as a Time object.
+ */
+static VALUE uptime_btime(){
+   VALUE v_time = Qnil;
+
+#ifdef HAVE_SYSCTL
+   struct timeval tv;
+   size_t tvlen = sizeof(tv);
+   int mib[2];
+
+   mib[0] = CTL_KERN;
+   mib[1] = KERN_BOOTTIME;
+
+   if(sysctl(mib, 2, &tv, &tvlen, NULL, 0))
+      rb_raise(cUptimeError, "sysctl() call failed: %s", strerror(errno));
+
+   v_time = rb_time_new(tv.tv_sec,tv.tv_usec);
+#else
+#ifdef HAVE_UTMPX_H
+   struct utmpx* ent;
+
+   setutxent();
+
+   while( (ent = getutxent()) ){
+      if(ent->ut_type == BOOT_TIME){
+         v_time = rb_time_new(ent->ut_tv.tv_sec, ent->ut_tv.tv_usec);
+         break;
+      }
+   }
+
+   endutxent();
+#else
+   rb_raise(cUptimeError, "boot_time method not implemented on this platform");
+#endif
+#endif
+
+   return v_time;
+}
+
+void Init_uptime()
+{
+   VALUE mSys, cUptime;
+
+   /* The Sys module only serves as a toplevel namespace */
+   mSys = rb_define_module("Sys");
+
+   /* The Uptime encapsulates various bits of uptime information */
+   cUptime = rb_define_class_under(mSys, "Uptime", rb_cObject);
+
+   /* The Uptime::Error class is raised if any of the Uptime methods fail */
+   cUptimeError = rb_define_class_under(cUptime, "Error", rb_eStandardError);
+
+   /* 0.5.4: The version of this library */
+   rb_define_const(cUptime, "VERSION", rb_str_new2(SYS_UPTIME_VERSION));
+
+   /* Singleton Methods */
+
+   rb_define_singleton_method(cUptime, "seconds", uptime_seconds, 0);
+   rb_define_singleton_method(cUptime, "minutes", uptime_minutes, 0);
+   rb_define_singleton_method(cUptime, "hours",   uptime_hours,   0);
+   rb_define_singleton_method(cUptime, "days",    uptime_days,    0);
+   rb_define_singleton_method(cUptime, "uptime",  uptime_uptime,  0);
+   rb_define_singleton_method(cUptime, "dhms",    uptime_dhms,    0);
+   rb_define_singleton_method(cUptime, "boot_time", uptime_btime, 0);
+}

data/lib/linux/sys/uptime.rb

@@ -0,0 +1,101 @@
+# The Sys module serves as a namespace only.
+module Sys
+
+  # The Uptime class encapsulates various bits of information regarding your
+  # system's uptime, including boot time.
+  class Uptime
+
+    # Error typically raised in one of the Uptime methods should fail.
+    class Error < StandardError; end
+
+    # The version of the sys-uptime library.
+    VERSION = '0.5.4'
+
+    # The file to read uptime information from.
+    UPTIME_FILE = '/proc/uptime'
+
+    # Returns the total number of seconds of uptime.
+    #
+    # Example:
+    #
+    #    Sys::Uptime.seconds # => 118800
+    #
+    def self.seconds
+      begin
+        IO.read(UPTIME_FILE).split.first.to_i
+      rescue Exception => err
+        raise Error, err
+      end
+    end
+
+    # Returns the total number of minutes of uptime.
+    #
+    # Example:
+    #
+    #    Sys::Uptime.minutes # => 678
+    #
+    def self.minutes
+      self.seconds / 60
+    end
+
+    # Returns the total number of hours of uptime.
+    #
+    # Example:
+    #
+    #    Sys::Uptime.hours # => 31
+    #
+    def self.hours
+      self.minutes / 60
+    end
+
+    # Returns the total number of days of uptime.
+    #
+    # Example:
+    #
+    #    Sys::Uptime.days # => 2
+    #
+    def self.days
+      self.hours / 24
+    end
+
+    # Returns the uptime as a colon separated string, including days,
+    # hours, minutes and seconds.
+    #
+    # Example:
+    #
+    #    Sys::Uptime.uptime # => "1:9:24:57"
+    #
+    def self.uptime
+      seconds = self.seconds
+      days    = seconds / 86400
+      seconds -= days * 86400
+      hours   = seconds / 3600
+      seconds -= hours * 3600
+      minutes = seconds / 60
+      seconds -= minutes * 60
+
+      "#{days}:#{hours}:#{minutes}:#{seconds}"
+    end
+
+    # Returns the uptime as a four element array, including days, hours,
+    # minutes and seconds.
+    #
+    # Example:
+    #
+    #    Sys::Uptime.dhms # => [1,9,24,57]
+    #
+    def self.dhms
+      self.uptime.split(":")
+    end
+
+    # Returns the time the system was booted as a Time object.
+    #
+    # Example:
+    #
+    #    Sys::Uptime.boot_time
+    #
+    def self.boot_time
+      Time.now - self.seconds
+    end
+  end
+end

data/lib/windows/sys/uptime.rb

@@ -0,0 +1,158 @@
+require 'win32ole'
+require 'socket'
+require 'date'
+require 'time'
+
+# The Sys module serves as a namespace only.
+module Sys
+
+  # The Uptime class encapsulates various bits of information regarding your
+  # system's uptime, including boot time.
+  class Uptime
+
+    # Error typically raised in one of the Uptime methods should fail.
+    class Error < StandardError; end
+
+    # The version of the sys-uptime library.
+    VERSION = '0.5.4'
+
+    # Returns the boot time as a Time object.
+    #
+    # Example:
+    #
+    #    Sys::Uptime.boot_time # => Fri Dec 12 20:18:58 -0700 2008
+    #
+    def self.boot_time(host=Socket.gethostname)
+      cs = "winmgmts://#{host}/root/cimv2"
+      begin
+        wmi = WIN32OLE.connect(cs)
+      rescue WIN32OLERuntimeError => e
+        raise Error, e
+      else
+        query = "select LastBootupTime from Win32_OperatingSystem"
+        results = wmi.ExecQuery(query)
+        results.each{ |ole|
+          time_array = parse_ms_date(ole.LastBootupTime)
+          return Time.mktime(*time_array)
+        }
+      end
+    end
+
+    # Calculates and returns the number of days, hours, minutes and
+    # seconds the +host+ has been running as a colon-separated string.
+    #
+    # The localhost is used if no +host+ is provided.
+    #
+    # Example:
+    #
+    #    Sys::Uptime.uptime # => "1:9:55:11"
+    #
+    def self.uptime(host=Socket.gethostname)
+      get_dhms(host).join(':')
+    end
+
+    # Calculates and returns the number of days, hours, minutes and
+    # seconds the +host+ has been running as a four-element Array.
+    # The localhost is used if no +host+ is provided.
+    #
+    # Example:
+    #
+    #    Sys::Uptime.dhms # => [1, 9, 55, 11]
+    #
+    def self.dhms(host=Socket.gethostname)
+      get_dhms(host)
+    end
+
+    # Returns the total number of days the system has been up on +host+,
+    # or the localhost if no host is provided.
+    #
+    # Example:
+    #
+    #    Sys::Uptime.days # => 1
+    #
+    def self.days(host=Socket.gethostname)
+      hours(host) / 24
+    end
+
+    # Returns the total number of hours the system has been up on +host+,
+    # or the localhost if no host is provided.
+    #
+    # Example:
+    #
+    #    Sys::Uptime.hours # => 33
+    #
+    def self.hours(host=Socket.gethostname)
+      minutes(host) / 60
+    end
+
+    # Returns the total number of minutes the system has been up on +host+,
+    # or the localhost if no host is provided.
+    #
+    # Example:
+    #
+    #    Sys::Uptime.minutes # => 1980
+    #
+    def self.minutes(host=Socket.gethostname)
+      seconds(host) / 60
+    end
+
+    # Returns the total number of seconds the system has been up on +host+,
+    # or the localhost if no host is provided.
+    #
+    # Example:
+    #
+    #    Sys::Uptime.seconds # => 118800
+    #
+    def self.seconds(host=Socket.gethostname)
+      get_seconds(host)
+    end
+
+    private
+
+    # Converts a string in the format '20040703074625.015625-360' into a
+    # Ruby Time object.
+    #
+    def self.parse_ms_date(str)
+      return if str.nil?
+      return Time.parse(str.split('.').first)
+    end
+
+    # Get the actual days, hours, minutes and seconds since boot using WMI.
+    #
+    def self.get_dhms(host)
+      seconds = get_seconds(host)
+
+      days = (seconds / 86400).to_i
+      seconds -= days * 86400
+      hours = seconds / 3600
+      seconds -= hours * 3600
+      minutes = seconds / 60
+      seconds -= minutes * 60
+
+      [days, hours, minutes, seconds]
+    end
+
+    # Returns the number of seconds since boot.
+    #
+    def self.get_seconds(host)
+      cs = "winmgmts://#{host}/root/cimv2"
+      begin
+        wmi = WIN32OLE.connect(cs)
+      rescue WIN32OLERuntimeError => e
+        raise Error, e
+      else
+        query = "select LastBootupTime from Win32_OperatingSystem"
+        results = wmi.ExecQuery(query)
+        now = Time.now
+
+        results.each{ |ole|
+          time_array = parse_ms_date(ole.LastBootupTime)
+          boot_time = Time.mktime(*time_array)
+          break
+        }
+      end
+
+      (now - boot_time).to_i
+    end
+  end
+end

data/sys-uptime.gemspec

@@ -0,0 +1,21 @@
+require 'rubygems'
+
+Gem::Specification.new do |spec|
+  spec.name              = 'sys-uptime'
+  spec.version           = '0.5.4'
+  spec.author            = 'Daniel J. Berger'
+  spec.email             = 'djberg96@gmail.com'
+  spec.homepage          = 'http://www.rubyforge.org/projects/sysutils'
+  spec.platform          = Gem::Platform::RUBY
+  spec.summary           = 'A Ruby interface for getting system uptime information.'
+  spec.test_file         = 'test/test_sys_uptime.rb'
+  spec.extra_rdoc_files  = ['CHANGES', 'README', 'MANIFEST', 'doc/uptime.txt']
+  spec.rubyforge_project = 'sysutils'
+  spec.files             =  Dir['**/*'].delete_if{ |item| item.include?('git') }
+
+  spec.description = <<-EOF
+    The sys-uptime library is a simple interface for gathering uptime
+    information. You can retrieve data in seconds, minutes, days, hours,
+    or all of the above.
+  EOF
+end

data/test/test_sys_uptime.rb

@@ -0,0 +1,65 @@
+#####################################################################
+# test_sys_uptime.rb
+#
+# Test suite for sys-uptime. This should generally be run via the
+# 'rake test' task, since it handles the pre-setup code for you.
+#####################################################################
+require 'sys/uptime'
+require 'test/unit'
+include Sys
+
+class TC_Sys_Uptime < Test::Unit::TestCase
+  def test_version
+    assert_equal('0.5.4', Uptime::VERSION)
+  end
+
+  def test_seconds
+    assert_respond_to(Uptime, :seconds)
+    assert_nothing_raised{ Uptime.seconds }
+    assert_kind_of(Fixnum, Uptime.seconds)
+    assert_equal(true, Uptime.seconds > 0)
+  end
+
+  def test_minutes
+    assert_respond_to(Uptime, :minutes)
+    assert_nothing_raised{ Uptime.minutes }
+    assert_kind_of(Fixnum, Uptime.minutes)
+  end
+
+  def test_hours
+    assert_respond_to(Uptime, :hours)
+    assert_nothing_raised{ Uptime.hours }
+    assert_kind_of(Fixnum, Uptime.hours)
+  end
+
+  def test_days
+    assert_respond_to(Uptime,:days)
+    assert_nothing_raised{ Uptime.days }
+    assert_kind_of(Fixnum, Uptime.days)
+  end 
+
+  def test_uptime
+    assert_respond_to(Uptime,:uptime)
+    assert_nothing_raised{ Uptime.uptime }
+    assert_kind_of(String, Uptime.uptime)
+    assert_equal(false, Uptime.uptime.empty?)
+  end
+   
+  def test_dhms
+    assert_respond_to(Uptime,:dhms)
+    assert_nothing_raised{ Uptime.dhms }
+    assert_kind_of(Array, Uptime.dhms)
+    assert_equal(false, Uptime.dhms.empty?)
+    assert_equal(4, Uptime.dhms.length)
+  end
+   
+  def test_boot_time
+    assert_respond_to(Uptime,:boot_time)
+    assert_nothing_raised{ Uptime.boot_time }
+    assert_kind_of(Time, Uptime.boot_time)
+  end
+
+  def test_uptime_error
+    assert_kind_of(StandardError, Uptime::Error.new)
+  end
+end

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification 
+name: sys-uptime
+version: !ruby/object:Gem::Version 
+  hash: 3
+  prerelease: 
+  segments: 
+  - 0
+  - 5
+  - 4
+  version: 0.5.4
+platform: universal-linux
+authors: 
+- Daniel J. Berger
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-07-27 00:00:00 Z
+dependencies: []
+
+description: "    The sys-uptime library is a simple interface for gathering uptime\n    information. You can retrieve data in seconds, minutes, days, hours,\n    or all of the above.\n"
+email: djberg96@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- CHANGES
+- README
+- MANIFEST
+- doc/uptime.txt
+files: 
+- doc/uptime.txt
+- Rakefile
+- examples/sys_uptime_example.rb
+- ext/extconf.rb
+- ext/sys/uptime.c
+- sys-uptime.gemspec
+- README
+- test/test_sys_uptime.rb
+- lib/windows/sys/uptime.rb
+- lib/linux/sys/uptime.rb
+- CHANGES
+- MANIFEST
+homepage: http://www.rubyforge.org/projects/sysutils
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+- lib/linux
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: sysutils
+rubygems_version: 1.8.6
+signing_key: 
+specification_version: 3
+summary: A Ruby interface for getting system uptime information.
+test_files: 
+- test/test_sys_uptime.rb