sys-cpu 0.6.1-x86-mswin32-60

data/CHANGES

@@ -0,0 +1,131 @@
+== 0.6.1 - 4-Jan-2009
+* Fix for OS X 10.5.x. Thanks go to Victor Costan for the spot and the patch.
+* Updated the gemspec and some other minor changes.
+* On MS Windows the impersonation level is now explicitly set to 'impersonate'
+  to avoid issues where systems might be using an older version of WMI.
+
+== 0.6.0 - 26-Apr-2007
+* Added support for most BSD flavors, including OS X. The freebsd.c file is
+  now just bsd.c.
+* The CPU.type method for Solaris has been changed to CPU.cpu_type to avoid
+  conflicting with the Object.type method.
+* Added a Rakefile. There are now tasks for building, testing and installing,
+  among other things. Run 'rake -T' to check your options.
+* Many internal directory layout changes - C source files are now under the
+  'ext' directory.
+* Improved RDoc comments in the C source files.
+* Changed CPUError to CPU::Error.
+
+== 0.5.5 - 17-Nov-2006
+* Fixed a bug in the Linux version where there could be a key but no
+   associated value, causing a String#strip! call to fail.  Now the value is
+   simply left at nil.
+* Refactored the CPU.processors method on Linux, including the removal of '?'
+  from the CPUStruct members for the boolean methods (Ruby doesn't like them).
+* Minor tweaks and updates to the documentation, including the README.
+* Modified the gemspec so that it sets the platform properly for Linux
+  and Windows.
+
+== 0.5.4 - 12-Jul-2006
+* Added a gemspec (and a gem on RubyForge).
+* The CPU.architecture method on HP-UX now returns nil if it cannot be
+  determined instead of "Unknown" for consistency with the other
+  platforms.
+* Inlined the RDoc and made some minor cosmetic source code changes.
+
+== 0.5.3 - 4-May-2006
+* Fixed in a bug in the Solaris version where CPU.load_avg returned bad values
+  when compiled in 64 bit mode.  Thanks go to James Hranicky for the spot and
+  both James Hranicky and Peter Tribble (via comp.unix.solaris) for patches.
+* Made some modifications to the test suite.  You know longer need to know
+  which test suite to run.  All platforms now use 'ts_all.rb', which will run
+  the appropriate test case behind the scenes.
+
+== 0.5.2 - 24-Jun-2005
+* Bug fixed on Linux where empty lines could cause problems.  This affected
+  both the install.rb and linux.rb files, though it only seems to have been
+  an issue on the 2.6+ kernel.
+* Altered the behavior of the CPU.cpu_stats method on Linux.  Now, only the
+  numbered cpu entries return associated data, unless the numberless entry
+  is the only entry.
+* Added a sample program for Linux under the 'examples' directory.
+
+== 0.5.1 - 5-May-2005
+* Fixed a potential bug in the FreeBSD version of CPU.model.
+* Eliminated some warnings in the FreeBSD version.
+* Moved examples directory to the toplevel package directory.
+* Renamed and updated the sample scripts.
+* Added a sample script for FreeBSD.
+* Removed the INSTALL file.  That information is now included in the README.
+* Made the CHANGES, README, and .txt files rdoc friendly.
+* The dynamic documentation generation for Linux has been altered.  Anything
+  relating to rd2 has been removed.  The doc file generated is now
+  doc/linux.txt.
+* Some $LOAD_PATH setup changes in the unit tests.
+
+== 0.5.0 - 26-Jun-2004
+* Now requires Ruby 1.8.0 or later.
+* FreeBSD support added.
+* Replaced 'CPUException' with 'CPUError'
+* The MS Windows version has been completely revamped to use WMI instead of
+  the C API.  Some method names have changed and some methods have been
+  dropped entirely.  Please see the documentation for details.
+* Corresponding documentation updates and test suite changes.
+* Sample programs have been moved to doc/examples.
+* Installation procedure somewhat revamped.
+* No longer autogenerates test file.
+* The .html files have been removed.  You can generate the html on your own
+  if you like.
+
+== 0.4.0 - 18-Sep-2003
+* Added MS Windows support
+* Changed some method names.  The "cpu" has been dropped from most method
+  names.  See documentation for details.
+* The state() and freq() methods (where supported) now assume a default 
+  value of zero.
+* More unit tests added.
+* Fixed minor issue with test.rb for those without TestUnit installed.
+* Fixed issue with linux.rb file being auto-installed on non-Linux platforms.
+* Minor API change for the load_avg() method on HP-UX.  It now accepts a
+  CPU number as an argument.
+
+== 0.3.1 - 16-Jul-2003
+* Fixed a bug in the Solaris version that was using up and not
+  freeing file descriptors.
+* Added html doc for Solaris under doc directory.
+* Minor changes to test_hpux.rb and test_sunos.rb
+* Minor README changes.
+
+== 0.3.0 - 30-Jun-2003
+* Added HP-UX support
+* Removed the VERSION class method.  Use the constant instead
+* Changed license to "Artistic"
+* Moved version info into its own file for convenience
+* Some minor mods to the test suites
+* Modified extconf.rb, moving some of the dynamic test generation
+  into separate files
+
+== 0.2.2 - 25-Mar-2003
+* fpu_type and cpu_type now return nil if not found (Solaris)
+* CPUException is now a direct subclass of StandardError
+* Modified extconf.rb script
+* Minor doc updates
+* Added another test to the solaris test suite
+* Important note added to INSTALL file
+
+== 0.2.1 - 12-Mar-2003
+* Added the cpu_stats() class method for Linux, which contains the
+  data from the 'cpu' lines of /proc/stat
+* Minor fix for extconf.rb (thanks Michael Granger)
+* Some tests added to Linux test suite
+* MANIFEST correction
+
+== 0.2.0 - 13-Feb-2003
+* Linux support added (pure Ruby only)
+* Many changes to extconf.rb to support Linux version
+* sys-uname prerequisite dropped
+* rd2 documentation now kept separate from source
+
+== 0.1.0 - 3-Feb-2003
+* Initial release
+* Currently supports Solaris (only)

data/MANIFEST

@@ -0,0 +1,28 @@
+* install.rb
+* MANIFEST
+* CHANGES
+* Rakefile
+* README
+* sys-cpu.gemspec
+* doc/bsd.txt
+* doc/hpux.txt
+* doc/linux.txt
+* doc/sunos.txt
+* doc/windows.txt
+* examples/test_cpu_freebsd.rb
+* examples/test_cpu_hpux.rb
+* examples/test_cpu_linux.rb
+* examples/test_cpu_sunos.rb
+* examples/test_cpu_windows.rb
+* ext/extconf.rb
+* ext/version.h
+* ext/bsd/bsd.c
+* ext/hpux/hpux.c
+* ext/sunos/sunos.c
+* lib/sys/linux.rb
+* lib/sys/windows.rb
+* test/tc_bsd.rb
+* test/tc_hpux.rb
+* test/tc_sunos.rb
+* test/tc_linux.rb
+* test/tc_windows.rb

data/README

@@ -0,0 +1,79 @@
+= Description
+   A Ruby interface for getting cpu information.
+
+= Installation
+== Standard Installation
+   rake test (optional)
+   rake install (non-gem)
+== Gem installation
+   rake test (optional)
+   ruby sys-cpu.gemspec
+   gem install sys-cpu-X.Y.Z.gem # where 'X.Y.Z' corresponds to the version.
+
+= Notes
+=== All Platforms
+   As of version 0.5.0 Ruby 1.8.0 or later is required.  It may work with
+   earlier versions, but I will not support it.
+
+=== Solaris
+   Currently there is no 'processors()' iterative method for multi-cpu systems.
+   I plan to add it this in a future release.
+   
+=== OS X
+   The CPU.freq method is not supported at the moment. The sysctl() approach
+   returns a bogus, hard coded value of some sort. I suspect it's possible
+   by using kernel modules via kldload(), but I'm not sure how yet.
+
+=== Linux
+   This is pure Ruby.  This version reads information out of /proc/cpuinfo and
+   /proc/loadavg, so if /proc isn't mounted it won't work.
+
+   The key-value information in /proc/cpuinfo is stored internally (i.e. in
+   memory) as an array of hashes when you first 'require' this package.  This
+   overhead is exceptionally minimal, given that your average cpuinfo file
+   contains less than 1k of text (and I don't store whitespace or newlines).
+
+   The text documentation for Linux is dynamically generated during the
+   build process because the fields vary depending on your setup.  So, don't
+   look at it until *after* you've installed it.  You will see a doc/linux.txt
+   file after you run 'rake install' (via install.rb).
+
+=== HP-UX
+   Unlike other platforms, you can get load averages for an individual cpu (in
+   multi-cpu systems). See documentation for more details.
+
+=== MS Windows
+   This is a pure Ruby implementation using the win32ole package + WMI. The C
+   version has been scrapped. 
+
+   As of version 0.5.0, the CPU.usage method has been removed in favor of the
+   CPU.load_avg method.  This does not (currently) use a perf counter, so there
+   is no longer any delay.  Also, the 'processors' method has been
+   added and the 'supported' method has been dropped.  See the documentation
+   for other changes.
+
+= Known Bugs
+   None that I'm aware of.  Please report bugs on the project page at
+   http://www.rubyforge.org/projects/sysutils.
+
+= Future Plans
+   Add iterative CPU.processors method.
+   Make CPU.freq work on OS X.
+   Add more information in general, such as what 'prtdiag' shows.
+
+= License
+   Ruby's.
+
+= Copyright
+   (C) 2003-2007 Daniel J. Berger
+   All Rights Reserved
+
+= Warranty
+   This package 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.
+
+= Author
+   Daniel J. Berger
+   djberg96 at nospam at gmail dot com
+   imperator on IRC (irc.freenode.net)

data/doc/bsd.txt

@@ -0,0 +1,67 @@
+= Description
+   Sys::CPU - An interface for various cpu statistics
+   
+= Synopsis
+   require "sys/cpu"
+   include Sys
+
+   # BSD and OS X
+   puts "Architecture: " + CPU.architecture
+   puts "Machine: " + CPU.machine
+   puts "Mhz: " + CPU.cpu_freq.to_s
+   puts "Number of cpu's on this system: " + CPU.num_cpu.to_s
+   puts "CPU model: " + CPU.model
+   puts "Load averages: " + CPU.load_avg.join(", ")
+   
+= Constants
+VERSION
+   Returns the current version number for this package.
+    
+= Class Methods
+CPU.architecture
+   Returns the cpu's architecture.
+
+CPU.freq
+   Returns an integer indicating the speed (i.e. frequency in Mhz) of
+   the cpu.
+   
+   Not supported on OS X.
+    
+CPU.load_avg
+   Returns an array of three floats indicating the 1, 5 and 15 minute load
+   average.
+    
+CPU.machine
+   Returns the class of cpu (probably identical to the architecture).
+
+CPU.model
+   Returns a string indicating the cpu model.
+    
+CPU.num_cpu
+   Returns an integer indicating the number of cpu's on the system.
+    
+= Error Classes
+CPU::Error < StandardError
+   Raised is response to internal function errors, usually relating to an
+   invalid cpu number.
+    
+= Known Bugs
+   None known.  Please post bug reports to the SourceForge home page at
+   http://www.rubyforge.org/projects/sysutils 
+    
+= Copyright
+   (C) 2003-2007 Daniel J. Berger
+   All Rights Reserved
+    
+= Warranty
+   This package 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.
+
+= License
+   Ruby's
+    
+= Author
+   Daniel J. Berger
+   djberg96 at nospam at gmail dot com
+   imperator on IRC (Freenode)

data/doc/hpux.txt

@@ -0,0 +1,75 @@
+= Description
+   Sys::CPU - An interface for various cpu statistics
+   
+= Synopsis
+   require "sys/cpu"
+   include Sys
+
+   puts "Mhz: " + CPU.cpu_freq.to_s
+   puts "State: " + CPU.state(0)
+   puts "Number of cpu's on this system: " + CPU.num_cpu.to_s
+   puts "Number of active cpu's: " + CPU.num_active_cpu.to_s
+   puts "Load averages: " + CPU.load_avg.join(", ")
+   
+= Constants
+VERSION
+   Returns the current version number for this package.
+    
+= Class Methods
+CPU.architecture
+   Returns the cpu architecture, e.g. PA RISC 1.2, etc.
+    
+CPU.freq(cpu_num=0)
+   Returns an integer indicating the speed (i.e. frequency in Mhz) of
+   the cpu.
+    
+CPU.load_avg
+CPU.load_avg(cpu_num)
+CPU.load_avg{ |cpu| ... }
+
+   In non-block form returns an array of three floats indicating the 1, 5
+   and 15 minute overall load average.
+
+   In block form, it returns an array of three floats indicating the 1, 5
+   and 15 minute load average for each cpu.  Only useful on multi-cpu
+   systems.
+
+   If 'cpu_num' is provided, returns the load average (as a 3-element
+   array) for that cpu only.
+
+   You cannot provide a cpu number and use block form at the same time.
+    
+CPU.num_cpu
+   Returns an integer indicating the number of cpu's on the system.
+    
+CPU.num_active_cpu
+   Returns an integer indicating the number of active cpu's on the system.
+    
+= Error Classes
+CPU::Error < StandardError
+   Raised is response to internal function errors, usually relating to an
+   invalid cpu number.
+    
+= Known Bugs
+   No bugs known.  Please log any bugs at
+   http://www.rubyforge.org/projects/sysutils
+    
+= Future Plans
+   Add cpu model and type
+   
+= Copyright
+   (C) 2003-2007 Daniel J. Berger
+   All Rights Reserved
+    
+= Warranty
+   This package 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.
+    
+= License
+   Ruby's
+    
+= Author
+   Daniel J. Berger
+   djberg96 at nospam at gmail dot com
+   imperator on IRC (Freenode)

data/doc/linux.txt

@@ -0,0 +1,41 @@
+== Description
+    Sys::CPU - An interface for various cpu statistics
+
+== Synopsis
+    require "sys/cpu"
+    include Sys
+
+    CPU.processors{ |cs|
+       cs.members.each{ |m|
+          puts "#{m}: " + cs[m].to_s
+       }
+    }
+
+    CPU.bogomips(1) # -> returns bogomips for cpu #2
+
+== Notes
+   Portions of this documentation built dynamically
+
+== Constants
+VERSION
+   Returns the current version number for this package as a String.
+
+== Class Methods
+CPU.load_avg
+    Returns an array of three floats indicating the 1, 5 and 15 minute load
+    average.
+
+CPU.cpu_stats
+    Returns a hash, with the cpu number as the key and an array as the value.
+    The array contains the number of seconds that the system spent in
+    user mode, user mode with low priority (nice), system mode, and the
+    idle task, respectively, for that cpu.
+
+CPU.processors{ |cpu struct| block }
+    Calls the block for each processor on your system, passing a CPUStruct as the
+    parameter.
+
+    The exact members of the CPUStruct are the same as the class method names, except
+    for CPU.processors (although you may optionally omit the "?" when referring to a
+    struct member).  These were determined when you installed this package because they
+    vary from one chip architecture to another.

data/doc/sunos.txt

@@ -0,0 +1,78 @@
+= Description
+   Sys::CPU - An interface for various cpu statistics
+   
+= Synopsis
+   require "sys/cpu"
+   include Sys
+
+   # Solaris
+   puts "Mhz: " + CPU.cpu_freq(0).to_s
+   puts "State: " + CPU.state(0)
+   puts "Number of cpu's on this system: " + CPU.num_cpu.to_s
+   puts "CPU type: " + CPU.type
+   puts "FPU type: " + CPU.fpu_type
+   puts "CPU model: " + CPU.model
+   puts "Load averages: " + CPU.load_avg.join(", ")
+   
+= Constants
+VERSION
+   Returns the current version number for this package.
+    
+= Class Methods
+CPU.freq(cpu_num=0)
+   Returns an integer indicating the speed (i.e. frequency in Mhz) of
+   'cpu_num', or CPU 0 if no number is provided.
+    
+CPU.type
+   Returns a string indicating the type of processor.  This is the
+   architecture (e.g. sparcv9), not the exact model (e.g. Ultra-IIe).
+   Returns nil if not found.
+    
+CPU.fpu_type
+   Returns a string indicating the type of floating point unit, or nil if
+   not found.
+    
+CPU.load_avg
+   Returns an array of three floats indicating the 1, 5 and 15 minute load
+   average.
+    
+CPU.model
+   Returns a string indicating the cpu model.  For now, this is the
+   architecture type, rather than the exact model.  However, see the
+   'Future Plans' section below.
+    
+CPU.num_cpu
+   Returns an integer indicating the number of cpu's on the system.
+    
+CPU.state(cpu_num)
+   Returns a string indicating the cpu state of 'cpu_num'.
+    
+= Error Classes
+CPU::Error < StandardError
+   Raised is response to internal function errors, usually relating to an
+   invalid cpu number.
+    
+= Known Bugs
+   None known.  Please post bug reports to the SourceForge home page at
+   http://www.rubyforge.org/projects/sysutils
+    
+= Future Plans
+   Add more information, such as what prtdiag shows.
+   Get the model() method to display more specific information.
+    
+= Copyright
+   (C) 2003-2007 Daniel J. Berger
+   All Rights Reserved
+    
+= Warranty
+   This package 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.
+    
+= License
+   Ruby's
+    
+= Author
+   Daniel J. Berger
+   djberg96 at nospam at gmail dot com
+   imperator on IRC (Freenode)