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

FreeBSD Manual Pages


home | help
snsend,v0.3.8(8)	    System Manager's Manual	      snsend,v0.3.8(8)

       snsend -	distribute articles
       snstore - store articles	locally

       snsend [-rvcna]
       snstore [-rvcna]

       snsend  reads  articles from descriptor 0 and distributes each one into
       each newsgroup they are posted to, like inews.  snstore does  the  same
       but  stores them	all locally.  The input	articles are expected to be in
       wire format (lines end with CRLF, leading dots are doubled,  and	 arti-
       cles are	terminated with	a lone dot).

       Control messages	are not	treated	specially.

       The  newsgroups	list is	taken from the X-sn-Newsgroups field if	it ex-
       ists; otherwise it is taken from	the Newsgroups field, which must exist
       or the article will be junked.  All fields whose	names begin with X-sn-
       (case insensitive) are always removed.

       If Date or Message-ID are not present, these are	 created.   The	 local
       hosts name is prepended to the Path field.

       If  an  article is to be	junked,	it is sent to the junk newsgroup if it
       exists, otherwise it is discarded.

       This applies only to snsend.  snstore does not  route;  it  treats  all
       news.groups  as	though	they were local	(see Nonexistent newsgroup and
       Local newsgroup below).	If any of the following	fails, snsend aborts:

       For each an article is (cross-) posted to, snsend routes the
       article as follows, aborting if any action fails:

       Nonexistent newsgroup
	      If /var/spool/news/ is not a directory,	snsend ignores
	      this	If all news.groups are thus ignored, the arti-
	      cle is junked.

       Global newsgroup
	      If  /var/spool/news/ is a (symlink to	a) di-
	      rectory, snsend stores the article into a	file  in  that	direc-
	      tory,  if	 the  same  article  does  not already exist there (so's upstream feed doesn't get multiple  copies  of  the
	      same  article.)	Such  in-transit article files are given names
	      that begin with a	$ sign.

       Local processing	via script
	      Otherwise	if /var/spool/news/	is  a  regular
	      file,  it	is taken to be a script	or program and is run with the
	      article available	on its input.  See  /var/spool/news/dot-outgo-

       Local processing	via fifo
	      Otherwise	if /var/spool/news/	is a fifo, the
	      article is written into it.  It is an error if nothing is	 read-
	      ing the fifo.

       Local newsgroup
	      Otherwise	 if  /var/spool/news/ does not ex-
	      ist, the article is stored into

       Options apply to	snsend and snstore equally.

       -r     The article stream is in rnews batch format,  rather  than  wire
	      format.  Only the	#! rnews form is understood.

       -c     If  an  article already exists in	the local newsgroup it is des-
	      tined for, don't store it	there.	For snsend, this option	has no
	      effect on	newsgroups that	are not	local.

       -a     (Aliases	not  allowed.)	 When  storing to multiple local news-
	      groups, do not alias subsequent copies to	 the  first,  instead,
	      make  a  copy.  Aliasing saves disk space, but when the original
	      expires, so do all aliases to it.	 This option has no effect  on
	      newsgroups that are not local.

       -n     Don't  actually  do anything with	the article, just dump it back
	      onto descriptor 1.

       -v     For each article stored in each newsgroup, output	a line to  de-
	      scriptor	1  similar  to what snscan would emit, except that for
	      non-local	newsgroups the serial number will always be 0.

	      This includes  /var/spool/news/=junk  newsgroup  if  it  exists.
	      Each  such  directory represents the newsgroup of	the same name,
	      and articles are stored in files 1, 2, 3,	etc. beneath it.  Each
	      such  file contains 1 or more articles.  This is contrary	to the
	      traditional     form     of     /var/spool/news/news/group/name.

	      See  also	 ROUTING  above.  The presence of this directory indi-
	      cates  that  is  global,  and	 articles  posted   to  end  up  here	 in  files  named $*.  These files are
	      linked in	already	complete, so all such files are	 ready	to  be

	      If  this	file  exists, articles stored in are	candi-
	      dates for	compression.  The content of the file is a number rep-
	      resenting	 a  minimum  article body size below which compression
	      won't be applied.	 If the	file is	empty this threshold  defaults
	      to 1024 bytes.

	      If  this	file  exists,  it's contents are taken to be the local
	      hosts name for purposes of the Path field.  Otherwise  the  name
	      is obtained from gethostname(2).

       See  also  /usr/local/sbin/dot-outgoing.ex for other variables exported
       when snsend invokes a .outgoing program.

       SNROOT If this is set, its value	is used	in place of /var/spool/news.

       snsend and snstore exit 0 on success, 1 on usage	error, 2 on system er-
       ror,	3     on     article	 format	    error,     and     9    if
       /var/spool/news/ (snsend  only)  exits  with	 other
       than 0.

       /usr/local/sbin/dot-outgoing.ex,	snscan(1)

N.B.				  Harold Tay		      snsend,v0.3.8(8)


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

home | help