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

NAME

6       pagesend - HylaFAX IXO/TAP and UCP transmit program
7

SYNOPSIS

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

DESCRIPTION

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
22       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
32       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
38       The protocol which must be used for a specific service provider is con‐
39       trolled from the hylafax-info(5F) file.
40

OPTIONS

42       -B        Do not increment the various ``dials''  counters  if  a  busy
43                 signal is encountered.
44
45       -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
51       -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
57       -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
61       -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

NOTES

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

FILES

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

SEE ALSO

80       faxq(8C), hylafax-server(5F), hylafax-config(5F), hylafax-info(5F)
81
82
83
84                                October 3, 1995                   PAGESEND(8C)
Impressum