To use this package, put bin on your path and libs in your PERL5LIB env
variable.  Also install the dependencies listed below.  ./tester.pl should run
with no errors if everything is working.

This is an informal list of dependencies.  Eventually I hope to make
auto-make/conf and distribution bundles, but for now, this will serve

Ubuntu packages: 
  libdbd-sqlite3-perl
  sqlite3
  libxml-simple-perl
  libproc-processtable-perl
  libdate-manip-perl
  libtext-csv-perl
  gnuplot
  libnetpacket-perl
  libnet-pcap-perl
  libnet-dns-perl
  libjson-perl

----

Once that is done, you might want to check out aRecordStreamStory in this
directory.  A humorus introduction to a simple use of RecordStream.

Some Examples you can run right now:

1. First setup your path and perl5lib:

(from the recordstream directory)

export PATH=$PATH:`pwd`/bin && export PERL5LIB=$PERL5LIB:`pwd`/libs


EXAMPLE 1:
How many processes are each of the users on my system running?

recs-fromps | recs-collate --key uid -a count | recs-sort --key count=n | recs-totable

Broken down this is:
1. recs-fromps - First get the records of all the prcesses currently running
2. recs-collate --key uid -a count
     Grouping by the uid field, count how many records fall into the group
3. recs-sort --key count=n 
     Sort the resulting records by the count key
     numerical (rather than lexically)
4. recs-totable - Print the output in a nicely formatted table.

EXAMPLE 2:
How many processes are each user on the system running at each priority level?

recs-fromps | recs-collate --key uid,priority -a count | recs-toptable --x priority --y uid --v count

Broken down:
1. recs-fromps - First get the records of all the prcesses currently running
2. recs-collate --key uid,priority -a count
     Grouping by the uid and the priority field, count how many records fall
     into the group
3. recs-toptable --x priority --y uid -v count
     Create a 2 dimensional table, across the top put the priority values, down
     the side put the uid.  In the game use as the value the count field.

EXAMPLE 3:
What Xorg modules put information in my Xorg.log at startup, and what log level
are they logged at?  I need this in csv format for importing into a spreadsheet
program.

recs-frommultire --re 'type,module=\((\S*)\) ([^:]+):' /var/log/Xorg.0.log | recs-collate --key type,module -a ct | recs-sort --key ct=n | recs-tocsv --header

1. recs-frommultire --re 'type,module=\((\S*)\) ([^:]+):' /var/log/Xorg.0.log 
     Parse out the type and module from the Xorg log file.  That regex reads
     capture text inside literal '()', then capture text after a space up to the
     first ':'.
2. recs-collate --key type,module -a ct
     Collate records into groups of type-modules.  Count how many in each group
     across all records.
3. recs-sort --key ct=n 
     Sort by the count, numerically.
4. recs-totable --spreadsheet --delim ','
     Output a table in spreadsheet format (no ASCII art), delimited by commas
     instead of tabs
