NAME

robsd-step — robsd step utility

SYNOPSIS

DESCRIPTION

The robsd-step utility manages the step file for all robsd utilities.

In read mode (-R), a step is selected to operate on using either -i or -n. Lines read from standard input are interpolated and written to standard output. Interpolation allows fields from the selected step on the form ${field} to be substituted with the corresponding value.

In write mode (-W), a step is written to the steps file. Any existing occurrence of the same step as given by id will be replaced.

In list mode (-L), all steps for the given mode is written to standard output in order of execution.

The options are as follows:

-f path

Steps file located at path.

-i id

In read mode, select the step with id to operate on. If id is negative, the step is selected starting from the last one in path.

In write mode, replace any existing step(s) with the same id.

-m mode

In list mode, select the robsd utility.

-n name

In read mode, select the step with name to operate on.

-o offset

In list mode, exclude all steps up to exclusively offset.

EXAMPLES

$ echo 'step ${name} took ${duration} seconds' | robsd-step -R -f step.csv -n cvs
step cvs took 64 seconds

DIAGNOSTICS

The robsd-step utility exits 0 on success, and >0 if an error occurs.

SEE ALSO

robsd(8), robsd-cross(8), robsd-ports(8), robsd-regress(8)

AUTHORS

Anton Lindqvist <anton@basename.se>