1PAGESEND(8C) PAGESEND(8C)
2
6 pagesend - HylaFAX IXO/TAP and UCP transmit program
7
9 /usr/sbin/pagesend [ -B ] [ -l ] [ -p ] [ -c config ] -m device-ID
10 qfile
11
13 pagesend is the program that implements the IXO/TAP and the UCP trans‐
14 mission protocol for the HylaFAX system. pagesend is invoked by the
15 faxq scheduler process for each pager transmit attempt. pagesend
16 assumes that its current working directory is the top of the spooling
17 hierarchy and that a suitable modem device has been allocated for its
18 use. In normal use pagesend will inherit a lockfile for the modem from
19 the faxq process. The format of the job description file specified on
20 the command line is described in sendq(5F).
21 pagesend initializes the modem before attempting to transmit the pager
23 message using the information in the appropriate modem configuration
24 file. If the modem does not respond to this initialization, pagesend
25 will repeatedly try to initialize the modem. This behaviour is
26 required for send-only environments in which a faxgetty(8C) process is
27 not run (and the modem would be known to be in a properly initialized
28 state). pagesend catches SIGINT and SIGTERM and cleans up any
29 resources it controls; this is the mechanism used by faxq to abort a
30 job while it is in progress.
31 Many aspects of pagesend operation are controlled through a configura‐
33 tion file. The configuration file is located in the spooler hierarchy
34 in the etc subdirectory and is named config.device-ID; consult hylafax-
35 config(5F) for detailed information on the contents of configuration
36 files.
37 The protocol which must be used for a specific service provider is con‐
39 trolled from the hylafax-info(5F) file.
40
42 -B Do not increment the various ``dials'' counters if a busy
43 signal is encountered.
44 -c config Treat config as a configuration parameter specification that
46 is interpreted after reading the per-device configuration
47 file. For example, ``-c sessiontracing:0x4f'' would set the
48 SessionTracing configuration parameter to ``0x4f'', overrid‐
49 ing any setting in the configuration file.
50 -m devID The device to use in processing the job. Note that this is a
52 device identifier and not the pathname of the tty special
53 file. A device identifier is formed from a device filename
54 by removing any leading ``/dev/'' and converting any ``/''
55 characters to ``_'' characters.
56 -l Do the UUCP lockfile protocol in pagesend. By default page‐
58 send assumes that it is invoked with the device already
59 locked and that it does not need to manage the lockfile.
60 -p Do not change the process priority when transmitting. Nor‐
62 mally pagesend will raise its priority to reduce i/o latency.
63 This option is useful for debugging.
64
66 pagesend returns the new job status to faxq through the exit(2) return
67 value of the process: send_retry (0), retry job; send_failed (1), job
68 finished without success, send_done (2), job completed successfully,
69 send_reformat (3), job should be retried after documents are reformat‐
70 ted.
71
73 /var/spool/hylafax/etc/config.devID device-specific configuration
74 file
75 Consult hylafax-server(5F) for a complete discussion of the structure
77 and content of the spooling area.
78
80 faxq(8C), hylafax-server(5F), hylafax-config(5F), hylafax-info(5F)
81 October 3, 1995 PAGESEND(8C)