1LMOVE(1) General Commands Manual LMOVE(1)
2
6 lmove - move articles into /news/group/number directories
7
9 lmove -d directory [ -c filename ] [ -a filename ] [ -e | -E filename ]
10 [ -l phrase_file ] [ -D ] [ -A ] [ -h | -s ]
11
14 -a filename
15 This is the location of the active file. See description of file
17 below. If this option is not provided, the default of "active" is
18 used.
19 -A
21 Lmove uses the active file to determine what number to start at when
23 creating the file name for the articles in each group. If an external
24 program or person either puts articles into the directories, or changes
25 the numbers in the active file, the possibility exists to accidently
26 overwrite already existing articles. In order to avoid this, lmove
27 checks to see if an article already exists before moving a new article
28 into the directory tree. If it already exists, then lmove aborts with
29 a warning message at that point.
30 This option overrides the default action. If this option is given when
32 lmove runs, then lmove will keep increasing the article number until it
33 finds one not being used.
34 -c filename
36 This is the location of the configuration file. See description of
38 file below. If this option is not provided, the default of "lmove-con‐
39 fig" is used.
40 -d directory
42 This option is required. This is the directory that contains the arti‐
44 cles for lmove to put into the directory structure. It should be on
45 the same filesystem as the BASE directory (see ACTIVE FILE below),
46 since some ..IX's move command can not move files across file systems.
47 -D
49 This option tells lmove to log various debugging messages to
51 debug.suck. This is primarily used by the developer to trace various
52 problems.
53 -e | -E filename
55 These options will send all error messages (normally displayed on
57 stderr), to an alternate file. The lower case version, -e, will send
58 the error messages to the compiled-in default defined in suck_config.h.
59 The upper case version, -E, requires the filename parameter. All error
60 messages will then be sent to this file.
61 -l phrase_file
63 This option tells lmove to load in an alternate phrase file, instead of
65 using the built-in messages. This allows you to have lmove print
66 phrases in another language, or to allow you to customize the messages
67 without re-building lmove. See the "FOREIGN LANGUAGE PHRASES" in
68 suck.1 for more details.
69 -s
71 This option tells suck to create symbolic links for articles that are
73 cross posted to multiple groups. The first group on the newsgroups
74 line that is in the active file gets the actual text of the article,
75 any other groups that are on the newsgroups line that also exist in the
76 active file will get symbolic links to the actual text. This is so
77 that news readers can see cross posted articles in all the groups that
78 they were cross posted to. NOTE: If an article is cross posted to a
79 group that does not exist in the active file, then a link will not be
80 created.
81 -h
83 This option is identical to the -s option, but instead of symbolic
85 links, hard links are created. See man 2 link and man 2 symlink to
86 explain the differences between hard and symbolic links.
87
90 Lmove will take articles in a single directory (such as those retrieved
91 with "suck" ), and put them into a directory tree based on newsgroups.
92 Lmove uses an "active" file to determine where to put the various arti‐
93 cles, and to keep track of the highest numbered articles in these
94 directories. Lmove will scan each article to find a matching group in
95 the active file, then store the article in that group's directory,
96 increasing the highest number for that group. Normally, once the first
97 group of an article is matched in the active file, lmove goes on to the
98 next article, unless you use the -h or -s option above.
99
102 The configuration file should contain two lines:
103 BASE=/usr/spool/news
105 ACTIVE=/usr/spool/news/active
106 The BASE= tells lmove the base directory for all articles. This is
108 where the articles are actually stored.
109 The ACTIVE= tells lmove where to find the active file, described below.
111
114 The active file consists of newsgroup names, the current highest arti‐
115 cle number, the current lowest article number, and the current status
116 of the group. Lmove only uses the newsgroup name and highest article
117 number. The other fields are just rewritten, and not modified in any
118 way. These are here for use by other programs.
119 Example:
121 comp.os.linux.announce 1000 1 y
123 The lines are a listing of the valid groups that lmove will store arti‐
125 cles in. The highest article number for a new group should be either 0
126 or 1.
127 Upon completion, lmove will move the current active file to
129 "active.old", and write out a new active file with the new highest
130 article numbers. Any articles not moved into the directory structure
131 are left in the original article directory.
132
135 0 on success, -1 on failure.
136
138 suck(1), rpost(1), testhost(1).
139 LMOVE(1)