catsit/catsit-timer.1
2021-02-25 19:45:56 -05:00

63 lines
883 B
Groff

.Dd February 25, 2021
.Dt CATSIT-TIMER 1
.Os
.
.Sh NAME
.Nm catsit-timer
.Nd run command at interval
.
.Sh SYNOPSIS
.Nm
.Ar interval
.Ar command ...
.
.Sh DESCRIPTION
The
.Nm
utility runs a command
at an interval.
The command is run once immediately,
then again every
.Ar interval
after waiting for the command to exit
each time.
The
.Nm
utility is not appropriate
for scheduling commands
to run at specific times.
.
.Pp
The format of the
.Ar interval
specifier is a series of integers
followed by units:
.Cm s
for seconds,
.Cm m
for minutes
and
.Cm h
for hours.
An integer with no unit
is assumed to be in seconds.
The
.Ar interval
is the sum of each
integer-unit pair.
For example,
.Cm 1m30s
is equivalent to
.Cm 90s .
.
.Sh EXIT STATUS
If the command exits non-zero,
.Nm
exits with the same status.
.
.Sh SEE ALSO
.Xr catsitd 8
.
.Sh AUTHORS
.An June Bug Aq Mt june@causal.agency