faxq-helper(1) [suse man page]

faxq-helper(1)						       mgetty+sendfax manual						    faxq-helper(1)

NAME

       faxq-helper - privileged helper process to access the fax queue

SYNOPSIS

       faxq-helper <command> [<options>]

DESCRIPTION

       faxq-helper is part of the internal workings of faxspool(1).

       Formerly,  the  /var/spool/fax/outgoing directory was world-writeable, leading to all sort of funny symlink attacks against faxspool(1) and
       faxrunq(8).

       These days, it's owned by the user ``fax'', and only this user can write to it.	To be able to put  jobs  there,  faxspool(1)  calls  faxq-
       helper for very clearly defined purposes:

	- make a new queue directory

	- put a new fax G3 file into this queue directory

	- put a JOB file into this queue directory, and activate the fax job

       and possibly:

	- remove a fax job from the queue (to be used by faxrm and in case of errors)

	- re-queue a job that has been suspended due to repeated failures (faxq -r)

       To  achieve  this,  faxq-helper	is installed set-user-id fax.  If you remove the suid bit, or chown the fax queue directory to a different
       user, it will stop working.

RETURN VALUES

       faxq-helper has the following exit() values:

       0      everything went fine

       1      invalid JOB ID specified on the command line

       2      some problem with the directory setup of the outgoing queue dir, /var/spool/fax/outgoing (it will print a detailed error message)

       3      some problems with the user ID setup of the ``fax'' user (it will print a detailed error message)

       10     failure to process the specified command (it will print a detailed error message)

SEE ALSO

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

AUTHOR

       faxq-helper is Copyright (C) 2004-2006 by Gert Doering, <gert@greenie.muc.de>.

greenie 							     18 Feb 06							    faxq-helper(1)

faxq(1) 						       mgetty+sendfax manual							   faxq(1)

NAME

       faxq - display fax jobs queued by faxspool(1)

SYNOPSIS

       faxq [<command>] [-osa] [-v] [-r] [-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 infor-
       mations 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

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

       -r     Restart 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)