ROBSD-STEP(8)

NAME
robsd-step - robsd step utility

SYNOPSIS
robsd-step -R -f path [-i id] [-n name]
robsd-step -W -f path -i id -- key=val ...
robsd-step -L -m mode [-o offset]

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

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

AUTHORS
Anton Lindqvist <anton@basename.se>