sys-uname 0.8.6-universal-mingw32

data/CHANGES

@@ -0,0 +1,160 @@
+== 0.8.6 - 2-Sep-2011
+* Fixed a failing test for Ruby 1.9.x.
+* The gemspec for Windows is now 'universal'.
+* Some minor doc updates.
+
+== 0.8.5 - 11-Dec-2010
+* Removed some non-ascii characters that somehow made it into the source.
+* Some updates to the Rakefile, including a default task.
+
+== 0.8.4 - 29-Jan-2010
+* Bug fix for Windows 7, which appears to have removed the QuantumLength and
+  QuantumType members of the Win32_OperatingSystem class. Thanks go to Mark
+  Seymour for the spot. RubyForge bug # 27645.
+* Changed license to Artistic 2.0.
+* Refactored the Rakefile and gemspec considerably. The gem building code is
+  now all inlined within the Rakefile build task itself.
+* Minor doc updates and some code reformatting.
+
+== 0.8.3 - 26-Apr-2008
+* Added an explicit "require 'time'" in the Windows version because recent
+  versions of Ruby now need it.
+* Changed the way I do platform checks in the Rakefile.
+
+== 0.8.2 - 22-Nov-2007
+* Fixed an issue where Ruby no longer parsed a certain type of date that
+  MS Windows uses. See RubyForge Bug #10646 for more information.
+
+== 0.8.1 - 29-Aug-2007
+* Made a minor modification to the build script for Linux. It turns out Linux
+  has sysctl, but not the necessary mibs for the Uname.model method. Thanks go
+  to Mickey Knox (?) for the spot.
+* Removed the install.rb file. The code from that program was integrated
+  directly into the Rakefile.
+
+== 0.8.0 - 10-Apr-2007
+* The Uname.model method should now work on most BSD platforms, not just OS X,
+  since it uses the sysctl() function behind the scenes.
+* The 'id' method was changed to 'id_number' on HP-UX to avoid confusion with
+  the Object.id method.
+* The UnameError class is now Uname::Error.
+* Added a Rakefile. There are now tasks for building, testing and installing
+  this package.
+* Removed some pre-setup code from the test suite that was no longer necessary
+  as a result of the Rake test task.
+
+== 0.7.4 - 19-Nov-2006
+* Internal layout changes, doc updates and gemspec improvements.
+* No code changes.
+
+== 0.7.3 - 30-Jul-2006
+* Bug fix for 64 bit platforms.
+* Minor modification of the extconf.rb file.
+
+== 0.7.2 - 5-Jul-2006
+* Removed '?' from the struct member names on MS Windows since these are no
+  longer legal.
+* Removed duplicate definition of Uname.version on MS Windows (oops).
+* Added a gemspec.
+* Added inline rdoc documentation to the source files.
+
+== 0.7.1 - 5-May-2005
+* Removed the uname.rd file.  The uname.txt file is rdoc friendly, so you
+  can autogenerate html from that file if you wish.
+* Removed the version.h file - no longer needed now that the Windows version
+  is pure Ruby.
+* Renamed test.rb to uname_test.rb
+* Minor setup modifications to the test suite.
+* This package is now hosted on RubyForge.
+
+== 0.7.0 - 11-Jan-2004
+* Scrapped the C version for Windows in favor of a pure Ruby version that uses
+  WMI + OLE.  I highly recommend using Ruby 1.8.2 or later on Win32 systems.
+  Earlier versions may cause segfaults.
+* Added the isa_list, hw_provider, hw_serial_number, srpc_domain and
+  dhcp_cache methods for Solaris.
+* Added install.rb program for Windows, and modified extconf.rb to only run on
+  non-Windows systems.
+* The 'examples' directory has been moved to the toplevel directory.
+* Removed the INSTALL file.  That information is now included in the README.
+* Documentation updates.
+
+== 0.6.1 - 25-Apr-2004
+* Simplified extconf.rb script and installation instructions.
+* Combined three test scripts into a single test script.
+* Warranty information added.
+
+== 0.6.0 - 25-Jun-2003
+* Added HP-UX support, including the id() class method (HP-UX only)
+* Fixed minor bug in extconf.rb (forgot 'require ftools' at top)
+* Added HP-UX specific tests and support
+* Made test.rb friendlier for folks without TestUnit installed
+
+== 0.5.0 - 16-Jun-2003
+* Added OS X support, including the "model" method.  Thanks to Mike Hall
+  for the patch
+* Removed VERSION() class method.  Use the constant instead
+* Moved rd documentation to its own file (under /doc directory)
+* Added a version.h file under 'lib' to store VERSION info for
+  all source files
+* Modified extconf.rb file to handle OS X support.  In addition, moved
+  test.rb into a static file under /test, instead of dynamically
+  generating it
+* Fixed up test suite.  Added OS X specific tests and support.  Should now
+  work with TestUnit 0.1.6 or later
+    
+== 0.4.1 - 7-Feb-2003
+* Fixed C89 issue (again) - thanks go to Daniel Zepeda for the spot
+* Fixed bugs in extconf.rb file (rescue clause, ftools)
+
+== 0.4.0 - 6-Feb-2003
+* MS Windows support!
+* Added a test suite and automatic test.rb creation
+* Documentation additions/fixes
+* Internal directory layout and filename changes (Changelog -> CHANGES)
+
+== 0.3.3 - 6-Jan-2003
+* Made the code C89 compliant for older compilers.  Thanks to Paul Brannan
+  for teaching me how to fix this in general.
+* Moved README to doc/uname.txt
+* Created an INSTALL file
+* Added a copyright notice
+* Added a VERSION class method
+* Changed tarball name to reflect RAA package name
+* Minor doc changes
+
+== 0.3.2 - 8-Aug-2002
+* Changed the struct name returned by the 'uname()' method from
+  "Uname::UnameStruct" to just "UnameStruct".  This was to make it
+  compliant with future versions of Ruby.  The extra namespace was
+  redundant anyway.
+* I include the documentation now, instead of making you install rd2 :)
+
+== 0.3.1 - 22-Jul-2002
+* Added the 'uname' class method, which returns a struct that contains all
+  of the uname information
+* Added a test script.  Do 'ruby test.rb' to run it.
+* If rd2 is installed on your system, the documentation is automatically
+  generated for you.
+* Moved html documentation to 'doc' directory.
+* Changed version number style to be consistent with other 'Sys' modules
+* Now installs into 'Sys-Uname-x.x.x' directory (instead of just 'Uname')
+
+== 0.03 - 6-June-2002
+* rd style documentation now inline
+* README.html is now uname.html - created via rdtool
+* The 'platform()' and 'architecture()' methods have been added for Solaris
+* You can now do an 'include Sys' to shorten your syntax
+* The whole 'Sys' class has been removed.  Delete your sys.so file if you
+  installed a previous version of Sys-Uname
+
+== 0.02 - 3-June-2002
+* Potentially fatal memory problems corrected.
+* Should now build with C++ as well
+* Thanks to Mike Hall for both the spot and the fix
+* Added a Changelog file
+* Added a README.html file
+* Added a Manifest file
+
+== 0.01 - 31-May-2002
+* Initial release (unannounced)

data/MANIFEST

@@ -0,0 +1,11 @@
+* MANIFEST
+* CHANGES
+* README
+* Rakefile
+* sys-uname.gemspec
+* doc/uname.txt
+* examples/uname_test.rb
+* ext/extconf.rb
+* ext/uname.c
+* lib/sys/uname.rb
+* test/tc_uname.rb

data/README

@@ -0,0 +1,36 @@
+= Description
+  A Ruby interface for getting operating system information. The name comes
+  from the Unix 'uname' command, but this library works on Windows as well.
+
+= Installation
+  gem install sys-uname
+
+  # If that doesn't work and you're on Windows try this:
+  gem install sys-uname --platform universal-mingw32
+   
+= Synopsis
+  require 'sys/uname'
+  include Sys
+   
+  p Uname.uname
+   
+= Solaris Notes
+  Folks building this library on SunOS get two extra methods: architecture()
+  and platform()
+
+= BSD flavors, including OS X
+  Users on BSD platforms get the extra Uname.model method.
+
+= HP-UX Notes
+  HP-UX users get the extra Uname.id_number method. This is actually a
+  String, not a Fixnum, because that's how it's defined in the utsname
+  struct.
+
+= MS Windows Notes
+  The C version for Windows has been completely scrapped in favor of an OLE
+  plus WMI approach. It is pure Ruby. Please see the MSDN documentation for
+  the Win32_OperatingSystem class for a complete list of what each of the
+  UnameStruct members mean.
+
+= Documentation
+  For more details, see the 'uname.txt' file under the 'doc' directory. 

data/Rakefile

@@ -0,0 +1,73 @@
+require 'rake'
+require 'rake/clean'
+require 'rake/testtask'
+require 'rbconfig'
+include Config
+
+WINDOWS = CONFIG['host_os'] =~ /msdos|mswin|win32|windows|mingw|cygwin/i
+
+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
+)
+
+desc "Build the source for C extensions"
+task :build => [:clean] do
+  Dir.chdir("ext"){
+    ruby "extconf.rb"
+    sh "make"
+    cp "uname." + Config::CONFIG['DLEXT'], 'sys'
+  }
+end
+
+desc "Run the example program"
+task :example => [:build] do
+  if WINDOWS
+    sh 'ruby -Ilib examples/uname_test.rb'
+  else
+    sh 'ruby -Iext examples/uname_test.rb'
+  end
+end
+
+namespace 'gem' do
+  desc "Create the sys-uname gem"
+  task :create do
+    spec = eval(IO.read('sys-uname.gemspec'))
+    if WINDOWS
+      spec.files = spec.files.reject{ |f| f.include?('ext') }
+      spec.platform = Gem::Platform::CURRENT
+      spec.platform.cpu = 'universal'
+      spec.platform.version = nil
+      spec.original_platform = spec.platform
+    else
+      spec.files = spec.files.reject{ |f| f.include?('lib') }
+      spec.extensions = ['ext/extconf.rb']
+      spec.extra_rdoc_files += ['ext/sys/uname.c']
+    end
+    Gem::Builder.new(spec).build
+  end
+
+  desc "Install the sys-uname gem"
+  task :install => [:create] do
+    file = Dir['sys-uname*.gem'].first
+    sh "gem install #{file}"
+  end
+end
+
+desc "Run the test suite"
+Rake::TestTask.new("test") do |t|
+  if WINDOWS
+    t.libs << 'lib'
+  else
+    task :test => :build
+    t.libs << 'ext'
+    t.libs.delete('lib')
+  end
+end
+
+task :default => :test

data/doc/uname.txt

@@ -0,0 +1,127 @@
+== Description
+   A Ruby interface for getting operating system information. The name comes
+   from the Unix 'uname' command, but this library works on Windows as well.
+
+== Synopsis
+   require 'sys/uname'
+   include Sys
+
+   # Unix
+   puts Uname.nodename  => my_host
+   puts Uname.version   => #1 Fri Oct 24 22:43:28 MDT 2003
+   puts Uname.sysname   => Linux
+   puts Uname.machine   => i686
+   puts Uname.release   => 2.4.22-21mdk
+	
+   p Uname.uname        => Show all UnameStruct members
+
+   # Windows
+   u = Uname.uname
+   puts u.caption     => 'Microsoft Windows XP Home Edition
+   puts u.csd_version => 'Service Pack 2'
+
+== Constants
+VERSION
+   The current version number of the sys-uname library. This is a String.
+
+== Class Methods
+Uname.sysname
+   Returns the operating system name, e.g. "SunOS"
+    
+Uname.nodename
+   Returns the nodename. This is usually, but not necessarily, the 
+   same as the system's hostname.
+	
+   You cannot currently set the nodename (root or otherwise). This may
+   be added in a future release.
+
+Uname.machine
+   Returns the machine hardware type, e.g. "i686"
+    
+Uname.version
+   Returns the operating system version. e.g. "5.8". In the case of MS
+   Windows, it returns the version plus patch information, separated by
+   a hyphen, e.g. "2915-Service Pack 2".
+    
+Uname.release
+   Returns the operating system release, e.g. "2.2.16-3"
+    
+Uname.uname
+   Returns a struct of type UnameStruct that contains sysname, nodename,
+   machine, version, and release.  On Solaris, it will also include 
+   architecture and platform.  On HP-UX, it will also include id_number.
+    
+   MS Windows - there are many more, and different, fields in the struct.
+   Please see the MSDN documenation on the Win32_OperatingSystem WMI class
+   for a complete explanation of what each of these members mean.
+    
+== Solaris Only
+Uname.architecture
+   Returns the instruction set architecture, e.g. "sparc"
+    
+Uname.platform
+   Returns the platform identifier, e.g. "SUNW,Sun-Blade-100"
+    
+Uname.isa_list
+   Returns a space separated string containing a list of all variant
+   instruction set architectures executable on the current system.
+	 
+   They are listed in order of performance, from best to worst.
+
+Uname.hw_provider
+   Returns the name of the hardware manufacturer.
+
+Uname.hw_serial_number
+   Returns the ASCII representation of the hardware-specific serial number
+   of the machine that executes the function.
+
+Uname.srpc_domain
+   Returns the name of the Secure Remote Procedure Call domain, if any.
+
+Uname.dhcp_cache
+   Returns a hexidecimal encoding, in String form, of the name of the
+   interface configured by boot(1M) followed by the DHCPACK reply from
+   the server.
+    
+== BSD Platforms Only (including OS X)
+Uname.model
+   Returns the model type,  e.g. "PowerBook5,1"
+    
+== HP-UX Only
+Uname.id_number
+   Returns the id number, e.g. 234233587. This is a String, not a Fixnum.
+
+== Notes
+   Not all of the information that you might be used to seeing with
+   a 'uname -a' is available.  This may be added in future releases,
+   but since different implementations provide different information
+   (via different header files) it will be a bit of a pain.
+
+   Windows users - please see the MSDN documentation for the
+   Win32_OperatingSystem class for a complete list of what each of the
+   UnameStruct members mean.
+
+== Known Bugs
+   None that I'm aware of.  Please log any bugs on the project page at
+   http://www.rubyforge.org/projects/sysutils.
+	
+== Future Plans
+   Add additional info for Linux, Solaris, BSD.
+
+== License
+   Artistic 2.0
+
+== Copyright
+   (C) 2002-2011 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 Berger
+	
+== See Also
+   uname(1) for unix, or WMI for MS Windows.

data/examples/uname_test.rb

@@ -0,0 +1,41 @@
+########################################################################
+# uname_test.rb
+#
+# Generic test script for general futzing. Modify as you see fit. This
+# should generally be run via the 'rake example' task.
+########################################################################
+require 'sys/uname'
+include Sys
+
+puts "VERSION: " + Uname::VERSION
+puts 'Nodename: ' + Uname.nodename
+puts 'Sysname: ' + Uname.sysname
+puts 'Version: ' + Uname.version
+puts 'Release: ' + Uname.release
+puts 'Machine: ' + Uname.machine # May be "unknown" on Win32
+
+if RUBY_PLATFORM =~ /sun|solaris/i
+   print "\nSolaris specific tests\n" 
+   puts "==========================="
+   puts 'Architecture: ' + Uname.architecture
+   puts 'Platform: ' + Uname.platform
+   puts 'Instruction Set List: ' + Uname.isa_list.split.join(", ")
+   puts 'Hardware Provider: ' + Uname.hw_provider
+   puts 'Serial Number: ' + Uname.hw_serial_number.to_s
+   puts 'SRPC Domain: ' + Uname.srpc_domain # might be empty
+   puts 'DHCP Cache: ' + Uname.dhcp_cache # might be empty
+end
+
+if RUBY_PLATFORM =~ /powerpc|darwin|bsd|mach/i
+   print "\nBSD/OS X specific tests\n" 
+   puts "======================="
+   puts 'Model: ' + Uname.model
+end
+
+if RUBY_PLATFORM =~ /hpux/i
+   print "\nHP-UX specific tests\n"
+   puts "========================"
+   puts "ID: " + Uname.id
+end
+
+print "\nTest finished successfully\n"