net-proto 1.0.3-x86-mswin32-60

data/CHANGES

@@ -0,0 +1,84 @@
+== 1.0.3 - 13-Aug-2007
+* Fix for OS X (whining about malloced pointer).
+* Added a Rakefile along with tasks for installation and testing.
+* Major internal reorganization.
+* Fixed Proto::VERSION test.
+
+== 1.0.2 - 18-Nov-2006
+* Updated the README, gemspec and netproto.txt files.
+* No code changes.
+
+== 1.0.1 - 30-Jun-2006
+* Added rdoc to the source files.
+* Added a gemspec.
+
+== 1.0.0 - 14-Jul-2005
+* Moved project to RubyForge.
+* Minor directory layout change.
+* Minor changes to the extconf.rb file.
+* Officially bumped VERSION to 1.0.0.
+
+== 0.2.5 - 18-Apr-2005
+* The Unix versions now call setprotoent(0) and endprotoent() internally
+  before each call.
+
+== 0.2.4 - 12-Apr-2005
+* Added internal taint checking for the Proto.getprotobyname method.
+* Removed the INSTALL file.  Installation instructions are now in the README.
+* Moved the sample script into the 'examples' directory.
+* General code cleanup.
+* Minor test suite changes and additions.
+* Removed the netproto.rd and netproto.html files.  The netproto.txt file is
+  now rdoc friendly.
+
+== 0.2.3 - 13-Sep-2004
+* Replaced all instances of the deprecated STR2CSTR() function with the
+  StringValuePtr() function.  That means that, as of this release, this
+  package requires Ruby 1.8.0 or later.
+* Minor documentation corrections.
+
+== 0.2.2 - 10-Apr-2004
+* No longer returns an Array in block form.  Only the non-block form returns
+  an array.  The block form returns nil.
+* Updated the documentation, warranty information included, license changed
+  back to "Ruby's".
+* Modified extconf.rb.  It is now assumed that you have TestUnit installed.
+* Changed "tc_all.rb" to "tc_netproto.rb".
+* Changed "netproto.rd2" to "netproto.rd".
+
+== 0.2.1 - 29-Jul-2003
+* Code cleanup (-Wall warnings on Linux)
+* Removed VERSION() class method.  Use the constant instead
+* The getprotoent() method now returns an array of structs in non-block form
+* Added README file
+* Added generic test script under test/
+* Modified extconf.rb to use generic test script for those who don't have
+  TestUnit installed, instead of dynamically generating one
+* Fixed up TestUnit test suite
+
+== 0.2.0 - 26-Feb-2003
+* Added MS Windows support (except 'getprotoent()' - see docs)
+* For protocols that aren't defined, nil is now returned instead
+  of crashing (always a good thing)
+* Removed sys-uname requirement
+* Added a test suite (for those with testunit installed)
+* Some internal layout changes (doc, lib, test dirs)
+* Added a VERSION constant and class method
+* RD2 documentation now separated from source
+* Installation instructions modified
+* Lots of changes to extconf.rb
+* Changelog now CHANGES
+* Manifest now MANIFEST
+* Package name changed to lower case
+
+== 0.1.0 - 13-Aug-2002
+* Fixed bug with getprotoent_r function for Linux
+* Added a 'generic' source file that uses the non-reentrant functions for
+  those platforms that are not specifically supported.
+* Added FreeBSD support
+* Modified test script slightly
+* Added a changelog :)
+* Added a manifest
+   
+== 0.0.1 - 12-Aug-2002
+* Initial release (though written earlier)

data/MANIFEST

@@ -0,0 +1,13 @@
+* CHANGES
+* MANIFEST
+* README
+* Rakefile
+* net-proto.gemspec
+* doc/netproto.txt
+* examples/test_proto.rb
+* ext/version.h
+* ext/generic/generic.c
+* ext/linux/linux.c
+* ext/sunos/sunos.c 
+* ext/windows/windows.c
+* test/tc_netproto.rb

data/README

@@ -0,0 +1,30 @@
+== Description
+The net-proto package provides a way to get protocol information.
+
+This is really just a wrapper for the getprotobyname(), getprotobynumber() and
+the getprotoent() functions.
+
+== Prerequisites
+Ruby 1.8.0 or later.
+
+== Installation
+rake test (optional)
+rake install (non-gem) OR rake install_gem (gem)
+
+== Notes
+The net-proto package uses reentrant code for sunos and linux. Otherwise, the
+generic form of the functions are used (which may be reentrant by default
+anway - check the man pages on your platform).
+
+The Proto.getprotoent method is not supported on MS Windows because the
+underlying function isn't supported by the MS Windows API.
+
+== Why should I use this?
+Ruby has a predefined set of constants in socket.c in the general form of
+IPPROTO_XXX, Y.  However, using constants in this fashion can be unreliable
+because it's easy to define your own protocols (I set 'echo' to 7, for
+example), or to modify/delete entries in /etc/protocols.
+
+== Further Documentation
+See the 'netproto.txt' file under the 'doc' directory for more details.  There
+is also an example under the 'examples' directory.

data/doc/netproto.txt

@@ -0,0 +1,82 @@
+== Description
+   Net::Proto - An interface for the 'getproto' family of functions.
+	
+== Synopsis
+   require "net/proto"
+   include Net
+
+   Proto.getprotobyname("tcp") # -> 6
+   Proto.getprotobynumber(1)   # -> "icmp"
+
+   # Block form
+   Proto.getprotoent{ |p|
+      puts p.name
+      puts p.aliases
+      puts p.proto
+   }
+   	
+   # Non-block form
+   a = Proto.getprotoent
+   	
+== Constants
+VERSION
+   The current version number of this package, returned as a String.
+	
+== Class Methods
+Proto.getprotobyname(name)
+   Given a protocol string, returns the corresponding number, or nil if not
+   found.
+    
+Proto.getprotobynumber(num)
+   Given a protocol number, returns the corresponding string, or nil if not
+   found.
+    
+Proto.getprotoent
+Proto.getprotoent{ |struct| ... }
+   In block form, yields each entry from /etc/protocols as a struct of type
+   Proto::ProtoStruct.  In non-block form, returns an array of
+   Proto::ProtoStruct objects.
+	
+   The fields are 'name' (a String), 'aliases' (an Array of String's,
+   though often only one element), and 'proto' (a Fixnum).
+
+   This method is NOT supported on MS Windows.
+    
+== Notes
+   This module uses the reentrant (i.e. thread safe) functions on those
+   platforms that support them.  In some cases, e.g. FreeBSD and HP-UX, the
+   standard function names are reentrant by default (i.e. there is no '_r'
+   version, or it's not needed), so you will not see specific .c files for
+   all platforms.
+
+   The 'setprotoent()' and 'endprotoent()' functions are not implemented as
+   separate method calls.  Rather, these are called internally by the various
+   methods, except on Windows, which does not support them.
+
+   The 'getprotoent()' method is not supported on the MS Windows platform.
+   It's not part of the API as of Windows XP.
+   
+== Known Bugs
+   None that I'm aware of.  Please log any bug reports on the project page
+   at http://ruby-netutils.sf.net.
+	
+== Future Plans
+   Use the asynchronous calls (WSAAsyncGetProtoByName and
+   WSAAsyncGetProtoByNumber) on MS Windows systems.
+	
+== 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 gmail dot com
+   imperator on IRC (Freenode)

data/ext/windows/windows.c

@@ -0,0 +1,73 @@
+/***********************
+ * proto.c (windows.c)
+ ***********************/
+#include <ruby.h>
+#include <version.h>
+#include <windows.h>
+
+#ifdef __cplusplus
+extern "C"
+{
+#endif
+
+/*
+ * call-seq:
+ *    Proto.getprotobyname(name)
+ *
+ * Given a protocol string, returns the corresponding number, or nil if not
+ * found.
+*/
+static VALUE np_getprotobyname(VALUE klass, VALUE rbProtoName){
+   struct protoent* p;
+   VALUE v_proto_num = Qnil;
+
+   SafeStringValue(rbProtoName);
+   p = getprotobyname(StringValuePtr(rbProtoName));
+   
+   if(p)
+      v_proto_num = INT2FIX(p->p_proto);
+
+   return v_proto_num;
+}
+
+/*
+ * call-seq:
+ *    Proto.getprotobynumber(num)
+ *
+ * Given a protocol number, returns the corresponding string, or nil if not
+ * found.
+ */
+static VALUE np_getprotobynumber(VALUE klass, VALUE v_proto_num)
+{
+   struct protoent* p;
+   VALUE v_proto_name = Qnil;
+
+   p = getprotobynumber(NUM2INT(v_proto_num));
+
+   if(p)
+      v_proto_name = rb_str_new2(p->p_name);
+
+   return v_proto_name;
+}
+
+void Init_proto()
+{
+   VALUE mNet, cProto;
+   
+   /* The Net module serves only as a namespace */
+   mNet = rb_define_module("Net");
+   
+   /* The Proto class encapsulates network protocol information */
+   cProto = rb_define_class_under(mNet, "Proto", rb_cObject);
+
+   /* Class Methods */
+   rb_define_singleton_method(cProto,"getprotobyname",np_getprotobyname,1);
+   rb_define_singleton_method(cProto,"getprotobynumber",np_getprotobynumber,1);
+
+   /* 1.0.3: The version of this package. This is a string, not a number */
+   rb_define_const(cProto, "VERSION", rb_str_new2(NET_PROTO_VERSION));
+}
+
+#ifdef __cplusplus
+}
+#endif

data/test/tc_netproto.rb

@@ -0,0 +1,71 @@
+###########################################################################
+# tc_netproto.rb
+#
+# Test suite for net-proto - all platforms. This test suite should be run
+# via the 'rake test' task.
+###########################################################################
+require "net/proto"
+require "test/unit"
+include Net
+
+class TC_Net_Proto < Test::Unit::TestCase
+   # These were the protocols listed in my
+   # own /etc/protocols file on Solaris 9.
+   def setup
+      @protocols = %w/
+         ip icmp igmp ggp ipip tcp cbt egp igp pup udp mux hmp
+         xns-idp rdp idpr idpr-cmtp sdrp idrp rsvp gre
+         mobile ospf pim ipcomp vrrp sctp hopopt ipv6
+         ipv6-route ipv6-frag esp ah ipv6-icmp ipv6-nonxt ipv6-opts
+      /
+   end
+	
+   def test_version
+      assert_equal("1.0.3", Proto::VERSION)
+   end
+
+   def test_getprotobynumber
+      assert_respond_to(Proto, :getprotobynumber)
+      assert_raises(TypeError){ Proto.getprotobynumber("foo") }
+      assert_raises(TypeError){ Proto.getprotobynumber(nil) }
+      assert_equal(nil, Proto.getprotobynumber(9999999))
+      assert_equal("tcp", Proto.getprotobynumber(6))
+      assert_nothing_raised{
+         0.upto(132){ |n| Proto.getprotobynumber(n) }
+      }
+   end
+
+   def test_getprotobyname
+      assert_respond_to(Proto, :getprotobyname)
+      assert_raises(TypeError){ Proto.getprotobyname(1) }
+      assert_raises(TypeError){ Proto.getprotobyname(nil) }       	
+      assert_equal(nil, Proto.getprotobyname("foo"))
+      assert_equal(6, Proto.getprotobyname("tcp"))
+      @protocols.each{ |prot|
+         assert_nothing_raised{ Proto.getprotobyname(prot) }
+      }
+   end
+
+   def test_getprotoent
+      if File::ALT_SEPARATOR
+         msg = "The getprotoent() function is not supported on this "
+         msg += "platform - test skipped"
+         STDERR.puts msg
+      else
+    	 assert_respond_to(Proto, :getprotoent)    
+         p = Proto.getprotoent.first
+         assert_kind_of(Struct::ProtoStruct, p)
+         assert_equal(%w/name aliases proto/,p.members)
+         assert_kind_of(String, p.name, "Bad type for name")
+         assert_kind_of(Array, p.aliases, "Bad type for aliases")
+         assert_kind_of(Integer, p.proto, "Bad type for proto")
+         p.aliases.each{ |a|
+            assert_kind_of(String, a, "Bad type for aliases member")
+         }
+      end
+   end
+	
+   def teardown
+      @protocols = nil
+   end
+end

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification 
+name: net-proto
+version: !ruby/object:Gem::Version 
+  version: 1.0.3
+platform: x86-mswin32-60
+authors: 
+- Daniel J. Berger
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-06-07 00:00:00 -06:00
+default_executable: 
+dependencies: []
+
+description: The net-proto package provides the getprotobyname(), getprotobynumber() and the getprotoent() methods for Ruby.
+email: djberg96@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- CHANGES
+- README
+- MANIFEST
+- doc/netproto.txt
+- ext/windows/windows.c
+files: 
+- doc/netproto.txt
+- test/tc_netproto.rb
+- lib/net
+- lib/net/proto.so
+- ext/windows/windows.c
+- CHANGES
+- README
+- MANIFEST
+has_rdoc: true
+homepage: http://www.rubyforge.org/projects/sysutils
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: 1.8.0
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: sysutils
+rubygems_version: 1.1.1
+signing_key: 
+specification_version: 2
+summary: The net-proto package provides the getprotobyname(), getprotobynumber() and the getprotoent() methods for Ruby.
+test_files: 
+- test/tc_netproto.rb