1FQ(1)                     BSD General Commands Manual                    FQ(1)
2

NAME

4     fq — job queue log viewer
5

SYNOPSIS

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

DESCRIPTION

10     fq is a simple utility for “following” the output of nq(1) jobs.
11
12     Without arguments, the output of the currently running and queued as-of-
13     now jobs is emitted; else the presented job ids are used.
14
15     fq automatically terminates after the corresponding jobs are done.
16
17     The options are as follows:
18
19     -a      Output all log files, even of already finished jobs.
20
21     -n      Don't wait for new output.  Can be used to look at enqueued com‐
22             mands.
23
24     -q      Only print the first line of each job output (i.e. the exec
25             line).
26

ENVIRONMENT

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

EXIT STATUS

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

INTERNALS

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

SEE ALSO

38     nq(1), tq(1)
39

AUTHORS

41     Leah Neukirchen <leah@vuxu.org>
42

LICENSE

44     fq is in the public domain.
45
46     To the extent possible under law, the creator of this work has waived all
47     copyright and related or neighboring rights to this work.
48
49     http://creativecommons.org/publicdomain/zero/1.0/
50
51BSD                            January 31, 2021                            BSD