fq - Man Page

job queue log viewer


fq[-a] [-n] [-q] [job id ...]


fq is a simple utility for “following” the output of nq(1) jobs.

Without arguments, the output of the currently running and queued as-of-now jobs is emitted; else the presented job ids are used.

fq automatically terminates after the corresponding jobs are done.

The options are as follows:


Output all log files, even of already finished jobs.


Don't wait for new output. Can be used to look at enqueued commands.


Only print the first line of each job output (i.e. the exec line).



Directory where lock files/job output resides, see nq(1).

Exit Status

The fq utility exits 0 on success, and >0 if an error occurs.


On Linux, inotify(7) is used to monitor job output. On FreeBSD and macOS, kqueue(2) is used. On other operating systems, polling is used.

See Also

nq(1), tq(1)


Leah Neukirchen <leah@vuxu.org>


fq is in the public domain.

To the extent possible under law, the creator of this work has waived all copyright and related or neighboring rights to this work.


Referenced By

nq(1), tq(1).

January 31, 2021