NAME

       lmove - move articles into /news/group/number directories

SYNOPSIS

       lmove  -d directory [ -c filename ] [ -a filename ] [ -e | -E filename ] [ -l phrase_file ] [ -D ] [ -A ]
       [ -h | -s ]

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.

       -A

       Lmove uses the active file to determine what number to start at when  creating  the  file  name  for  the
       articles  in  each group.  If an external program or person either puts articles into the directories, or
       changes the numbers in the active file, the possibility exists to accidently overwrite  already  existing
       articles.   In  order to avoid this, lmove checks to see if an article already exists before moving a new
       article into the directory tree.  If it already exists, then lmove aborts with a warning message at  that
       point.

       This  option overrides the default action.  If this option is given when lmove runs, then lmove will keep
       increasing the article number until it finds one not being 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.

       -s

       This option tells suck to create symbolic links for articles that are cross posted  to  multiple  groups.
       The  first  group  on the newsgroups line that is in the active file gets the actual text of the article,
       any other groups that are on the newsgroups line that also exist in the active  file  will  get  symbolic
       links  to the actual text.   This is so that news readers can see cross posted articles in all the groups
       that they were cross posted to.  NOTE: If an article is cross posted to a group that does  not  exist  in
       the active file, then a link will not be created.

       -h

       This  option  is  identical to the -s option, but instead of symbolic links, hard links are created.  See
       man 2 link and man 2 symlink to explain the differences between hard and symbolic links.

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.  Normally, once the first group of an article is matched in
       the active file, lmove goes on to the next article, unless you use the -h or -s option above.

CONFIGURATION FILE

       The configuration file should contain two lines:

              BASE=/usr/spool/news
              ACTIVE=/usr/spool/news/active

       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.

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:

              comp.os.linux.announce 1000 1 y

       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.

EXIT VALUES

       0 on success, -1 on failure.

SEE ALSO

       suck(1), rpost(1), testhost(1).

                                                                                                        LMOVE(1)