NAME

       faxq - display fax jobs queued by faxspool(1)

SYNOPSIS

       faxq [<command>] [-osa] [-v] [-r<job>] [-rall] [-P<job><prio>]

DESCRIPTION

       Display the fax queue set up by faxspool(1).

       faxq  looks  for  all  the  jobs  queued by faxspool(1) to /var/spool/fax/outgoing/*. For each job in the
       queue, faxq displays some status informations about it. If no options are specified, one line per  queued
       fax job is printed, displaying the job number, sender, number of pages and target fax number.

COMMANDS

       faxq stop stops the fax queue processing by creating the file /var/spool/fax/outgoing/stop.  This command
       works only if you have write access to the spool directory.  Depending on local setup, this means  ``root
       only'' or ``fax administrator group''.  If you don't have write access, an error message is printed.

       faxq  start  re-starts  a  previously stopped fax queue, by removing the ``stop'' file.  As for faxq stop
       this only works if you have write access.

OPTIONS

       -v     Tells faxq to print a more verbose report for each job (multiple lines).

       -o     Show old jobs, already sent but still in the queue directory, too.

       -s     Show suspended jobs (stopped because of too many fatal errors during  sending).  You  can  restart
              those jobs with faxq -r <job>

       -a     Show all jobs (active, old, suspended).

       -r <job>
              Restart job with the given ID(s) ("-r F012345" or "-r F01234*").

       -r all Restart ALL suspended jobs. Every suspended job in the queue (that you have write permissions for)
              will be requeued.  Use faxrm to delete jobs that you do not want to be sent!

       -P <job> <prio>
              Change the priority of fax job <job> to <prio>. Example: "faxq -P F000247 3".

BUGS

       faxq doesn't handle time scheduling yet.

       faxq -P is currently broken (needs re-implementing with faxq-helper).

SEE ALSO

       faxrunq(1), faxspool(1), faxrm(1), faxqueue(5)

AUTHOR

       faxq is Copyright (C) 1993 by Gert Doering, <gert@greenie.muc.de>.