Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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, lead-
     ing  to  all  sort  of  funny  symlink  attacks  against  faxspool(1)   and
     faxrunq(8).

     These  days,  it's owned by the user ``root'', 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 er-
     rors)

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

     To  achieve this, faxq-helper is installed set-user-id root.  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 ``root'' 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@gree-
     nie.muc.de>.

greenie 			    18 Feb 06			  faxq-helper(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=faxq-helper&sektion=8&manpath=FreeBSD+Ports+15.1.quarterly>

home | help