INN

InterNet News

newsfeeds 、

innfeed.conf

NNTP readerNNTP server

NNTP server, main program, inbound receiver server,program, NNTP main –

– innfeed: outbound,feed articles to peers For readers: readers.conf For peers: incoming.conf Exchangenews articles with peers    

nnrpd readersSeparateand peers components… A lot of ISC took over developmentISC took over 1996 in http://www.isc.org/software/inn innd

• • • • • •

INN is a complete system Usenet complete a INN is Originally written by Rich Salz Rich by written Originally

  Introduction to(1) INN

Computer Center, CS, NCTU 2

Introduction to(2) INN

Computer Center, CS, NCTU 3

history

、 overview.fmt 、

newsgroups

、 ovdb.conf

newsfeeds cycbuff.conf

、 、

active.times NNTP feederNNTP

for users for

main daemon for peers (and daemon for peersusers) main –

– storage.conf readers.conf active buffindexed.conf incoming.conf innfeed.conf       Spool nnrpd databaseNewsgroups Overview database inn.conf innd innfeed

• • • • • • • Main configuration Main Components

  Introduction to(3) INN

Computer Center, CS, NCTU 4

news.daily innreports.conf … expire.ctl control.ctl moderators       Cron jobs Cron INN Summeryof fileslog Others Article and historyand Articleexpiration controlHandling of messages addressesgroups for moderatedSubmission

• • • • • • Specific functions Specific

 Introduction to(4) INN

Computer Center, CS, NCTU 5 INN Installation

GD -

graphics/p5 、 Tools - MIME -

mail/p5 、 2.5.2.tar.gz

- http://www.eyrie.org/~eagle/software/inn/

/perl5.8+ /bison

lang

devel

in - gmake / v2.5.2 , ISC is pleased to announce a new bug fixeda new pleasedbug is to announcev2.5.2ISC ,

gnupg

: built databases/db47+ devel INN

gcc

- INN 2.4.6 was made EOL by the release of 2.5.0. of releasethe by made EOL was 2.4.6 INN

- : security/ 25 - implementation: 08

ftp://ftp.isc.org/isc/inn/inn - : 06 Mar - - Berkeley Berkeley DB: Yacc C compiler C compiler Perl and MIME::Parser: GNU make: GnuPG       Tarball in Dependencies:“Requirements” news/inn: INN 2.4.6news/inn:INN 2009 2010 of 2.5versionINN

• • • • • How to install INN 2.5.2? install How to In FreeBSD portsFreeBSD In

  Install (1) INN

Computer Center, CS, NCTU 7

tcsh /bin/ : 2.5/checklist.html 2.5/install.html - -

rhosts

news:news /home/news news:news

/home/news after installing. Some bins are SUID SUID root. bins areSome after installing.

chown

, and set ~news/.

R news:news -

inetd

username chown via u news …

-

localhost

sudo rlogind p /home/news && && p /home/news localhost – l news

– – *CANNOT* *CANNOT* Enable news /

-

 mkdir # You su rlogin

news:*:8:8::0:0:News Subsystem: news:*:8:8::0:0:News • • • • „news‟ as Login Set up the home directory for „news‟for directory home the up Set „news‟ account up Set http://www.eyrie.org/~eagle/software/inn/docs http://www.eyrie.org/~eagle/software/inn/docs

     Install (2) INN

Computer Center, CS, NCTU 8

)

wget

hash - (ftp/ tagged - usr_local wget enable

--

by fetch or byfetch

tmp

public_html /local usr 2.5.2.tar.gz cannot be used with

-

=/

inn

=$HOME/

and in / put it

dir -

xzf help largefiles keywords - - -- perl berkeleydb http n CONFIG_DONE_INN=1 tarball - - - -

/ports/news/inn/work/.configure_done.inn._

enable enable with with prefix=$HOME with usr CC, CFLAGS, CXXFLAGS, LDFLAGS CXXFLAGS, CFLAGS, CC, ------make / -- --         You can copy some environment variables from ports/news/innfrom environmentvariablesYou cansome copy Fetchthe tar it: Extract ./configure

• • • • Configure The source

  Install (3) INN

Computer Center, CS, NCTU 9

/db47 /db47 4.7 - ldb

-

/local/include lz

/local/include /local/lib –

/local/lib /local/lib usr

also needs to link against DB_LDFLAGS and DB_LIBS. and DB_LDFLAGS against link to needs also usr

usr I/ 4.7 options.h paths.h usr - I/ - L/ - - L/

- ldb innfeed.h - config.h / libstorage Makefile.global include/ include/inn/ include/inn/ innfeed

Please check the following files before running make, to ensure that ensure to make, running before files following the check Please correctly. set was everything Makefile.global Modify

After configure After

DB_LIBS = = DB_LIBS = DBM_CPPFLAGS = DBM_LIBS ## Berkeley DB support. If this support is configured, anything linking anything configured, is support this If support. DB Berkeley ## against ## = DB_CPPFLAGS = DB_LDFLAGS   Install (4) INN

Computer Center, CS, NCTU 10

master) -

news files -

with ` config --

man:`manpath @ (which is defined @ (whichin is

usenet

root (make) (make) install (make) update

PATH $HOME/bin:$PATH PATH $HOME/share/ MANPATH

tcshrc upgrade binaries, scripts, and manual pages, but not Be sure to configure INN with the same options that was used previously.

  gmake gmake gmake Create mail aliasfor mail Create . Set $ „ Loginas # #

setenv setenv • • • • • • Finally To upgrade INN To upgrade Compile INN Compile INN Install

    Install (5) INN

Computer Center, CS, NCTU 11

news.notice news.crit

/log/news/ /log/news/news.err /log/news/ var var var / /

s ~news/log news –

these if you're running inn running you're if these

# /etc/rc.d/syslogd # /etc/rc.d/syslogd reload $ cd ~/log && touch news.crit news.err news.notice # cd /var/log && ln    uncomment Done by news.daily, which is triggered by cron by is triggeredwhich Done bynews.daily, In /etc/syslog.conf

news.crit / news.err news.notice # • • Log rotate Log

Set up syslog up Set

  Install (6) INN

Computer Center, CS, NCTU 12 to the aboveto the

delayrm

lowmark

expireover

U -

CNFS CNFS storage add methods, -

rnews news.daily

file

e –

~news/log/expire.rm expirerm

  to theserver spooled againmessages Processing crontab for „news‟ crontab crontab $ non anyIf you'reusing for news.daily.optionlist

0 3 * * * ~news/bin/ * * 0 3 0 3 * * * ~news/bin/ * * 0 3 • • • • rnews news.daily Set up cron jobscron up Set

   Install (7) INN

Computer Center, CS, NCTU 13

…) 、

/usr/local/news 、

~news

 ~news (/home/news

~news/db

=“YES” up script from news/inn/files/innd.sh.in from script up - %%PREFIX%% %%DBDIR$$ %%NEWSBASE%%   

Put itin /usr/local/etc/rc.d/innd Put „%%VAR%%‟s Modify chmod 555 # /usr/local/etc/rc.d/innd

innd_enable • • • A lot of configurations remain… configurations of lot A

Modify /etc/rc.conf Modify Copy start Copy

   Install (8) INN

Computer Center, CS, NCTU 14 INN Databases

~news/db/

control* 、

cs.test 0000003681 0000000285 y Normally updated nightly as part of the expire process

   If the lowest article number is greater than the highest article number, thenthegreaterhighestarticle number, is If the lowest articlenumber than areno newsgroup. thetherearticlesin name: junk highestarticleevernumber high is the seen hint. be a be taken to only and should accurate, to be is not guaranteed low Maintained using ctlinndcontrolusing or Maintained messages database overview active.times, directly:it Edit only isnewsgroup listedonce Each line Each specifiesone newsgroup a space:byFour fieldsseparated

• • • • • • • • • Format List the newsgroups carried by INN. carried newsgroupsthe List

  active (1)

Computer Center, CS, NCTU 16

newsgroups

、 tw.bbs.* Big5 newsgroups fortw.bbs.* y: allow y: posting and feeding m: moderated, all posting must be approved n: allow feeding only j: fed articles are filed in junk group x: disallow posting and feeding =foo.bar: articles are filed in the newsgroup foo.bar

        ftp://ftp.isc.org/pub/usenet/CONFIG/ active status:

• • • Get a close to complete newsgroups database file database newsgroups complete to a close Get Format

  active (2)

Computer Center, CS, NCTU 17

8 -

mail mail address of the creator -

r

date This field shouldencoded be in UTF Usually the e

     creator: plain text intended to describe the entity that createdthenewsgroup thattextto describe creator:entity plain intended the Three fieldsThree expressed as Unix timestamp was created, itthetime:time

• • • Provide a chronological record of when newsgroups were created on the created were newsgroupswhen of record a chronological Provide server local Format

  active.times

Computer Center, CS, NCTU 18

] (Moderated) 系計中公告 [ to manually create a group, only the active active the only group,a create manually to

ASCII characters in description is recommended -

center - 8 fornon

- t \

ctlinnd newgroup ctlinnd using UTF cs.computer Preferred format: The total line length should be at most 79 columns. The description should start with a capital and not be more than 55 characters long

    edit newsgroups file to add a short description for the created group for the created description short to add a filenewsgroups edit one separatedatleastlinetab fields Each consists of two by It is not necessary that all the groups carriedthe serverlistednews all in be bygroups that theIt is notnecessary file newsgroups the filenewsgroups be in the allgroups listedthat the necessaryIt is alsonot news server bycarriedthe

• • • • file is updated file Format If you use you If Contain a list of newsgroups and its short description short its and newsgroups of list a Contain

   newsgroups

Computer Center, CS, NCTU 19

- ID header -

-

t \ fields separated by a „~‟, each contains Unix timestamp containsUnix by eachfieldsseparateda „~‟, -

field: „Expires:‟ header or „ field: „Date:‟ header, record of the posting time field: arrival time of the article - - t - \ sub sub sub

st nd rd Use sm Use sm utility to retrieve the article 1 2 3 This field is empty if the article has been expired

     date: threedate: sub of a thearticle.token:token [] 1274105567~ [E7516D3A69051BC9712D093D52A4C67B] @0305414C543100000000000E92A20000025E@~1274105565 line Each corresponds to one article Message of of ASCII thehash theHash: representation

• • • • • • Keep a record of current and recently expired articles expired recently and current of recorda Keep Format

  history (1)

Computer Center, CS, NCTU 20

ID -

FOx –

makehistory makehistory Be sure to stop innd and delete or zero out the existing database   Also can be used to rebuild the to overviewdatabaseAlso can be used rebuild Query the INN historytheviaINN Message databaseQuery server on the news is still articleif the the token Output use sm to retrievethearticleof By database historyrebuildINN or Initialize

• • • • • makehistory grephistory

  history (2)

Computer Center, CS, NCTU 21 INN Configurations

~news/etc/

2.5/install.html#S6 -

configured buffer files -

Similar Similar to timehash, but multiple articles are put in the same file Articles are stored in pre http://www.eyrie.org/~eagle/software/inn/docs Articles Articles are stored as individual text files, named by the article number, and divided up into directories based on the newsgroups name article in12345 cs.test wouldbe stored as cs/test/12345 Articles are stored as individual text files, and divided into directories based on the arrival time.

      INN can support all four at the same thesame time four cansupport atINN all timecaf cnfs and Disadvantages Advantages tradspool timehash

• • • • • • The supported storage formats storage The supported

 Article Article Storage Format

Computer Center, CS, NCTU 23

Stores overview data and index information into buffers, which are preconfigured files defined in buffindexed.conf, similar to CNFS buffers Slower for readers Stores overview data in a Berkeley DB database Fast and robust, but may require more disk space Uses two files per newsgroup,one containing the overview data and one containing the index Fast for readers, but slow to write to       ovdb tradindexed buffindexed

• • • Overview is for readers for is Overview mechanisms overview Three

  Overview Overview Storage Mechanism

Computer Center, CS, NCTU 24

innfeed.conf 、 overview.fmt

newsfeeds

、 outline

storage.conf

、 buffindexed.conf

… Expiration: expire.ctlExpiration: list:Moderators moderators report:INN innreport.conf subscriptions client:a new for subscriptions Default Peers: incoming.confPeers: readers.conf Readers: cycbuff.conf ovdb.conf

• • • • • • • • • Overview controls Other Storage Access controls Access

    Configration

Computer Center, CS, NCTU 25

[ ] [ ]

“College of Computer “College of Computer Science, NCTU” ovdb csnews2.cs.nctu.edu.tw news.cs.nctu.edu.tw

:

:

: See inn.conf(5) Default NNTP server for nnrpd,actsync, nntpget, getlist News servers within a particular organization to add a common identity It will be filled in the „Organization:‟ header forposts The overview mechanism (1)

– – – – – Extraoverviewhidden: server pathalias: extraoverviewadvertised: organization ovmethod       Feed Configuration Storage Article Most likely to needsetting to likelyMost Settings General

• • • • The primary general configuration file for all INN programs INNall for file configuration general The primary

 inn.conf

Computer Center, CS, NCTU 26

nnrpd keeps

and

is started

innd

scanlogs innd

true 3 true true false when

innwatch

:

:

cnfsstat

:

:

:

How many How many old logs Disable the Start For separately running „Sender:‟ Add header to local postscontaining the identity assigned by readers.conf (2)

– – – – – doinnwatch docnfsstat logcycles noreader nntpauthsender

    

Logging Posting Monitoring Reading • • • • inn.conf

Computer Center, CS, NCTU 27

"

" } " peer.nctu.edu.tw, 140.113.250.119" peer.nctu.edu.tw,

- .*,@local*

csie

"

.*,@cs.*,@ cis !*,freebsd.*,mailing.* connections: 8 } connections:

- *,@local* *,@ max

: " : {

Connections from hosts not listed in this file will be rejected or be handed willbe rejectedor this in from file hosts not listedConnections in readers.conf restrictions access the againstand checked to nnrpd off cs connections: 16 connections: connections: 16 connections: CSBBS { hostname: "bbs.cs.nctu.edu.tw, 140.113.168.8" } 140.113.168.8" "bbs.cs.nctu.edu.tw, hostname: { CSBBS

patterns: " patterns:

- - connections: 8 # per feed per # 8 connections: - • Three types of entries: key/value, peer, group peer, key/value, entries: of types Three Specify who are permitted to connect to your host and feed it articles it feed and host yourto connect to permitted are who Specify

patterns: " patterns: "news hostname: { NCTUPEER peer peer FREEBSD { hostname: "freebsd.cs.nctu.edu.tw, 140.113.17.209" "freebsd.cs.nctu.edu.tw, { hostname: FREEBSD peer max max patterns peer } } { peering group max group streaming: true # streaming allowed by default by allowed streaming # true streaming:   incoming.conf

Computer Center, CS, NCTU 28

separated list

-

list> -

between misc.foo and misc.bar

distrbution

/< ” vs. “misc.*,!misc.bar” .* crossposted comp.os misc.bar pattern> -

patterns patterns also support patterns "poison" (patterns starting with @) patterns can be specified in a comma /,,…

For a article For a article posted only to misc.bar *,!comp.*, “misc.*,@ pattern matching syntax » » » »

These are simple These are simple wildcard matches the using„*‟ as the wildmat The last pattern in the line that matches the groupname is used Patterns beginningwith ! mean to exclude groups matching that pattern wildmat – – – – – If you don't want a feed to receive articles from a certain source, then … wildmat field: field:

  st nd Organized as as of a seriesfeedOrganized entries „:‟ byseparatedfour fields of is composed entryEach 1 2

• • • • Determine how incoming articles are redistributed to your peers your to redistributed are articles incoming how Determine

 newsfeeds newsfeeds (1)

Computer Center, CS, NCTU 29

field

rd

innfeed.conf y" an an y" - 2.5/newsfeeds.html#S2 -

y -

.

to use the name of each feed as the as feed each of name the use to

\ innfeed foo innfeed innfeed .*/!

separatedflagsof list

- \

purpose parameter, meaning depends on in 3 theflags dependsmeaning purpose parameter, -

if you're using using you're if

! uunet

*:/home/news/bin/ y" as an option to to option an as y" funnel master. funnel -

http://www.eyrie.org/~eagle/software/inn/docs \

field: comma field: field: multi field: junk,!control,!control !

\  th rd Tc,Wnm Tm:innfeed 4 3 Uncomment " Add " without to; articles feed to host the of name needed. is file :!* : :*,! :

innfeed • • settings Site

Feeding peers via innfeed via peers Feeding

news.uu.net/ ## ## # innfeed ## ## ##   newsfeeds newsfeeds (2)

Computer Center, CS, NCTU 30

\ tw.bbs.campus.nctu

cs

\ nctu.talk overchan sqlite.pl sqlite.pl -

:/news/bin/ \

.* \

!

cs.cc mirrorpost,netnews.cs.nctu.edu.tw Tc,WnteO :/news/bin/archive

!/ SQLite - :/news/bin/mirrorpost.pl :/news/bin/mirrorpost.pl

nctu.talk,tw.bbs.campus.nctu Tc,Wn :!*,cs.*,@ : Tc,Wf :!*, :

archive_sqlite_cs # mirror # mirrorpost # News overview. News # overview!:*: Mirror nctu.talkand tw.bbs.campus.nctu News in overviewused true”News inn.confwhen “useoverchan: ArchiveCS

• • • Other examples Other

 newsfeeds newsfeeds (3)

Computer Center, CS, NCTU 31

\

name: bbs.cs.nctu.edu.tw } bbs.cs.nctu.edu.tw name: -

ip

y y in „innfeed!‟ entry in newsfeeds, then … -

!

connections: 2 connections: number: 7777 number: - - Tm:innfeed

:!*,cs.*,tw.bbs.*,twbbs.*,taiwan.*,nctu.*,mailing.*, :

streaming: false streaming: port { NCTUCSBBS peer max } group BBS { BBS group NCTUCSBBS/bbs.cs.nctu.edu.tw,BS2 In newsfeeds In innfeed.conf If you do not specify # body #   

peer { peer } „newsfeeds‟ as is thethesitename in same

• • Used to control the innfeed program innfeed the control to Used incoming.conf) (as group peer, key/value, entries: of types Three

  innfeed.conf

Computer Center, CS, NCTU 32

mail address address mail -

2.5/readers.conf.html#S4 -

step process step - (1)

http://www.eyrie.org/~eagle/software/inn/docs access: access: given the user's identity, what that user is permitted to do No way Noto way continue a line onthe next line, and noto way have a value longer than about 8,180characters auth: provides mechanisms to establish the identity of the user     determine theuser'spermissions determine Put all of the auth groups first, and all of the access groups below,of alltheauth last match first,thegroups accessgroups and allPut of likeby an e looks an authgroup,established as A user identity, "@“ theused one in the filelastmatchingto is When matchingaccessgroups : : groups Configuration

• • • • • readers.conf is a two is readers.conf Specify access control for nnrpdfor control access Specify groups configuration parameter/value, entries: of Twotypes

   readers.conf

Computer Center, CS, NCTU 33

, 2.5/readers.conf.html#S2 - cs.nctu.edu.tw *.

,

cs.nctu.edu.tw t"

- (2)

*.

: "EVERYWHERE" : "

bsd ident

domain "NCTUCSCC" domain: : "" : - - @EVERYWHER liuyh@NCTUCSCC nnrpdauthsender : " :    : " : http://www.eyrie.org/~eagle/software/inn/docs Generate the user identity like theuser Generate identity

cs.nctu.edu.tw default res default default hosts hosts: "*" hosts: • •

auth groupauth

sun*. } } { "NCTUCSCC"auth auth "EVERYWHERE"auth {  readers.conf

Computer Center, CS, NCTU 34

.*,!

csie.sysadmin N(NEWNEWS)

.*,! 、 .*,!junk" 2.5/readers.conf.html#S3 - cis.sysadmin A(Approver) 、 cis.bbs.admin .*,! .*,gmane.*,mailing.*" I(IHAVE)

.*,!csie.cc.*,! 、

P(Post)

(3) 、

local posting newsgroups, [jnx] local [jnx] posting newsgroups, in active) cs.help,freebsd - vs. read + post vs. read

: :

center.staff,!cis.syslog

cs.prsystem,!cs.cc - : "R" : : "*@*“ : : "!*, : http://www.eyrie.org/~eagle/software/inn/docs newsgroups R(read) access: L(post to non

users: "*@NCTUCS, *@NCTUCSCC, *@NCTUCISCC, *@NCTUCSIECC“ *@NCTUCISCC, *@NCTUCSCC, "*@NCTUCS, users: "RP" access: newsgroups access read users • • •

access group access

} "*,!control*,! cis.computer } { "CS" access access "READING_LIMIT" { "READING_LIMIT" access  readers.conf

Computer Center, CS, NCTU 35

largefiles -

enable --

is the length in(2GB=2097152) KB cycbuff:BIG80:/home/news/cycbuffs/BIG80:524288 cycbuff:BIG81:/home/news/cycbuffs/BIG81:524288 dd if=/dev/zero of=/home/news/cycbuffs/BIG80 bs=1kcount=524288 Mode: INTERLEAVE(default) or SEQUENTIAL metacycbuff:BIG8:BIG80,BIG81 No longer than 7 characters in , and than in 63       metacycbuff::[,,...][:] To use any sysbuff larger than 2GB: 2GB: largersysbuffTo use any than cycbuffupdate: refreshinterval: cycbuff:::

• • • • • Define the cyclical buffers that make up the storage pools for CNFS for pools storage the up make that buffers cyclical the Define Formats

  cycbuff.conf

Computer Center, CS, NCTU 36

trash 、 name

cnfs 、 metacycbuff

timecaf 255 to thestorage 255 identify - 、 >]

timecaf >]

, and

timehash

maxtime > > 、 > { >

maxsize > >[,<

timehash wildmat bool >[,< tradspool (1) : < :

>: a unique number in 0 number a unique >: >: mintime storage_class methodname minsize Used in expire.ctl,

newsgroups: < newsgroups: < class: < size: < expires: options: exactmatch 

methodname storage_class } method < method < < theto specifyfor CNFS only:

• • •

Contain the rules used to assign articles to different storage methods storage different to articles assign to used rules the Contain Format

  storage.conf

Computer Center, CS, NCTU 37

(2)

{

{ {

cnfs cnfs tradspool Anexample

newsgroups: comp.*,humanities.*,misc.*,news.*,rec.*,sci.*,soc.*,talk.* newsgroups: 2 class: BIG8 options: newsgroups: cs.cc.* newsgroups: 0 class:

newsgroups: cs.*, eecsep.*,nctu.* cs.*, newsgroups: 1 class: 0,8191 size: NCTUCS options:  storage.conf

}

} method

method } method

Computer Center, CS, NCTU 38

65535, is in KB is 65535, -

No longer used by INN sincebyv2.5No longerINN used and in inn.confextraoverviewhiddenUse extraoverviewadvertised Parameters for tuning ovdb, no needto modify Parameters for tuning ovdb, no to (similar cycbuff)entries :: uniquein 0 is

• • • • • overview.fmt buffinedxed.conf ovdb.conf

   overview

Computer Center, CS, NCTU 39

(delete from all groups) X

A(all) 、

U(unmoderated) 、

: : ! and not@ permitted, and only a single expression : M(moderated) if „groupbaseexpiry: false„ in inn.conf : defined in storage.conf, „*‟ to specify a default for all classes if „groupbaseexpiry: true„ in inn.conf (default) Last match – – – – – – : used as the expiration period formost articles ::: , , : decimal number days, offraction is allowed or „never‟ , : come into play with an „Expire:‟ header /remember/: ::::       History entries for expired or rejected articlesareentriesor remembered for rejected expiredHistory stored theserverArticles retainedon are

• • Default configuration file for expire and expireover, define how long how define andexpireover, expire for file configuration Default

 expire.ctl (1)

Computer Center, CS, NCTU 40

plus one. plus

artcutoff

.*:A:never:never:never

Anexample

 expire.ctl (2) example.*:A:1:90:90 example.project # retain moderated groups for a bit longer. bit a for groups moderated # retain *:M:1:30:365 forever. groups project local and time a long for groups local # Keep headers. Expires: ignoring weeks, two for stay articles # Most *:A:14:14:14 and year a to up for groups in moderated headers Expires: # Accept # Keep expired article history for 11 days, matching days, 11 for history article expired # Keep /remember/:11

Computer Center, CS, NCTU 41

‟ -

mail address mail

-

news.org -

center:[email protected] with all „.‟ in the name changed to „ More specific patterns should be listed before general patterns At most one „%s‟ may occur and be replaced the by name of the newsgroup, -

 

:

match for First a simple e
: • • •

Determine submission addresses for moderated newsgroups moderated for addresses submission Determine Format

  moderators fj.*:%[email protected] medlux.*:%[email protected] moderator database. master the to hierarchies publicother all Direct ## *:%[email protected] ## CS moderated newsgroup moderated CS ## cs.computer exceptions. with hierarchies Public ## ffm.*:%[email protected]

Computer Center, CS, NCTU 42

"innreport.css"; true; "Daily Usenet report formynews"; "Local contact: usenet@mynews";

html title footer html_css_url     section default: section

• appearance and content report for options of A lot Configuration file for innreport for file Configuration parameters Default

   innreport.conf

Computer Center, CS, NCTU 43 Control Messages

checkgroups 、

rmgroup 、

ftp://ftp.isc.org/pub/usenet/CONFIG/control.ctl  control control.cancel control.checkgroups control.newgroup control.rmgroup The actions of controlchan are determined bycontrol.ctl determined are controlchanof The actions newgroup

• • • • • • • control* Cancels are handled internally by INN internally handled are Cancels (newsfeeds) controlchan by processed are Others

   Control Messages (1)

Computer Center, CS, NCTU 45

import PGPKEYS import -- s ~/.gnupg~/etc/pgp s - ftp://ftp.isc.org/pub/pgpcontrol/PGPKEYS gpg $ ln $ Obviously perilous and control messages areforgedwidelyand messages perilous control Obviously PGP with messages control of their allsign hierarchies Many pgpverify)additionalwithout(using do how tothiscontrolchanknows configuration

• • • • • • PGP key import key PGP Authenticate control messages based on the „From:‟ header „From:‟ the on based messages control Authenticate

  Control Messages (2)

Computer Center, CS, NCTU 46 gate! gate! -

peer!ctu -

ID,Date,From,Sender -

back - 0700

-

sci.physics.acoustics

011Topics in acoustics and vibrations. acoustics in 011Topics

[email protected]> \ /OKujGsOs9wy1HQKZBErDIfxCf+XD6JenRccrBPAZoCMdS - sci.physics.acoustics

Subject,Control,Message [email protected] - newgroup

sci.physics.acoustics [email protected] - its.stanford.edu!bounce

- : 2.6.3a 2.6.3a : NqWqMug ID:

Sig

-

: csnews.cs.nctu.edu.tw control.newgroup:168581 csnews.cs.nctu.edu.tw :

PGP Control Messages (3) - 011vFU9B4Az+ew= 011=d9AE 011iOYqpW+WiF7pI6JaNzPaeS/Y3Dh7G9HRjjhuYbQ/+bTUHWeDItRFBbGVe 011TbQ/ 011iQCVAwUBS+79QsJdOtO4janBAQGNsAP7BAj2Vl4LS2RoIZmYTfHc9GFg/n sci.physics.acoustics \ \ Xref file: For your newsgroups \ 3t+yXEv \ FieztZe Date: Sat, 15 2010 May13:00:01 Sat, Date: Message X \ Fve8Hj From: group Newsgroups: Subject: Control: group Approved: Path: csnews2!csnews.cs.nctu.edu.tw!news.cs.nctu.edu.tw!ctu Path: news.nctu.edu.tw!newsfeed.berkeley.edu!ucberkeley!solaris.cc.vt.edu!news.vt .edu!guardian.oit.duke.edu!news.glorb.com!news2.glorb.com!usenet.stanford. edu!usenet

Computer Center, CS, NCTU 47

pgp_userid -

r verify -

、 8

-

8 mail - 、 log 、

drop

/localencoding/:utf /maxdocheckgroups/:*:*:10 doit /encoding/:*:nctu.*:big5 /encoding/:*:tw.*:big5 /encoding/:*:fido7.*:koi8 /encoding/:*:fido.*:utf :::         Checkgroups Encoding of messages newgroup Encodingand checkgroupscontrol Lastmatch Format … rmgroup, newgroup,checkgroups,all, : header the„From:‟ match : :

• • • • • • • control.ctl

 Control Messages (4)

Computer Center, CS, NCTU 48 More on INN control and operations

D" –

perm

-

pedantic -

f - v - c "/home/news/bin/nnrpd nnrpd" c "killall c "/home/news/bin/rc.news start" c "/home/news/bin/rc.news stop" c "/home/news/bin/rc.news - - - - a - fm news fm news fm fm news fm news fm - - - - su su $ inncheck$ su su

• • • • •

separately nnrpd runyou If /usr/local/etc/rc.d/innd Before starting, check the configurations the check starting, Before

   Start Start and Stop

Computer Center, CS, NCTU 50

Edit newsfeeds and corresponding innfeed.conf or nntpsend.ctl ctlinnd reload newsfeeds 'reason„ Edit incoming.conf $ ctlinnd reload incoming.conf 'reason„     To get your outgoing feeds working feeds outgoing yourTo get To get your incoming incoming feedsTo getyour working

• • When INN is running is INN When Using ctlinnd Using

  Reload the configurations

Computer Center, CS, NCTU 51

ctlinnd rmgroup Optional remove the description in db/newsgroups ctlinnd newgroup [ status [creator] ] theAdd description in db/newsgroups     Create Remove

• • Use ctlinnd Use Use control messages Use control

  Create/Remove Newsgroups

Computer Center, CS, NCTU 52

Processing innfeed dropped files with procbatch with files dropped innfeed Processing with filectlinndRenumbering theactive filethehistory with expire Rebuilding theanypathrundirectoryfound in Removing old socket files allit and mailingoutput the Collecting Producing a status report with a status reportinnstatProducing is keyword if the delayrm expirerm (with articles old news Removing specified) with theovervieweponymif thecorrespondingdatabaseexpireover Purging is specifiedkeyword with scanlogs thelog files log archived rotating Processing filesand

• • • • • • • • • Perform a number of important Usenet administrative functions administrative Usenet important of number a Perform

 news.daily

Computer Center, CS, NCTU 53

post mailing.freebsd.acpi" - mail message from from stdin message mail - mail message into a newsgroupa into message mail - acpi: "|/home/news/bin/mail acpi:

- Read a properly formattedReade a properly server to a news posting for inews to it Feed freebsd

• • • Normally, mailpost is run via mail aliases mail via run is mailpost Normally, A program to feed an e feed to A program

  mailpost

Computer Center, CS, NCTU 54

2.5/ 2.5/news.html - -

http://www.mixmin.net/cleanfeed/ http://www.eyrie.org/~eagle/software/inn/docs http://www.eyrie.org/~eagle/software/inn/docs http://www.eyrie.org/~eagle/faqs/inn.html

• • • •

Cleanfeed INN 2.x FAQINN 2.x INN 2.5 Documentation INN 2.5 information upgrade and INNchanges

    Further Further reading

Computer Center, CS, NCTU 55