diff options
Diffstat (limited to 'nqtail.1')
| -rw-r--r-- | nqtail.1 | 71 |
1 files changed, 71 insertions, 0 deletions
diff --git a/nqtail.1 b/nqtail.1 new file mode 100644 index 0000000..87273ee --- /dev/null +++ b/nqtail.1 @@ -0,0 +1,71 @@ +.Dd July 3, 2024 +.Dt NQTAIL 1 +.Os +.Sh NAME +.Nm nqtail +.Nd job queue log viewer +.Sh SYNOPSIS +.Nm +.Op Fl a +.Op Fl n +.Op Fl q +.Op Ar job\ id ... +.Sh DESCRIPTION +.Nm +is a simple utility for +.Dq following +the output of +.Xr nq 1 +jobs. +.Pp +Without arguments, the output of the currently running and queued +as-of-now jobs is emitted; else the presented job ids are used. +.Pp +.Nm +automatically terminates after the corresponding jobs are done. +.Pp +The options are as follows: +.Bl -tag -width Ds +.It Fl a +Output all log files, even of already finished jobs. +.It Fl n +Don't wait for new output. +Can be used to look at enqueued commands. +.It Fl q +Only print the first line of each job output +(i.e. the +.Li exec +line). +.El +.Sh ENVIRONMENT +.Bl -hang -width Ds +.It Ev NQDIR +Directory where lock files/job output resides, see +.Xr nq 1 . +.El +.Sh EXIT STATUS +.Ex -std +.Sh INTERNALS +On Linux, +.Xr inotify 7 +is used to monitor job output. +On FreeBSD and macOS, +.Xr kqueue 2 +is used. +On other operating systems, polling is used. +.Sh SEE ALSO +.Xr nq 1 , +.Xr nqterm 1 +.Sh AUTHORS +.An Leah Neukirchen Aq Mt leah@vuxu.org +.Sh LICENSE +.Nm +is in the public domain. +.Pp +To the extent possible under law, +the creator of this work +has waived all copyright and related or +neighboring rights to this work. +.Pp +.Lk http://creativecommons.org/publicdomain/zero/1.0/ +.\" .Sh BUGS |