stella 0.5.3 → 0.5.4

data/support/kvm.h

@@ -0,0 +1,91 @@
+/*
+ * Copyright (c) 2000 Apple Computer, Inc. All rights reserved.
+ *
+ * @APPLE_LICENSE_HEADER_START@
+ * 
+ * This file contains Original Code and/or Modifications of Original Code
+ * as defined in and that are subject to the Apple Public Source License
+ * Version 2.0 (the 'License'). You may not use this file except in
+ * compliance with the License. Please obtain a copy of the License at
+ * http://www.opensource.apple.com/apsl/ and read it before using this
+ * file.
+ * 
+ * The Original Code and all software distributed under the License are
+ * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
+ * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
+ * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
+ * Please see the License for the specific language governing rights and
+ * limitations under the License.
+ * 
+ * @APPLE_LICENSE_HEADER_END@
+ */
+/*-
+ * Copyright (c) 1989, 1993
+ *	The Regents of the University of California.  All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in the
+ *    documentation and/or other materials provided with the distribution.
+ * 3. All advertising materials mentioning features or use of this software
+ *    must display the following acknowledgement:
+ *	This product includes software developed by the University of
+ *	California, Berkeley and its contributors.
+ * 4. Neither the name of the University nor the names of its contributors
+ *    may be used to endorse or promote products derived from this software
+ *    without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ * SUCH DAMAGE.
+ *
+ *	@(#)kvm.h	8.1 (Berkeley) 6/2/93
+ */
+
+#ifndef _KVM_H_
+#define	_KVM_H_
+
+/* Default version symbol. */
+#define	VRS_SYM		"_version"
+#define	VRS_KEY		"VERSION"
+
+#include <nlist.h>
+#include <sys/cdefs.h>
+
+__BEGIN_DECLS
+
+typedef struct __kvm kvm_t;
+
+struct kinfo_proc;
+int	  kvm_close(kvm_t *);
+char	**kvm_getargv(kvm_t *, const struct kinfo_proc *, int);
+char	**kvm_getenvv(kvm_t *, const struct kinfo_proc *, int);
+char	 *kvm_geterr(kvm_t *);
+int	  kvm_getloadavg(kvm_t *, double [], int);
+char	 *kvm_getfiles(kvm_t *, int, int, int *);
+struct kinfo_proc *
+	  kvm_getprocs(kvm_t *, int, int, int *);
+int	  kvm_nlist(kvm_t *, struct nlist *);
+kvm_t	 *kvm_open
+	   (const char *, const char *, const char *, int, const char *);
+kvm_t	 *kvm_openfiles
+	   (const char *, const char *, const char *, int, char *);
+int	  kvm_read(kvm_t *, unsigned long, void *, unsigned int);
+int	  kvm_write(kvm_t *, unsigned long, const void *, unsigned int);
+
+__END_DECLS
+
+#endif /* !_KVM_H_ */

data/support/ruby-pcap-takuma-notes.txt

@@ -0,0 +1,19 @@
+Ruby-Pcap Patch (2008-02-10)
+-------------------------------------------------------
+
+"pcap.bundle: warning: do not use Fixnums as Symbols"
+
+Ruby-Pcap is a libpcap binding for Ruby. On Ruby 1.8.6, 
+the latest release (0.6) produces the warning above on 
+OS X. ruby-pcap-takuma-patch.txt is a patch from here:
+http://d.hatena.ne.jp/takuma104/20080210/1202638583
+
+You can get Ruby-Pcap from here:
+http://www.goto.info.waseda.ac.jp/~fukusima/ruby/pcap-e.html
+
+$ tar -zxf ruby-pcap-0.6.tar.gz
+$ cd pcap
+$ patch -p1 < ruby-pcap-takuma-patch.txt
+$ make 
+$ make install
+

data/support/ruby-pcap-takuma-patch.txt

@@ -0,0 +1,30 @@
+diff -ur pcap-0.6/Pcap.c pcap-working/Pcap.c
+--- pcap-0.6/Pcap.c     2008-02-10 19:10:30.000000000 +0900
++++ pcap-working/Pcap.c 2008-02-10 18:58:49.000000000 +0900
+@@ -782,9 +782,9 @@
+     /* define class PcapStat */
+     cPcapStat = rb_funcall(rb_cStruct, rb_intern("new"), 4,
+                           Qnil,
+-                          INT2NUM(rb_intern("recv")),
+-                          INT2NUM(rb_intern("drop")),
+-                          INT2NUM(rb_intern("ifdrop")));
++                          ID2SYM(rb_intern("recv")),
++                          ID2SYM(rb_intern("drop")),
++                          ID2SYM(rb_intern("ifdrop")));
+     rb_define_const(mPcap, "Stat", cPcapStat);
+ 
+     /* define exception classes */
+diff -ur pcap-0.6/packet.c pcap-working/packet.c
+--- pcap-0.6/packet.c   2008-02-10 19:10:30.000000000 +0900
++++ pcap-working/packet.c       2008-02-10 18:55:13.000000000 +0900
+@@ -17,8 +17,8 @@
+ 
+ VALUE cPacket;
+ static VALUE mMarshal;
+-int id_load;
+-int id_dump;
++ID id_load;
++ID id_dump;
+ 
+ /* called from GC */
+ static void

data/support/text/en.yaml

@@ -30,16 +30,28 @@
     Examples:
      
       # Run Apache Bench with 50 users, 20 requests each. Repeat 5 times. 
-      $ stella -t 5 ab -n 1000 -c 50 http://stellaaahhhh.com/
+      $ stella -x 5 -w 0.5 ab -n 1000 -c 50 http://stellaaahhhh.com/
   
       # Run Siege with 100 users, 10 requests each with a Linux FireFox 3 user agent
-      $ stella -a firefox-3-linux siege -c 100 -r 10 http://stellaaahhhh.com/
-  
+      $ stella --rampup=25,200 --agent=firefox-3-linux siege -c 100 -r 10 http://stellaaahhhh.com/
+      
+      # Display available user agent strings
+      $ stella agents -l
+    
+      # Launch a proxy to monitor HTTP traffic. Record requests to a flatfile.
+      $ stella -vv watch -W -p 3114 -r uri.txt
+      
+      # Monitor network traffic with packet sniffer (requires unix and root access)
+      $ stella watch -P dns 
+      $ stella watch -P -p 9000 http
+        
+        
     User-Agent Examples (--agent): 
       ff-3-linux, ie-7-win, opera-10, chrome-0.2-osx
 
 :option_help_message: A short note about the test (i.e. 'new cache enabled')
 :option_help_format: "Output file format. One of: csv [default], yaml, tsv, json"
+:option_help_force: "Force the command to ignore non-fatal errors. CAREFUL!"
 :option_help_version: Display the version, then exit
 :option_help_sleep: Number of seconds to sleep between runs
 :option_help_agent: Specify a User-Agent. Can be a short string or complete agent string. Defaults to 'random'. 
@@ -50,5 +62,16 @@
 :error_class_must_override: "You must override the method: %s"
 :error_class_unknown_argument: "Ignoring unknown argument: %s"
 :error_adapter_command_not_ready: "Incomplete options or arguments for %s"
+:error_adapter_runtime: "%s had a problem: %s"
+:error_watch_proxy: "The proxy has a problem: %s"
+
 :error_invalid_argument: "%s is not a valid argument"
 :error_unknown_value: "I don't know what to do with %s"
+:error_missing_dependency: "%s is not available: %s"
+:error_generic: "Oops, there was an unidentified problem (consider reporting it as a bug)"
+
+:error_sysinfo_notunix: "Sorry, Unix only"
+:error_sysinfo_notwindows: "Sorry, Windows only"
+:error_sysinfo_notroot: "You need to be root to do that"
+
+:error_watch_norubypcap: "Ruby-Pcap not installed (http://www.goto.info.waseda.ac.jp/~fukusima/ruby/pcap-e.html)"

data/vendor/frylock/README.textile

@@ -0,0 +1,72 @@
+h1. Frylock - Easy Command line apps
+
+Inspired by "github-gem":http://github.com/defunkt/github-gem
+
+*Install:*
+
+gem install bmizerany-sinatra
+
+*Example:*
+
+Let's say we want to run our app like this:
+
+<pre><code>ruby script.rb hello</pre></code>
+
+Then we write this:
+
+<pre><code>require 'rubygems'
+require 'bmizerany-frylock'
+
+command :hello do
+  puts "Hello!"
+end</pre></code>
+
+If we want and optional name:
+
+<pre><code>ruby script.rb hello Blake</pre></code>
+
+Add a command with proc that has an arity of 1 and it will be matched instead of the first command
+
+<pre><code>require 'rubygems'
+require 'bmizerany-frylock'
+
+command :hello do
+  puts "Hello!"
+end
+
+command :hello do |name|
+  puts "Hello #{name}!"
+end</pre></code>
+
+
+For further examples see: bin/example
+
+
+*Contribute:*
+
+I'm very open to patches!  Please fork and send a pull request.
+
+*LICENSE*
+
+Copyright (c) 2008 Blake Mizerany
+
+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/vendor/frylock/bin/example

@@ -0,0 +1,170 @@
+#!/usr/bin/env ruby
+
+FRYLOCK_HOME = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+$: << File.join(FRYLOCK_HOME, 'lib')
+
+require 'rubygems'
+require 'frylock'
+
+default :commands
+
+
+before do
+# You can execute a block before the requests command is executed. You 
+# can use it to define instance variables here and use them in the commands
+end
+
+
+command :commands do
+# Example: ruby bin/example welcome
+
+  puts "Meatwad: Science is a mystery to man, isn't it Frylock?"
+  print "Frylock: At least we have some commands: "
+  
+  # The commands method returns a hash of Frylock::Command objects
+  puts commands.keys.inject([]) { |list, command| list << command.to_s }.sort.join(', ')
+end
+
+
+option :f, :found, "A boolean value. Did you find the car?"
+command :findcar do |options|
+# +options+ is a hash containing the options defined above
+# Example: ruby bin/example -f findcar
+  
+  puts "Frylock: So, did they ever find your car?"
+  
+  # The keys to the hash are the long string from the option definition.
+  # If only the short string is provided, those will be used instead (i.e. :f). 
+  puts (!options[:found]) ? "Carl: No" : 
+    "Carl: Oh, they found part of it, hangin' from a trestle near the turnpike."
+end
+
+
+
+global_usage "USAGE: #{File.basename($0)} [global options] command [command options]"
+global_option :s, :seconds, "Display values in seconds"
+global_option :v, :verbose, "Verbosity level (i.e. -vvv is greater than -v)" do |v|
+# Use instance variables to maintain values between option blocks. 
+# This will increment for every -v found (i.e. -vvv)
+  @val ||= 0
+  @val += 1
+end
+
+
+usage "ruby bin/example [--seconds] [-vv] time"
+command :date do |options, argv, global_options| 
+# +argv+ contains the unnamed arguments
+# +global_options+ contains hash of the options defined with global_options
+  
+  require 'time'
+  now = Time.now
+  puts "More verbosely, the date is now: " if (global_options[:verbose] || 0) >= 2
+  puts (global_options[:seconds]) ? now.to_i : now.to_s
+end
+
+
+option :c, :check, "Check response codes for each URI"
+option :d, :delim, String, "Output delimiter"
+option :t, :timeout, Float, "Timeout value for HTTP request" do |v|
+  # You can provide an block to process the option value. 
+  # This block must return the final value. 
+  v = 10 if (v > 10)
+  v
+end
+
+usage 'echo "http://github.com/" | ruby bin/example process -c -d " " -t 15 http://solutious.com/'
+command :processuris do |options, argv, global_options, stdin, cmd|
+# +stdin+ is either an IO object or a custom object defined with a stdin block (see below)
+# +cmd+ is the string used to evoke this command. Useful with alias_command (see below).
+
+  require 'net/http'
+  require 'uri'
+  require 'timeout'
+  
+  uris = [stdin, argv].flatten        # Combine the argv and stdin arrays
+  delim = options[:delim] || ','
+  timeout = options[:timeout] || 5
+  code = :notchecked                  # The default code when :check is false
+  
+  if uris.empty?
+    puts "Frylock: You didn't provide any URIs. "
+    puts "Master Shake: Ya, see #{$0} #{cmd} -h"
+    exit 0
+  end
+  
+  uris.each_with_index do |uri, index|
+    code = response_code(uri, timeout) if (options[:check])
+    puts [index+1, uri, code].join(delim)
+  end
+end
+alias_command :process, :processuris
+
+
+
+
+stdin do |stdin, output|
+# Pre-process STDIN for all commands. This example returns an array of lines. 
+# The command processuris uses this array.
+  
+  # We only want piped data. If this is not included  
+  # execution will wait for input from the user.
+  unless stdin.tty?   
+    
+    while !stdin.eof? do
+      line = stdin.readline
+      line.chomp!
+      (output ||= []) << line
+    end
+    
+  end
+  output
+end
+
+
+
+# response_code
+#
+# return the HTTP response code for the given URI
+# +uri+ A valid HTTP URI
+# +duration+ The timeout threshold (in seconds) for the request. 
+def response_code(uri_str, duration=5)
+  response = :unavailable
+  begin 
+    uri = (uri_str.kind_of? URI::HTTP) ? uri_str : URI.parse(uri_str) 
+    timeout(duration) do
+      response = Net::HTTP.get_response(uri).code
+    end 
+  rescue Exception => ex
+  end
+  response
+end
+
+
+at_exit do
+# This is an example of how to call Frylock in your script. 
+  begin    
+    Frylock.run!(ARGV, STDIN) 
+    
+  rescue Frylock::UnknownCommand => ex
+    STDERR.puts "Frylock: I don't know what the #{ex.name} command is. #{$/}"
+    STDERR.puts "Master Shake: I'll tell you what it is, friends... it's shut up and let me eat it."
+    
+  rescue Frylock::NoCommandsDefined => ex
+    STDERR.puts "Frylock: Carl, I don't want it. And I'd appreciate it if you'd define at least one command. #{$/}"
+    STDERR.puts "Carl: Fryman, don't be that way! This sorta thing happens every day! People just don't... you know, talk about it this loud."
+  
+  rescue Frylock::InvalidArgument => ex
+    STDERR.puts "Frylock: Shake, how many arguments have you not provided a value for this year? #{$/}"
+    STDERR.puts "Master Shake: A *lot* more than *you* have! (#{@args.join(', ')})"
+  
+  rescue Frylock::MissingArgument => ex
+    STDERR.puts "Frylock: I don't know what #{ex.args.join(', ')} is. #{$/}"
+    STDERR.puts "Master Shake: I'll tell you what it is, friends... it's shut up and let me eat it."
+  
+  rescue => ex
+    STDERR.puts "Master Shake: Okay, but when we go in, watch your step. "
+    STDERR.puts "Frylock: Why?"
+    STDERR.puts "Meatwad: [explosion] #{ex.message}"
+    STDERR.puts ex.backtrace
+  end
+end

data/vendor/frylock/frylock.gemspec

@@ -0,0 +1,18 @@
+Gem::Specification.new do |s|
+  s.name = %q{frylock}
+  s.version = "0.1.0"
+
+  s.specification_version = 1 if s.respond_to? :specification_version=
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Blake Mizerany"]
+  s.date = %q{2008-08-17}
+  s.description = %q{Command line apps made easy}
+  s.email = %q{blake.mizerany@gmail.com}
+  s.files = Dir["lib/*.rb"]
+  s.has_rdoc = false
+  s.homepage = %q{http://github.com/bmizerany/frylock}
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.1.1}
+  s.summary = %q{Command line apps made easy}
+end

data/vendor/frylock/lib/frylock/exceptions.rb

@@ -0,0 +1,24 @@
+module Frylock
+  
+  class UnknownCommand < RuntimeError
+    attr_reader :name
+    def initialize(name)
+      @name = name || :unknown
+    end
+  end
+  
+  class NoCommandsDefined < RuntimeError
+  end
+  
+  class InvalidArgument < RuntimeError
+    attr_accessor :args
+    def initialize(args)
+      # We grab just the name of the argument
+      @args = args || []
+    end
+  end
+  
+  class MissingArgument < InvalidArgument
+  end
+  
+end