faxq-helper man page

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

Info

18 Feb 06 greenie mgetty+sendfax manual