bionic (8) faxgetty.8.gz

Provided by: hylafax-server_6.0.6-8.1~ubuntu0.18.04.1_amd64 bug

NAME

       faxgetty - HylaFAX front-door process

SYNOPSIS

       /usr/sbin/faxgetty [ -D ] [ -p ] [ -q queue-dir ] device

DESCRIPTION

       faxgetty is the HylaFAX server program that listens for incoming phone calls and either handles each call
       directly or hands it off to an appropriate program.   In  addition  faxgetty  monitors  modem  usage  and
       notifies  the  HylaFAX scheduler process when a modem's status changes; e.g. when a modem is busy with an
       outbound call.

       One faxgetty should be run for each facsimile modem on a  machine.   faxgetty  is  typically  started  by
       init(8).   faxgetty  can  also  be  used with data-only modems; this may be desirable if some of the non-
       facsimile features are important, such  as  the  support  for  screening  calls  according  to  Caller-ID
       information.

       faxgetty listens to its facsimile modem for incoming calls and to a FIFO special file on which it accepts
       command directives from administrative commands such as  faxanswer(8)  and  faxabort(8).   faxgetty  also
       catches SIGTERM and SIGINT signals; cleaning up any necessary resources before exiting.

       Many  aspects  of  faxgetty  operation  are  controlled through a configuration file.  In particular, for
       faxgetty to automatically invoke the getty(8) program to handle incoming data connections  the  GettyArgs
       parameter  must  be  setup  in  the configuration file.  The configuration file is located in the spooler
       hierarchy in the etc subdirectory and is named config.devid, where devid is an  identifier  derived  from
       the name of the modem's device file; for example ttym2 for /dev/ttym2, term_10 for /dev/term/10.  Consult
       hylafax-config(5) for detailed information on the contents of configuration files.

OPTIONS

       -D        This option forces faxgetty to detach itself  from  the  controlling  tty  from  which  it  was
                 invoked.  In normal operation faxgetty will not disassociate itself from the controlling tty.

       -p        Do  not change the process priority when receiving facsimile.  Normally faxgetty will raise its
                 priority to reduce i/o latency.  This option is useful for debugging.

       -q dir    The specified  directory  is  treated  as  the  spooling  area.   The  default  spooling  area,
                 /var/spool/hylafax, is defined at the time the software is built.

FILES

       /var/spool/hylafax/FIFO.device          FIFO special file for submitting commands
       /var/spool/hylafax/etc/config.device    device-specific configuration file

       Consult hylafax-server(5) for a complete discussion of the structure and content of the spooling area.

SEE ALSO

       faxabort(8),  faxlock(8),  faxanswer(8), faxconfig(8), faxstate(8), faxq(8), getty(8), hylafax-server(5),
       hylafax-config(5)

                                                  July 31, 1995                                      FAXGETTY(8)