1faxq-helper(1)               mgetty+sendfax manual              faxq-helper(1)
2
3
4

NAME

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

SYNOPSIS

9       faxq-helper <command> [<options>]
10

DESCRIPTION

12       faxq-helper is part of the internal workings of faxspool(1).
13
14       Formerly,  the  /var/spool/fax/outgoing  directory was world-writeable,
15       leading to all sort of funny symlink attacks  against  faxspool(1)  and
16       faxrunq(8).
17
18       These  days,  it's  owned  by  the user ``fax'', and only this user can
19       write to it.  To be able to put jobs  there,  faxspool(1)  calls  faxq-
20       helper for very clearly defined purposes:
21
22        - make a new queue directory
23
24        - put a new fax G3 file into this queue directory
25
26        - put a JOB file into this queue directory, and activate the fax job
27
28       and possibly:
29
30        -  remove a fax job from the queue (to be used by faxrm and in case of
31       errors)
32
33        - re-queue a job that has been  suspended  due  to  repeated  failures
34       (faxq -r)
35
36       To  achieve  this,  faxq-helper  is  installed set-user-id fax.  If you
37       remove the suid bit, or chown the fax queue directory  to  a  different
38       user, it will stop working.
39
40

RETURN VALUES

42       faxq-helper has the following exit() values:
43
44
45       0      everything went fine
46
47
48       1      invalid JOB ID specified on the command line
49
50
51       2      some problem with the directory setup of the outgoing queue dir,
52              /var/spool/fax/outgoing (it will print a detailed error message)
53
54
55       3      some problems with the user ID setup of  the  ``fax''  user  (it
56              will print a detailed error message)
57
58
59       10     failure  to  process  the  specified  command  (it  will print a
60              detailed error message)
61
62

SEE ALSO

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

AUTHOR

67       faxq-helper is Copyright (C) 2004-2006  by  Gert  Doering,  <gert@gree‐
68       nie.muc.de>.
69
70
71
72greenie                            18 Feb 06                    faxq-helper(1)