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

FreeBSD Manual Pages


home | help

       faxgetty	- HylaFAX front-door process

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

       faxgetty	 is the	HylaFAX	server program that listens for	incoming phone
       calls and either	handles	each call directly or hands it off to  an  ap-
       propriate program.  In addition faxgetty	monitors modem usage and noti-
       fies 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(8C).  faxgetty can	also  be  used
       with data-only modems; this may be desirable if some of the non-facsim-
       ile features are	important, such	as the support for screening calls ac-
       cording 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  adminis-
       trative commands	such as	faxanswer(8C) and faxabort(8C).	 faxgetty also
       catches SIGTERM and SIGINT signals; cleaning up any necessary resources
       before exiting.

       Many  aspects of	faxgetty operation are controlled through a configura-
       tion file.  In particular, for faxgetty	to  automatically  invoke  the
       getty(8C) program to handle incoming data connections the GettyArgs pa-
       rameter 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(5F) for detailed  information
       on the contents of configuration	files.

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

       -p	 Do not	change the process priority when receiving  facsimile.
		 Normally  faxgetty  will raise	its priority to	reduce i/o la-
		 tency.	 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.

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

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

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

				 July 31, 1995			  FAXGETTY(8C)


Want to link to this manual page? Use this URL:

home | help