xenial (1) lmove.1.gz

Provided by: suck_4.3.2-15_amd64 bug

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)