Content-type: text/html Man page of habput

habput

Section: Habitat (1)
Updated: 0.99.3
Index Return to Main Contents
 

NAME

habput - Store habitat data from stdin  

SYNTAX

habput [-s <nslots> -t <desc>] [-c <purl>] [-C <cfcmd>] [-e <fmt>] [-dDhv] <route>  

DESCRIPTION

Open <route> using habitat's route addressing and send data from stdin to the route.

See clockwork(1) for an explanation of the route syntax  

OPTIONS

-c <purl>
Append user configuration data from the route <purl>, rather than the default file ~/.habrc.
-C <cfcmd>
Append a list of configuration directives from <cfcmd>, separated by semicolons.
-d
Place ghabitat in diagnostic mode, giving an additional level of logging and sending the text to stderr rather than the default or configured destinations. In daemon mode, will send output to the controlling terminal.
-D
Place ghabitat in debug mode. As -d above but generating a great deal more information, designed to be used in conjunction with the source code. Also overrides normal outputs and will send the text to stderr. In daemon mode, will send output to the controlling terminal.
-e <fmt>
Change the logging output to one of eight preset alternative formats, some showing additional information. <fmt> must be 0-7. See LOGGING below.
-h
Print a help message to stdout and exit
-v
Print the version to stdout and exit
-s <nslots>
Number of slots for creating ringed routes (default 1000); <nslots> of 0 gives a queue behaviour where the oldest data is not lost
-t <desc>
text description for creating ringed routes
 

EXAMPLES

To append a sample of tabular data to a table store, use a tablestore driver. This will create a ring which can store 1,000 slots of data.

habput tab:var/myfile.ts,myring

To save the same data, but limit the ring to just the most recent 10 slots and give the ring a description

habput -s 10 -t "my description" tab:var/myfile.ts,myring

The same data, stored to the same location, but with an unlimited history (technically a queue). To make the ring readable in ghabitat with current conventions, we store with the prefix '.r'

habput -s 0 -t "my description" tab:var/myfile.ts,r.myring

To save an error record, use a timestore driver

habput -s 100 -t "my logs" ts:var/myfile.ts,mylogs  

AUTHORS

Nigel Stuckey <nigel.stuckey@systemgarden.com>  

SEE ALSO

clockwork(1), killclock(1), ghabitat(1), habget(1), irs(1), habedit(1), habprobe(1), habmeth(1), habconf(5)


 

Index

NAME
SYNTAX
DESCRIPTION
OPTIONS
EXAMPLES
AUTHORS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 14:06:53 GMT, November 22, 2009