unixinfo 1.0.0

data/History.txt

@@ -0,0 +1,6 @@
+=== 1.0.0 / 2011-03-31
+
+* 1 major enhancement
+
+  * Birthday!
+

data/Manifest.txt

@@ -0,0 +1,8 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+ext/unixinfo/extconf.rb
+ext/unixinfo/unixinfo_native.c
+ext/unixinfo/unixinfo_native.h
+lib/unixinfo.rb

data/README.txt

@@ -0,0 +1,63 @@
+= unixinfo
+
+* http://github.com/erikh/unixinfo
+
+== DESCRIPTION:
+
+A small hodgepodge of neat little UNIX API things I like to have access to without shelling out.
+
+== FEATURES/PROBLEMS:
+
+* getloadavg returns a 3-element tuple with your 1, 5, and 15 minute load averages.
+* gethostname returns your hostname.
+* getifaddrs returns a data structure with the ipv4 and ipv6 addresses bound to each of your interfaces, including netmask and broadcast information.
+
+== SYNOPSIS:
+
+  require 'unixinfo'
+
+  UnixInfo.getloadavg
+  UnixInfo.gethostname
+  UnixInfo.getifaddrs
+
+== REQUIREMENTS:
+
+Something recognizably unix-compatible, a compiler and macro preprocessor, ruby.
+
+== INSTALL:
+
+* gem install unixinfo
+
+== DEVELOPERS:
+
+After checking out the source, run:
+
+  $ rake newb
+
+This task will install any missing dependencies, run the tests/specs,
+and generate the RDoc.
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2011 Erik Hollensbe
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,22 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+
+Hoe.plugins.delete :rubyforge
+Hoe.plugin :git
+Hoe.plugin :rcov
+
+spec = Hoe.spec 'unixinfo' do
+  developer('Erik Hollensbe', 'erik@hollensbe.org')
+
+  self.rubyforge_name = nil
+
+  spec_extras[:extensions] = [ "ext/unixinfo/extconf.rb" ]
+end
+
+task :install => [:gem] do
+  sh "gem install pkg/#{spec.name}-#{spec.version}.gem"
+end
+
+# vim: syntax=ruby

data/ext/unixinfo/extconf.rb

@@ -0,0 +1,33 @@
+#!/usr/bin/env ruby
+require 'mkmf'
+
+HEADERS = %w[
+  stdlib.h
+  unistd.h
+  sys/types.h
+  sys/socket.h
+  ifaddrs.h
+  netdb.h
+]
+
+CALLS = %w[
+  getloadavg
+  gethostname
+  getifaddrs
+  getnameinfo
+]
+
+all_calls = CALLS.all? { |x| have_library("c", x) }
+all_headers = HEADERS.all? { |x| have_header(x) }
+
+if all_calls and all_headers
+    #$CFLAGS << " -g "
+    if have_struct_member("struct sockaddr", "sa_len", "sys/socket.h")
+      $CFLAGS << " -DHAVE_SA_LEN "
+    end
+    dir_config("unixinfo_native")
+    create_makefile("unixinfo_native")
+else
+    rm_f "Makefile"
+end
+

data/ext/unixinfo/unixinfo_native.c

@@ -0,0 +1,172 @@
+#include "unixinfo_native.h"
+
+void Init_unixinfo_native(void) {
+    VALUE si;
+    si = rb_define_module("UnixInfo");
+    rb_define_singleton_method(si, "getloadavg", si_getloadavg, 0);
+    rb_define_singleton_method(si, "gethostname", si_gethostname, 0);
+    rb_define_singleton_method(si, "getifaddrs", si_getifaddrs, 0);
+}
+
+/* 
+ * SysInfo.getloadavg()
+ *
+ * Returns 3 float values which correspond to the 1 minute, 5 minute, and 15
+ * minute load averages respectively.
+ *
+ * If for some reason the load average cannot be retreived, nil is returned.
+ *
+ */
+VALUE si_getloadavg(VALUE self) {
+    VALUE ary;
+    double averages[3]; 
+    int i = 0;
+
+    ary = rb_ary_new();
+
+    if(getloadavg(averages, 3) == 3) {
+        for(; i < 3; i++) {
+            rb_ary_push(ary, rb_float_new(averages[i]));
+        }
+    } else {
+        return Qnil;
+    }
+
+    return ary;
+}
+
+#define HOSTNAME_MAX_LEN 1000
+
+VALUE si_gethostname(VALUE self) { 
+    char str[HOSTNAME_MAX_LEN];
+
+    if (!gethostname(str, HOSTNAME_MAX_LEN)){
+        return rb_str_new2(str);
+    } else {
+        return Qnil;
+    }
+}
+
+char * si_my_getnameinfo(struct sockaddr *addr) {
+    char *address;
+
+    address = malloc(NI_MAXHOST * sizeof(char));
+
+// BSD uses sa_len, linux switches on the family type.
+#ifdef HAVE_SA_LEN
+    getnameinfo(
+            addr, 
+            addr->sa_len, 
+            address, 
+            NI_MAXHOST,
+            NULL, 0, 
+            NI_NUMERICHOST
+    );
+#else
+    getnameinfo(
+            addr,
+            (addr->sa_family == AF_INET) ? 
+                sizeof(struct sockaddr_in) :
+                sizeof(struct sockaddr_in6),
+            address, NI_MAXHOST, NULL, 0, NI_NUMERICHOST
+    );
+#endif
+
+    return address;
+}
+
+VALUE si_my_get_new_af_hash(struct sockaddr *addr, VALUE hash) {
+    VALUE key;
+    VALUE inner_hash;
+    VALUE array;
+
+    if (addr->sa_family == AF_INET) {
+        key = rb_str_new2("ipv4");
+    } else if (addr->sa_family == AF_INET6) {
+        key = rb_str_new2("ipv6");
+    }
+
+    array = rb_hash_aref(hash, key);
+
+    if (array == Qnil) {
+        array = rb_ary_new();
+        rb_hash_aset(hash, key, array);
+    }
+
+    inner_hash = rb_hash_new();
+
+    rb_ary_push(array, inner_hash);
+
+    return inner_hash;
+}
+
+void si_my_fill_address_hash(VALUE hash, struct ifaddrs *addr) {
+    char *address;
+    
+    address = si_my_getnameinfo(addr->ifa_addr);
+
+    if (address) {
+        rb_hash_aset(hash, rb_str_new2("address"), rb_str_new2(address));
+        free(address);
+    }
+
+    if (addr->ifa_netmask) {
+        address = si_my_getnameinfo(addr->ifa_netmask);
+        if (address) {
+            rb_hash_aset(hash, rb_str_new2("netmask"), rb_str_new2(address));
+            free(address);
+        }
+    }
+
+    if (addr->ifa_dstaddr) {
+        address = si_my_getnameinfo(addr->ifa_dstaddr);
+        if (address) {
+            rb_hash_aset(hash, rb_str_new2("dst_address"), rb_str_new2(address));
+            rb_hash_aset(hash, rb_str_new2("broadcast"), rb_str_new2(address));
+            free(address);
+        }
+    }
+}
+
+VALUE si_getifaddrs(VALUE self) {
+    VALUE hash;
+    VALUE key;
+    VALUE inner_hash;
+    VALUE inner_inner_hash;
+
+    struct ifaddrs *ifap;
+    struct ifaddrs *cur;
+
+    struct sockaddr *tmp;
+    
+    if (getifaddrs(&ifap)) {
+        return Qnil;
+    }
+
+    cur = ifap;
+    hash = rb_hash_new();
+
+    if (ifap == NULL)
+        return Qnil;
+
+    do {
+        key = rb_str_new2(cur->ifa_name);
+        inner_hash = rb_hash_aref(hash, key);
+
+        if (Qnil == inner_hash)
+            inner_hash = rb_hash_new();
+
+        tmp = cur->ifa_addr;
+
+        if (tmp && (tmp->sa_family == AF_INET || tmp->sa_family == AF_INET6)) { 
+            inner_inner_hash = si_my_get_new_af_hash(tmp, inner_hash);
+            si_my_fill_address_hash(inner_inner_hash, cur);            
+        }
+
+        rb_hash_aset(hash, key, inner_hash); 
+    } while (cur = cur->ifa_next);
+
+    freeifaddrs(ifap);
+
+    return hash;
+}

data/ext/unixinfo/unixinfo_native.h

@@ -0,0 +1,16 @@
+#include <stdlib.h>
+#include <unistd.h>
+#include <sys/types.h>
+#include <sys/socket.h>
+#include <ifaddrs.h>
+#include <netdb.h>
+#include <ruby.h>
+
+void si_my_fill_address_hash(VALUE hash, struct ifaddrs *addr);
+VALUE si_my_get_new_af_array(struct sockaddr *addr, VALUE hash);
+char * si_my_getnameinfo(struct sockaddr *addr);
+VALUE si_getloadavg(VALUE self);
+VALUE si_gethostname(VALUE self);
+VALUE si_getifaddrs(VALUE self);
+void Init_unixinfo_native(void);
+

data/lib/unixinfo.rb

@@ -0,0 +1,4 @@
+require 'unixinfo_native'
+module UnixInfo
+  VERSION = "1.0.0"
+end

metadata

@@ -0,0 +1,77 @@
+--- !ruby/object:Gem::Specification 
+name: unixinfo
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 1.0.0
+platform: ruby
+authors: 
+- Erik Hollensbe
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-03-31 00:00:00 Z
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.9.1
+  type: :development
+  version_requirements: *id001
+description: A small hodgepodge of neat little UNIX API things I like to have access to without shelling out.
+email: 
+- erik@hollensbe.org
+executables: []
+
+extensions: 
+- ext/unixinfo/extconf.rb
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- ext/unixinfo/extconf.rb
+- ext/unixinfo/unixinfo_native.c
+- ext/unixinfo/unixinfo_native.h
+- lib/unixinfo.rb
+has_rdoc: true
+homepage: http://github.com/erikh/unixinfo
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: A small hodgepodge of neat little UNIX API things I like to have access to without shelling out.
+test_files: []
+