sys-uptime 0.7.2-universal-mingw32

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1a2dd1832bebec9fd06b9481d0aeb067a2155e9b09c746814bb49bf4196e24d1
+  data.tar.gz: 33b1ddb693e56b58f864e9fe63b84f4c7db5ee7030463c0ba2c6f3bec0652d80
+SHA512:
+  metadata.gz: 9e9a4994e293334e196804185fafd90ea1ea0a3ddfadf22e06942f04468bd59f11da60b89c10f414655ef4225b623259bbc13064218a687498976d3f270c5ae5
+  data.tar.gz: 329787a710fde14f5d9e5ca40afd503b579e8225a26681f15b6a8d3f36f8d6d73b03ce993c95c6c09afeb5da3f5e463daf4aff47f6466b2bf15e9e97f69205b0

checksums.yaml.gz.sig

@@ -0,0 +1,2 @@
+Ob=���mޱ��^,��݋�*6+�\�zC}�y�a(����O���z��_�W�c9���F3W?�`��l�wE��*a�(�
+z]�yM�KA Q

data/CHANGES

@@ -0,0 +1,169 @@
+== 0.7.2 - 4-Nov-2018
+* Added metadata to the gemspec.
+* The VERSION constant is now frozen.
+* Updated cert.
+
+== 0.7.1 - 14-May-2016
+* Altered internal layout, which also fixed a require bug. Thanks go
+  to jkburges for the spot.
+* Moved the VERSION constant into a single file shared by all platforms.
+
+== 0.7.0 - 3-Oct-2015
+* Changed license to Apache 2.0.
+* Added a cert. This gem is now signed.
+* Added a sys-uptime.rb file for convenience.
+* Gem related tasks in the Rakefile now assume Rubygems 2.x.
+
+== 0.6.2 - 8-Nov-2014
+* Minor updates to gemspec and Rakefile.
+
+== 0.6.1 - 22-Oct-2012
+* Refactored a private method in the MS Windows source.
+* Minor fix for one private method test.
+* Fixed an RbConfig vs Config warning. Thanks Pedro Carrico.
+
+== 0.6.0 - 11-Dec-2011
+* Switched Unix code to use FFI.
+* Removed all of the C related tasks from the Rakefile and added the gem:build
+  and gem:install tasks.
+* Internal directory layout changes, with appropriate changes to the gemspec.
+
+== 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,11 @@
+* CHANGES
+* MANIFEST
+* Rakefile
+* README
+* sys-uptime.gemspec
+* certs/djberg96_pub.pem
+* examples/test.rb
+* lib/sys-uptime.rb
+* lib/unix/sys/uptime.rb
+* lib/windows/sys/uptime.rb
+* test/test_sys_uptime.rb

data/README

@@ -0,0 +1,66 @@
+= Description
+  A Ruby interface for getting system uptime information.
+
+= Prerequisites
+  ffi 0.1.0 or later on Unixy platforms.
+
+= Installation
+  gem install sys-uptime
+
+= Synopsis
+  require 'sys-uptime'
+  include Sys
+
+  # Get everything
+  p Uptime.uptime
+  p Uptime.dhms.join(', ')
+
+  # Get individual units
+  p Uptime.days
+  p Uptime.hours
+  p Uptime.minutes
+  p Uptime.seconds
+
+  # Get the boot time
+  p Uptime.boot_time
+
+= Notes
+  On MS Windows the Uptime.uptime and Uptime_boot_time methods optionally
+  takes a host name as a single argument. The default is localhost.
+
+  The current time, users and load average are not included in this library
+  module, even though you may be used to seeing them with the command
+  line version of 'uptime'.
+
+== Known Bugs
+  None that I am aware of.  Please log any bugs you find on the project
+  website at https://github.com/djberg96/sys-uptime.
+
+== Questions
+  "Doesn't Struct::Tms do this?" - No.
+    
+== License
+  Apache 2.0
+    
+== Copyright
+  Copyright 2002-2018, 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
+  Andrea Fazzi for help with the FFI version.
+
+  Mike Hall for help with the BSD side of things for the original C code.
+
+  Ola Eriksson, whose source code I shamelessly plagiarized to get a better
+  implementation for systems that have the utmpx.h header file for the
+  original C code.
+
+== Author
+  Daniel J. Berger

data/Rakefile

@@ -0,0 +1,42 @@
+require 'rake'
+require 'rake/clean'
+require 'rake/testtask'
+
+CLEAN.include("**/*.gem", "**/*.rbx", "**/*.rbc")
+
+namespace 'gem' do
+  desc 'Build the sys-uptime gem'
+  task :create => [:clean] do
+    require 'rubygems/package'
+    spec = eval(IO.read('sys-uptime.gemspec'))
+    spec.signing_key = File.join(Dir.home, '.ssh', 'gem-private_key.pem')
+    
+    if File::ALT_SEPARATOR
+      spec.platform = Gem::Platform.new(['universal','mingw32'])
+    else
+      spec.add_dependency('ffi', '>= 1.0.0')
+    end
+
+    Gem::Package.build(spec, true)
+  end
+
+  desc 'Install the sys-uptime gem'
+  task :install => [:create] do
+    file = Dir["*.gem"].first
+    sh "gem install -l #{file}"
+  end
+end
+
+desc "Run the test suite"
+Rake::TestTask.new do |t|
+  if File::ALT_SEPARATOR
+    t.libs << 'lib/windows'
+  else
+    t.libs << 'lib/unix'
+  end
+
+  t.warning = true
+  t.verbose = true
+end
+
+task :default => :test

data/certs/djberg96_pub.pem

@@ -0,0 +1,26 @@
+-----BEGIN CERTIFICATE-----
+MIIEcDCCAtigAwIBAgIBATANBgkqhkiG9w0BAQsFADA/MREwDwYDVQQDDAhkamJl
+cmc5NjEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYKCZImiZPyLGQBGRYDY29t
+MB4XDTE4MDMxODE1MjIwN1oXDTI4MDMxNTE1MjIwN1owPzERMA8GA1UEAwwIZGpi
+ZXJnOTYxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixkARkWA2Nv
+bTCCAaIwDQYJKoZIhvcNAQEBBQADggGPADCCAYoCggGBALgfaroVM6CI06cxr0/h
+A+j+pc8fgpRgBVmHFaFunq28GPC3IvW7Nvc3Y8SnAW7pP1EQIbhlwRIaQzJ93/yj
+u95KpkP7tA9erypnV7dpzBkzNlX14ACaFD/6pHoXoe2ltBxk3CCyyzx70mTqJpph
+75IB03ni9a8yqn8pmse+s83bFJOAqddSj009sGPcQO+QOWiNxqYv1n5EHcvj2ebO
+6hN7YTmhx7aSia4qL/quc4DlIaGMWoAhvML7u1fmo53CYxkKskfN8MOecq2vfEmL
+iLu+SsVVEAufMDDFMXMJlvDsviolUSGMSNRTujkyCcJoXKYYxZSNtIiyd9etI0X3
+ctu0uhrFyrMZXCedutvXNjUolD5r9KGBFSWH1R9u2I3n3SAyFF2yzv/7idQHLJJq
+74BMnx0FIq6fCpu5slAipvxZ3ZkZpEXZFr3cIBtO1gFvQWW7E/Y3ijliWJS1GQFq
+058qERadHGu1yu1dojmFRo6W2KZvY9al2yIlbkpDrD5MYQIDAQABo3cwdTAJBgNV
+HRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNVHQ4EFgQUFZsMapgzJimzsbaBG2Tm8j5e
+AzgwHQYDVR0RBBYwFIESZGpiZXJnOTZAZ21haWwuY29tMB0GA1UdEgQWMBSBEmRq
+YmVyZzk2QGdtYWlsLmNvbTANBgkqhkiG9w0BAQsFAAOCAYEAW2tnYixXQtKxgGXq
+/3iSWG2bLwvxS4go3srO+aRXZHrFUMlJ5W0mCxl03aazxxKTsVVpZD8QZxvK91OQ
+h9zr9JBYqCLcCVbr8SkmYCi/laxIZxsNE5YI8cC8vvlLI7AMgSfPSnn/Epq1GjGY
+6L1iRcEDtanGCIvjqlCXO9+BmsnCfEVehqZkQHeYczA03tpOWb6pon2wzvMKSsKH
+ks0ApVdstSLz1kzzAqem/uHdG9FyXdbTAwH1G4ZPv69sQAFAOCgAqYmdnzedsQtE
+1LQfaQrx0twO+CZJPcRLEESjq8ScQxWRRkfuh2VeR7cEU7L7KqT10mtUwrvw7APf
+DYoeCY9KyjIBjQXfbj2ke5u1hZj94Fsq9FfbEQg8ygCgwThnmkTrrKEiMSs3alYR
+ORVCZpRuCPpmC8qmqxUnARDArzucjaclkxjLWvCVHeFa9UP7K3Nl9oTjJNv+7/jM
+WZs4eecIcUc4tKdHxcAJ0MO/Dkqq7hGaiHpwKY76wQ1+8xAh
+-----END CERTIFICATE-----

data/examples/uptime_test.rb

@@ -0,0 +1,21 @@
+###########################################################
+# uptime_test.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/lib/sys-uptime.rb

@@ -0,0 +1 @@
+require_relative 'sys/uptime'

data/lib/sys/unix/sys/uptime.rb

@@ -0,0 +1,210 @@
+require 'ffi'
+
+# 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
+    extend FFI::Library
+    ffi_lib FFI::Library::LIBC
+
+    # Error typically raised in one of the Uptime methods should fail.
+    class Error < StandardError; end
+
+    private
+
+    # Hit this issue on Linux, not sure why
+    begin
+      find_type(:clock_t)
+    rescue TypeError
+      typedef(:long, :clock_t)
+    end
+
+    attach_function :strerror, [:int],     :string
+    attach_function :sysconf,  [:int],     :long
+    attach_function :time,     [:pointer], :time_t
+    attach_function :times,    [:pointer], :clock_t
+
+    private_class_method :strerror, :sysconf, :time, :times
+
+    begin
+      attach_function :sysctl, [:pointer, :uint, :pointer, :pointer, :pointer, :size_t], :int
+      private_class_method :sysctl
+    rescue FFI::NotFoundError
+      attach_function :setutxent, [], :void
+      attach_function :getutxent, [], :pointer
+      attach_function :endutxent, [], :void
+      private_class_method :setutxent, :getutxent, :endutxent
+    end
+
+    CTL_KERN      = 1   # Kernel
+    KERN_BOOTTIME = 21  # Time kernel was booted
+    TICKS         = 100 # Ticks per second (TODO: use sysconf)
+    BOOT_TIME     = 2   # Boot time
+
+    class Tms < FFI::Struct
+      layout(
+        :tms_utime, :clock_t,
+        :tms_stime, :clock_t,
+        :tms_cutime, :clock_t,
+        :tms_cstime, :clock_t
+      )
+    end
+
+    class Timeval < FFI::Struct
+      layout(
+        :tv_sec,  :long,
+        :tv_usec, :long
+      )
+    end
+
+    class ExitStatus < FFI::Struct
+      layout(
+        :e_termination, :short,
+        :e_exit, :short
+      )
+    end
+
+    class Utmpx < FFI::Struct
+      layout(
+        :ut_user, [:char, 32],
+        :ut_id,   [:char, 4],
+        :ut_line, [:char, 32],
+        :ut_pid,  :pid_t,
+        :ut_type, :short,
+        :ut_exit, ExitStatus,
+        :ut_tv,   Timeval,
+        :ut_session, :int,
+        :padding, [:int, 5],
+        :ut_host, [:char, 257]
+      )
+    end
+
+    public
+
+    # Returns a Time object indicating the time the system was last booted.
+    #
+    # Example:
+    #
+    #    Sys::Uptime.boot_time # => Mon Jul 13 06:08:25 -0600 2009
+    #
+    def self.boot_time
+      if RbConfig::CONFIG['host_os'] =~ /linux/i
+        Time.now - self.seconds
+      elsif respond_to?(:sysctl, true)
+        tv = Timeval.new
+        mib  = FFI::MemoryPointer.new(:int, 2).write_array_of_int([CTL_KERN, KERN_BOOTTIME])
+        size = FFI::MemoryPointer.new(:long, 1).write_int(tv.size)
+
+        if sysctl(mib, 2, tv, size, nil, 0) != 0
+          raise SystemCallError, 'sysctl() - ' + strerror(FFI.errno)
+        end
+
+        Time.at(tv[:tv_sec], tv[:tv_usec])
+      else
+        begin
+          setutxent()
+          while ent = Utmpx.new(getutxent())
+            if ent[:ut_type] == BOOT_TIME
+              time = Time.at(ent[:ut_tv][:tv_sec], ent[:ut_tv][:tv_usec])
+              break
+            end
+          end
+        ensure
+          endutxent()
+        end
+        time
+      end
+    end
+
+    # Returns the total number of seconds of uptime.
+    #
+    # Example:
+    #
+    #    Sys::Uptime.seconds => 118800
+    #
+    def self.seconds
+      if RbConfig::CONFIG['host_os'] =~ /linux/i
+        begin
+          IO.read('/proc/uptime').split.first.to_i
+        rescue Exception => err
+          raise Error, err
+        end
+      elsif respond_to?(:sysctl, true)
+        tv   = Timeval.new
+        mib  = FFI::MemoryPointer.new(:int, 2).write_array_of_int([CTL_KERN, KERN_BOOTTIME])
+        size = FFI::MemoryPointer.new(:long, 1).write_int(tv.size)
+
+        if sysctl(mib, 2, tv, size, nil, 0) != 0
+          raise SystemCallError, 'sysctl() - ' + strerror(FFI.errno)
+        end
+
+        time(nil) - tv[:tv_sec]
+      else
+        tms = Tms.new
+        times(tms) / TICKS
+      end
+    end
+
+    # Returns the total number of minutes of uptime.
+    #
+    # Example:
+    #
+    #    Sys::Uptime.minutes # => 678
+    #
+    def self.minutes
+      seconds / 60
+    end
+
+    # Returns the total number of hours of uptime.
+    #
+    # Example:
+    #
+    #    Sys::Uptime.hours # => 31
+    #
+    def self.hours
+      seconds / 3600
+    end
+
+    # Returns the total number of days of uptime.
+    #
+    # Example:
+    #
+    #    Sys::Uptime.days # => 2
+    #
+    def self.days
+      seconds / 86400
+    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
+      secs  = seconds
+      days  = secs / 86400
+      secs  -= days * 86400
+      hours = secs / 3600
+      secs  -= hours * 3600
+      mins  = secs / 60
+      secs  -= mins * 60
+
+      "#{days}:#{hours}:#{mins}:#{secs}"
+    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
+      uptime.split(':')
+    end
+  end
+end

data/lib/sys/uptime.rb

@@ -0,0 +1,12 @@
+if File::ALT_SEPARATOR
+  require_relative 'windows/sys/uptime'
+else
+  require_relative 'unix/sys/uptime'
+end
+
+module Sys
+  class Uptime
+    # The version of the sys-uptime library
+    VERSION = '0.7.2'.freeze
+  end
+end

data/lib/sys/windows/sys/uptime.rb

@@ -0,0 +1,144 @@
+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
+
+    # 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
+
+    private_class_method :parse_ms_date
+
+    # 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
+
+    private_class_method :get_dhms
+
+    # Returns the number of seconds since boot.
+    #
+    def self.get_seconds(host)
+      (Time.now - boot_time).to_i
+    end
+
+    private_class_method :get_seconds
+  end
+end

data/sys-uptime.gemspec

@@ -0,0 +1,31 @@
+require 'rubygems'
+
+Gem::Specification.new do |spec|
+  spec.name       = 'sys-uptime'
+  spec.version    = '0.7.2'
+  spec.author     = 'Daniel J. Berger'
+  spec.license    = 'Apache 2.0'
+  spec.email      = 'djberg96@gmail.com'
+  spec.homepage   = 'https://github.com/djberg96/sys-uptime'
+  spec.summary    = 'A Ruby interface for getting system uptime information.'
+  spec.test_file  = 'test/test_sys_uptime.rb'
+  spec.files      = Dir["**/*"].reject{ |f| f.include?('git') }
+  spec.cert_chain = ['certs/djberg96_pub.pem']
+
+  spec.extra_rdoc_files  = ['CHANGES', 'README', 'MANIFEST']
+
+  spec.metadata = {
+    'homepage_uri'      => 'https://github.com/djberg96/sys-uptime',
+    'bug_tracker_uri'   => 'https://github.com/djberg96/sys-uptime/issues',
+    'changelog_uri'     => 'https://github.com/djberg96/sys-uptime/blob/ffi/CHANGES',
+    'documentation_uri' => 'https://github.com/djberg96/sys-uptime/wiki',
+    'source_code_uri'   => 'https://github.com/djberg96/sys-uptime',
+    'wiki_uri'          => 'https://github.com/djberg96/sys-uptime/wiki'
+  }
+
+  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,107 @@
+#####################################################################
+# 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'
+require 'socket'
+include Sys
+
+class TC_Sys_Uptime < Test::Unit::TestCase
+  test "version is set to expected value" do
+    assert_equal('0.7.2', Uptime::VERSION)
+    assert_true(Uptime::VERSION.frozen?)
+  end
+
+  test "seconds method basic functionality" do
+    assert_respond_to(Uptime, :seconds)
+    assert_nothing_raised{ Uptime.seconds }
+  end
+
+  test "seconds method returns a plausible value" do
+    assert_kind_of(Integer, Uptime.seconds)
+    assert_true(Uptime.seconds > 300)
+  end
+
+  test "minutes method basic functionality" do
+    assert_respond_to(Uptime, :minutes)
+    assert_nothing_raised{ Uptime.minutes }
+  end
+
+  test "minutes method returns a plausible value" do
+    assert_kind_of(Integer, Uptime.minutes)
+    assert_true(Uptime.minutes > 5)
+  end
+
+  test "hours method basic functionality" do
+    assert_respond_to(Uptime, :hours)
+    assert_nothing_raised{ Uptime.hours }
+  end
+
+  test "hours method returns a plausible value" do
+    assert_kind_of(Integer, Uptime.hours)
+    assert_true(Uptime.hours > 0)
+  end
+
+  test "days method basic functionality" do
+    assert_respond_to(Uptime, :days)
+    assert_nothing_raised{ Uptime.days }
+  end
+
+  test "days method returns a plausible value" do
+    assert_kind_of(Integer, Uptime.days)
+    assert_true(Uptime.days >= 0)
+  end
+
+  test "uptime method basic functionality" do
+    assert_respond_to(Uptime, :uptime)
+    assert_nothing_raised{ Uptime.uptime }
+  end
+
+  test "uptime method returns a non-empty string" do
+    assert_kind_of(String, Uptime.uptime)
+    assert_false(Uptime.uptime.empty?)
+  end
+
+  test "uptime method does not accept any arguments" do
+    omit_if(File::ALT_SEPARATOR)
+    assert_raise(ArgumentError){ Uptime.uptime(1) }
+  end
+
+  test "uptime accepts a host name on Windows" do
+    omit_unless(File::ALT_SEPARATOR, "MS Windows only")
+    assert_nothing_raised{ Uptime.uptime(Socket.gethostname) }
+  end
+
+  test "dhms method basic functionality" do
+    assert_respond_to(Uptime, :dhms)
+    assert_nothing_raised{ Uptime.dhms }
+    assert_kind_of(Array, Uptime.dhms)
+  end
+
+  test "dhms method returns an array of four elements" do
+    assert_false(Uptime.dhms.empty?)
+    assert_equal(4, Uptime.dhms.length)
+  end
+
+  test "boot_time method basic functionality" do
+    assert_respond_to(Uptime, :boot_time)
+    assert_nothing_raised{ Uptime.boot_time }
+  end
+
+  test "boot_time method returns a Time object" do
+    assert_kind_of(Time, Uptime.boot_time)
+  end
+
+  test "Uptime class cannot be instantiated" do
+    assert_kind_of(StandardError, Uptime::Error.new)
+  end
+
+  test "Ensure that ffi functions are private" do
+    methods = Uptime.methods(false).map{ |e| e.to_s }
+    assert_false(methods.include?('time'))
+    assert_false(methods.include?('times'))
+  end
+end

metadata

@@ -0,0 +1,104 @@
+--- !ruby/object:Gem::Specification
+name: sys-uptime
+version: !ruby/object:Gem::Version
+  version: 0.7.2
+platform: universal-mingw32
+authors:
+- Daniel J. Berger
+autorequire: 
+bindir: bin
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIEcDCCAtigAwIBAgIBATANBgkqhkiG9w0BAQsFADA/MREwDwYDVQQDDAhkamJl
+  cmc5NjEVMBMGCgmSJomT8ixkARkWBWdtYWlsMRMwEQYKCZImiZPyLGQBGRYDY29t
+  MB4XDTE4MDMxODE1MjIwN1oXDTI4MDMxNTE1MjIwN1owPzERMA8GA1UEAwwIZGpi
+  ZXJnOTYxFTATBgoJkiaJk/IsZAEZFgVnbWFpbDETMBEGCgmSJomT8ixkARkWA2Nv
+  bTCCAaIwDQYJKoZIhvcNAQEBBQADggGPADCCAYoCggGBALgfaroVM6CI06cxr0/h
+  A+j+pc8fgpRgBVmHFaFunq28GPC3IvW7Nvc3Y8SnAW7pP1EQIbhlwRIaQzJ93/yj
+  u95KpkP7tA9erypnV7dpzBkzNlX14ACaFD/6pHoXoe2ltBxk3CCyyzx70mTqJpph
+  75IB03ni9a8yqn8pmse+s83bFJOAqddSj009sGPcQO+QOWiNxqYv1n5EHcvj2ebO
+  6hN7YTmhx7aSia4qL/quc4DlIaGMWoAhvML7u1fmo53CYxkKskfN8MOecq2vfEmL
+  iLu+SsVVEAufMDDFMXMJlvDsviolUSGMSNRTujkyCcJoXKYYxZSNtIiyd9etI0X3
+  ctu0uhrFyrMZXCedutvXNjUolD5r9KGBFSWH1R9u2I3n3SAyFF2yzv/7idQHLJJq
+  74BMnx0FIq6fCpu5slAipvxZ3ZkZpEXZFr3cIBtO1gFvQWW7E/Y3ijliWJS1GQFq
+  058qERadHGu1yu1dojmFRo6W2KZvY9al2yIlbkpDrD5MYQIDAQABo3cwdTAJBgNV
+  HRMEAjAAMAsGA1UdDwQEAwIEsDAdBgNVHQ4EFgQUFZsMapgzJimzsbaBG2Tm8j5e
+  AzgwHQYDVR0RBBYwFIESZGpiZXJnOTZAZ21haWwuY29tMB0GA1UdEgQWMBSBEmRq
+  YmVyZzk2QGdtYWlsLmNvbTANBgkqhkiG9w0BAQsFAAOCAYEAW2tnYixXQtKxgGXq
+  /3iSWG2bLwvxS4go3srO+aRXZHrFUMlJ5W0mCxl03aazxxKTsVVpZD8QZxvK91OQ
+  h9zr9JBYqCLcCVbr8SkmYCi/laxIZxsNE5YI8cC8vvlLI7AMgSfPSnn/Epq1GjGY
+  6L1iRcEDtanGCIvjqlCXO9+BmsnCfEVehqZkQHeYczA03tpOWb6pon2wzvMKSsKH
+  ks0ApVdstSLz1kzzAqem/uHdG9FyXdbTAwH1G4ZPv69sQAFAOCgAqYmdnzedsQtE
+  1LQfaQrx0twO+CZJPcRLEESjq8ScQxWRRkfuh2VeR7cEU7L7KqT10mtUwrvw7APf
+  DYoeCY9KyjIBjQXfbj2ke5u1hZj94Fsq9FfbEQg8ygCgwThnmkTrrKEiMSs3alYR
+  ORVCZpRuCPpmC8qmqxUnARDArzucjaclkxjLWvCVHeFa9UP7K3Nl9oTjJNv+7/jM
+  WZs4eecIcUc4tKdHxcAJ0MO/Dkqq7hGaiHpwKY76wQ1+8xAh
+  -----END CERTIFICATE-----
+date: 2018-11-04 00:00:00.000000000 Z
+dependencies: []
+description: |2
+      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.
+email: djberg96@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- CHANGES
+- README
+- MANIFEST
+files:
+- certs
+- certs/djberg96_pub.pem
+- CHANGES
+- examples
+- examples/uptime_test.rb
+- lib
+- lib/sys
+- lib/sys/unix
+- lib/sys/unix/sys
+- lib/sys/unix/sys/uptime.rb
+- lib/sys/uptime.rb
+- lib/sys/windows
+- lib/sys/windows/sys
+- lib/sys/windows/sys/uptime.rb
+- lib/sys-uptime.rb
+- MANIFEST
+- Rakefile
+- README
+- sys-uptime.gemspec
+- test
+- test/test_sys_uptime.rb
+homepage: https://github.com/djberg96/sys-uptime
+licenses:
+- Apache 2.0
+metadata:
+  homepage_uri: https://github.com/djberg96/sys-uptime
+  bug_tracker_uri: https://github.com/djberg96/sys-uptime/issues
+  changelog_uri: https://github.com/djberg96/sys-uptime/blob/ffi/CHANGES
+  documentation_uri: https://github.com/djberg96/sys-uptime/wiki
+  source_code_uri: https://github.com/djberg96/sys-uptime
+  wiki_uri: https://github.com/djberg96/sys-uptime/wiki
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.7.6
+signing_key: 
+specification_version: 4
+summary: A Ruby interface for getting system uptime information.
+test_files:
+- test/test_sys_uptime.rb

metadata.gz.sig

@@ -0,0 +1,4 @@
+G;��H����])����?�/�T��B�ڰԿ1�9����vL��$����.�����tB���M���}��mX� �5��Ӹ���h��:��-�~����.1eE'24ߦ�+3��U�s5�	���~O�u#�"pJ[�%��*�6�TQ�_w���j��'�C���1��Y�L1���H��s���K���酐j͇r񲪎10��j=Xè���AO��
@�}��`t�I�;�?�Zj'�bL�((��B��2
YR�
+�[������[	M<�ޞ��s)Ύ0��$~�V��e��%��@
+[gI+�V0�+���9
+i�l�,�XA�qa��.eaf��mHd#��̌�K^�0p�p����/���O���z�k