[go: up one dir, main page]

File: lmove.1

package info (click to toggle)
suck 3.10.1-3
  • links: PTS
  • area: main
  • in suites: slink
  • size: 728 kB
  • ctags: 727
  • sloc: ansic: 8,357; sh: 585; makefile: 212; java: 144; perl: 24
file content (124 lines) | stat: -rw-r--r-- 3,390 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
.\" $Revision: 1.2 $
.TH LMOVE 1
.SH NAME
lmove - move articles into /news/group/number directories
.SH SYNOPSIS
.I lmove
.BI 
-d directory
[
.BI 
-c filename
]
[
.BI
-a filename
]
[
.BI
-e | -E filename
]
[
.BI
-l phrase_file
]
[
.BI
-D
]

.SH OPTIONS

\-a filename

This is the location of the active file.  See description of file below.
If this option is not provided, the default of "active" is used.

\-c filename

This is the location of the configuration file.  See description of file below.
If this option is not provided, the default of "lmove-config" is used.

\-d directory

This option is required. This is the directory that contains the articles
for lmove to put into the directory structure.  It should be on the same
filesystem as the BASE directory (see ACTIVE FILE below), since some ..IX's
move command can not move files across file systems.

\-D 

This option tells lmove to log various debugging messages to debug.suck.  This is
primarily used by the developer to trace various problems.

\-e | \-E filename

These options will send all error messages (normally displayed on stderr), to 
an alternate file.  The lower case version, -e, will send the error messages
to the compiled-in default defined in suck_config.h.
The upper case version, -E, requires the filename parameter.  All error messages
will then be sent to this file.

\-l phrase_file

This option tells lmove to load in an alternate phrase file, instead of using
the built-in messages.  This allows you to have lmove print phrases in another
language, or to allow you to customize the messages without re-building lmove.
See the "FOREIGN LANGUAGE PHRASES" in suck.1 for more details.

.SH DESCRIPTION

Lmove will take articles in a single directory (such as those retrieved with
"suck" ), and put them into a directory tree based on newsgroups.  Lmove uses
an "active" file to determine where to put the various articles, and to keep
track of the highest numbered articles in these directories.  Lmove will scan
each article to find a matching group in the active file, then store the
article in that group's directory, increasing the highest number for that
group.

.SH CONFIGURATION FILE

The configuration file should contain two lines:

.RS
BASE=/usr/spool/news
.RE
.RS
ACTIVE=/usr/spool/news/active
.RE

The BASE= tells lmove the base directory for all articles.  This is where 
the articles are actually stored.

The ACTIVE= tells lmove where to find the active file, described below.

.SH ACTIVE FILE

The active file consists of newsgroup names, the current highest article number,
the current lowest article number, and the current status of the group.  Lmove
only uses the newsgroup name and highest article number.  The other fields are
just rewritten, and not modified in any way.  These are here for use by other
programs.

Example:

.RS
comp.os.linux.announce 1000 1 y
.RE

The lines are a listing of the valid groups that lmove will
store articles in.  The highest article number for a new group should be
either 0 or 1.

Upon completion, lmove will move the current active file to "active.old",
and write out a new active file with the new highest article numbers.
Any articles not moved into the directory structure are left in the original
article directory.

.SH EXIT VALUES
0 on success, -1 on failure.
.de R$
Revision \\$$3, \\$$4
..
.SH "SEE ALSO"
suck(1), rpost(1), testhost(1).