nsca 0.0.1

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/Gemfile

@@ -0,0 +1,14 @@
+source "http://rubygems.org"
+
+gem 'enum'
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem "shoulda"
+  gem "yard"
+  gem "rdoc"
+  gem "bundler"
+  gem "jeweler"
+  gem "simplecov"
+end

data/Gemfile.lock

@@ -0,0 +1,48 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activesupport (3.2.13)
+      i18n (= 0.6.1)
+      multi_json (~> 1.0)
+    bourne (1.4.0)
+      mocha (~> 0.13.2)
+    enum (1.0.0)
+    git (1.2.5)
+    i18n (0.6.1)
+    jeweler (1.8.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+      rdoc
+    json (1.7.7)
+    metaclass (0.0.1)
+    mocha (0.13.3)
+      metaclass (~> 0.0.1)
+    multi_json (1.7.2)
+    rake (10.0.4)
+    rdoc (4.0.1)
+      json (~> 1.4)
+    shoulda (3.4.0)
+      shoulda-context (~> 1.0, >= 1.0.1)
+      shoulda-matchers (~> 1.0, >= 1.4.1)
+    shoulda-context (1.1.0)
+    shoulda-matchers (1.5.6)
+      activesupport (>= 3.0.0)
+      bourne (~> 1.3)
+    simplecov (0.7.1)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.7.1)
+    simplecov-html (0.7.1)
+    yard (0.8.5.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler
+  enum
+  jeweler
+  rdoc
+  shoulda
+  simplecov
+  yard

data/LICENSE.txt

@@ -0,0 +1,165 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

data/README.md

@@ -0,0 +1,38 @@
+pure ruby NSCA library
+======================
+
+NSCA is a protocol for Nagios passive checks.
+You must run nsca on your server to use it.
+
+This is a ruby-pure implementation.
+
+First it was planed to provide a client-API, but now there is also a full server-API.
+
+Tested against nsca-2.7.
+
+TO DO AND DONE
+==============
+
+TODO
+----
+
+* build packet with performance data
+* server side parsing of performance data
+* more documentations
+* mcrypt-support
+
+DONE
+----
+
+* packet-API (one check will be packed in one packet)
+* simple-"encryption" (only xor with password and server-side generated iv-key)
+* client-API (send to server)
+* server-API (recv from client)
+* check-API (describe checks and performance data)
+* fast usable API for sending checks
+
+Copyright
+=========
+
+Copyright (c) 2013 Denis Knauf. See LICENSE.txt for
+further details.

data/Rakefile

@@ -0,0 +1,48 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "nsca"
+  gem.homepage = "http://github.com/DenisKnauf/nsca"
+  gem.license = "MIT"
+  gem.summary = %Q{Nagios passive alerts with friendly API}
+  gem.description = %Q{Create your alerts easily and send it to Nagios}
+  gem.email = "Denis.Knauf@gmail.com"
+  gem.authors = ["Denis Knauf"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+=begin
+require 'rcov/rcovtask'
+Rcov::RcovTask.new do |test|
+  test.libs << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+  test.rcov_opts << '--exclude "gems/*"'
+end
+=end
+
+task :default => :test
+
+require 'yard'
+YARD::Rake::YardocTask.new

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/dummy_server.rb

@@ -0,0 +1,10 @@
+require 'socket'
+
+module NSCA
+	class ServerDummy
+		attr_reader :server
+		def initialize *host_and_port
+			@server = TCPServer.new *host_and_port
+		end
+	end
+end

data/lib/nsca.rb

@@ -0,0 +1,37 @@
+require 'socket'
+require 'enum'
+require 'timeout'
+require 'benchmark'
+require 'securerandom'
+
+module NSCA
+	class ReturnCode <Enum
+		start_at 0
+		enum %w[OK WARNING CRITICAL UNKNOWN]
+	end
+	
+	module Helper
+		class <<self
+			def class_name_gen label
+				clname = label.gsub( /\W+/, '_').sub /^[0-9_]+/, ''
+				return nil  if clname.empty?
+				clname[0] = clname[0].upcase
+				clname.to_sym
+			end
+		end
+	end
+
+	class <<self
+		def destinations()  @destinations ||= []  end
+
+		def send *results
+			NSCA.destinations.each {|server| server.send *results }
+			self
+		end
+	end
+end
+
+require 'nsca/packet'
+require 'nsca/server'
+require 'nsca/client'
+require 'nsca/check'

data/lib/nsca/check.rb

@@ -0,0 +1,182 @@
+module NSCA
+	module PerformanceData
+		class Base
+			extend Timeout
+			extend Benchmark
+
+			class <<self
+				attr_reader :label, :unit, :warn, :crit, :min, :max
+				def init label, unit = nil, warn = nil, crit = nil, min = nil, max = nil
+					@label, @unit, @warn, @crit, @min, @max = label.to_s, unit, warn, crit, min, max
+					self
+				end
+
+				def measure &block
+					timeout ||= 0
+					exception = Class.new Timeout::Error
+					pd = perfdatas[perfdata_label]
+					timeout = pd.max
+					m = realtime do
+						begin
+							timeout timeout, exception, &block
+						rescue exception
+						end
+					end
+					new m
+				end
+			end
+
+			attr_reader :value
+			def initialize( value) @value = value end
+			def label()  self.class.label  end
+			def unit()  self.class.unit  end
+			def warn()  self.class.warn  end
+			def crit()  self.class.crit  end
+			def min()  self.class.min  end
+			def max()  self.class.max  end
+			def to_s() "#{label}=#{value}#{unit},#{warn},#{crit},#{min},#{max}" end
+
+			def return_code
+				if @value.nil? then 3
+				elsif crit <= @value then 2
+				elsif warn <= @value then 1
+				else 0
+				end
+			end
+		end
+
+		class <<self
+			def new label, unit = nil, warn = nil, crit = nil, min = nil, max = nil
+				cl = Class.new Base
+				cl.init label, unit, warn, crit, min, max
+			end
+
+			def create label, unit = nil, warn = nil, crit = nil, min = nil, max = nil
+				cl = new label, unit, warn, crit, min, max
+				clname = NSCA::Helper.class_name_gen label
+				self.const_set clname, cl  if clname
+				cl
+			end
+		end
+	end
+
+	module Check
+		class Base
+			attr_reader :perfdatas, :return_code, :status, :timestamp
+			def initialize return_code = nil, status = nil, perfdatas = nil
+				@perfdatas = {}
+				init return_code, status, perfdatas, timestamp || Time.now
+			end
+
+			def init return_code = nil, status = nil, perfdatas = nil, timestamp = nil
+				@return_code = return_code  if return_code
+				@status = status  if status
+				perfdatas.each &method( :[])  if perfdatas
+				@timestamp = timestamp  if timestamp
+				self
+			end
+
+			def [] perfdata_label
+				pd = @perfdatas[perfdata_label]
+				pd && pd.value
+			end
+
+			def []= perfdata_label, value
+				cl = self.class.perfdatas[perfdata_label]
+				cl ||= PerformanceData::Base.new perfdata_label
+				@perfdatas[perfdata_label] = cl.new value
+			end
+
+			def text
+				r = "#{status || ReturnCode.find(return_code)}"
+				r += " | #{perfdatas.map( &:to_s).join ' '}"  unless perfdatas.empty?
+				r
+			end
+
+			def measure( perfdata_label, &block) @perfdatas[perfdata_label].measure &block end
+			def send() NSCA::send self end
+
+			def ok status = nil, perfdatas = nil
+				init ReturnCode::OK, status, perfdatas
+				send
+			end
+
+			def warning status = nil, perfdatas = nil
+				init ReturnCode::WARNING, status, perfdatas
+				send
+			end
+			alias warn warning
+
+			def critical status = nil, perfdatas = nil
+				init ReturnCode::CRITICAL, status, perfdatas
+				send
+			end
+			alias crit critical
+
+			def unknown status = nil, perfdatas = nil
+				init ReturnCode::UNKNOWN, status, perfdatas
+				send
+			end
+
+			def determine_return_code
+				self.class.perfdatas.map do |label, pdc|
+					pd = @perfdatas[label]
+					if pd
+						pd.return_code
+					else
+						-1
+					end
+				end.max
+			end
+
+			def retcode
+				rc = return_code || determine_return_code
+				(0..3).include?(rc) ? rc : 3
+			end
+
+			def service() self.class.service end
+			def hostname() self.class.hostname end
+
+			class <<self
+				attr_reader :service, :hostname, :perfdatas
+				def init service, hostname = nil, perfdatas = nil
+					@service, @hostname, @perfdatas = service, hostname || `hostname -f`, {}
+					perfdatas.each {|pd| @perfdatas[pd.label] = pd }
+					self
+				end
+
+				def ok( status = nil, perfdatas = nil) new.ok status, perfdatas end
+				def warning( status = nil, perfdatas = nil) new.warning status, perfdatas end
+				alias warn warning
+				def critical( status = nil, perfdatas = nil) new.warning status, perfdatas end
+				alias crit critical
+				def unknown( status = nil, perfdatas = nil) new.unknown status, perfdatas end
+			end
+		end
+
+		class <<self
+			def create service, hostname = nil, perfdatas = nil
+				cl = Class.new Base
+				cl.init service, hostname, perfdatas
+				cl
+			end
+
+			def new service, hostname = nil, perfdatas = nil
+				cl = create service, hostname, perfdatas
+				clname = NSCA::Helper.class_name_gen service.to_s
+				self.const_set clname, cl  if clname
+				cl
+			end
+		end
+	end
+
+	module Checks
+		def perfdata( cl, *params) const_set cl, NSCA::PerformanceData.new( *params) end
+
+		def check cl, service, hostname, perfdatas = nil
+			perfdatas ||= []
+			perfdatas.map! {|cl| cl.is_a?( Symbol) ? const_get( cl) : cl }
+			const_set cl, NSCA::Check.new( service, hostname, perfdatas)
+		end
+	end
+end

data/lib/nsca/client.rb

@@ -0,0 +1,97 @@
+require 'socket'
+require 'enum'
+require 'timeout'
+require 'benchmark'
+require 'securerandom'
+
+module NSCA
+	class Client
+		class Connection
+			attr_reader :iv_key, :timestamp, :socket, :packet_version, :password
+
+			def self.open *args
+				conn = new *args
+				if block_given?
+					begin yield conn
+					ensure conn && conn.close
+					end
+				else conn
+				end
+			end
+
+			# opts must be a hash
+			# Connection.new host, port [, opts]
+			# Connection.new socket [, opts]
+			# Connection.new host, opts # need `opts = {port: Port}`!
+			# Connection.new opts # need `opts = {port: Port, hostname: Hostname}`!
+			# Connection.new opts # need `opts = {port: Port, socket: Socket}`!
+			def initialize *args
+				opts = {}
+				opts = args.pop.dup  if args.last.is_a? Hash
+				opts[:host] ||= opts[:hostname]
+				opts[:sock] ||= opts[:socket]
+				opts[:pass] ||= opts[:password]
+
+				case args[0]
+				when String
+					opts[:host] = args[0]
+					opts[:port] ||= args[1]
+				when IO
+					opts[:sock] = args[0]
+				end
+
+				@socket = if opts[:sock].is_a? IO
+						opts[:sock]
+					elsif opts[:host].is_a? String
+						TCPSocket.new opts[:host], opts[:port]
+					else
+						raise ArgumentError, "Socket or hostname+port expected."
+					end
+				@packet_version = opts[:packet_version] || PacketV3
+
+				# read iv_key and timestamp
+				iv_key_and_timestamp = @socket.recv 132
+				@iv_key, ts = iv_key_and_timestamp.unpack 'a128N'
+				@timestamp = Time.at ts
+				@password = opts[:pass]
+			end
+
+			# Builds a check-result-line for NSCA.
+			#
+			# Will be terminated by end-of-terminate.
+			# @param [Time,Integer,nil] timestamp Checked at this time
+			# @param [0..3] return_code `NSCA::ReturnCode`
+			# @param [String(length<64),nil] hostname If nil, local hostname will be used.
+			#                                         Must be known by Nagios.
+			# @param [String(length<128)] service Name of Service. Must be known by Nagios.
+			# @param [String(length<512)] status Status-line inclusive optional Performance Data.
+			def build_packet timestamp, return_code, hostname, service, status
+				packet = @packet_version.new timestamp || @timestamp, return_code, hostname, service, status
+				packet.build @iv_key, @password
+			end
+
+			# Sends a check-result.
+			# @see #build_packet
+			def send_packet( *a)  @socket.write build_packet( *a)  end
+
+			# Sends check-results
+			# @param [Array<NSCA::Check::Base>] results
+			def send *results
+				results.flatten.each do |r|
+					send_packet r.timestamp, r.retcode, r.hostname, r.service, r.text
+				end
+			end
+
+			# Closes connection to NSCA.
+			def close( *a)  @socket.close( *a)  end
+		end
+
+		attr_reader :hostname, :port, :password
+		def initialize hostname = nil, port = nil, password = nil
+			@hostname, @port, @password = hostname, port, password
+		end
+
+		def open( &e) Connection.open @hostname, @port, @password, &e end
+		def send( *results) open {|conn| conn.send results } end
+	end
+end

data/lib/nsca/packet.rb

@@ -0,0 +1,121 @@
+require 'socket'
+require 'enum'
+require 'timeout'
+require 'benchmark'
+require 'securerandom'
+
+module NSCA
+	class <<self
+		def xor key, msg, key_a = nil
+			key_a ||= key.unpack 'C*'
+			l = key_a.length
+			return msg  if l < 1
+			# Slice the message in parts of length key_a.length.
+			# XOR each char of a part with char at the same index in key_a.
+			msg.unpack( 'C*').each_with_index.map {|c,i| c^key_a[i%l] }.pack 'C*'
+		end
+
+		def crc32 msg
+			(msg.each_byte.inject 0xFFFFFFFF do |r,b|
+				8.times.inject( r^b) {|r,_i| (r>>1) ^ (0xEDB88320 * (r&1)) }
+			end) ^ 0xFFFFFFFF
+		end
+
+		# Builds a null terminated, null padded string of length maxlen
+		def str2cstr( str, maxlen = nil)
+			str = str.to_s
+			str = str.to_s[0..(maxlen-2)]  if maxlen
+			"#{str}\x00"
+		end
+		def cstr2str( str, maxlen = nil) str[ 0, x.index( ?\0) || ((maxlen||0)-1)]  end
+	end
+
+	class Packet
+		class CSC32CheckFailed <Exception
+		end
+		class VersionCheckFailed <Exception
+		end
+
+		def self.versions version = nil
+			@@versions ||= {}
+			version ? @@versions[version] : @@versions
+		end
+
+		def self.register_version( version, klass) versions[version] = klass end
+
+		# @param [Time,Integer,nil] timestamp Checked at this time
+		# @param [0..3] return_code `NSCA::ReturnCode`
+		# @param [String(length<64),nil] hostname If nil, local hostname will be used.
+		#                                         Must be known by Nagios.
+		# @param [String(length<128)] service Name of Service. Must be known by Nagios.
+		# @param [String(length<512)] status Status-line inclusive optional Performance Data.
+		def initialize timestamp, return_code, hostname, service, status
+			@timestamp, @return_code, @hostname, @service, @status =
+				Time.at( timestamp.to_f), return_code, hostname, service, status
+		end
+
+		attr_accessor :timestamp, :return_code, :hostname, :service, :status
+	end
+
+	class PacketV3 < Packet
+		NAGIOS_VERSION = 2.7
+		PACKET_VERSION = 3
+		END_OF_TRANSMISSION = ?\x0a
+		HOSTNAME_LENGTH = 64
+		SERVICE_LENGTH = 128
+		STATUS_LENGTH = 512
+
+		# these line describes the data package:
+		# typedef struct data_packet_struct{
+		#   int16_t   packet_version;
+		#   /* xx means, 2 bytes without any data.
+		#    * i do not know, why but there are 2 extra bytes without any need and
+		#    * no where i can find information how these will be send,
+		#    * because these struct does not know it.
+		#    */
+		#   u_int32_t crc32_value;
+		#   u_int32_t timestamp;
+		#   int16_t   return_code;
+		#   char      host_name[MAX_HOSTNAME_LENGTH];
+		#   char      svc_description[MAX_DESCRIPTION_LENGTH];
+		#   char      plugin_output[MAX_PLUGINOUTPUT_LENGTH];
+		#   /* 2 extre xx, too. */
+		# }data_packet;
+		PACK_STRING = "s> xx L> L> s> Z#{HOSTNAME_LENGTH} Z#{SERVICE_LENGTH} Z#{STATUS_LENGTH} xx"
+		PACK_LENGTH = 2+2+4+4+2+HOSTNAME_LENGTH+SERVICE_LENGTH+STATUS_LENGTH+2
+		register_version PACKET_VERSION, self
+
+		# Builds a check-result-line for NSCA.
+		#
+		# Will be terminated by end-of-terminate.
+		def build key = nil, password = nil
+			entry = [
+				PACKET_VERSION,
+				0, # crc32 (unknown yet)
+				(timestamp || Time.now).to_i,
+				return_code.to_i,
+				NSCA::str2cstr( hostname || `hostname -f`, HOSTNAME_LENGTH),
+				NSCA::str2cstr( service, SERVICE_LENGTH),
+				NSCA::str2cstr( status, STATUS_LENGTH) # incl perfdata
+			]
+			# generate crc32 and put it at entry[2...6]
+			entry[1] = NSCA::crc32 entry.pack( PACK_STRING)
+			entry = entry.pack PACK_STRING
+			entry = NSCA::xor key, entry  if key
+			entry = NSCA::xor password, entry  if password
+			entry
+		end
+
+		def self.parse entry, key = nil, password = nil, no_verification_checks = nil
+			entry = NSCA::xor key, entry  if key
+			entry = NSCA::xor password, entry  if password
+			ver, crc32sum, *x = entry.unpack( PACK_STRING)
+			raise VersionCheckFailed, "Packet version 3 expected. (recv: #{ver})" \
+				unless no_verification_checks or 3 == ver
+			entry[4..7] = ?\x00*4
+			raise CSC32CheckFailed, "crc32-check failed. packet seems to be broken." \
+				unless no_verification_checks or crc32sum == NSCA::crc32( entry)
+			new *x
+		end
+	end
+end

data/lib/nsca/server.rb

@@ -0,0 +1,78 @@
+require 'socket'
+require 'enum'
+require 'timeout'
+require 'benchmark'
+require 'securerandom'
+
+module NSCA
+	class Server
+		include Enumerable
+
+		attr_reader :iv_key, :server, :packet_version, :password
+		def initialize *args
+			opts = {}
+			opts = args.pop.dup  if args.last.is_a? Hash
+			opts[:host] ||= opts[:hostname]
+			opts[:sock] ||= opts[:socket]
+			opts[:pass] ||= opts[:password]
+
+			case args[0]
+			when Integer
+				opts[:port] = args[0]
+				opts[:host] ||= args[1]
+			when IO
+				opts[:sock] = args[0]
+			end
+
+			@packet_version = opts[:packet_version] || PacketV3
+			@iv_key = (opts[:iv_key] || SecureRandom.random_bytes( 128)).to_s
+			raise ArgumentError, "Key must be 128 bytes long"  unless 128 == @iv_key.length
+			@password = opts[:pass].to_s
+			@server = if opts[:serv].is_a?( TCPServer) or opts[:serv].is_a?( UNIXServer)
+					opts[:serv]
+				elsif opts[:port].is_a? Integer
+					TCPServer.new *[opts[:port], opts[:host]].compact
+				else
+					raise ArgumentError, "Server or port-number expected"
+				end
+		end
+
+		def accept() Connection.new @server.accept, self end
+		def close() @server.close end
+
+		def each &block
+			return Enumerator.new( self)  unless block_given?
+			while conn = accept
+				yield conn
+			end
+		end
+
+		class Connection
+			include Enumerable
+
+			def initialize socket, server
+				@socket, @server = socket, server
+				@iv_key, @password = server.iv_key, server.password
+				@packet_version = server.packet_version
+				@packet_length = @packet_version::PACK_LENGTH
+				@socket.write [@iv_key, Time.now.to_i].pack( 'a* L>')
+			end
+
+			def fetch
+				data = read
+				@packet_version.parse data, @iv_key, @password  if data
+			end
+
+			def each &block
+				return Enumerator.new( self)  unless block_given?
+				while data = fetch
+					yield data
+				end
+			end
+
+			def eof?() @socket.eof? end
+			def read() @socket.read @packet_length end
+			def close() @socket.close end
+		end
+	end
+end

data/nsca.gemspec

@@ -0,0 +1,74 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "nsca"
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Denis Knauf"]
+  s.date = "2013-04-08"
+  s.description = "Create your alerts easily and send it to Nagios"
+  s.email = "Denis.Knauf@gmail.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.md"
+  ]
+  s.files = [
+    ".document",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.md",
+    "Rakefile",
+    "VERSION",
+    "dummy_server.rb",
+    "lib/nsca.rb",
+    "lib/nsca/check.rb",
+    "lib/nsca/client.rb",
+    "lib/nsca/packet.rb",
+    "lib/nsca/server.rb",
+    "nsca.gemspec",
+    "test/dummy_server.rb",
+    "test/helper.rb",
+    "test/test_nsca.rb"
+  ]
+  s.homepage = "http://github.com/DenisKnauf/nsca"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.23"
+  s.summary = "Nagios passive alerts with friendly API"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<enum>, [">= 0"])
+      s.add_development_dependency(%q<shoulda>, [">= 0"])
+      s.add_development_dependency(%q<yard>, [">= 0"])
+      s.add_development_dependency(%q<rdoc>, [">= 0"])
+      s.add_development_dependency(%q<bundler>, [">= 0"])
+      s.add_development_dependency(%q<jeweler>, [">= 0"])
+      s.add_development_dependency(%q<simplecov>, [">= 0"])
+    else
+      s.add_dependency(%q<enum>, [">= 0"])
+      s.add_dependency(%q<shoulda>, [">= 0"])
+      s.add_dependency(%q<yard>, [">= 0"])
+      s.add_dependency(%q<rdoc>, [">= 0"])
+      s.add_dependency(%q<bundler>, [">= 0"])
+      s.add_dependency(%q<jeweler>, [">= 0"])
+      s.add_dependency(%q<simplecov>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<enum>, [">= 0"])
+    s.add_dependency(%q<shoulda>, [">= 0"])
+    s.add_dependency(%q<yard>, [">= 0"])
+    s.add_dependency(%q<rdoc>, [">= 0"])
+    s.add_dependency(%q<bundler>, [">= 0"])
+    s.add_dependency(%q<jeweler>, [">= 0"])
+    s.add_dependency(%q<simplecov>, [">= 0"])
+  end
+end
+

data/test/dummy_server.rb

@@ -0,0 +1,16 @@
+require 'pathname'
+$: << Pathname.new( __FILE__).dirname.join( '..', 'lib').to_s
+
+module NSCA
+	def self.dummy_server *args
+		Dir[ Pathname.new( __FILE__).dirname.join( '..', 'lib', '**').to_s].each_entry do |l|
+			load l  if /\.rb$/ =~ l
+		end
+		serv = NSCA::Server.new *args
+		sock = serv.accept
+		sock.to_a
+	ensure
+		sock.close  if sock
+		serv.close  if serv
+	end
+end

data/test/helper.rb

@@ -0,0 +1,18 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'test/unit'
+require 'shoulda'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'nsca'
+
+class Test::Unit::TestCase
+end

data/test/test_nsca.rb

@@ -0,0 +1,95 @@
+require 'helper'
+
+class TestNSCA < Test::Unit::TestCase
+	class TestChecks
+		extend NSCA::Checks
+		perfdata :PD1, :pd1_in_sec, :s, 10, 20, 0, 30
+		perfdata :PD2, :pd2_in_1, 1, 0.99, 0.98, 0, 1
+		perfdata :PD3, :pd3_count, :c, 3, 5, 0
+		check :T0, 'TestNSCA0', 'uxnags01-sbe.net.mobilkom.at'
+		check :T1, 'TestNSCA1', 'uxnags01-sbe.net.mobilkom.at', [PD1, PD2]
+		check :T2, :TestNSCA2, 'uxnags01-sbe.net.mobilkom.at', [PD1, PD2, PD3]
+	end
+
+	context 'our test server' do
+		should 'receive data. NSCA-server should run on localhost 5777. if not, ignore this test. password=abcdefghijkl' do
+			PD1 = TestChecks::PD1
+			PD2 = TestChecks::PD2
+			PD3 = TestChecks::PD3
+			T0 = TestChecks::T0
+			T1 = TestChecks::T1
+			T2 = TestChecks::T2
+
+			checks = []
+			checks << TestChecks::T0.new( 1, "0123456789"*51+"AB")
+
+			pd1 = PD1.new 3
+			pd2 = PD2.new 0.9996
+			pd3 = PD3.new 2
+			checks << TestChecks::T1.new( nil, "Should be OK", [pd1, pd2, pd3])
+
+			NSCA::destinations << NSCA::Client.new( 'localhost', 5667, password: 'abcdefghijkl')
+			NSCA::send *checks
+		end
+	end
+end
+
+class TestNSCA::ReturnCode < Test::Unit::TestCase
+	context 'return code' do
+		should( 'be 0 == OK') { assert NSCA::ReturnCode.find(0) == NSCA::ReturnCode::OK }
+		should( 'be 1 == WARNING') { assert NSCA::ReturnCode.find(1) == NSCA::ReturnCode::WARNING }
+		should( 'be 2 == CRITICAL') { assert NSCA::ReturnCode.find(2) == NSCA::ReturnCode::CRITICAL }
+		should( 'be 3 == UNKNOWN') { assert NSCA::ReturnCode.find(3) == NSCA::ReturnCode::UNKNOWN }
+	end
+end
+
+class TestNSCA::Helper < Test::Unit::TestCase
+	context 'class gen name' do
+		should 'generate class names' do
+			assert :Total_run_check_measure == NSCA::Helper.class_name_gen( 'total run check measure')
+		end
+
+		should 'do not generate class names, if no letter' do
+			assert nil == NSCA::Helper.class_name_gen( '123 321, 43 _ ?')
+		end
+	end
+end
+
+class TestNSCA::PerformanceData < Test::Unit::TestCase
+	should 'set a subclass for new PerfData-types' do
+		NSCA::PerformanceData.create 'subclass test'
+		assert_nothing_raised NameError do
+			assert NSCA::PerformanceData::Subclass_test, "No subclass created."
+		end
+	end
+
+	def perfdata *a
+		NSCA::PerformanceData.new *a
+	end
+
+	context 'Created NSCA::PerformanceData-subclasses' do
+		should 'be the same like returned' do
+			cl = NSCA::PerformanceData.create 'returned and subclass the same test'
+			assert cl == NSCA::PerformanceData::Returned_and_subclass_the_same_test, 'Classes are not the same.'
+		end
+		should 'have a unit if given' do
+			assert :s == perfdata( 'have an unit test', :s).unit, "Not s as unit"
+		end
+		should 'have not a unit if not given' do
+			assert nil == perfdata( 'have not an unit test', nil).unit, "Not nil as unit"
+		end
+		should 'have a warn thresh if given' do
+			assert 3 == perfdata( 'have a warn test', nil, 3).warn, "Not 3 as warn"
+		end
+		should 'have not a warn thresh if not given' do
+			assert nil == perfdata( 'have not a warn test', nil, nil).warn, "Not nil as warn"
+		end
+	end
+end
+
+
+class TestNSCA::Client < Test::Unit::TestCase
+	should '' do
+		NSCA::Client
+	end
+end

metadata

@@ -0,0 +1,179 @@
+--- !ruby/object:Gem::Specification
+name: nsca
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Denis Knauf
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-04-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: enum
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: shoulda
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Create your alerts easily and send it to Nagios
+email: Denis.Knauf@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.md
+files:
+- .document
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- VERSION
+- dummy_server.rb
+- lib/nsca.rb
+- lib/nsca/check.rb
+- lib/nsca/client.rb
+- lib/nsca/packet.rb
+- lib/nsca/server.rb
+- nsca.gemspec
+- test/dummy_server.rb
+- test/helper.rb
+- test/test_nsca.rb
+homepage: http://github.com/DenisKnauf/nsca
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -852364013
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Nagios passive alerts with friendly API
+test_files: []