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

FreeBSD Manual Pages

  
 
  

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

NAME
       snget,sngetd - fetch news from upstream sites and store them locally.

SYNOPSIS
       snget [options] [news.group...]
       sngetd [options]
       options:	[-d] [-h Bps] [-p nparallel] [-c depth]	[-m max]

DESCRIPTION
       snget  fetches articles for the news.groups on the command line (or all
       non-local newsgroups if none are	specified) from	their  respective  up-
       stream  feeds, and stores them in the news spool	/var/spool/news.  If a
       newsgroup could not be fetched for, it may be attempted again.	sngetd
       does    the    same,    except	 it   reads   newsgroup	  names	  from
       /var/spool/news/.fifo and does not exit.	 sngetd	does not fork into the
       background.

       snget  does not guarantee to fetch the groups in	the order specified on
       the command line.  snget	and sngetd will	write errors and  status  mes-
       sages to	descriptor 2.

       snget  and  sngetd  are	both  scheduling  wrappers  that call /usr/lo-
       cal/sbin/SNHELLO, snfetch, and snstore.	You must  own  /var/spool/news
       or be root in order to run snget	and sngetd.

OPTIONS
       -d     Enable  verbosity, may be	specified multiple times.  This	option
	      is also propagated to snfetch and	snstore.

       -p nparallel
	      Attempt to fetch for nparallel newsgroups	at once.   Default  is
	      4, maximum is 8.

       -h Bps Throttle the sum of bandwidth used by all	snfetches to Bps bytes
	      per second.  This	option is used to prevent snget	or sngetd from
	      hogging the network.  By default there is	no throttling.

       -c depth
	      depth is passed to snfetch as the	depth of the command pipeline.

       -m max The very first time contacting the news server, retrieve no more
	      than max articles	per newsgroup, default is 200.	This option is
	      useful  only  if there are unprimed newsgroups and has no	effect
	      otherwise.  The .max file	in each	newsgroup directory still  ap-
	      plies (see snfetch(8)).

       -t timeout
	      This  option  is	not  documented	because	it is ignored and will
	      disappear	in a future release.  See .timeout in FILES next.

FILES
       Server Directories
	      These    are     the     directories     /var/spool/news/.outgo-
	      ing/server.name:port,	 which	    are	    symlinked	  from
	      /var/spool/news/news.group/.outgoing.  If	 the  latter  isn't  a
	      (symlink to a) directory,	snget won't fetch for news.group.

       /var/spool/news/.outgoing/server.name:port/.timeout
	      If  this	file exists and	contains a number, this	is taken to be
	      the timeout in seconds in	all  dealings  with  server.name:port.
	      Default is 120 seconds.

       /var/spool/news/.outgoing/server.name:port/.SNHELLO
	      If  this	program	 file exists, it is invoked instead of the de-
	      fault (usually /usr/local/sbin/SNHELLO) when an NNTP  connection
	      is  first	made to	server.name:port in order to read the greeting
	      and upload posted	 articles.   If	 server.name:port  requires  a
	      username	and password, you would	copy the default here and edit
	      that information in.

       /var/spool/news/news.group/{.serial,.max}
	      snget and	sngetd read these files	on behalf of snfetch.

SIGNALS
       Other signals have default behaviour.

       SIGUSR1
	      If -h Bps	was specified, Bps is halved, else is ignored.

       SIGUSR2
	      If -h Bps	was specified, Bps is doubled, else is ignored.

ENVIRONMENT VARIABLES
       See also	/usr/local/sbin/SNHELLO	for the	list of	environment  variables
       exported	by snget/sngetd.

       SNROOT If  this	is set and is not empty, the value is used in place of
	      /var/spool/news, the default news	spool directory.

       PATH   To find SNHELLO (if this	server	does  not  have	 a  .SNHELLO),
	      snfetch,	and snstore.  If PATH does not contain /usr/local/sbin
	      as one of	it's components, /usr/local/sbin is appended to	it.

SEE ALSO
       snfetch(8), snstore(8), /usr/local/sbin/SNHELLO

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

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | FILES | SIGNALS | ENVIRONMENT VARIABLES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=snget&sektion=8&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help