Documentation updates

This commit is contained in:
Michiel Broek 2002-01-27 14:59:50 +00:00
parent 7750952ad5
commit e494ac93c7
6 changed files with 110 additions and 92 deletions

View File

@ -4395,6 +4395,8 @@ v0.33.19 26-Oct-2001
Fixes for Sparc systems. Fixes for Sparc systems.
System calls for archivers and virus scanners are replaced System calls for archivers and virus scanners are replaced
with execute. with execute.
During startup the username is tried from the environment
variables LOGNAME and USER.
mbnewusr: mbnewusr:
New program, run by user bbs. This is only to register a new New program, run by user bbs. This is only to register a new
@ -4406,6 +4408,7 @@ v0.33.19 26-Oct-2001
Added more checks to see if it's legal invoked. Added more checks to see if it's legal invoked.
Password change on FreeBSD finally works. Password change on FreeBSD finally works.
Moved to new sourcetree. Moved to new sourcetree.
Ported to NetBSD.
mblogin: mblogin:
New program. Replaces standard login, allows Fidonet style New program. Replaces standard login, allows Fidonet style

View File

@ -23,7 +23,7 @@ MBSE Installation
1.3 Will MBSE BBS ever be ported to DOS/Windows or OS/2? 1.3 Will MBSE BBS ever be ported to DOS/Windows or OS/2?
1.4 What does the guest switch in BBS user setup mean? 1.4 What does the guest switch in BBS user setup mean?
1.5 How do I monitor as the things happen? 1.5 How do I monitor as the things happen?
1.6 How to start mbsebbs from inetd. 1.6 How to start mbsebbs from inetd?
FidoNet Setup FidoNet Setup
2.1 The nodelist compiler crashes 2.1 The nodelist compiler crashes
@ -72,13 +72,8 @@ 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: You need to change the file /etc/inetd.conf. Change the line with A: This is described in the documentation of the mblogin program.
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

View File

@ -1,4 +1,5 @@
<HTML> <HTML>
<!-- $Id$ -->
<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">
@ -11,7 +12,7 @@
</HEAD> </HEAD>
<BODY> <BODY>
<BLOCKQUOTE> <BLOCKQUOTE>
<h5>Last update 22-Oct-2001</h5> <h5>Last update 27-Jan-2002</h5>
<P>&nbsp;<P> <P>&nbsp;<P>
<H1>BBS doors dropfiles.</H1> <H1>BBS doors dropfiles.</H1>
@ -20,7 +21,8 @@
<h3>Dropfiles for Unix BBS systems.</h3> <h3>Dropfiles for Unix BBS systems.</h3>
<p> <p>
Not all options that are available under DOS or OS/2 can be used with Unix Not all options that are available under DOS or OS/2 can be used with Unix
BBS systems and must be faked. BBS systems and must be faked. The doorfile is written in the users
homedirectory when the user starts a door.
<p>&nbsp;<P> <p>&nbsp;<P>
<h3>DOOR.SYS format.</h3> <h3>DOOR.SYS format.</h3>
@ -31,23 +33,23 @@ dates instead of the MM-DD-YY style. Newer doors sometimes need that.
<pre> <pre>
Line Description Line Description
----- ----------------------------------------------------------------- ----- -----------------------------------------------------------------
1 Port, 5 characters in DOS format, p.e. COM1: 1 Port, 5 characters in DOS format, COM1: or COM0:
2 Effective Baudrate 2 Effective Baudrate, 19200 or 0 for COM0:
3 Databits 3 Databits, always 8
4 Nodenumber, 1..9999 4 Nodenumber, 1..9999
5 Locked baudrate 5 Locked baudrate, 19200 or tty portspeed for COM0:
6 Screen display, Y=snoop on, N=snoop off. On Linux allways N. 6 Screen display, Y=snoop on, N=snoop off, on Unix allways Y.
7 Printer Y=on N=off 7 Printer Y=on N=off, on Unix always N
8 Page Bell Y=on N=off 8 Page Bell Y=on N=off, on Unix allways Y
9 Caller alarm Y=on N=off 9 Caller alarm Y=on N=off, on Unix allways Y
10 Users first name and lastname 10 Users first name and lastname
11 Users location 11 Users location
12 Voice/Home phone 12 Voice/Home phone
13 Work/Dataphone 13 Work/Dataphone
14 Password, empty if not available (stored coded). 14 Users password.
15 Security level, 0..32768 15 Security level, 0..32768
16 Users number of calls 16 Users number of calls
17 Users last call date MM-DD-YY 17 Users last call date MM-DD-YY or MM-DD-YYYY
18 Seconds remaining this call 18 Seconds remaining this call
19 Time left in minutes 19 Time left in minutes
20 ANSI, "GR" is yes, otherwise ? 20 ANSI, "GR" is yes, otherwise ?
@ -55,25 +57,25 @@ Line Description
22 User mode, always N 22 User mode, always N
23 Always blank 23 Always blank
24 Always blank 24 Always blank
25 Subscription expire date MM-DD-YY 25 Subscription expire date MM-DD-YY or MM-DD-YYYY
26 Users record number 26 Users record number
27 Default protocol 27 Default protocol
28 Users total number of uploads 28 Users total number of uploads
29 Users total number of downloads 29 Users total number of downloads
30 Users daily download kilobytes total 30 Users daily download kilobytes total
31 Daily download kilobyte limit 31 Daily download kilobyte limit
32 Users date of birth MM-DD-YY 32 Users date of birth MM-DD-YY or MM-DD-YYYY
33 Path to users database files Cannot be used on Linux. 33 Path to users database files, cannot be used on Unix
34 Path to message database files 34 Path to message database files, cannot be used on Unix
35 Sysop first and last name 35 Sysop first and last name
36 Users handle 36 Users handle
37 Next event starting time or "none" 37 Next event starting time or "none"
38 Error-free connection Y=Yes or N=No 38 Error-free connection Y=Yes or N=No, always Y
39 Always set to N 39 Always set to N
40 Always set to Y 40 Always set to Y
41 Text color as defined in setup 7 = gray. 41 Text color as defined in setup 7 = gray.
42 Always 0 42 Always 0
43 Last new files scan date MM-DD-YY 43 Last new files scan date MM-DD-YY or MM-DD-YYYY
44 Time of this call HH:MM 44 Time of this call HH:MM
45 Time of last call HH:MM 45 Time of last call HH:MM
46 Always set to 32768 46 Always set to 32768
@ -86,31 +88,7 @@ Line Description
</pre> </pre>
<P>&nbsp;<P> <P>&nbsp;<P>
<h3>DORINFOn.DEF dropfile.</H3> <A HREF="index.htm"><IMG SRC="../images/b_arrow.gif" ALT="Back" Border="0">Go Back</A>
<P>
The DORINFOn.DEF file is a 12 lines ascii textfile, each line terminated with
a cr/lf pair. All characters in the file are uppercase. The n in the filename
represents the current line number and will be between 1 and 9. Using number
1 seems always fine.
<pre>
Line Description
------ ------------------------------------------------------------------
1 System name
2 Sysop's first name
3 Sysop's last name
4 Port name, like COM1, COM2 etc. COM0 = local
5 Baudrate format: "19200 BAUD-R,N,8,1"
6 Always 0
7 Users firstname
8 Users lastname
9 Users location
10 Graphics mode: 0=no, 1=ANSI, 2=Avatar, 3=ANSI+Avatar
11 Security level, 0..32767
12 Time left in minutes
</pre>
<p>
<A HREF="index.htm"><IMG SRC="../images/b_arrow.gif" ALT="Back" Border="0" width="33" height="35"> Go Back</A>
</BLOCKQUOTE> </BLOCKQUOTE>
</BODY> </BODY>
</HTML> </HTML>

View File

@ -1,4 +1,5 @@
<HTML> <HTML>
<!-- $Id$ -->
<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">
@ -11,7 +12,7 @@
</HEAD> </HEAD>
<BODY> <BODY>
<BLOCKQUOTE> <BLOCKQUOTE>
<h5>Last update 06-Jun-2001</h5> <h5>Last update 27-Jan-2002</h5>
<P>&nbsp;<P> <P>&nbsp;<P>
<H1>How to setup an FTP server to work with MBSE BBS.</H1> <H1>How to setup an FTP server to work with MBSE BBS.</H1>
@ -26,36 +27,36 @@ may be another ftpd installed. <font color=red><u>Don't use mbftpd yet!</u></fon
<P> <P>
<H4>The filestructure I used is as follows:</H4> <H4>The filestructure I used is as follows:</H4>
<PRE> <PRE>
/var/spool/mbse/ftp/pub/dos_util/dos_4dos - Public download areas /opt/mbse/ftp/pub/dos_util/dos_4dos - Public download areas
| | | /dos_disk | | | /dos_disk
| | | /dos_file | | | /dos_file
| | /virnet/mcafee | | /virnet/mcafee
| | /win16 | | /win16
| | /win32 | | /win32
| /bin - FTP bin directory | /bin - FTP bin directory
| /etc - FTP etc directory | /etc - FTP etc directory
| /incoming - FTP public upload. | /incoming - FTP public upload.
/mail/out - Your default outbound /var/bso/outbound - Your default outbound
| /out.009 - Outbound Zone 9 | /outbound.009 - Outbound Zone 9
| /inbound - Inbound directory | /inbound - Inbound directory
/raonly/upload - Non-public download areas /private/upload - Non-public download areas
| /sysop | /sysop
| /logfiles | /logfiles
/tic_queue - Queue for .tic files. /tic_queue - Queue for .tic files.
</PRE> </PRE>
In order to give DOS style names for fidonet sessions you must set the If another DOS/Windows style mailer has access to your MBSE outbound you must
DOS path and Unix path in <strong>mbsetup</strong> (1.3.11 and 1.3.12) to set the DOS path and Unix path in <strong>mbsetup</strong> (1.4.12 and 1.4.13) to
<strong>"m:"</strong> and <strong>"/var/spool/mbse"</strong>. Note that to get <strong>"m:"</strong> and <strong>"/opt/mbse"</strong>. Note that to get
forwarding of .tic files to work the <strong>tic_queue</strong> must be a forwarding of .tic files to work the <strong>tic_queue</strong> must be a
subdirectory of "/var/spool/mbse" too. You could actually use any drive letter for subdirectory of "/opt/mbse" too. You could actually use any drive letter for
the DOS path. the DOS path.<BR>
<P>
This means that a fidonet file attach from the dos_4dos public download This means that a fidonet file attach from the dos_4dos public download
directory shall get the subject "M:\FTP\PUB\DOS_UTIL\DOS_4DOS\COMMAND.ZIP". directory shall get the subject "M:\FTP\PUB\DOS_UTIL\DOS_4DOS\COMMAND.ZIP".
Only use this if you need it!
<P> <P>
As you can see, anonymous ftp users can't get to the mail, non-public As you can see, anonymous ftp users can't get to the mail, non-public
downloads etc. Normally, your BBS users have unix accounts and will be able downloads etc. Normally, your BBS users have unix accounts and will be able
to do a ftp login and access any directory on your system. Because the bbs to do a ftp login and access any directory on your system. Because the bbs
@ -70,28 +71,28 @@ the man pages for the DARPA ftpd server.
<PRE> <PRE>
Directory owner group mode perms Directory owner group mode perms
------------------------------- ----- ----- ---- ---------- ------------------------------- ----- ----- ---- ----------
/var/spool/mbse mbse bbs 0755 drwxr-xr-x /opt/mbse mbse bbs 0755 drwxr-xr-x
/var/spool/mbse/ftp root wheel 0555 dr-xr-xr-x /opt/mbse/ftp root wheel 0555 dr-xr-xr-x
/var/spool/mbse/ftp/bin root wheel 0555 dr-xr-xr-x /opt/mbse/ftp/bin root wheel 0555 dr-xr-xr-x
/var/spool/mbse/ftp/bin/ls root bin 0111 ---x--x--x /opt/mbse/ftp/bin/ls root bin 0111 ---x--x--x
/var/spool/mbse/ftp/etc root root 0555 dr-xr-xr-x /opt/mbse/ftp/etc root root 0555 dr-xr-xr-x
/var/spool/mbse/ftp/etc/passwd root root 0444 -r--r--r-- /opt/mbse/ftp/etc/passwd root root 0444 -r--r--r--
/var/spool/mbse/ftp/etc/group root root 0444 -r--r--r-- /opt/mbse/ftp/etc/group root root 0444 -r--r--r--
/var/spool/mbse/ftp/pub mbse bbs 0775 drwxrwxr-x /opt/mbse/ftp/pub mbse bbs 0775 drwxrwxr-x
/var/spool/mbse/ftp/incoming ftp users 0755 drwxr-xr-x /opt/mbse/ftp/incoming ftp users 0755 drwxr-xr-x
</PRE> </PRE>
Note that all subdirectories under ../pub also must be owned by <strong>mbse Note that all subdirectories under ../pub also must be owned by <strong>mbse
</strong> and group <strong>bbs</strong> and have at least mode 775 as long </strong> and group <strong>bbs</strong> and have at least mode 755 as long
as it are real bbs subdirectories. The bbs will maintain these directories as it are real bbs subdirectories. The bbs will maintain these directories
automatic and must have the rights to do so. automatic and must have the rights to do so.
<P> <P>
In the /var/spool/mbse/ftp/etc/group file, add the group bbs so that your directory In the /opt/mbse/ftp/etc/group file, add the group bbs so that your directory
listings give the proper groupname instead of a number. listings give the proper groupname instead of a number.
<P> <P>
<A HREF="index.htm"><IMG SRC="../images/b_arrow.gif" ALT="Back" Border="0" width="33" height="35"> 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>

View File

@ -1,4 +1,5 @@
<HTML> <HTML>
<!-- $Id$ -->
<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">
@ -11,7 +12,7 @@
</HEAD> </HEAD>
<BODY> <BODY>
<BLOCKQUOTE> <BLOCKQUOTE>
<h5>Last update 02-Feb-2001</h5> <h5>Last update 27-Jan-2002</h5>
<P>&nbsp;<P> <P>&nbsp;<P>
<h1>Binkly style outbound documentation for MBSE BBS.</H1> <h1>Binkly style outbound documentation for MBSE BBS.</H1>
@ -76,7 +77,8 @@ Note that this is a very simple document and that it is not even finished.
.sts Node status file created by mbcico. These are data files containing .sts Node status file created by mbcico. These are data files containing
three values: three values:
1. 'time', this is the last call attempt time (in time_t format). 1. 'time', this is the time when a new call to this node is allowed.
(in time_t format).
2. 'retries', is the number of retries to try to connect that node. This 2. 'retries', is the number of retries to try to connect that node. This
field is zeroed when the call succeeds or when that node calls in. field is zeroed when the call succeeds or when that node calls in.
It is also zeroed when a new poll is created. Currently, mbcico stops It is also zeroed when a new poll is created. Currently, mbcico stops
@ -106,8 +108,7 @@ Note that this is a very simple document and that it is not even finished.
</PRE> </PRE>
<A HREF="index.htm"><IMG SRC="../images/b_arrow.gif" ALT="Back" Border="0" width="33" height="35"> <A HREF="index.htm"><IMG SRC="../images/b_arrow.gif" ALT="Back" Border="0">Go Back</A>
Go Back</A>
</BLOCKQUOTE> </BLOCKQUOTE>
</BODY> </BODY>
</HTML> </HTML>

View File

@ -1,4 +1,5 @@
<HTML> <HTML>
<!-- $Id$ -->
<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">
@ -11,7 +12,7 @@
</HEAD> </HEAD>
<BODY> <BODY>
<BLOCKQUOTE> <BLOCKQUOTE>
<h5>Last update 07-Jan-2002</h5> <h5>Last update 27-Jan-2002</h5>
<P>&nbsp;<P> <P>&nbsp;<P>
<H1>mblogin - Unix login replacement for MBSE BBS.</H1> <H1>mblogin - Unix login replacement for MBSE BBS.</H1>
@ -41,6 +42,45 @@ 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> <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 to login. I advice against it, you should use <strong>ssh</strong> if you want
remote access to do maintenance. remote access to do maintenance.
<P>&nbsp;<P>
<H3>How to use from telnetd.</H3>
<P>
If your system is connected to the internet you may want to let users login
using telnet. The changes you need to make are different for each operating
system mbse supports.
I will only describe how to use it from inetd, not xinetd.
When you make changes to your system to
change the telnet login, make sure you are already logged into your system as root
from another terminal. If you make a mistake and can't login anymore you will be
glad that you are still logged in on another terminal. Here are the tested
setups:
<UL>
<LI>Linux: edit the telnet line in /etc/inetd.conf:<BR>
<code>telnet stream tcp nowait root /usr/sbin/tcpd in.telnetd -L /opt/mbse/bin/mblogin</code><br>
After changing this file do a <b>kill -HUP pid</b> where pid is the pid of the
inetd process.
<LI>FreeBSD: edit the telnet line in /etc/inetd.conf:<BR>
<code>telnet stream tcp nowait root /usr/libexec/telnetd telnetd -p /opt/mbse/bin/mblogin</code><br>
After changing this file do a <b>kill -HUP pid</b> where pid is the pid of the
inetd process.
<LI>NetBSD: append a line in /etc/gettytab just below the line with the default
entry:<br>
<code>mbsebbs:cd:ck:np:lo=/opt/mbse/bin/mblogin:sp#38400:</code><br>
The speed entry 38400 doesn't seem to be important.
Then edit the telnet line in /etc/inetd.conf:<BR>
<code>telnetd stream tcp nowait root /usr/libexec/telnetd telnetd -g mbsebbs</code><br>
After changing this file do a <b>kill -HUP pid</b> where pid is the pid of the
inetd process.
</UL>
Now you can test it with <code>telnet localhost</code> or from another machine
with <code>telnet your.machine.com</code>. Check if you can still do other
logins such as ssh, rlogin and login on local consoles.
<P>&nbsp;<p>
<H3>How to use from mgetty</H3>
<P>
This is described with the setup for <A HREF="../mgetty.html">mgetty</A>.
<P> <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/larrow.gif" ALT="Index" Border="0">Back to index</A>&nbsp;