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

FreeBSD Manual Pages

  
 
  

home | help
DNEWSLINK(8)		    System Manager's Manual		  DNEWSLINK(8)

NAME
       dnewslink - Diablo program to feed news to remote systems

SYNOPSIS
       dnewslink  -s xxx...xxxx	-n -i -D -f -p -P port -d[#] -b	batchfile/tem-
       plate -r	-S beginSeq -N numSeq -H -L -A[classes]	-h remote-host -w  de-
       lay  -t	timeout	 -l logFrequency -c reconnectFrequency -T txbufsize -R
       rxbufsize -I rxbufsize -B ip

DESCRIPTION
       DNewslink generally takes queue files from the  dqueue  directory  that
       were  generated by the diablo server and	uses them to transfer articles
       from the	news spool to a	remote host.  There are	a horrendous number of
       options covering	four modes of operation.  DNewslink can	transmit arti-
       cles based on a discrete	queue file, can	transmit using multiple	 queue
       files  based on a template, can transmit	based on input from a pipe, or
       can sit on a realtime queue file	to transmit a feed in near real	 time.
       DNewslink will usually rewrite the queue	file with any entries that had
       to be defered.  When DNewslink connects to a remote host, it  will  at-
       tempt  to  negotiate a check/takethis streaming connection and, if that
       fails, will fallback to the non-streaming ihave protocol.

       DNewslink locks queue files as it  processes  them,  allowing  multiple
       dnewslinks  to operate in parallel on different queue files without the
       possibility of creating a conflict.   DNewslink	uses  a	 sophisticated
       non-blocking  I/O  model	 to  keep  the TCP pipeline full for streaming
       feeds and is capable of generating serious bandwidth.  The options  are
       described below.

       -s xxx...xxxx

       This  option  reserves  space  in the argv array, allowing dnewslink to
       store realtime status in	it such	that it	shows up in a ps.  At least 23
       characters must be given	to reserve sufficient space.

       -n

       This option is a	NOP.  It does nothing, but is often used by other pro-
       grams (aka dspoolout) to	placehold optional arguments.

       -i

       This option disables the	streaming negotiation, forcing the non-stream-
       ing ihave protocol to be	used.  If not given, DNewslink will attempt to
       negotiate the streaming protocol	and fallback to	the non-streaming pro-
       tocol if	the negotiation	fails.

       -D

       This  option causes dnewslink to	detect when the	batch file it is oper-
       ating on	is deleted out from under it.  DNewslink will not  attempt  to
       rewrite	the  batchfile,	or will	rewrite	and remove the batchfile if it
       detects this case and the -D option is given.

       -f

       This option has been depreciated.

       -p

       This option specifies that the input is coming from a pipe rather  then
       the  batchfile  (see  -b	option).  A batchfile must still be specified,
       but it will be used solely for the rewriting of defered lines.

       -P port

       This option specifies the port on the destination host dnewslink	should
       connect to.  The	default	is port	119 (nntp).

       -d [level]

       This  option turns on debugging.	 Normally something like -d2 is	speci-
       fied when dnewslink is run manually in order to trace the protocol  in-
       teraction.

       -b batchfile/template

       This  option specififes the batchfile.  The batchfile specification de-
       pends on	the mode of operation.	For a pipe input, this	is  the	 spill
       file.   With  a	normal batch, this is simply a batch file such as 'la-
       bel.S04522'.  When combined with	-S, this is a template	(usually  'la-
       bel.S%05d').   For  a  realtime	feed, this is the name of the realtime
       queue file... usually just 'label'.

       -r

       This option turns on realtime operation,	indicating that	the  batchfile
       is  being  actively  appended  to  by  another  program (aka the	diablo
       server).	 This option enables a number of optimizations	including  de-
       tecting	when dspoolout flushes/renames the active file.	 When this oc-
       curs, DNewslink will attempt to reopen/lock the new realtime queue file
       and, when this succeeds,	will delete the	renamed	file.  However,	if de-
       ferals had to be	made, DNewslink	will not remove	the renamed file which
       usually results in dspoolout rerunning the file as a normal spool file.

       -S beginSeq

       This  option  turns on multi-batch sequencing, causing DNewslink	to at-
       tempt to	feed several batch files in  sequence.	 If  given,  you  must
       specify	the beginning sequence number in this option and the batchfile
       name (-b	option)	must contain a template	rather then a filename.

       -N numSeq

       This option specifies the number	of sequential sequence numbers to  at-
       tempt  to feed out.  DSpoolout usually specifies	32 here.  If there are
       more then 32 batch files	or if dnewslink	gets interrupted  before  com-
       pletion,	dspoolout will simply start another one.  For realtime batches
       dspoolout specifies a higher number which reflects the  number  of  new
       queue files it is allowed to rotate through before exiting.  For	queue-
       delayed batches (qNNNN option in	dspoolout.ctl),	dspoolout will specify
       an appropriate number based on the number of queue files.

       -H

       This  option  tells dnewslink to	generate a header-only feed, used when
       feeding the diablo reader system	and often coupled with diablo  support
       for  Xref: headers to assign article numbers.  The remote end must sup-
       port sent to a normal feed and propogating outward.  Beyond  that,  the
       header-only  feed  uses	the same ihave/check/takethis protocols	that a
       normal feed uses.

       -L

       This option will	enable generation of Lines: headers in	headfeed  mode
       (see  above); the reason	for this option	is to always have a meaningful
       lines count in overview.	Specifying the	'genlines'  option  in	dnntp-
       spool.ctl will make dspoolout pass -L to	dnewslink.

       -h remote-host

       This  option  specifies	the remote system to connect to.  See also: -P
       option.

       -w delay

       This option specifies the connection fail / reconnection	delay in  sec-
       onds.  The default is 10	seconds.

       -t timeout

       This  option  specifies the inactivity timeout.	The default is 10 min-
       utes.

       -l logFrequency

       This option specifies the log frequency.	 The default is	to  log	 every
       1000 transactions.

       -c reconnectFrequency

       This  option  specifies	the  forced  disconnect/reconnect frequency to
       cause the remote	end to generate	a log line.  The default is  to	 close
       and reopen the connection every 1000 transactions.

       -T txbufsize

       -R rxbufsize

       These options set the TCP receive and transmit buffer sizes.  DNewslink
       will impose a minimum receive buffer size to prevent pipeline  lockups.
       This  option  is	normally used to tune the system.  You can usually re-
       duce the	receive	buffer size to	4096  bytes  without  effecting	 effi-
       ciency.	Some people may	want to	increase the transmit buffer size from
       the system defaults.  These same	options	can be given to	dspoolout  and
       will be passed to dnewslink.

       -I

       This  option disables the "check" NNTP command.	Rather then check each
       message id, dnewslink will simply push the article out with "takethis",
       assuming	 a  streaming  feed  was  negotiated.	Useful for header-only
       feeds.

       -A [classes]

       This option turns on article logging  to	 <logpath>/feedlog.<hostname>.
       Classes	is  is	either comma-separated list of any combination of "ac-
       cept", "reject",	"defer", "refuse" and  "error",	 or  "all".  Not  that
       specifying  "refuse"  can  generate  huge logfiles. Default is "all" if
       classes is not specified, and no	logging	if this	option is not given.

       -B

       This option sets	the source ip address for outbound connections.	It can
       be either an ip address or a hostname which will	be resolved by DNS.

TYPICAL	USE
       DNewslink  is  run  by dspoolout	and usually operated manually only for
       debugging purposes.  Typical usage  is  something  like:	 dnewslink  -b
       fubar.S23343 -h news.fubar.com

SEE ALSO
       diablo(8), dicmd(8), didump(8), diload(8), dnewslink(8),	doutq(8), dex-
       pire(8),	 dexpireover(8),  diconvhist(8),  dilookup(8),	 dspoolout(8),
       dkp(8), dpath(8), diablo-kp(5), diablo-files(5)

								  DNEWSLINK(8)

NAME | SYNOPSIS | DESCRIPTION | TYPICAL USE | SEE ALSO

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

home | help