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

传真(Fax)编程

开发平台:

C/C++

  1. ." $Id: faxq.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 FAXQ ${MANNUM1_8} "October 27, 1995"
  31. .SH NAME
  32. faxq - *(Fx queue manager process
  33. .SH SYNOPSIS
  34. .B ${LIBEXEC}/faxq
  35. [
  36. .B -D
  37. ] [
  38. .B -q
  39. .I queue-dir
  40. ] [
  41. .B -c
  42. .I config
  43. ]
  44. .SH DESCRIPTION
  45. .I faxq
  46. is the central queueing agent for *(Fx.
  47. One (and only one)
  48. .I faxq
  49. process is normally running at all times.
  50. .I faxq
  51. is responsible for scheduling, preparing, and initiating
  52. outbound facsimile jobs (and potentially other types of jobs as well).
  53. .PP
  54. .I faxq
  55. may be run by itself to provide outbound-only services or it
  56. may be run together with one or more
  57. .IR faxgetty (${MANNUM1_8})
  58. processes, in which case inbound services (e.g. receiving
  59. facsimile) are provided.
  60. When
  61. .I faxq
  62. is run by itself the set of available modems must be specified
  63. using the
  64. .IR faxmodem (${MANNUM1_8})
  65. command.
  66. Each modem specified in this way is assumed to exist and to
  67. be capable of use as a facsimile modem.
  68. When
  69. .I faxq
  70. is run in conjunction with
  71. .IR faxgetty
  72. processes, it is not necessary to use
  73. .I faxmodem
  74. to specify modems; instead the programs
  75. communicate information about the status and
  76. capabilities of each modem.
  77. The latter setup provides a more robust and powerful system and
  78. is the intended way for the software to operate.
  79. .PP
  80. .I faxq
  81. receives notification of outbound jobs to process from the
  82. .IR hfaxd (${MANNUM1_8})
  83. process that implements the server-side of the *(Fx
  84. client-server protocol.
  85. Notification is through messages sent to a
  86. .SM FIFO
  87. special file that
  88. .I faxq
  89. listens to.
  90. This file is also used by other administrative programs such as
  91. .IR faxquit (${MANNUM1_8}).
  92. .PP
  93. Many aspects of
  94. .I faxq
  95. operation may be controlled through a configuration file.
  96. This file is located in the spooler hierarchy in the
  97. .B etc
  98. subdirectory and is named
  99. .B config
  100. (as opposed to the per-modem configuration files named
  101. .BI config. devid );
  102. consult
  103. .IR hylafax-config (${MANNUM4_5})
  104. for detailed information on this configuration file.
  105. Note that
  106. .I faxq
  107. automatically re-reads its configuration file if it has been
  108. changed.
  109. It is also possible to dynamically change configuration parameters
  110. in a running process with the
  111. .IR faxconfig (${MANNUM1_8})
  112. program.
  113. Beware however that parameters changed in this way will be reset
  114. to the values specified in the configuration file if the file
  115. is re-read.
  116. .SH OPTIONS
  117. .TP 10
  118. .BI -q " dir"
  119. The specified directory is treated as the spooling area.
  120. The default spooling area,
  121. .IR ${SPOOL} ,
  122. is defined at the time the software is built.
  123. .TP 10
  124. .B -D
  125. This option forces
  126. .I faxq
  127. to remain attached to the controlling tty from which it was invoked.
  128. In normal operation
  129. .I faxq
  130. will
  131. .IR fork (2)
  132. and disassociate itself from the controlling tty.
  133. This option is useful for debugging.
  134. .TP 10
  135. .BI -c " config"
  136. Treat
  137. .I config
  138. as a configuration parameter specification that is interpreted
  139. after reading the configuration file.
  140. For example, ``-c servertracing:0x4f'' would set the
  141. .B ServerTracing
  142. configuration parameter to ``0x4f'', overriding any setting in
  143. the configuration file.
  144. .SH FILES
  145. .ta w'${SPOOL}/etc/config    'u
  146. .nf
  147. ${SPOOL}/FIFO FIFO special file for submitting commands
  148. ${SPOOL}/etc/config configuration file
  149. .fi
  150. .PP
  151. Consult
  152. .IR hylafax-server (${MANNUM4_5})
  153. for a complete discussion of the structure and
  154. content of the spooling area.
  155. .SH "SEE ALSO"
  156. .IR faxabort (${MANNUM1_8}),
  157. .IR faxconfig (${MANNUM1_8}),
  158. .IR faxmodem (${MANNUM1_8}),
  159. .IR faxquit (${MANNUM1_8}),
  160. .IR faxstate (${MANNUM1_8}),
  161. .IR getty (${MANNUM1_8}),
  162. .IR hylafax-server (${MANNUM4_5}),
  163. .IR hylafax-config (${MANNUM4_5}).