Updated documentation

This commit is contained in:
Michiel Broek 2002-05-10 20:32:21 +00:00
parent e83107196f
commit ec002bcda5
8 changed files with 14 additions and 437 deletions

View File

@ -5,7 +5,7 @@
include ../Makefile.global include ../Makefile.global
H_BASE = basic.html date.html dist.html manual.css \ H_BASE = basic.html date.html dist.html manual.css \
flow.html postfix.html gwnews.html index.htm ups.html \ flow.html postfix.html index.htm ups.html \
intergate.html intro.html invoking.html faq.html \ intergate.html intro.html invoking.html faq.html \
known_bugs.html mgetty.html routing.html nodelist.html known_bugs.html mgetty.html routing.html nodelist.html
@ -56,7 +56,7 @@ H_MISC = misc/dropfile.html misc/fileid.html misc/index.htm \
misc/ftpserver.html misc/ipmailer.html misc/outbound.html \ misc/ftpserver.html misc/ipmailer.html misc/outbound.html \
misc/usleep.html misc/webserver.html misc/usleep.html misc/webserver.html
H_PROGS = programs/import.html programs/mbchat.html \ H_PROGS = programs/mbchat.html \
programs/mbfido.html programs/mbmon.html \ programs/mbfido.html programs/mbmon.html \
programs/mbtoberep.html programs/mblogin.html \ programs/mbtoberep.html programs/mblogin.html \
programs/index.htm programs/mbcico.html \ programs/index.htm programs/mbcico.html \

View File

@ -1,382 +0,0 @@
<HTML>
<!-- $Id$ -->
<HEAD>
<META http-equiv="Content-Type" content="text/html; charset=ISO 8859-1">
<META http-equiv="Content-Style-Type" content="text/css">
<META name="author" lang="en" content="Michiel Broek">
<META name="copyright" lang="en" content="Copyright Michiel Broek">
<META name="description" lang="en" content="MBSE BBS Manual">
<META name="keywords" lang="en" content="MBSE BBS, MBSE, BBS, manual, fido, fidonet, gateway, tosser, mail, tic, mailer">
<TITLE>MBSE BBS - Internet gateway - INN.</TITLE>
<LINK rel=stylesheet HREF="manual.css">
</HEAD>
<BODY>
<BLOCKQUOTE>
<h5>Last update 10-Apr-2001</h5>
<P>&nbsp;<P>
<H1 ALIGN="CENTER">MBSE BBS - Internet Gateway - INN.</H1>
<P>
<H3>SETUP INND</H3>
<P>
Below are the files that you need to setup for INN news. I used inn-2.2.2 on
my system. It is configured to install in /opt/news with the command
<strong>./configure --prefix=/opt/news</strong> during the installation of
inn.
<P>
<hr>
<pre>
<code>
## $Revision$
## inn.conf -- inn configuration data
## Format:
## <parameter>:<whitespace><value>
##
## See the inn.conf(5) man page for a full description of each
## of these options
##
## Blank values are allowed for certain parameters
## ---------------------------------
# All parameters must exist
#
organization: MBSE BBS Development Site
server: localhost
pathhost: news.mbse.nl
moderatormailer:
domain: mbse.nl
fromhost: news.mbse.nl
pathalias:
complaints: abuse@f2802.n280.z2.fidonet.org
mta: /usr/sbin/sendmail -oi %s
mailcmd: /opt/news/bin/innmail
checkincludedtext: false
maxforks: 10
maxartsize: 1000000
nicekids: 4
nicenewnews: 0
verifycancels: false
logcancelcomm: false
wanttrash: false
remembertrash: true
linecountfuzz: 0
peertimeout: 3600
clienttimeout: 600
allownewnews: true
localmaxartsize: 1000000
logartsize: true
logipaddr: true
logsitename: true
maxconnections: 50
artcutoff: 14
icdsynccount: 10
hiscachesize: 0
readertrack: false
strippostcc: false
status: 0
timer: 0
readerswhenstopped: false
noreader: false
extendeddbz: false
nnrpdoverstats: false
storeonxref: true
nnrpdcheckart: true
storemsgid: true
usecontrolchan: false
mergetogroups: false
backoffauth: false
backoffdb: /opt/news/db/backoff
backoffpostfast: 0L
backoffpostslow: 1L
backofftrigger: 10000L
mimeversion:
mimecontenttype:
mimeencoding:
refusecybercancels: false
activedenable: false
activedupdate: 30
activedport: 1119
nnrpperlauth: false
#
#
# These options are unlikely to need changing in most situations
#
chaninacttime: 600
chanretrytime: 300
pauseretrytime: 300
nntplinklog: false
nntpactsync: 200
badiocount: 5
blockbackoff: 120
#
# ---------------------------------
# Changing these options can have an effect on the way articles are
# stored and may require recreating the spool and/or database files
#
wireformat: false
xrefslave: false
nnrpdposthost:
nnrpdpostport: 119
spoolfirst: false
writelinks: true
storageapi: false
articlemmap: false
overviewmmap: true
bindaddress: all
sourceaddress: any
port: 119
#
## Keywords-in-overview options
## Enabling this without stopping innd and deleting the existing overview
## database and adding will probably confuse a lot of things. You must
## have compiled this support in too.
#
keywords: false
keylimit: 512
keyartlimit: 100000
keymaxwords: 250
#
# Other options
innflags:
doinnwatch: true
innwatchsleeptime: 600
pgpverify: false
controlfailnotice: false
logcycles: 3
innwatchpauseload: 1500
innwatchhiload: 2000
innwatchloload: 1000
innwatchspoolspace: 8000
innwatchbatchspace: 800
innwatchlibspace: 25000
innwatchspoolnodes: 200
docnfsstat: false
#
# ---------------------------------
# Paths to various aspects of the news system
#
pathnews: /opt/news
pathbin: /opt/news/bin
pathfilter: /opt/news/bin/filter
pathcontrol: /opt/news/bin/control
pathdb: /opt/news/db
pathetc: /opt/news/etc
pathrun: /opt/news/run
pathlog: /opt/news/log
pathhttp: /opt/news/log
pathtmp: /opt/news/tmp
pathspool: /opt/news/spool
patharticles: /opt/news/spool/articles
pathoverview: /opt/news/spool/overview
pathoutgoing: /opt/news/spool/outgoing
pathincoming: /opt/news/spool/incoming
patharchive: /opt/news/spool/archive
pathuniover: /opt/news/spool/uniover
overviewname: .overview
#
# ---------------------------------
#
</code>
</pre>
<hr>
<pre>
## $Revision$
## expire.ctl - expire control file
## Format:
## /remember/:&lt;keep&gt;
## &lt;patterns&gt;:&lt;modflag&gt;:&lt;keep&gt;:&lt;default&gt;:&lt;purge&gt;
## First line gives history retention; other lines specify expiration
## for newsgroups. Must have a "*:A:..." line which is the default.
## &lt;patterns&gt; wildmat-style patterns for the newsgroups
## &lt;modflag&gt; Pick one of M U A -- modifies pattern to be only
## moderated, unmoderated, or all groups
## &lt;keep&gt; Mininum number of days to keep article
## &lt;default&gt; Default number of days to keep the article
## &lt;purge&gt; Flush article after this many days
## &lt;keep&gt;, &lt;default&gt;, and &lt;purge&gt; can be floating-point numbers or the
## word "never." Times are based on when received unless -p is used;
## see expire.8
## If article expires before 14 days, we still remember it for 14 days in
## case we get offered it again. Depending on what you use for the innd
## -c flag and how paranoid you are about old news, you might want to
## make this 28, 30, etc.
/remember/:14
## Keep for 1-10 days, allow Expires headers to work.
*:A:1:10:never
fido.*:A:1:30:60
comp.*:A:1:30:60
local.*:A:1:30:60
nl.*:A:1:30:60
## Some particular groups stay forever.
# Keep FAQ's for a month, so they're always available
#*.answers:M:1:35:90
news.announce.*:M:1:35:90
# Some other recommendations. Uncomment if you want
# .announce groups tend to be low-traffic, high signal.
# *.announce:M:1:30:90
# Weather forecasts
# *.weather:A:1:2:7
# test posts
# *.test:A:1:1:1
## Some particular groups stay forever.
# dc.dining*:A:never:never:never
# uunet*:A:never:never:never
</pre>
<hr>
<pre>
## $Revision$
## Mailing addresses for moderators.
## Format:
## &lt;newsgroup&gt;:&lt;pathname&gt;
## First match found is used.
## &lt;newsgroup&gt; Shell-style newsgroup pattern or specific newsgroup
## &lt;pathname&gt; Mail address, "%s" becomes newgroup name with dots
## changed to dashes.
## Russian hierarchies
fido7.*:%s@fido7.ru
medlux.*:%s@news.medlux.ru
relcom.*:%s@moderators.relcom.ru
## Direct all public hierarchies to the master moderator database.
*:%s@moderators.isc.org
</pre>
<hr>
<pre>
## $Revision$
## newsfeeds - determine where Usenet articles get sent
## Format:
## site[/exclude,exclude...]\
## :pattern,pattern...[/distrib,distrib...]\
## :flag,flag...\
## :param
## Summary of flags:
## &lt;size Article must be less then size bytes.
## &gt;size Article must be more then size bytes.
## Aitems Article checks -- d (must have Distribution header)
## p (don't check for site in Path header)
## c (no control messages) C (only control messages)
## e (all groups must exist).
## Bhigh/low Internal buffer size before writing to output.
## Fname Name of the spool file.
## Gcount Crossposts limited to count groups.
## H[count] Article must have less then count hops; default is 1.
## Isize Internal buffer size (if a file feed)
## Nm Only moderated groups that match the patterns.
## Nu Only unmoderated groups that match the patterns.
## Ppriority Nice priority of channel or program feed.
## Ooriginator First field of X-Trace must match originator (wildmat).
## Ssize Start spooling if more than size bytes get queued.
## Ttype Feed types -- f (file) m (funnel; param names the
## real entry) p (pipe to program) c (send to stdin
## channel of param's sub-process) x (like c, but
## handles commands on stdin) x (log entry only).
## Witems What to write -- b (article bytesize) f (full path)
## g (first newsgroup) h (Message-ID hash)
## m (Message-ID) n (relative path) p (posted time)
## s (site that fed article) t (time received)
## * (names of funnel feed-in's or all sites that get
## the article) N (Newsgroups header) D (Distribution
## header) H (all headers) O (overview data)
## P (path header) R (replication information)
## Param field depends on T flag. For Tf, relative paths are from the
## out.going directory. For Tp and Tc, it is a shell command to execute.
## If a Tm refers to this entry (which will have its own T param) then "*"
## is expanded to all the funnel sites that triggered this one. Useful
## for spawning one mail process, e.g.
##
## This file is complicated -- see newsfeeds.5!
## This is the local site.
## The "pattern" field gives the initial subscription list for
## all other sites. You might want to put "!control,!junk,!<local>.*"
## there. The "distrib" subfield limits incoming articles.
##
## You can also have ME/bad.site: to refuse articles from a particular
## site (by matching the Path: entry). Other pseudo-sites may be put
## in here, to REFUSE certain types of 3rd-party cancel messages
## (See the "Cancel FAQ" news.admin.net-abuse.misc):
## cyberspam Spam cancels, munged articles, binary postings
## spewcancel just munged articles from runaway gateways
## bincancel just binary postings to non-binaries groups
##
## Note that refusing articles means you won't offer them to sites you feed
## Default of everything to everybody except for junk, control, anything
## with "local" as the newsgroup prefix (i.e. matches "localhost.stuff") or
## groups under foo. Articles posted to any group under alt.binaries.warez
## will not get propagated, even if they're cross posted to something that
## is.
ME\
:*,!junk,!control*,!foo.*/fido,local\
::
## news.wxs.nl via rpost (suck)
news.wxs.nl/news.wxs.nl:*,!control,!junk,!fido.*,!iba.*,!local.*/!local,!fido::
## News overview
# use this flag if storage api is used
#overview!:*:Tc,Ao,WhR,S30000:/opt/news/bin/overchan
# else
overview!:*:Tc,WO,S30000:/opt/news/bin/overchan
</pre>
<hr>
<pre>
## $Revision$
## distrib.pats -- specify default Distribution header for newsgroups
## Format:
## &lt;weight&gt;:&lt;pattern&gt;:&lt;value&gt;
## All articles are matched against all patterns, value to be used is the
## one with the highest weight.
## &lt;weight&gt; The weight assigned to this match, integer
## &lt;pattern&gt; Newsgroup name or single wildmat(3) pattern
## &lt;value&gt; Value of Distribution header.
##
##
## Uncomment to default all local.* groups to a distribution of local.
#10:local.*:local
10:local.*:local
10:fido.*:fido
</pre>
<hr>
<pre>
## $Revision$
## nnrp.access - access file for on-campus NNTP sites
## Format:
## &lt;host&gt;:&lt;perm&gt;:&lt;user&gt;:&lt;pass&gt;:&lt;groups&gt;
## &lt;host&gt;:&lt;/path/file&gt;
## Connecting host must be found in this file; the last match found is
## used, so put defaults first.
## &lt;host&gt; Wildcard name or IP address
## &lt;perm&gt; R to read; P to post
## &lt;user&gt; Username for authentication before posting
## &lt;pass&gt; Password, for same reason
## &lt;groups&gt; Newsgroup patterns that can be read or not read
## &lt;/path/file&gt; A second file to scan in the same format as this
## To disable posting put a space in the &lt;user&gt; and &lt;pass&gt; fields, since
## there is no way for client to enter one.
##
## Default is no access, no way to authentication, and no groups.
*::::!*
stdin:Read Post:::*
localhost:Read Post:::*
127.0.0.1:Read Post:::*
*.mbse.nl:Read Post:::*
</pre>
<hr>
<A HREF="./intergate.html"><IMG SRC="images/larrow.gif" ALT="Back" Border="0" width="40" height="30">Go back</A>
<A HREF="index.htm"><IMG SRC="images/b_arrow.gif" ALT="Home" Border="0" width="33" height="35">Go to main</A>
</BLOCKQUOTE>
</BODY>
</HTML>

View File

@ -16,7 +16,7 @@
<h1>MBSE BBS System Guide v0.33.20</h1> <h1>MBSE BBS System Guide v0.33.20</h1>
<HR> <HR>
<h5>Last update 10-Feb-2002</h5><BR><P> <h5>Last update 10-May-2002</h5><BR><P>
<h3><a NAME="top"></a>Introduction</h3> <h3><a NAME="top"></a>Introduction</h3>
@ -90,7 +90,6 @@
<li><a href="mgetty.html">Setup mgetty for the BBS</a></li> <li><a href="mgetty.html">Setup mgetty for the BBS</a></li>
<li><a href="programs/index.htm">Programs and utilities</a></li> <li><a href="programs/index.htm">Programs and utilities</a></li>
<ol> <ol>
<li><a href="programs/import.html">import, Import databases</a></li>
<li><a href="programs/mbaff.html">mbaff, Announce newfiles and filefind</a></li> <li><a href="programs/mbaff.html">mbaff, Announce newfiles and filefind</a></li>
<li><a href="programs/mball.html">mball, Allfiles and newfiles list creator</a></li> <li><a href="programs/mball.html">mball, Allfiles and newfiles list creator</a></li>
<li><a href="programs/mbchat.html">mbchat, Sysop to user chat utility</a></li> <li><a href="programs/mbchat.html">mbchat, Sysop to user chat utility</a></li>

View File

@ -12,7 +12,7 @@
</HEAD> </HEAD>
<BODY> <BODY>
<BLOCKQUOTE> <BLOCKQUOTE>
<h5>Last update 22-Jan-2002</h5> <h5>Last update 10-May-2002</h5>
<P>&nbsp;<P> <P>&nbsp;<P>
<H1 ALIGN="CENTER">MBSE BBS - Internet Gateway.</H1> <H1 ALIGN="CENTER">MBSE BBS - Internet Gateway.</H1>
@ -65,7 +65,6 @@ database for news with all the already existing news articles. If you skip
that, you may get a lot of old articles that will be gated. Just run that that, you may get a lot of old articles that will be gated. Just run that
command once after you have set this up. Later when you receive fresh articles command once after you have set this up. Later when you receive fresh articles
the command <strong>mbfido news</strong> will only gate new arrived articles. the command <strong>mbfido news</strong> will only gate new arrived articles.
See the configuration of <A HREF="gwnews.html">INN news configuration</A>.
In each mail area you can set the number of articles to get in one run. If you In each mail area you can set the number of articles to get in one run. If you
set this too high, mbfido will scan all headers on the newsserver for new set this too high, mbfido will scan all headers on the newsserver for new
articles. This can cost a lot of time. The best thing to do is to set this value articles. This can cost a lot of time. The best thing to do is to set this value

View File

@ -1,42 +0,0 @@
<HTML>
<!-- $Id$ -->
<HEAD>
<META http-equiv="Content-Type" content="text/html; charset=ISO 8859-1">
<META http-equiv="Content-Style-Type" content="text/css">
<META name="author" lang="en" content="Michiel Broek">
<META name="copyright" lang="en" content="Copyright Michiel Broek">
<META name="description" lang="en" content="MBSE BBS Manual">
<META name="keywords" lang="en" content="MBSE BBS, MBSE, BBS, manual, fido, fidonet, gateway, tosser, mail, tic, mailer">
<TITLE>MBSE BBS Programs - Import Configuration.</TITLE>
<LINK rel=stylesheet HREF="../manual.css">
</HEAD>
<BODY>
<BLOCKQUOTE>
<h5>Last update 30-Jan-2001</h5>
<P>&nbsp;<P>
<H1>import - Import Configuration.</H1>
<P>
<H3>Synopsis.</H3>
<P>
<code><strong>import</strong> [command]</code>
<P>&nbsp;<P>
<H3>Description.</H3>
<P>
<strong>import</strong> can be used to import the configuration databases from
plain ascii textfiles. This program is not supported. For the format of the
input files look in the source. This program will also not function properly
after 31-Dec-1999. If someone writes real good working conversion programs
to convert BBS, Tosser, Mailer setups to MBSE BBS setup, then make them
public available. On my BBS there is a utility to export RA2.02 databases to
the format that this <strong>import</strong> program can read.
<P>
<A HREF="index.htm"><IMG SRC="../images/larrow.gif" ALT="Index" Border="0">Back to index</A>&nbsp;
<A HREF="../index.htm"><IMG SRC="../images/b_arrow.gif" ALT="Main" Border="0">Back to Main index</A>
</BLOCKQUOTE>
</BODY>
</HTML>

View File

@ -12,14 +12,13 @@
</HEAD> </HEAD>
<BODY> <BODY>
<BLOCKQUOTE> <BLOCKQUOTE>
<h5>Last update 21-Jan-2002</h5> <h5>Last update 10-May-2002</h5>
<P>&nbsp;<P> <P>&nbsp;<P>
<h1>MBSE BBS Programs.</h1> <h1>MBSE BBS Programs.</h1>
<ol> <ol>
<li><A HREF="import.html">import, Import databases</A>
<li><A HREF="mbaff.html">mbaff, Announce newfiles and filefind</A> <li><A HREF="mbaff.html">mbaff, Announce newfiles and filefind</A>
<li><A HREF="mball.html">mball, Allfiles and newfiles list creator</A> <li><A HREF="mball.html">mball, Allfiles and newfiles list creator</A>
<li><A HREF="mbchat.html">mbchat, Sysop to user chat utility</A> <li><A HREF="mbchat.html">mbchat, Sysop to user chat utility</A>

View File

@ -12,7 +12,7 @@
</HEAD> </HEAD>
<BODY> <BODY>
<BLOCKQUOTE> <BLOCKQUOTE>
<h5>Last update 21-Jan-2002</h5> <h5>Last update 10-May-2002</h5>
<P>&nbsp;<P> <P>&nbsp;<P>
<H1>MBSE BBS Setup - File Echo's Setup - Hatch Manager.</H1> <H1>MBSE BBS Setup - File Echo's Setup - Hatch Manager.</H1>
@ -40,7 +40,8 @@ filenames are created in the same way as windows does.
<pre> <pre>
<strong>Mask </strong>The path and filename mask to search for. <strong>Mask </strong>The path and filename mask to search for.
"?" matches any character, "#" matches digits and "@" matches "?" matches any character, "#" matches digits and "@" matches
alpha characters. Don't use "*", this doesn't work! upper or lowercase letters. Except for the "@" the test is
case sensitive.
<strong>Area </strong>The area to hatch this file in. <strong>Area </strong>The area to hatch this file in.
<strong>Replace </strong>The filename to replace, ie. "nodelist.z*" <strong>Replace </strong>The filename to replace, ie. "nodelist.z*"
<strong>Magic </strong>The filerequest magic name, ie. "nodelist" <strong>Magic </strong>The filerequest magic name, ie. "nodelist"

View File

@ -12,7 +12,7 @@
</HEAD> </HEAD>
<BODY> <BODY>
<BLOCKQUOTE> <BLOCKQUOTE>
<h5>Last update 30-Jan-2001</h5> <h5>Last update 10-May-2002</h5>
<P>&nbsp;<P> <P>&nbsp;<P>
<H1>MBSE BBS Setup - File Echo's Setup - Magics Files Setup.</H1> <H1>MBSE BBS Setup - File Echo's Setup - Magics Files Setup.</H1>
@ -28,6 +28,8 @@ delete file (don't process it further) and execute a command. The edit screen
is different for all kinds of actions you select. More than one magic record is different for all kinds of actions you select. More than one magic record
may exist for each area. With all these actions you can for example can setup may exist for each area. With all these actions you can for example can setup
processing of nodediff's and unpacking nodelists in the nodelist directory. processing of nodediff's and unpacking nodelists in the nodelist directory.
If you use the execute command, you can only execute commands that are in the
directory $MBSE_ROOT/bin, ie. /opt/mbse/bin.
<P>&nbsp;<P> <P>&nbsp;<P>
<H3>Magics Setup.</H3> <H3>Magics Setup.</H3>
@ -35,7 +37,8 @@ processing of nodediff's and unpacking nodelists in the nodelist directory.
<pre> <pre>
<strong>Magic </strong>The action to perform, select with the spacebar. <strong>Magic </strong>The action to perform, select with the spacebar.
<strong>Filemask </strong>The filemask to scan for. "?" Matches all characters, <strong>Filemask </strong>The filemask to scan for. "?" Matches all characters,
"#" matches any digit and "@" any alpha character. "#" matches any digit and "@" any upper or lowercase letter.
Except for the "@" the test is case sensitive.
<strong>Active </strong>If this magic is active. <strong>Active </strong>If this magic is active.
<strong>Deleted </strong>If this magic must be deleted. <strong>Deleted </strong>If this magic must be deleted.
<strong>Area </strong>The area in which this magic is found. <strong>Area </strong>The area in which this magic is found.
@ -63,7 +66,7 @@ parts of the commandline. The following macro's are defined:
</pre> </pre>
<P> <P>
<IMG SRC="../images/magic.gif" width="589" height="343"> <IMG SRC="../images/magic.gif">
<P> <P>
<A HREF="tic.html"><IMG SRC="../images/larrow.gif" ALT="Back" Border="0">Back to File Echo's Setup</A>&nbsp; <A HREF="tic.html"><IMG SRC="../images/larrow.gif" ALT="Back" Border="0">Back to File Echo's Setup</A>&nbsp;