1FAXSEND(8C) FAXSEND(8C)
2
6 faxsend - HylaFAX facsimile transmit program
7
9 /usr/sbin/faxsend [ -B ] [ -l ] [ -p ] [ -c config ] -m device-ID qfile
10 [qfile [qfile [...]]]
11
13 faxsend is the program that implements the facsimile transmission pro‐
14 tocol for the HylaFAX system. faxsend is invoked by the faxq scheduler
15 process for each facsimile transmit attempt. faxsend assumes that its
16 current working directory is the top of the spooling hierarchy, that a
17 suitable modem device has been allocated for its use, and that all doc‐
18 uments to be sent are already converted to TIFF/F (TIFF Class F) at the
19 appropriate resolution and with an appropriate data encoding. In nor‐
20 mal use faxsend will inherit a lockfile for the modem from the faxq
21 process. The format of the job description file specified on the com‐
22 mand line is described in sendq(5F).
23 faxsend initializes the modem before attempting to transmit the facsim‐
25 ile using the information in the appropriate modem configuration file.
26 If the modem does not respond to this initialization, faxsend will
27 repeatedly try to initialize the modem. This behaviour is required for
28 send-only environments in which a faxgetty(8C) process is not run (and
29 the modem would be known to be in a properly initialized state).
30 faxsend catches SIGINT and SIGTERM and cleans up any resources it con‐
31 trols; this is the mechanism used by faxq to abort a job while it is in
32 progress.
33 Multiple fax jobs of documents with varying formatting may be sent in
35 one fax call by ``batching'' them by supplying faxsend with multiple
36 qfile entries.
37 Many aspects of faxsend operation are controlled through a configura‐
39 tion file. The configuration file is located in the spooler hierarchy
40 in the etc subdirectory and is named config.device-ID; consult hylafax-
41 config(5F) for detailed information on the contents of configuration
42 files.
43
45 The following options are recognized:
46 -B Do not increment the various ``dials'' counters if a busy
48 signal is encountered.
49 -c config Treat config as a configuration parameter specification that
51 is interpreted after reading the per-device configuration
52 file. For example, ``-c sessiontracing:0x4f'' would set the
53 SessionTracing configuration parameter to ``0x4f'', overrid‐
54 ing any setting in the configuration file.
55 -m devID The device to use in processing the job. Note that this is a
57 device identifier and not the pathname of the tty special
58 file. A device identifier is formed from a device filename
59 by removing any leading ``/dev/'' and converting any ``/''
60 characters to ``_'' characters.
61 -l Do the UUCP lockfile protocol in faxsend. By default faxsend
63 assumes that it is invoked with the device already locked and
64 that it does not need to manage the lockfile.
65 -p Do not change the process priority when transmitting. Nor‐
67 mally faxsend will raise its priority to reduce i/o latency.
68 This option is useful for debugging.
69
71 faxsend returns the new job status to faxq through the returned value
72 in the associated qfile: send_retry, retry job; send_failed, job fin‐
73 ished without success, send_done, job completed successfully,
74 send_reformat, job should be retried after documents are reformatted.
75
77 /var/spool/hylafax/etc/config.devID device-specific configuration
78 file
79 Consult hylafax-server(5F) for a complete discussion of the structure
81 and content of the spooling area.
82
84 faxq(8C), hylafax-server(5F), hylafax-config(5F)
85 October 3, 1995 FAXSEND(8C)