Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
LMOVE(1)		    General Commands Manual		      LMOVE(1)

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

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

       -a filename

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


       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-con-
       fig" is used.

       -d directory

       This option is required.	This is	the directory that contains the	 arti-
       cles  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.


       This  option  tells  lmove  to  log  various  debugging messages	to de-
       bug.suck.  This is primarily used by the	 developer  to	trace  various

       -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.


       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


       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 ex-
       plain the differences between hard and symbolic links.

       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 arti-
       cles, and to keep track of the highest numbered articles	in  these  di-
       rectories.   Lmove  will	 scan each article to find a matching group in
       the active file,	then store the article in that group's directory,  in-
       creasing	 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.

       The configuration file should contain two lines:


       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.

       The active file consists	of newsgroup names, the	current	highest	 arti-
       cle  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.


	      comp.os.linux.announce 1000 1 y

       The lines are a listing of the valid groups that	lmove will store arti-
       cles 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  "ac-
       tive.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.

       0 on success, -1	on failure.

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



Want to link to this manual page? Use this URL:

home | help