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? 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 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 \ H_PROGS = programs/import.html programs/mbchat.html \
programs/mbfido.html programs/mbmon.html \ programs/mbfido.html programs/mbmon.html \
programs/mbtoberep.html \ programs/mbtoberep.html programs/mblogin.html \
programs/index.htm programs/mbcico.html \ programs/index.htm programs/mbcico.html \
programs/mbfile.html programs/mbmsg.html \ programs/mbfile.html programs/mbmsg.html \
programs/mbseq.html programs/mbuser.html \ programs/mbseq.html programs/mbuser.html \

11
html/index.htm
View File

@ -2,7 +2,7 @@
<HEAD> <HEAD>
<META http-equiv="Content-Type" content="text/html; charset=ISO 8859-1"> <META http-equiv="Content-Type" content="text/html; charset=ISO 8859-1">
<META http-equiv="Content-Style-Type" content="text/css"> <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="copyright" lang="en" content="Copyright Michiel Broek">
<META name="description" lang="en" content="MBSE BBS Manual"> <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"> <META name="keywords" lang="en" content="MBSE BBS, MBSE, BBS, manual, fido, fidonet, gateway, tosser, mail, tic, mailer">
@ -12,10 +12,10 @@
<BODY> <BODY>
<BLOCKQUOTE> <BLOCKQUOTE>
<center><img SRC="images/mbse.jpg" BORDER=0></center> <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> <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> <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/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/mbindex.html">mbindex, Nodelist index compiler</a></li>
<li><a href="programs/mblang.html">mblang, Language datafile 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/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/mbmon.html">mbmon, The monitor program</a></li>
<li><a href="programs/mbmsg.html">mbmsg, The messagebase utility program</a></li> <li><a href="programs/mbmsg.html">mbmsg, The messagebase utility program</a></li>
@ -130,8 +131,8 @@
</ul> </ul>
<hr> <hr>
<a href=".."><img SRC="images/b_arrow.gif" ALT="Back" BORDER=0 height=35 width=33>Back</a>&nbsp; <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 height=40 width=30>Top</a> <a href="#top"><img SRC="images/uarrow.gif" ALT="Top" BORDER=0>Top</a>
</blockquote> </blockquote>
</body> </body>

24
html/mgetty.html
View File

@ -11,7 +11,7 @@
</HEAD> </HEAD>
<BODY> <BODY>
<BLOCKQUOTE> <BLOCKQUOTE>
<h5>Last update 09-Dec-2001</h5> <h5>Last update 07-Jan-2002</h5>
<P>&nbsp;<P> <P>&nbsp;<P>
<H1 ALIGN="CENTER">Setup mgetty for MBSE BBS</H1> <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! # entry here, otherwise /bin/login will fail!
# This entry isn't really necessary: if it's missing, the built-in # This entry isn't really necessary: if it's missing, the built-in
# default will do exactly this. # 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 # end of login.config
@ -144,12 +145,11 @@ init-chat "" ATZ OK AT&E714017198&W0 OK AT&B512 OK
<HR> <HR>
<P> <P>
Because we use /bin/login the users can get confused by the Unix login prompt. I have added the <strong>-i /opt/mbse/etc/issue</strong> options to the
Most of them are used to DOS based bbs systems and will try to login with <strong>mgetty</strong> line in /etc/inittab.
two names which won't work of course. For this reason I have added the The file /opt/mbse/etc/issue is a plain textfile to give a small banner just
<strong>-i /opt/mbse/etc/issue</strong> options to the <strong>mgetty</strong> before the login prompt.
line in /etc/inittab. The file /opt/mbse/etc/issue is a plain textfile It could look like this:<br>
explaining users how to login to start the bbs. It could look like this:<br>
<pre> <pre>
.--. Welcome at MBSE BBS Development. .--. 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. 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> </pre>
There is a default /opt/mbse/etc/issue installed by the installation script. 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 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 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> <p>
I discovered that some systems don't have the right permissions on the serial 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: 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. a legal user of your serial ports. Most distributions have some tool for this.
<p> <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> </BLOCKQUOTE>
</BODY> </BODY>
</HTML> </HTML>

7
html/programs/index.htm
View File

@ -2,7 +2,7 @@
<HEAD> <HEAD>
<META http-equiv="Content-Type" content="text/html; charset=ISO 8859-1"> <META http-equiv="Content-Type" content="text/html; charset=ISO 8859-1">
<META http-equiv="Content-Style-Type" content="text/css"> <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="copyright" lang="en" content="Copyright Michiel Broek">
<META name="description" lang="en" content="MBSE BBS Manual"> <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"> <META name="keywords" lang="en" content="MBSE BBS, MBSE, BBS, manual, fido, fidonet, gateway, tosser, mail, tic, mailer">
@ -11,7 +11,7 @@
</HEAD> </HEAD>
<BODY> <BODY>
<BLOCKQUOTE> <BLOCKQUOTE>
<h5>Last update 06-Jun-2001</h5> <h5>Last update 07-Jan-2002</h5>
<P>&nbsp;<P> <P>&nbsp;<P>
<h1>MBSE BBS Programs.</h1> <h1>MBSE BBS Programs.</h1>
@ -29,6 +29,7 @@
<li><A HREF="mbfile.html">mbfile, Files database maintenance program</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="mbindex.html">mbindex, Nodelist index compiler</A>
<li><A HREF="mblang.html">mblang, Language datafile 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="mbmon.html">mbmon, The monitor program</A>
<li><A HREF="mbmsg.html">mbmsg, The messagebase utility 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="mbout.html">mbout, The mailer outbound program</A>
@ -43,7 +44,7 @@
</ol> </ol>
<A HREF="../index.htm"><IMG SRC="../images/b_arrow.gif" ALT="Main" width="33" height="35" border="0"> Back to Main index</A> <A HREF="../index.htm"><IMG SRC="../images/b_arrow.gif" ALT="Main" border="0">Back to Main index</A>
</BLOCKQUOTE> </BLOCKQUOTE>
</BODY> </BODY>
</HTML> </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>

30
html/programs/mbpasswd.html
View File

@ -2,7 +2,7 @@
<HEAD> <HEAD>
<META http-equiv="Content-Type" content="text/html; charset=ISO 8859-1"> <META http-equiv="Content-Type" content="text/html; charset=ISO 8859-1">
<META http-equiv="Content-Style-Type" content="text/css"> <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="copyright" lang="en" content="Copyright Michiel Broek">
<META name="description" lang="en" content="MBSE BBS Manual"> <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"> <META name="keywords" lang="en" content="MBSE BBS, MBSE, BBS, manual, fido, fidonet, gateway, tosser, mail, tic, mailer">
@ -11,7 +11,7 @@
</HEAD> </HEAD>
<BODY> <BODY>
<BLOCKQUOTE> <BLOCKQUOTE>
<h5>Last update 31-Jan-2001</h5> <h5>Last update 07-Jan-2002</h5>
<P>&nbsp;<P> <P>&nbsp;<P>
<H1>mbpasswd - The password wrapper.</H1> <H1>mbpasswd - The password wrapper.</H1>
@ -27,13 +27,15 @@
<strong>mbpasswd</strong> is the wrapper for the <strong>passwd</strong> program <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 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. 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 The wrapper <b>mbpasswd</b> is run from the bbs by user <b>mbse</b> when a new
user is logged in the bbs. The program is called when a new user logs in the bbs or user is being registered to set his password. It can also be started from the
when an existing user changes his password. His password under Unix is then always the same as his bbs when an existing user changes his password. If you as sysop use
password in the bbs program. This is necessary for the user to be able to get <strong>mbsetup</strong> to change a users password it will be used too.
his email using the pop3 protocol.<P> 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 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. 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> <P>&nbsp;<P>
<H3>Environment.</H3> <H3>Environment.</H3>
@ -51,15 +53,15 @@ members of group <b>bbs</b> are allowed to use it.
mbpasswd -f michiel secret mbpasswd -f michiel secret
</pre> </pre>
Valid options are <strong>-f</strong> (forced), this will also change locked passwords, 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 this has only effect if your system uses shadow passwords. This is used for new
<strong>-n</strong> as option, locked passwords cannot be changed. For a new user the users or from the <b>mbsetup</b> program to reset users passwords.<br>
<b>-f</b> option is used by <b>mbsebbs</b>, when a user changes his own password the If you use <strong>-n</strong> as option, locked passwords cannot be changed.
<b>-n</b> option is used. This mode is used when a user changes his password from the bbs.
<P> <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/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" width="33" height="35"> Back to Main index</A> <A HREF="../index.htm"><IMG SRC="../images/b_arrow.gif" ALT="Main" Border="0">Back to Main index</A>
</BLOCKQUOTE> </BLOCKQUOTE>
</BODY> </BODY>
</HTML> </HTML>

29
html/setup/global.html
View File

@ -11,7 +11,7 @@
</HEAD> </HEAD>
<BODY> <BODY>
<BLOCKQUOTE> <BLOCKQUOTE>
<h5>Last update 25-Dec-2001</h5> <h5>Last update 07-Jan-2002</h5>
<P>&nbsp;<P> <P>&nbsp;<P>
<H1>MBSE BBS Setup - Global Setup</H1> <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>Unix path </strong>The Translated DOS path in real
<strong>LeaveCase </strong>Leave outbound .flo filenames as is, No forces to uppercase <strong>LeaveCase </strong>Leave outbound .flo filenames as is, No forces to uppercase
</pre> </pre>
The DOS path and Unix path are translated for in and outbound mail sessions, If you fill in the DOS path then the DOS path and Unix path are translated
so the outside world will be happy. The DOS path is a fake, you can put to DOS paths in the flo files for outbound mail sessions. You only need this if
anything you like in there, but "C:\OUT" is a good choice. Note that another mailer uses the outbound that doesn't understand Unix paths.
the TIC queue must be somewere in the Unix path, otherwise it is 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 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 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 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 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 files.
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.
<P> <P>
<h3>1.5. Edit BBS Configuration</H3> <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 define the mailer of your ISP as Smarthost. Incoming email will still come
from the UUCP gate. Users have email addresses like from the UUCP gate. Users have email addresses like
<strong>user@f2802.m280.z2.fidonet.org</strong> Note, the username is their <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 <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 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 also if you have an UUCP domain and have a dialup UUCP connection. Also
register a DNS name and MX record for your system, if you don't you won't be able to you can use this for dialup if you have your own maildomain.
receive email from the internet and must use the previous Dial mode.
If you have a dynamic IP address you can still get a DNS name from for 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> example <A HREF="http://www.dynip.com">dynip.com</A>
Incoming email will come directly from the internet, but if someone sends Incoming email will come directly from the internet, but if someone sends
@ -455,9 +454,9 @@ there is no user authentication yet available.
</pre> </pre>
<P> <P>
<A HREF="./"><IMG SRC="../images/larrow.gif" ALT="Back" Border="0" align="bottom" width="40" height="30"> Back to index</A> <A HREF="./"><IMG SRC="../images/larrow.gif" ALT="Back" Border="0" align="bottom">Back to index</A>
<BR> &nbsp;
<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/b_arrow.gif" ALT="Home" Border="0" align="bottom">Back to main index</A>
</BLOCKQUOTE> </BLOCKQUOTE>
</BODY> </BODY>
</HTML> </HTML>