From e494ac93c7fb35e7fcde301534c7b31e9e1443d6 Mon Sep 17 00:00:00 2001 From: Michiel Broek Date: Sun, 27 Jan 2002 14:59:50 +0000 Subject: [PATCH] Documentation updates --- ChangeLog | 3 ++ MBSE.FAQ | 11 ++---- html/misc/dropfile.html | 64 +++++++++++---------------------- html/misc/ftpserver.html | 73 +++++++++++++++++++------------------- html/misc/outbound.html | 9 ++--- html/programs/mblogin.html | 42 +++++++++++++++++++++- 6 files changed, 110 insertions(+), 92 deletions(-) diff --git a/ChangeLog b/ChangeLog index eb311f73..ef0e5ed7 100644 --- a/ChangeLog +++ b/ChangeLog @@ -4395,6 +4395,8 @@ v0.33.19 26-Oct-2001 Fixes for Sparc systems. System calls for archivers and virus scanners are replaced with execute. + During startup the username is tried from the environment + variables LOGNAME and USER. mbnewusr: 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. Password change on FreeBSD finally works. Moved to new sourcetree. + Ported to NetBSD. mblogin: New program. Replaces standard login, allows Fidonet style diff --git a/MBSE.FAQ b/MBSE.FAQ index 94756cd6..40cadf1b 100644 --- a/MBSE.FAQ +++ b/MBSE.FAQ @@ -23,7 +23,7 @@ MBSE Installation 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.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 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? -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. +A: This is described in the documentation of the mblogin program. + FIDONET SETUP diff --git a/html/misc/dropfile.html b/html/misc/dropfile.html index 1cb819f1..06893bf7 100644 --- a/html/misc/dropfile.html +++ b/html/misc/dropfile.html @@ -1,4 +1,5 @@ + @@ -11,7 +12,7 @@
-
Last update 22-Oct-2001
+
Last update 27-Jan-2002

 

BBS doors dropfiles.

@@ -20,7 +21,8 @@

Dropfiles for Unix BBS systems.

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.

 

DOOR.SYS format.

@@ -31,23 +33,23 @@ dates instead of the MM-DD-YY style. Newer doors sometimes need that. 
 Line	Description
 -----	-----------------------------------------------------------------
-1	Port, 5 characters in DOS format, p.e. COM1:
-2	Effective Baudrate
-3	Databits
+1	Port, 5 characters in DOS format, COM1: or COM0:
+2	Effective Baudrate, 19200 or 0 for COM0:
+3	Databits, always 8
 4	Nodenumber, 1..9999
-5	Locked baudrate
-6	Screen display, Y=snoop on, N=snoop off. On Linux allways N.
-7	Printer Y=on N=off
-8	Page Bell Y=on N=off
-9	Caller alarm Y=on N=off
+5	Locked baudrate, 19200 or tty portspeed for COM0:
+6	Screen display, Y=snoop on, N=snoop off, on Unix allways Y.
+7	Printer Y=on N=off, on Unix always N
+8	Page Bell Y=on N=off, on Unix allways Y
+9	Caller alarm Y=on N=off, on Unix allways Y
 10	Users first name and lastname
 11	Users location
 12	Voice/Home phone
 13	Work/Dataphone
-14	Password, empty if not available (stored coded).
+14	Users password.
 15	Security level, 0..32768
 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
 19	Time left in minutes
 20	ANSI, "GR" is yes, otherwise ?
@@ -55,25 +57,25 @@ Line	Description
 22	User mode, always N
 23	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
 27	Default protocol
 28	Users total number of uploads
 29	Users total number of downloads
 30	Users daily download kilobytes total
 31	Daily download kilobyte limit
-32	Users date of birth MM-DD-YY
-33	Path to users database files   Cannot be used on Linux.
-34	Path to message database files
+32	Users date of birth MM-DD-YY or MM-DD-YYYY
+33	Path to users database files, cannot be used on Unix
+34	Path to message database files, cannot be used on Unix
 35	Sysop first and last name
 36	Users handle
 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
 40	Always set to Y
 41	Text color as defined in setup 7 = gray.
 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
 45	Time of last call HH:MM
 46	Always set to 32768
@@ -86,31 +88,7 @@ Line	Description

 

-

DORINFOn.DEF dropfile.

-

-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. -

-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
-
-

- -Back Go Back +BackGo Back

diff --git a/html/misc/ftpserver.html b/html/misc/ftpserver.html index cabbf033..7228339f 100644 --- a/html/misc/ftpserver.html +++ b/html/misc/ftpserver.html @@ -1,4 +1,5 @@ + @@ -11,7 +12,7 @@
-
Last update 06-Jun-2001
+
Last update 27-Jan-2002

 

How to setup an FTP server to work with MBSE BBS.

@@ -26,36 +27,36 @@ may be another ftpd installed. Don't use mbftpd yet!

The filestructure I used is as follows:

-/var/spool/mbse/ftp/pub/dos_util/dos_4dos	- Public download areas
-               |   |   |        /dos_disk
-               |   |   |        /dos_file
-               |   |   /virnet/mcafee
-               |   |          /win16
-               |   |          /win32
-               |   /bin				- FTP bin directory
-               |   /etc				- FTP etc directory
-               |   /incoming			- FTP public upload.
-               /mail/out			- Your default outbound
-               |    /out.009			- Outbound Zone 9
-               |    /inbound			- Inbound directory
-               /raonly/upload			- Non-public download areas
-               |      /sysop
-               |      /logfiles
-               /tic_queue			- Queue for .tic files.
+/opt/mbse/ftp/pub/dos_util/dos_4dos	- Public download areas
+         |   |   |        /dos_disk
+         |   |   |        /dos_file
+         |   |   /virnet/mcafee
+         |   |          /win16
+         |   |          /win32
+         |   /bin			- FTP bin directory
+         |   /etc			- FTP etc directory
+         |   /incoming			- FTP public upload.
+         /var/bso/outbound		- Your default outbound
+             |   /outbound.009		- Outbound Zone 9
+             |   /inbound		- Inbound directory
+             /private/upload		- Non-public download areas
+             |       /sysop
+             |       /logfiles
+             /tic_queue			- Queue for .tic files.
-In order to give DOS style names for fidonet sessions you must set the -DOS path and Unix path in mbsetup (1.3.11 and 1.3.12) to -"m:" and "/var/spool/mbse". Note that to get +If another DOS/Windows style mailer has access to your MBSE outbound you must +set the DOS path and Unix path in mbsetup (1.4.12 and 1.4.13) to +"m:" and "/opt/mbse". Note that to get forwarding of .tic files to work the tic_queue must be a -subdirectory of "/var/spool/mbse" too. You could actually use any drive letter for -the DOS path. -

+subdirectory of "/opt/mbse" too. You could actually use any drive letter for +the DOS path.
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". - +Only use this if you need it!

+ 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 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. 

 Directory               	owner group mode perms
 ------------------------------- ----- ----- ---- ----------
-/var/spool/mbse			mbse  bbs   0755 drwxr-xr-x
-/var/spool/mbse/ftp		root  wheel 0555 dr-xr-xr-x
-/var/spool/mbse/ftp/bin		root  wheel 0555 dr-xr-xr-x
-/var/spool/mbse/ftp/bin/ls	root  bin   0111 ---x--x--x
-/var/spool/mbse/ftp/etc		root  root  0555 dr-xr-xr-x
-/var/spool/mbse/ftp/etc/passwd	root  root  0444 -r--r--r--
-/var/spool/mbse/ftp/etc/group	root  root  0444 -r--r--r--
-/var/spool/mbse/ftp/pub		mbse  bbs   0775 drwxrwxr-x
-/var/spool/mbse/ftp/incoming   	ftp   users 0755 drwxr-xr-x
+/opt/mbse			mbse  bbs   0755 drwxr-xr-x
+/opt/mbse/ftp			root  wheel 0555 dr-xr-xr-x
+/opt/mbse/ftp/bin		root  wheel 0555 dr-xr-xr-x
+/opt/mbse/ftp/bin/ls		root  bin   0111 ---x--x--x
+/opt/mbse/ftp/etc		root  root  0555 dr-xr-xr-x
+/opt/mbse/ftp/etc/passwd	root  root  0444 -r--r--r--
+/opt/mbse/ftp/etc/group		root  root  0444 -r--r--r--
+/opt/mbse/ftp/pub		mbse  bbs   0775 drwxrwxr-x
+/opt/mbse/ftp/incoming   	ftp   users 0755 drwxr-xr-x
Note that all subdirectories under ../pub also must be owned by mbse - and group bbs and have at least mode 775 as long + and group bbs and have at least mode 755 as long as it are real bbs subdirectories. The bbs will maintain these directories automatic and must have the rights to do so.

-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.

-Back Go Back +BackGo Back

diff --git a/html/misc/outbound.html b/html/misc/outbound.html index 2ea29459..837b8522 100644 --- a/html/misc/outbound.html +++ b/html/misc/outbound.html @@ -1,4 +1,5 @@ + @@ -11,7 +12,7 @@
-
Last update 02-Feb-2001
+
Last update 27-Jan-2002

 

Binkly style outbound documentation for MBSE BBS.

@@ -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 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 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 @@ -106,8 +108,7 @@ Note that this is a very simple document and that it is not even finished. -Back -Go Back +BackGo Back
diff --git a/html/programs/mblogin.html b/html/programs/mblogin.html index 395b9fbc..570b7a93 100644 --- a/html/programs/mblogin.html +++ b/html/programs/mblogin.html @@ -1,4 +1,5 @@ + @@ -11,7 +12,7 @@
-
Last update 07-Jan-2002
+
Last update 27-Jan-2002

 

mblogin - Unix login replacement for MBSE BBS.

@@ -41,6 +42,45 @@ login, not even root. If you change it in the file /opt/mbse/etc/login.defs you may allow user mbse to login. I advice against it, you should use ssh if you want remote access to do maintenance. +

 

+ +

How to use from telnetd.

+

+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: +

    +
  • Linux: edit the telnet line in /etc/inetd.conf:
    + telnet stream tcp nowait root /usr/sbin/tcpd in.telnetd -L /opt/mbse/bin/mblogin
    + After changing this file do a kill -HUP pid where pid is the pid of the + inetd process. +
  • FreeBSD: edit the telnet line in /etc/inetd.conf:
    + telnet stream tcp nowait root /usr/libexec/telnetd telnetd -p /opt/mbse/bin/mblogin
    + After changing this file do a kill -HUP pid where pid is the pid of the + inetd process. +
  • NetBSD: append a line in /etc/gettytab just below the line with the default + entry:
    + mbsebbs:cd:ck:np:lo=/opt/mbse/bin/mblogin:sp#38400:
    + The speed entry 38400 doesn't seem to be important. + Then edit the telnet line in /etc/inetd.conf:
    + telnetd stream tcp nowait root /usr/libexec/telnetd telnetd -g mbsebbs
    + After changing this file do a kill -HUP pid where pid is the pid of the + inetd process. +
+Now you can test it with telnet localhost or from another machine +with telnet your.machine.com. Check if you can still do other +logins such as ssh, rlogin and login on local consoles. +

 

+ +

How to use from mgetty

+

+This is described with the setup for mgetty.

IndexBack to index