aboutsummaryrefslogtreecommitdiffstats
path: root/sleep-until.1
diff options
context:
space:
mode:
authorMattias Andrée <maandree@kth.se>2019-10-22 16:43:36 +0200
committerMattias Andrée <maandree@kth.se>2019-10-22 16:43:36 +0200
commit82571a9f052608484db10ad04fb9d0665e0fafd3 (patch)
tree03722f1be83de4af925934468707572b40beb327 /sleep-until.1
parentadd rationale to readme (diff)
downloadsleep-until-0ca2018deba72af29d0f4766baf8e42c9f4d1a21.tar.gz
sleep-until-0ca2018deba72af29d0f4766baf8e42c9f4d1a21.tar.bz2
sleep-until-0ca2018deba72af29d0f4766baf8e42c9f4d1a21.tar.xz
Change license, change style, remove info manual, flat dir hier2
Signed-off-by: Mattias Andrée <maandree@kth.se>
Diffstat (limited to 'sleep-until.1')
-rw-r--r--sleep-until.147
1 files changed, 47 insertions, 0 deletions
diff --git a/sleep-until.1 b/sleep-until.1
new file mode 100644
index 0000000..c166d7a
--- /dev/null
+++ b/sleep-until.1
@@ -0,0 +1,47 @@
+.TH SLEEP-UNTIL 1
+.SH NAME
+sleep-until - sleep until a specified time
+.SH SYNOPSIS
+.B sleep-until
+.RI [ clockname
+|
+.IR timepoint ]\ ...
+.SH DESCRIPTION
+Pause until \fItimepoint\fP. \fItimepoint\fP is the number of
+seconds since Epoch, in UTC but not accounting for leap seconds,
+by default. If \fIclockname\fP is specifed, \fItimepoint\fP is
+the number of seconds since the zerotime of that clock.
+\fItimepoint\fP may be an arbitrary floating point number.
+Pause is continued when interrupted.
+.PP
+On Linux 4.2.2 the clocks that can be used are:
+.TP
+*
+\fBCLOCK_REALTIME\fP
+.TP
+*
+\fBCLOCK_MONOTONIC\fP
+.TP
+*
+\fBCLOCK_BOOTTIME\fP
+.TP
+*
+\fBCLOCK_REALTIME_ALARM\fP
+.TP
+*
+\fBCLOCK_BOOTTIME_ALARM\fP
+.PP
+Note that the neither course clocks, \fBCLOCK_MONOTONIC_RAW\fP
+(the proper implementation of a monotonic clock), and
+\fBCLOCK_TAI\fP does not work.
+.SH EXIT STATUS
+.TP
+0
+The command was successful.
+.TP
+1
+The command failed.
+.SH SEE ALSO
+.BR sleep (1),
+.BR date (1),
+.BR clock_gettime (3)