File: texpire.8.in

package info (click to toggle)
leafnode 1.11.11-1
  • links: PTS
  • area: main
  • in suites: bullseye, buster, sid
  • size: 2,468 kB
  • sloc: ansic: 10,914; sh: 1,748; xml: 628; makefile: 291; perl: 84; sed: 4
file content (131 lines) | stat: -rw-r--r-- 3,916 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
.TH texpire 8 "@VERSION@" leafnode \" -*- nroff -*-
.\" DO NOT EDIT: @configure_input@
.\"
.\" Written by Arnt Gulbrandsen <agulbra@troll.no> and copyright 1995 Troll
.\" Tech AS, Postboks 6133 Etterstad, 0602 Oslo, Norway, fax +47 22646949.
.\"
.\" Use, modification and distribution is allowed without limitation,
.\" warranty, or liability of any kind.
.\"
.\" $Id: texpire.8.in,v 1.16 2004/05/17 09:01:21 emma Exp $
.\"
.\" hilit19 is stupid: "
.SH NAME
texpire \- delete old news articles and repair leafnode news spool

.SH SYNOPSIS
.B texpire
[\fB\-v\fR[...]] [\fB\-q\fR] [\fB\-f\fR] [\fB\-h\fR] [\fB\-r\fR]

.SH DESCRIPTION
.B Leafnode
is a USENET package intended for small sites, where there are few
users and little disk space, but where a large number of groups is
desired.
.PP
.B Texpire
is the program which deletes old articles from the local news spool and
repairs most problems of the news spool. It can restore broken hard
links, re-sort message.id links into the right directories (necessary
when the spool has been moved to a different path) and update overview
data. It can \fBnot\fR repair loss of @spooldir@/news/group/* files.
.PP
.B Archive feature:
If a
.B groupexpire
parameter is set to \-1 for a particular group (or pattern), texpire will
skip this (these) groups.

.SH OPTIONS
.TP
.B \-v
Be verbose.  A maximum of four
.B \-v
can be used (the more v, the more verbose).  Don't expect all the output
to make sense. Cancels preceding \-q options.
.TP
.B \-f
Force expire. Expire will be made regardless of the access time of the file.
Especially useful if you regularly backup your news spool or do other things
to it where you open files in there.
.TP
.B \-q
Quiet. Print no messages unless problems occur. Cancels preceding \-v
options.
.TP
.B \-r
Repair (since v1.9.54). Runs a more thorough yet slower check to detect
broken hard links between articles and message.id files.
.TP
.B \-h
Help. Print short usage message and exit with code 0.

.SH FILES
See
.BR leafnode (8)
for the list of files affected.

.SH NOTES
.PP
.B Texpire
sets its real and effective uid to "news" (if it can), because almost
all of the problems I have had with
.B leafnode
are due to files which aren't writable for user "news".

.SH BUGS
.B Texpire
may not delete an article as soon as it should in certain circumstances,
for instance after backing up or restoring data; eventually it will.
.PP
.B Texpire
ignores "Expires" headers.
.PP
.B Texpire
is unable to delete articles in groups which have non-consecutive
numbers with huge gaps.
.PP
.B Texpire
does not delete thread-based, but is only looking at individual
articles, although the leafnode documentation of previous versions
claimed otherwise.
.PP
.B Texpire
only removes the innermost empty directory when all articles expire
from a group. On the next run, it will remove the parent, which then is
empty again, so eventually, empty directories will be deleted after some
.B texpire
runs.

.SH ENVIRONMENT
.TP
.B
LN_LOCK_TIMEOUT
This variable is parsed as an unsigned integer value and determines how
many seconds texpire will wait when trying to obtain the lock file
from another leafnode program. 0 means to wait indefinitely. This
variable takes precedence over the configuration file.

.SH AUTHOR
Written by Arnt Gulbrandsen <agulbra@troll.no> and copyright 1995
Troll Tech AS, Postboks 6133 Etterstad, 0602 Oslo, Norway, fax +47
22646949.
.PP
Modified by Cornelius Krasel <krasel@wpxx02.toxi.uni\-wuerzburg.de>.
Copyright of the modifications 1997 \[en] 1999.
.PP
Modified Ralf Wildenhues <ralf.wildenhues@gmx.de>. Copyright of the
modifications 2002.
.PP
Modified by Matthias Andree
<matthias.andree@gmx.de>. Copyright of the modifications 2002 \[en] 2004.
.PP
The archive feature was contributed by Andreas Meininger
<a.meininger@gmx.net>.

.SH SEE ALSO
.BR tcpd (8),
.BR hosts.allow (5),
.BR leafnode (8),
.BR fetchnews (8),
.BR "RFC 977".