faxgetty.1m
上传用户:weiyuanprp
上传日期:2020-05-20
资源大小:1169k
文件大小:5k
源码类别:

传真(Fax)编程

开发平台:

C/C++

  1. ." $Id: faxgetty.1m,v 1.3 2009/09/29 11:10:13 faxguy Exp $
  2. ."
  3. ." HylaFAX Facsimile Software
  4. ."
  5. ." Copyright (c) 1990-1996 Sam Leffler
  6. ." Copyright (c) 1991-1996 Silicon Graphics, Inc.
  7. ." HylaFAX is a trademark of Silicon Graphics
  8. ." 
  9. ." Permission to use, copy, modify, distribute, and sell this software and 
  10. ." its documentation for any purpose is hereby granted without fee, provided
  11. ." that (i) the above copyright notices and this permission notice appear in
  12. ." all copies of the software and related documentation, and (ii) the names of
  13. ." Sam Leffler and Silicon Graphics may not be used in any advertising or
  14. ." publicity relating to the software without the specific, prior written
  15. ." permission of Sam Leffler and Silicon Graphics.
  16. ." 
  17. ." THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, 
  18. ." EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY 
  19. ." WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.  
  20. ." 
  21. ." IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
  22. ." ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
  23. ." OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
  24. ." WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF 
  25. ." LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE 
  26. ." OF THIS SOFTWARE.
  27. ."
  28. .if n .po 0
  29. .ds Fx fIHylas-1FAXs+1fP
  30. .TH FAXGETTY ${MANNUM1_8} "July 31, 1995"
  31. .SH NAME
  32. faxgetty - *(Fx front-door process
  33. .SH SYNOPSIS
  34. .B ${LIBEXEC}/faxgetty
  35. [
  36. .B -D
  37. ] [
  38. .B -p
  39. ] [
  40. .B -q
  41. .I queue-dir
  42. ] [
  43. .B -c
  44. .I config
  45. ]
  46. .I device
  47. .SH DESCRIPTION
  48. .I faxgetty
  49. is the *(Fx server program that listens for incoming phone calls
  50. and either handles each call
  51. directly or hands it off to an appropriate program.
  52. In addition
  53. .I faxgetty
  54. monitors modem usage and notifies the *(Fx scheduler process
  55. when a modem's status changes; e.g. when a modem is busy
  56. with an outbound call.
  57. .PP
  58. One
  59. .I faxgetty
  60. should be run for each facsimile modem on a machine.
  61. .I faxgetty
  62. is typically started by
  63. .IR init (${MANNUM1_8}).
  64. .I faxgetty
  65. can also be used with data-only modems; this may be desirable if
  66. some of the non-facsimile features are important, such as the
  67. support for screening calls according to Caller-ID information.
  68. .PP
  69. .I faxgetty
  70. listens to its facsimile modem for incoming calls
  71. and to a
  72. .SM FIFO
  73. special file on which it accepts command directives from
  74. administrative commands such as
  75. .IR faxanswer (${MANNUM1_8})
  76. and
  77. .IR faxabort (${MANNUM1_8}).
  78. .I faxgetty
  79. also catches 
  80. .SM SIGTERM
  81. and
  82. .SM SIGINT
  83. signals; cleaning up any necessary resources before exiting.
  84. .PP
  85. Many aspects of
  86. .I faxgetty
  87. operation are controlled through a configuration file.
  88. In particular, for 
  89. .I faxgetty
  90. to automatically invoke the
  91. .IR getty (${MANNUM1_8})
  92. program to handle incoming data connections the
  93. .B GettyArgs
  94. parameter must be setup in the configuration file.
  95. The configuration file is located in the spooler hierarchy
  96. in the
  97. .B etc
  98. subdirectory and is named
  99. .BI config. devid ,
  100. where
  101. .I devid
  102. is an identifier derived from the name of
  103. the modem's device file; for example
  104. .I ttym2
  105. for
  106. .IR /dev/ttym2 ,
  107. .I term_10
  108. for
  109. .IR /dev/term/10 .
  110. Consult
  111. .IR hylafax-config (${MANNUM4_5})
  112. for detailed information on the contents of configuration files.
  113. .SH OPTIONS
  114. .TP 10
  115. .B -D
  116. This option forces
  117. .I faxgetty
  118. to detach itself from the controlling tty from which it was invoked.
  119. In normal operation
  120. .I faxgetty
  121. will 
  122. .B not
  123. disassociate itself from the controlling tty.
  124. .TP 10
  125. .B -p
  126. Do not change the process priority when receiving facsimile.
  127. Normally
  128. .I faxgetty
  129. will raise its priority to reduce i/o latency.
  130. This option is useful for debugging.
  131. .TP 10
  132. .BI -q " dir"
  133. The specified directory is treated as the spooling area.
  134. The default spooling area,
  135. .IR ${SPOOL} ,
  136. is defined at the time the software is built.
  137. .TP 10
  138. .BI -c " config"
  139. Treat
  140. .I config
  141. as a configuration parameter specification that is interpreted
  142. after reading the per-device configuration file.
  143. For example, ``-c sessiontracing:0x4f'' would set the
  144. .B SessionTracing
  145. configuration parameter to ``0x4f'', overriding any setting in
  146. the configuration file.
  147. .SH FILES
  148. .ta w'${SPOOL}/etc/config.fIdevicefP    'u
  149. .nf
  150. ${SPOOL}/FIFO.fIdevicefP FIFO special file for submitting commands
  151. ${SPOOL}/etc/config.fIdevicefP device-specific configuration file
  152. .fi
  153. .PP
  154. Consult
  155. .IR hylafax-server (${MANNUM4_5})
  156. for a complete discussion of the structure and
  157. content of the spooling area.
  158. .SH "SEE ALSO"
  159. .IR faxabort (${MANNUM1_8}),
  160. .IR faxlock (${MANNUM1_8}),
  161. .IR faxanswer (${MANNUM1_8}),
  162. .IR faxconfig (${MANNUM1_8}),
  163. .IR faxstate (${MANNUM1_8}),
  164. .IR faxq (${MANNUM1_8}),
  165. .IR getty (${MANNUM1_8}),
  166. .IR hylafax-server (${MANNUM4_5}),
  167. .IR hylafax-config (${MANNUM4_5})