home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / unix / volume1 / expire.8 < prev    next >
Internet Message Format  |  1986-11-30  |  4KB
  1. Date: Mon, 11 Feb 85 08:20:41 pst
  2. From: decvax!ihnp4!uw-beaver!entropy!dataio!bossert (John Bossert)
  3. Subject: Manual page for 2.10.2 expire(8)
  4. Newsgroups: mod.sources
  5.  
  6. Some sites apparently didn't get this.  Hope it helps.
  7.  
  8. #    This is a shell archive.
  9. #    Remove everything above and including the cut line.
  10. #    Then run the rest of the file through sh.
  11. -----cut here-----cut here-----cut here-----cut here-----
  12. #!/bin/sh
  13. # shar:    Shell Archiver
  14. #    Run the following text with /bin/sh to create:
  15. #    expire.8
  16. # This archive created: Mon Feb 11 08:18:23 1985
  17. # By:    John Bossert (Data I/O Corporation, Redmond WA)
  18. sed 's/^X//' << \SHAR_EOF > expire.8
  19. X.TH EXPIRE 8 "14 January 1985"
  20. X.SH NAME
  21. X\fBexpire\fR \- remove outdated news articles
  22. X.SH SYNOPSIS
  23. X\fBexpire\fR 
  24. X[\fB\-n\fR \fInewsgroups\fR]
  25. X[\fB\-i\fR]
  26. X[\fB\-I\fR]
  27. X[\fB\-v\fR \fIlevel\fR]
  28. X[\fB\-e\fR \fIdays\fR]
  29. X[\fB\-a\fR \fR[\fPnewsgroups\fR]]\fP
  30. X.br
  31. X\fBexpire\fR
  32. X\fB\-p\fR
  33. X.br
  34. X\fBexpire\fR
  35. X\fB\-r\fR
  36. X.br
  37. X\fBexpire\fR
  38. X\fB\-f\fR \fIaccount\fR
  39. X[\fB\-e\fR \fIdays\fR]
  40. X.br
  41. X\fBexpire\fR
  42. X\fB\-u\fR
  43. X.SH DESCRIPTION
  44. X.B Expire
  45. Xis used to clean the spool directory of old news.
  46. XIt is normally executed by \fIcron\fR(8) every night.
  47. X.B Expire
  48. Xwith no arguments will remove those articles older than a site dependent age.
  49. XThe age of an article is determined from its creation
  50. Xdate or from an Expire: field in the article header.
  51. X.PP
  52. XThe following flags are valid:
  53. X.TP 10
  54. X\fB\-a\fR \fR[\fInewsgroups\fR]\fP
  55. XArchive the expired articles from the selected \fInewsgroups\fR
  56. Xin /usr/spool/oldnews.
  57. XWith no argument, all expired articles will be archived.
  58. X.TP 10
  59. X\fB\-e\fR \fR[\fIdays\fR]\fP
  60. XRemove articles older than \fIdays\fR days.
  61. XThe default is site specific, often 14.
  62. X.TP 10
  63. X\fB\-f\fR \fR[\fIuser\fR]\fP
  64. XExpire all messages sent by \fIuser\fR.
  65. XThe next parameter is used as the name and is in the same
  66. Xformat as the From: line in the header (i.e. account@site.UUCP).
  67. XThis is often used when a notes site resends a batch of old news.
  68. X.TP 10
  69. X\fB\-h\fR
  70. XIgnore the history file if it exists.
  71. X.B Expire
  72. Xwill search the entire spool directory, 
  73. Xopen each file in it and check the header for expirations. 
  74. XThis method is a couple of orders of magnitude less efficient than 
  75. Xusing a history file,
  76. Xbut if you have trashed your history file 
  77. Xor have had things drop out of the history file for some reason,
  78. Xthis will track them down and remove them.
  79. X.TP 10
  80. X\fB\-I\fR
  81. X.TP 10
  82. X\fB\-i\fR
  83. XIgnore any expiration date explicitly given on articles.
  84. XThis can be used when disk space is really tight.
  85. XThe 
  86. X.B \-I
  87. Xflag will always ignore expiration dates,
  88. Xwhile the
  89. X.B \-i
  90. Xflag will only ignore the date if ignoring it would expire the article sooner.
  91. X.I WARNING:
  92. XIf you have articles archived by giving them expiration dates far into the
  93. Xfuture, these options might cause them to be removed.
  94. X.TP 10
  95. X\fB\-n\fR \fInewsgroups\fR
  96. XExpire the selected \fInewsgroups\fR.
  97. X.TP 10
  98. X\fB\-p\fR
  99. XUse the posting date rather than the received date to expire articles.
  100. X.TP 10
  101. X\fB\-r\fR
  102. XRebuild the history file. 
  103. X.B Expire 
  104. Xsearches the entire spool directory and
  105. Xconstructs a new history entry for each article found.
  106. XRebuilding the history file also rebuilds the associated DBM files.
  107. X.TP 10
  108. X\fB\-u\fR
  109. XUpdate the minimum article number field in the active file.
  110. XThis is normally used only while converting from 2.10.1 news system to 2.10.2.
  111. X.TP 10
  112. X\fB\-v\fR \fR[\fIlevel\fR]\fP
  113. XVerbosity level from 1 to 3 (default 1). 
  114. XGood for debugging or when articles aren't being properly expired.
  115. X.SH SEE ALSO
  116. X.BR checknews (1),
  117. X.BR inews (1),
  118. X.BR readnews (1),
  119. X.BR recnews (8),
  120. X.BR sendnews (8),
  121. X.BR uurec (8),
  122. X.BR vnews (1)
  123. SHAR_EOF
  124. #    End of shell archive
  125. exit 0
  126.  
  127.  
  128.