GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  FAXGETTY (8)

NAME

faxgetty - HylaFAX front-door process

CONTENTS

Synopsis
Description
Options
Files

SYNOPSIS

/usr/local/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(8C). 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(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 configuration file. In particular, for faxgetty to automatically invoke the getty(8C) 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(5F) 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(5F) for a complete discussion of the structure and content of the spooling area.

SEE ALSO

faxabort(8C), faxlock(8C), faxanswer(8C), faxconfig(8C), faxstate(8C), faxq(8C), getty(8C), hylafax-server(5F), hylafax-config(5F)
Search for    or go to Top of page |  Section 8 |  Main Index


--> FAXGETTY (8C) July 31, 1995

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.