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>.

greenie                                             27 Oct 93                                            faxq(1)