Quick start guide for the gopher-nntp gateway

Requirements: perl, sys/socket.ph, an NNTP server that supports XHDR
(this can be gotten around with a bit of extra coding)

Notes: If running chroot(), be sure to have perl,sys/socket.ph, and
sort in the gopher space. If you don't want sort, remove the sorting
routine from the -g option. 

gonntp has 5 options:
-g pattern	retrieve all matching groups (as shipped gonntp only
                matches with the beginning of the group name)

-h group	retrieve subject headers from specified group

-b group	same as -h, but sets up next level to only display
		the body of the article (no headers)

-s group keyword	same a -h but display only subject lines
			which contain keyword. Currently limited to
			one word, should be easily fixed for more.
			To use this from gopher, you will have to call
			a shell script to run gonntp rather than exec'ing
			gonntp directly. I am still working on the 
			search stuff, may change it later...

-a group_#[_body]	Internal option to retrieve article # from
			group. If body is specified then only the
			body of the article is displayed (no headers).
			The -a option should never be used in a .link
			file unless you never get rid of news articles.	

-l group		Show last article from a group. Added by 
			Bob Peterson (peterson@choctaw.csc.ti.com)

The following are only useful if you have the XINDEX extension to
NNTP provided by the tin news reader (and have tind building indexes)

-G pattern		Same as -g, except prepare to thread groups

-T group		Same as -h except thread articles.

-X group_thread#	Show authors from thread

-t group		Use thread indexes to show headers, but don't 
			thread.			
Sample link files


Name=comp
Type=1
Path=exec:-g comp:/bin/gonntp
Host=+
Port=+

Name=Comp.Sys groups
Type=1
Path=exec:-g comp.sys:/bin/gonntp
Host=+
Port=+

Name=Gopher News
Type=1
Path=exec:-h alt.gopher:/bin/gonntp
Host=+
Port=+

Name=No headers alt.gopher
Type=1
Path=exec:-b alt.gopher:/bin/gonntp
Host=+
Port=+

Name=Search alt.gopher subjects for keyword
Type=7
Path=7/bin/gonntp.sh
Port=+
Host=+

(gonntp.sh is a shell script which execs gonntp -s alt.gopher $*, the
exec type will try to exec "/bin/gonntp keyword" rather than 
exec "/bin/gonntp" "keyword")

i.e.:

#!/bin/sh

/bin/gonntp -s alt.gopher $*

Comments & Suggestions to:

dan@engr.latech.edu



