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 upstream feeds, and stores them in the news spool /var/spool/sn.   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/sn/.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 messages to descriptor 2.

       snget  and  sngetd  are  both scheduling wrappers that call /usr/sbin/SNHELLO, snfetch, and snstore.  You
       must own /var/spool/sn 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 applies (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/sn/.outgoing/server.name:port,  which  are symlinked from
              /var/spool/sn/news.group/.outgoing.  If the latter isn't a (symlink to a) directory,  snget  won't
              fetch for news.group.

       /var/spool/sn/.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/sn/.outgoing/server.name:port/.SNHELLO
              If this program file exists, it is invoked instead of the default (usually /usr/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/sn/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/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/sn, 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/sbin as one of it's components, /usr/sbin is appended to it.

SEE ALSO

       snfetch(8), snstore(8), /usr/sbin/SNHELLO

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