habput

NAME

habput - Store habitat data from standard input  

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 standard input (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 grs:var/myfile.grs,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" grs:var/myfile.grs,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" grs:var/myfile.grs,r.myring

To save an error record, use a ringstore driver

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

AUTHORS

Nigel Stuckey <[email protected]>  

SEE ALSO

clockwork(8), killclock(8), statclock(8), habedit(8), habrep(8), habconf(5), myhabitat(1), habget(1), habrs(1), habprobe(1), habmeth(1)

---

 

Index

NAME

SYNTAX

DESCRIPTION

OPTIONS

EXAMPLES

AUTHORS

SEE ALSO