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
-