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

传真(Fax)编程

开发平台:

C/C++

  1. ." $Id: faxqclean.1m,v 1.1.1.1 2005/11/11 21:32:03 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 FAXQCLEAN ${MANNUM1_8} "March 14, 1996"
  31. .SH NAME
  32. faxqclean - *(Fx queue cleaner process
  33. .SH SYNOPSIS
  34. .B ${SBIN}/faxqclean
  35. [
  36. .I options
  37. ]
  38. .SH DESCRIPTION
  39. .I faxqclean
  40. is a program that processes completed *(Fx
  41. jobs and expunges unreferenced document files.
  42. This program is intended to be invoked by
  43. .IR cron (${MANNUM1_8})
  44. on behalf of the super user (i.e. root) one or more times a day.
  45. For example, the following crontab entry might be setup for root to run
  46. .I faxqclean
  47. each hour.
  48. .sp .5
  49. .nf
  50. .ti +.2i
  51. s-1fC0   *    *    *    *   ${SBIN}/faxqcleanfPs+1
  52. .fi
  53. .PP
  54. When
  55. .I faxqclean
  56. is run it scans the
  57. .B doneq
  58. subdirectory in the *(Fx spooling area and process each job
  59. according to the
  60. .B doneop
  61. field specified in the job description file; c.f.
  62. .IR sendq (${MANNUM4_5}).
  63. Jobs that are marked for removal are purged and references to documents
  64. are removed.
  65. Jobs that are marked for archival may be archived depending on the
  66. options supplied on the command line.
  67. .PP
  68. After scanning for completed jobs
  69. .I faxqclean
  70. scans the
  71. .B docq
  72. subdirectory and builds up a table of document files.
  73. Files that are not referenced by any job and that are older than
  74. a specified threshold are removed.
  75. .SH OPTIONS
  76. .TP 10
  77. .B -a
  78. Enable job archiving support.
  79. .TP 10
  80. .B -A
  81. This option forces archiving even if 'doneop' in
  82. the queue file is not 'archive', i.e. even if the user submitted the job
  83. without specifying the -A flag to sendfax
  84. .TP 10
  85. .BI -j " secs"
  86. Set the job age threshold (in seconds)
  87. that controls how long jobs may reside in the
  88. .B doneq
  89. directory before being processed.
  90. By default this value is 15 minutes (15*60 = 900 seconds).
  91. .TP 10
  92. .BI -d " secs"
  93. Set the document age threshold (in seconds)
  94. that controls how long unreferenced files may reside in the
  95. .B docq
  96. directory before being removed.
  97. By default this value is 1 hour (60*60 = 3600 seconds).
  98. .TP 10
  99. .B -n
  100. Do not carry out any work; just show what would be done.
  101. This option is useful together with the
  102. .B -t
  103. option for debugging.
  104. .TP 10
  105. .BI -q " dir"
  106. The specified directory is treated as the spooling area.
  107. The default spooling area,
  108. .IR ${SPOOL} ,
  109. is defined at the time the software is built.
  110. .TP 10
  111. .B -t
  112. Trace in great detail exactly what
  113. .I faxqclean
  114. is doing.
  115. Messages are sent to the standard output.
  116. .TP 10
  117. .B -v
  118. Print messages on the standard output about jobs removed or
  119. archived and about document files removed.
  120. .SH FILES
  121. .ta w'${SPOOL}/archive    'u
  122. .nf
  123. ${SPOOL}/doneq directory to scan for completed jobs
  124. ${SPOOL}/docq directory to scan for unreferenced documents
  125. ${SPOOL}/archive directory where archived jobs are placed
  126. .fi
  127. .PP
  128. Consult
  129. .IR hylafax-server (${MANNUM4_5})
  130. for a complete discussion of the structure and
  131. content of the spooling area.
  132. .SH "SEE ALSO"
  133. .IR faxq (${MANNUM1_8}),
  134. .IR hylafax-server (${MANNUM4_5}),
  135. .IR sendq (${MANNUM4_5}),
  136. .IR doneq (${MANNUM4_5}),
  137. .IR archive (${MANNUM4_5}).