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

FreeBSD Manual Pages


home | help
FAXSEND(8C)							   FAXSEND(8C)

       faxsend - HylaFAX facsimile transmit program

       /usr/local/sbin/faxsend	[ -l ] [ -p ] [	-c config ] -m device-ID qfile
       [qfile [qfile [...]]]

       faxsend is the program that implements the facsimile transmission  pro-
       tocol for the HylaFAX system.  faxsend is invoked by the	faxq scheduler
       process for each	facsimile transmit attempt.  faxsend assumes that  its
       current	working	directory is the top of	the spooling hierarchy,	that a
       suitable	modem device has been allocated	for its	use, and that all doc-
       uments to be sent are already converted to TIFF/F (TIFF Class F)	at the
       appropriate resolution and with an appropriate data encoding.  In  nor-
       mal  use	 faxsend  will	inherit	a lockfile for the modem from the faxq
       process.	 The format of the job description file	specified on the  com-
       mand line is described in sendq(5F).

       faxsend initializes the modem before attempting to transmit the facsim-
       ile using the information in the	appropriate modem configuration	 file.
       If  the modem does not respond to this initialization, faxsend will re-
       peatedly	try to initialize the modem.  This behaviour is	 required  for
       send-only  environments in which	a faxgetty(8C) process is not run (and
       the modem would be known	 to  be	 in  a	properly  initialized  state).
       faxsend	catches	SIGINT and SIGTERM and cleans up any resources it con-
       trols; this is the mechanism used by faxq to abort a job	while it is in

       Multiple	 fax  jobs of documents	with varying formatting	may be sent in
       one fax call by ``batching'' them by supplying  faxsend	with  multiple
       qfile entries.

       Many  aspects  of faxsend operation are controlled through a configura-
       tion file.  The configuration file is located in	the spooler  hierarchy
       in the etc subdirectory and is named config.device-ID; consult hylafax-
       config(5F) for detailed information on the  contents  of	 configuration

       The following options are recognized:

       -c config Treat	config as a configuration parameter specification that
		 is interpreted	after  reading	the  per-device	 configuration
		 file.	 For example, ``-c sessiontracing:0x4f'' would set the
		 SessionTracing	configuration parameter	to ``0x4f'',  overrid-
		 ing any setting in the	configuration file.

       -m devID	 The device to use in processing the job.  Note	that this is a
		 device	identifier and not the pathname	 of  the  tty  special
		 file.	 A  device identifier is formed	from a device filename
		 by removing any leading ``/dev/'' and	converting  any	 ``/''
		 characters to ``_'' characters.

       -l	 Do the	UUCP lockfile protocol in faxsend.  By default faxsend
		 assumes that it is invoked with the device already locked and
		 that it does not need to manage the lockfile.

       -p	 Do  not  change the process priority when transmitting.  Nor-
		 mally faxsend will raise its priority to reduce i/o  latency.
		 This option is	useful for debugging.

       faxsend	returns	 the new job status to faxq through the	returned value
       in the associated qfile:	send_retry, retry job; send_failed,  job  fin-
       ished  without success, send_done, job completed	successfully, send_re-
       format, job should be retried after documents are reformatted.

       /var/spool/hylafax/etc/config.devID     device-specific	 configuration

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

       faxq(8C), hylafax-server(5F), hylafax-config(5F)

				October	3, 1995			   FAXSEND(8C)


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

home | help