GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  SNGET (8)

NAME

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

CONTENTS

Synopsis
Description
Options
Files
Signals
Environment Variables
See Also

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/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 messages to descriptor 2.

snget and sngetd are both scheduling wrappers that call /usr/local/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 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/news/.outgoing/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 default (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
Search for    or go to Top of page |  Section 8 |  Main Index


N.B. SNGET,V0.3.8 (8) Harold Tay

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.