bbs/deb-mbse
Archived
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Updated documentation

Browse Source
This commit is contained in:
Michiel Broek 2002-01-07 22:11:33 +00:00
parent 355a13ac6a
commit 0ac8295887
8 changed files with 208 additions and 153 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
MBSE.FAQ
View File

@ -72,8 +72,13 @@ A: tail -f /opt/mbse/log/system.log or start mbmon.
1.6 How to start mbsebbs from inetd?
A: This is not possible anymore from version 0.33.19 and later.
A: You need to change the file /etc/inetd.conf. Change the line with
telnetd on it, on Linux:
telnet stream tcp nowait root /usr/sbin/tcpd in.telnetd -L /opt/mbse/bin/mblogin
on FreeBSD:
telnet stream tcp nowait root /usr/libexec/telnetd telnetd -p /opt/mbse/bin/mblogin
It may differ on some systems. After changing this file do a kill -HUP to
the inetd process and try.
FIDONET SETUP

2
html/Makefile
View File

@ -56,7 +56,7 @@ H_MISC = misc/dropfile.html misc/fileid.html misc/index.htm \
H_PROGS = programs/import.html programs/mbchat.html \
programs/mbfido.html programs/mbmon.html \
programs/mbtoberep.html \
programs/mbtoberep.html programs/mblogin.html \
programs/index.htm programs/mbcico.html \
programs/mbfile.html programs/mbmsg.html \
programs/mbseq.html programs/mbuser.html \

11
html/index.htm
View File

@ -2,7 +2,7 @@
<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="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">
@ -12,10 +12,10 @@
<BODY>
<BLOCKQUOTE>
<center><img SRC="images/mbse.jpg" BORDER=0></center>
<h1>MBSE BBS System Guide v0.33.18</h1>
<h1>MBSE BBS System Guide v0.33.19</h1>
<HR>
<h5>Last update 27-Sep-2001</h5><BR><P>
<h5>Last update 07-Jan-2002</h5><BR><P>
<h3><a NAME="top"></a>Introduction</h3>
@ -101,6 +101,7 @@
<li><a href="programs/mbfile.html">mbfile, Files database maintenance program</a></li>
<li><a href="programs/mbindex.html">mbindex, Nodelist index compiler</a></li>
<li><a href="programs/mblang.html">mblang, Language datafile compiler</a></li>
<li><a href="programs/mblogin.html">mblogin, Unix login replacement</a></li>
<li><a href="programs/mbmail.html">mbmail, Mail Transport Agent for email</a></li>
<li><a href="programs/mbmon.html">mbmon, The monitor program</a></li>
<li><a href="programs/mbmsg.html">mbmsg, The messagebase utility program</a></li>
@ -130,8 +131,8 @@
</ul>
<hr>
<a href=".."><img SRC="images/b_arrow.gif" ALT="Back" BORDER=0 height=35 width=33>Back</a>&nbsp;
<a href="#top"><img SRC="images/uarrow.gif" ALT="Top" BORDER=0 height=40 width=30>Top</a>
<a href=".."><img SRC="images/b_arrow.gif" ALT="Back" BORDER=0>Back</a>&nbsp;
<a href="#top"><img SRC="images/uarrow.gif" ALT="Top" BORDER=0>Top</a>
</blockquote>
</body>

24
html/mgetty.html
View File

@ -11,7 +11,7 @@
</HEAD>
<BODY>
<BLOCKQUOTE>
<h5>Last update 09-Dec-2001</h5>
<h5>Last update 07-Jan-2002</h5>
<P>&nbsp;<P>
<H1 ALIGN="CENTER">Setup mgetty for MBSE BBS</H1>
@ -135,8 +135,9 @@ init-chat "" ATZ OK AT&E714017198&W0 OK AT&B512 OK
# entry here, otherwise /bin/login will fail!
# This entry isn't really necessary: if it's missing, the built-in
# default will do exactly this.
# Here we replace the standard login with MBSE BBS login:
#
* - - /bin/login @
* - - /opt/mbse/bin/mblogin @
#
#
# end of login.config
@ -144,12 +145,11 @@ init-chat "" ATZ OK AT&E714017198&W0 OK AT&B512 OK
<HR>
<P>
Because we use /bin/login the users can get confused by the Unix login prompt.
Most of them are used to DOS based bbs systems and will try to login with
two names which won't work of course. For this reason I have added the
<strong>-i /opt/mbse/etc/issue</strong> options to the <strong>mgetty</strong>
line in /etc/inittab. The file /opt/mbse/etc/issue is a plain textfile
explaining users how to login to start the bbs. It could look like this:<br>
I have added the <strong>-i /opt/mbse/etc/issue</strong> options to the
<strong>mgetty</strong> line in /etc/inittab.
The file /opt/mbse/etc/issue is a plain textfile to give a small banner just
before the login prompt.
It could look like this:<br>
<pre>
.--. Welcome at MBSE BBS Development.
@ -161,15 +161,11 @@ explaining users how to login to start the bbs. It could look like this:<br>
\___)=(___/
Powered by Linux.
To register as a new user login with the name "bbs" without quotes.
Existing users must login with their unix name (one word).
Nieuwe gebruikers kunnen inloggen met "bbs" zonder aanhalingstekens.
Bestaande gebruikers moeten inloggen met hun unix naam (een woord).
</pre>
There is a default /opt/mbse/etc/issue installed by the installation script.
You need to edit this to insert your bbs name in it or even completely replace
this file for a nicer one. Don't make it too big, don't put control characters
in it as this may prevent some mailers to connect to your system.
or ANSI sequences in it as this may prevent some mailers to connect to your system.
<p>
I discovered that some systems don't have the right permissions on the serial
port for MBSE BBS. To fix this type the following commands:
@ -185,7 +181,7 @@ solution. If youre system allows it, try to add the the user <b>mbse</b> as
a legal user of your serial ports. Most distributions have some tool for this.
<p>
<A HREF="index.htm"><IMG SRC="images/b_arrow.gif" ALT="Back" Border="0"> Go Back</A>
<A HREF="index.htm"><IMG SRC="images/b_arrow.gif" ALT="Back" Border="0">Go Back</A>
</BLOCKQUOTE>
</BODY>
</HTML>

101
html/programs/index.htm
View File

@ -1,50 +1,51 @@
<HTML>
<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.</TITLE>
<LINK rel=stylesheet HREF="../manual.css">
</HEAD>
<BODY>
<BLOCKQUOTE>
<h5>Last update 06-Jun-2001</h5>
<P>&nbsp;<P>
<h1>MBSE BBS Programs.</h1>
<ol>
<li><A HREF="import.html">import, Import databases</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="mbchat.html">mbchat, Sysop to user chat utility</A>
<li><A HREF="mbcico.html">mbcico, The Fidonet mailer ala ifcico</A>
<li><A HREF="mbdiff.html">mbdiff, Nodelist difference processor</A>
<li><A HREF="mbfbgen.html">mbfbgen, FileBase Generator utility</A>
<li><A HREF="mbfido.html">mbfido, Fidonet mail and files procesor</A>
<li><A HREF="mbfile.html">mbfile, Files database maintenance program</A>
<li><A HREF="mbindex.html">mbindex, Nodelist index compiler</A>
<li><A HREF="mblang.html">mblang, Language datafile compiler</A>
<li><A HREF="mbmon.html">mbmon, The monitor program</A>
<li><A HREF="mbmsg.html">mbmsg, The messagebase utility program</A>
<li><A HREF="mbout.html">mbout, The mailer outbound program</A>
<li><A HREF="mbpasswd.html">mbpasswd, The passwd wrapper</A>
<li><A HREF="mbsebbs.html">mbsebbs, The bbs program</A>
<li><A HREF="mbseq.html">mbseq, Sequence number creator</A>
<li><A HREF="mbsetup.html">mbsetup, The setup program</A>
<li><A HREF="mbstat.html">mbstat, The bbs status change program</A>
<li><A HREF="mbtoberep.html">mbtoberep, The toberep.data lister</A>
<li><A HREF="mbuser.html">mbuser, The userbase maintenance program</A>
<li><A HREF="mbuseradd.html">mbuseradd, The adduser wrapper</A>
</ol>
<A HREF="../index.htm"><IMG SRC="../images/b_arrow.gif" ALT="Main" width="33" height="35" border="0"> Back to Main index</A>
</BLOCKQUOTE>
</BODY>
</HTML>
<HTML>
<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.</TITLE>
<LINK rel=stylesheet HREF="../manual.css">
</HEAD>
<BODY>
<BLOCKQUOTE>
<h5>Last update 07-Jan-2002</h5>
<P>&nbsp;<P>
<h1>MBSE BBS Programs.</h1>
<ol>
<li><A HREF="import.html">import, Import databases</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="mbchat.html">mbchat, Sysop to user chat utility</A>
<li><A HREF="mbcico.html">mbcico, The Fidonet mailer ala ifcico</A>
<li><A HREF="mbdiff.html">mbdiff, Nodelist difference processor</A>
<li><A HREF="mbfbgen.html">mbfbgen, FileBase Generator utility</A>
<li><A HREF="mbfido.html">mbfido, Fidonet mail and files procesor</A>
<li><A HREF="mbfile.html">mbfile, Files database maintenance program</A>
<li><A HREF="mbindex.html">mbindex, Nodelist index compiler</A>
<li><A HREF="mblang.html">mblang, Language datafile compiler</A>
<li><A HREF="mblogin.html">mblogin, Unix login replacement</A>
<li><A HREF="mbmon.html">mbmon, The monitor program</A>
<li><A HREF="mbmsg.html">mbmsg, The messagebase utility program</A>
<li><A HREF="mbout.html">mbout, The mailer outbound program</A>
<li><A HREF="mbpasswd.html">mbpasswd, The passwd wrapper</A>
<li><A HREF="mbsebbs.html">mbsebbs, The bbs program</A>
<li><A HREF="mbseq.html">mbseq, Sequence number creator</A>
<li><A HREF="mbsetup.html">mbsetup, The setup program</A>
<li><A HREF="mbstat.html">mbstat, The bbs status change program</A>
<li><A HREF="mbtoberep.html">mbtoberep, The toberep.data lister</A>
<li><A HREF="mbuser.html">mbuser, The userbase maintenance program</A>
<li><A HREF="mbuseradd.html">mbuseradd, The adduser wrapper</A>
</ol>
<A HREF="../index.htm"><IMG SRC="../images/b_arrow.gif" ALT="Main" border="0">Back to Main index</A>
</BLOCKQUOTE>
</BODY>
</HTML>

51
html/programs/mblogin.html Normal file
View File

@ -0,0 +1,51 @@
<HTML>
<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 - mblogin - Unix login replacement for MBSE BBS.</TITLE>
<LINK rel=stylesheet HREF="../manual.css">
</HEAD>
<BODY>
<BLOCKQUOTE>
<h5>Last update 07-Jan-2002</h5>
<P>&nbsp;<P>
<H1>mblogin - Unix login replacement for MBSE BBS.</H1>
<P>
<H3>Synopsis.</H3>
<P>
<code><strong>mblogin</strong> [-p] [-h hostname] [user]</code>
<P>&nbsp;<P>
<H3>Description.</H3>
<P>
<strong>mblogin</strong> replaces the standard Unix login program for MBSE BBS.
You can use this program from <strong>mgetty</strong> for modem/ISDN access,
or from <strong>inetd</strong> to allow telnet access.
This program logs in the systems syslog facility because the normal login
program does this too. It uses the file <code>/opt/mbse/etc/login.defs</code>
for the behaviour you prefere. All options in this file are well commented. It uses
the bbs user database to see who are allowed to login. Users can use their
Fidonet name, Unix name or Handle. If the name is found in the userbase, the
name is replaced with the real Unix name to do the password check and to start
the <strong>mbsebbs</strong> program. If the user is not found in the user base,
the user is asked if he wants to register as a new user. This behaviour can be
turned off. If the user uses the name <strong>bbs</strong> he will start the
<strong>mbnewusr</strong> program directly. All other users are not allowed to
login, not even root. If you change it in the file
<code>/opt/mbse/etc/login.defs</code> you may allow user <strong>mbse</strong>
to login. I advice against it, you should use <strong>ssh</strong> if you want
remote access to do maintenance.
<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>

134
html/programs/mbpasswd.html
View File

@ -1,66 +1,68 @@
<HTML>
<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 - mbuseradd - The useradd wrapper.</TITLE>
<LINK rel=stylesheet HREF="../manual.css">
</HEAD>
<BODY>
<BLOCKQUOTE>
<h5>Last update 31-Jan-2001</h5>
<P>&nbsp;<P>
<H1>mbpasswd - The password wrapper.</H1>
<P>
<H3>Synopsis.</h3>
<P>
<code><strong>mbpasswd</strong> [-opt] [username] [password]</code>
<P>&nbsp;<P>
<H3>Description.</h3>
<P>
<strong>mbpasswd</strong> is the wrapper for the <strong>passwd</strong> program
is present on all Linux systems. To use <b>passwd</b> to change the password of
another user is only allowed by <b>root</b>. The mbpasswd program overcomes this limitation.
The wrapper <b>mbpasswd</b> is run from the bbs by user <b>mbse</b> when an ordinary
user is logged in the bbs. The program is called when a new user logs in the bbs or
when an existing user changes his password. His password under Unix is then always the same as his
password in the bbs program. This is necessary for the user to be able to get
his email using the pop3 protocol.<P>
You never need to run <strong>mbpasswd</strong> by hand, in fact it is protected so that only
members of group <b>bbs</b> are allowed to use it.
<P>&nbsp;<P>
<H3>Environment.</H3>
<P>
<strong>mbpasswd</strong> must be installed setuid root and setgid root, ls -la looks like this:<br>
<pre>
-rws--s--x 1 root root 6644 Jun 26 21:23 /opt/mbse/bin/mbpasswd*
</pre>
<P>&nbsp;<P>
<H3>Commands.</H3>
<P>
<code><strong>mbpasswd</strong> [-opt] [username] [password]</code> for example:<br>
<pre>
mbpasswd -f michiel secret
</pre>
Valid options are <strong>-f</strong> (forced), this will also change locked passwords,
this has only effect if your system uses shadow passwords. If you use
<strong>-n</strong> as option, locked passwords cannot be changed. For a new user the
<b>-f</b> option is used by <b>mbsebbs</b>, when a user changes his own password the
<b>-n</b> option is used.
<P>
<A HREF="index.htm"><IMG SRC="../images/larrow.gif" ALT="Index" Border="0" width="40" height="30"> Back to index</A>&nbsp;
<A HREF="../index.htm"><IMG SRC="../images/b_arrow.gif" ALT="Main" Border="0" width="33" height="35"> Back to Main index</A>
</BLOCKQUOTE>
</BODY>
</HTML>
<HTML>
<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 - mbuseradd - The useradd wrapper.</TITLE>
<LINK rel=stylesheet HREF="../manual.css">
</HEAD>
<BODY>
<BLOCKQUOTE>
<h5>Last update 07-Jan-2002</h5>
<P>&nbsp;<P>
<H1>mbpasswd - The password wrapper.</H1>
<P>
<H3>Synopsis.</h3>
<P>
<code><strong>mbpasswd</strong> [-opt] [username] [password]</code>
<P>&nbsp;<P>
<H3>Description.</h3>
<P>
<strong>mbpasswd</strong> is the wrapper for the <strong>passwd</strong> program
is present on all Linux systems. To use <b>passwd</b> to change the password of
another user is only allowed by <b>root</b>. The mbpasswd program overcomes this limitation.
The wrapper <b>mbpasswd</b> is run from the bbs by user <b>mbse</b> when a new
user is being registered to set his password. It can also be started from the
bbs when an existing user changes his password. If you as sysop use
<strong>mbsetup</strong> to change a users password it will be used too.
His password under Unix is then always the same as his password in the bbs program.
This is necessary for the user to be able to get his email using the pop3 protocol.<P>
You never need to run <strong>mbpasswd</strong> by hand, in fact it is protected so that only
members of group <b>bbs</b> are allowed to use it. User <b>mbse</b> can use thsi
program and if you do, the password for a user are not in sync anymore.
<P>&nbsp;<P>
<H3>Environment.</H3>
<P>
<strong>mbpasswd</strong> must be installed setuid root and setgid root, ls -la looks like this:<br>
<pre>
-rws--s--x 1 root root 6644 Jun 26 21:23 /opt/mbse/bin/mbpasswd*
</pre>
<P>&nbsp;<P>
<H3>Commands.</H3>
<P>
<code><strong>mbpasswd</strong> [-opt] [username] [password]</code> for example:<br>
<pre>
mbpasswd -f michiel secret
</pre>
Valid options are <strong>-f</strong> (forced), this will also change locked passwords,
this has only effect if your system uses shadow passwords. This is used for new
users or from the <b>mbsetup</b> program to reset users passwords.<br>
If you use <strong>-n</strong> as option, locked passwords cannot be changed.
This mode is used when a user changes his password from the bbs.
<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>

29
html/setup/global.html
View File

@ -11,7 +11,7 @@
</HEAD>
<BODY>
<BLOCKQUOTE>
<h5>Last update 25-Dec-2001</h5>
<h5>Last update 07-Jan-2002</h5>
<P>&nbsp;<P>
<H1>MBSE BBS Setup - Global Setup</H1>
@ -74,17 +74,16 @@ Here you can enter 40 fidonet addresses. These are 5d addresses.
<strong>Unix path </strong>The Translated DOS path in real
<strong>LeaveCase </strong>Leave outbound .flo filenames as is, No forces to uppercase
</pre>
The DOS path and Unix path are translated for in and outbound mail sessions,
so the outside world will be happy. The DOS path is a fake, you can put
anything you like in there, but "C:\OUT" is a good choice. Note that
the TIC queue must be somewere in the Unix path, otherwise it is
If you fill in the DOS path then the DOS path and Unix path are translated
to DOS paths in the flo files for outbound mail sessions. You only need this if
another mailer uses the outbound that doesn't understand Unix paths.
The DOS path is a fake, but it must match the other mailer.
Note that the TIC queue must be somewere in the Unix path, otherwise it is
impossible to create a DOS path from the path to the TIC files in that
directory. To set this up correctly is also important if you use other mailers
as well, for example binkd, or even a DOS binkly-style mailer running from
a network. All those mailer must "see" the same file attaches in the .flo
files. If you leave the DOS path empty, no translation will be performed
and the Unix paths will be stored in the .flo files. This is the best setting
if mbsebbs is the only mailer running on your system and is the default.
files.
<P>
<h3>1.5. Edit BBS Configuration</H3>
@ -310,12 +309,12 @@ can set with 1.14.11:
define the mailer of your ISP as Smarthost. Incoming email will still come
from the UUCP gate. Users have email addresses like
<strong>user@f2802.m280.z2.fidonet.org</strong> Note, the username is their
Unix name.
Unix name. If you have your own maildomain, don't use this option, use the
next option:
<li><strong>Perm ISP</strong>. If you are permanent connected to the internet
either with a static or dynamic IP address use this option. Use this option
also if you have an UUCP domain and hav a dialup UUCP connection. You need to
register a DNS name and MX record for your system, if you don't you won't be able to
receive email from the internet and must use the previous Dial mode.
also if you have an UUCP domain and have a dialup UUCP connection. Also
you can use this for dialup if you have your own maildomain.
If you have a dynamic IP address you can still get a DNS name from for
example <A HREF="http://www.dynip.com">dynip.com</A>
Incoming email will come directly from the internet, but if someone sends
@ -455,9 +454,9 @@ there is no user authentication yet available.
</pre>
<P>
<A HREF="./"><IMG SRC="../images/larrow.gif" ALT="Back" Border="0" align="bottom" width="40" height="30"> Back to index</A>
<BR>
<A HREF="../"><IMG SRC="../images/b_arrow.gif" ALT="Home" Border="0" align="bottom" width="33" height="35"> Back to main index</A>
<A HREF="./"><IMG SRC="../images/larrow.gif" ALT="Back" Border="0" align="bottom">Back to index</A>
&nbsp;
<A HREF="../"><IMG SRC="../images/b_arrow.gif" ALT="Home" Border="0" align="bottom">Back to main index</A>
</BLOCKQUOTE>
</BODY>
</HTML>