Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

faxq-helper(1) [centos man page]

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

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, <>. greenie 18 Feb 06 faxq-helper(1)

Check Out this Related Man Page

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

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, <>. greenie 27 Oct 93 faxq(1)
Man Page