1FAXSEND(8C)                                                        FAXSEND(8C)
2
3
4

NAME

6       faxsend - HylaFAX facsimile transmit program
7

SYNOPSIS

9       /usr/sbin/faxsend [ -B ] [ -l ] [ -p ] [ -c config ] -m device-ID qfile
10       [qfile [qfile [...]]]
11

DESCRIPTION

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
24       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
34       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
38       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

OPTIONS

45       The following options are recognized:
46
47       -B        Do  not  increment  the  various ``dials'' counters if a busy
48                 signal is encountered.
49
50       -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
56       -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
62       -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
66       -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

NOTES

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

FILES

77       /var/spool/hylafax/etc/config.devID     device-specific   configuration
78       file
79
80       Consult hylafax-server(5F) for a complete discussion of  the  structure
81       and content of the spooling area.
82

SEE ALSO

84       faxq(8C), hylafax-server(5F), hylafax-config(5F)
85
86
87
88                                October 3, 1995                    FAXSEND(8C)
Impressum