emonti-rbkb 0.6.1.1

data/lib/rbkb/plug.rb

@@ -0,0 +1,6 @@
+
+require "rbkb.rb"
+
+require "rbkb/plug/plug.rb"
+require "rbkb/plug/blit.rb"
+

data/lib/rbkb.rb

@@ -0,0 +1,6 @@
+module RBkB
+  VERSION="0.6.1"
+end
+
+require 'rbkb/extends'
+

data/usage.txt

@@ -0,0 +1,224 @@
+== Command Line Tools
+
+
+=== b64
+
+Base64 encode data supplied via an argument, file, or standard input.
+
+  Usage: b64 [options] <data | blank for stdin>
+    -h, --help                       Show this message
+    -v, --version                    Show version and exit
+    -f, --file FILENAME              Input from FILENAME
+
+  Output options:
+    -l, --length LEN                 Encode in lines of LEN characters
+
+
+=== bgrep
+
+Binary grep. Prints 'inspected' matches and offset information.
+
+  Usage: bgrep [options] <subject> <file | blank for stdin>
+    -h, --help                       Show this message
+    -v, --version                    Show version and exit
+    -x, --[no-]hex                   Specify subject as hex (default: false)
+    -r, --[no-]regex                 Specify subject as regex (default: false)
+    -a, --align=BYTES                Only match on alignment boundary
+    -n, --[no-]filename              Suppress prefixing of filenames.
+
+
+=== blit
+
+Sends data through any plugboard that implements a Plug::Blit listener for
+out-of band input.
+
+See also: telson
+
+  Usage: blit [options] <data | blank for stdin>
+    -h, --help                       Show this message
+    -v, --version                    Show version and exit
+    -f, --file FILENAME              Input from FILENAME
+    -t, --trans-protocol=PROTO       Blit transport protocol TCP/UDP
+    -b, --blitsrv=ADDR:PORT          Where to send blit messages
+    -i, --peer-index=IDX             Index for remote peer to receive
+    -l, --list-peers                 Lists the peer array for the target
+    -k, --kill                       Stops the remote event loop.
+
+
+=== c
+
+Prints a character n-times.
+
+  Usage: c 100 A; # print 100 A's'
+
+
+=== crc32
+
+Generates a crc32 checksum for data provided via stdin or file
+
+  Usage: crc32 [options]
+    -h, --help                       Show this message
+    -v, --version                    Show version and exit
+    -f, --file FILENAME              Input from FILENAME
+    -r, --range=START[:END]          Start and optional end range
+    -x, --hexrange=START[:END]       same, but in hex
+
+
+=== d64
+
+Base64 decode an encoded chunk supplied via argument, file, or standard input.
+
+  Usage: d64 [options] <data | blank for stdin>
+    -h, --help                       Show this message
+    -v, --version                    Show version and exit
+    -f, --file FILENAME              Input from FILENAME
+
+
+=== dedump
+
+Reverses a hexdump back to raw data. Designed to work with hexdumps created 
+by Unix utilities like 'xxd' as well as 'hexdump -C'.
+
+  Usage: dedump [options] <input-file | blank for stdin>
+    -h, --help                       Show this message
+    -v, --version                    Show version and exit
+    -l, --length LEN                 Bytes per line in hexdump (default: 16)
+
+
+=== hexify
+
+Converts a string or raw data to hex characters. Input can be supplied via 
+stdin, a string argument, or a file (with -f).
+
+  Usage: hexify [options] <data | blank for stdin>
+    -h, --help                       Show this message
+    -v, --version                    Show version and exit
+    -f, --file FILENAME              Input from FILENAME
+    -l, --length LEN                 Hexify in lines of LEN bytes
+    -d, --delim=DELIMITER            DELIMITER between each byte
+    -p, --prefix=PREFIX              PREFIX before each byte
+    -s, --suffix=SUFFIX              SUFFIX after each byte
+
+
+=== len
+
+Takes input from a blob of data and output it with its binary length prepended.
+
+  Usage: len [options] <data | blank for stdin>
+    -h, --help                       Show this message
+    -v, --version                    Show version and exit
+    -f, --file FILENAME              Input from FILENAME
+    -n, --nudge INT                  Add integer to length
+    -s, --size=SIZE                  Size of length field in bytes
+    -x, --[no-]swap                  Swap endianness. Default=big
+    -t, --[no-]total                 Include size word in size
+    -l, --length=LEN                 Ignore all else and use LEN
+
+
+=== rex
+
+  Lazy shortcut for ruby -e "..."
+
+  All commandline arguments get smeared into a ruby statement via 'eval()'.
+
+
+=== rstrings
+
+A utility much like Unix 'strings' -- implemented in ruby.
+
+  Usage: rstrings [options] <file | blank for stdin>
+    -h, --help                       Show this message
+    -v, --version                    Show version and exit
+    -s, --start=OFFSET               Start at offset
+    -e, --end=OFFSET                 End at offset
+    -t, --encoding-type=TYPE         Encoding: ascii/unicode/both (default=both)
+    -l, --min-length=NUM             Minimum length of strings (default=6)
+    -a, --align=ALIGNMENT            Match only on alignment (default=none)
+
+
+=== slice
+
+Returns a slice from input. Just a shell interface to a string slice operation.
+
+  Usage: slice [options] start (no args when using -r|-x)
+    -h, --help                       Show this message
+    -v, --version                    Show version and exit
+    -f, --file FILENAME              Input from FILENAME
+    -r, --range=START[:END]          Start and optional end range
+    -x, --hexrange=START[:END]       same, but in hex
+
+
+=== telson
+
+This is an implementation of the original blackbag "telson" using ruby and 
+eventmachine. 
+
+Telson is for doing the following things with minimum fuss: 
+
+* Run as a server or client using UDP or TCP
+* Debugging network protocols
+* Observe client/server behaviors using different messages at various phases 
+  of a conversation.
+
+  Usage: telson [options] host:port
+    -h, --help                       Show this message
+    -v, --version                    Show version and exit
+    -u, --udp                        UDP mode
+    -b, --blit=ADDR:PORT             Where to listen for blit
+    -o, --output=FILE                Output to file instead of screen
+    -q, --quiet                      Turn off verbose logging
+    -r, --reconnect                  Attempt to reconnect endlessly.
+    -s, --source=(ADDR:?)PORT        Bind on port (and addr?)
+
+
+=== unhexify
+
+unhexify converts a string of hex bytes back to raw data. Input can be 
+supplied via stdin, a hex-string argument, or a file containing hex (use -f).
+
+  Usage: unhexify [options] <data | blank for stdin>
+    -h, --help                       Show this message
+    -v, --version                    Show version and exit
+    -f, --file FILENAME              Input from FILENAME
+    -d, --delim DELIMITER            DELIMITER regex between hex chunks
+
+
+=== urldec
+
+Decodes a url percent-encoded string. 
+Input from stdin, file, or command-line argument.
+
+  Usage: urldec [options] <data | blank for stdin>
+    -h, --help                       Show this message
+    -v, --version                    Show version and exit
+    -f, --file FILENAME              Input from FILENAME
+    -p, --[no-]plus                  Convert '+' to space (default is true)
+
+
+=== urlenc
+
+Encodes data as a url percent-encoded string.
+Input from stdin, file, or command-line argument.
+
+  Usage: urlenc [options] <data | blank for stdin>
+    -h, --help                       Show this message
+    -v, --version                    Show version and exit
+    -f, --file FILENAME              Input from FILENAME
+    -p, --[no-]plus                  Convert spaces to '+' (default is false)
+
+
+=== xor
+
+Repeating string xor. Takes input and XOR's it against a string. 
+String can be provided in hex.
+
+  Usage: xor [options] -k|-s <key> <data | stdin>
+    -h, --help                       Show this message
+    -v, --version                    Show version and exit
+    -f, --file FILENAME              Input from FILENAME
+
+  Key options (one of the following is required):
+    -s, --strkey STRING              xor against bare STRING
+    -x, --hexkey HEXSTR              xor against decoded HEXSTR
+
+

metadata

@@ -0,0 +1,109 @@
+--- !ruby/object:Gem::Specification 
+name: emonti-rbkb
+version: !ruby/object:Gem::Version 
+  version: 0.6.1.1
+platform: ruby
+authors: 
+- Eric Monti
+autorequire: rbkb
+bindir: bin
+cert_chain: []
+
+date: 2009-02-13 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: eventmachine
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.12.2
+    version: 
+description: 
+email: emonti@matasano.com
+executables: 
+- b64
+- bgrep
+- blit
+- c
+- crc32
+- d64
+- dedump
+- hexify
+- len
+- rex
+- rstrings
+- slice
+- telson
+- unhexify
+- urldec
+- urlenc
+- xor
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.rdoc
+- usage.txt
+- bin/b64
+- bin/bgrep
+- bin/blit
+- bin/c
+- bin/crc32
+- bin/d64
+- bin/dedump
+- bin/hexify
+- bin/len
+- bin/rex
+- bin/rstrings
+- bin/slice
+- bin/telson
+- bin/unhexify
+- bin/urldec
+- bin/urlenc
+- bin/xor
+- lib/rbkb.rb
+- lib/rbkb/command_line.rb
+- lib/rbkb/extends.rb
+- lib/rbkb/plug.rb
+- lib/rbkb/plug/blit.rb
+- lib/rbkb/plug/peer.rb
+- lib/rbkb/plug/plug.rb
+has_rdoc: true
+homepage: http://www.matasano.com
+post_install_message: 
+rdoc_options: 
+- --title
+- rbkb -- Ruby Black-Bag
+- --main
+- README.rdoc
+- --line-numbers
+- README.rdoc
+- usage.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Ruby Black-Bag
+test_files: []
+