*BEGIN WORDS VERSION=400/320 ENCODING=7BIT
<Applix Words>
<Globals levelIndent:0 hyphMethod:0 headerMargin:500 footerMargin:500 changeBar\
 Pos:0>
<start_styles>
<style "Normal" no-pageBreak no-keepWith no-block justifyLeft indentToLevel spe\
 llcheck firstIndent:0 leftIndent:0 rightIndent:0 lineSpacing:0 preParaSpacing:\
 0 postParaSpacing:0 level:0 hyphZone:0 hyphMinFrag:0  no-bold no-italic no-str\
 ikethru no-hidden no-caps no-underline no-hyphenate color:"Black" face:"Times \
 New Roman" size:10 position:0 tag:"" lB:0:0:"" rB:0:0:"" tB:0:0:"" bB:0:0:"" h\
 B:0:0:"" vB:0:0:"" shading:18:"":"":"" horizontalMargin:0 verticalMargin:0 dro\
 pShadow:0 localTabs  noFrame  >
<style "TOC" parent "Normal" nextStyle "TOC" >
<style "TOC-heading 1" parent "TOC" nextStyle "TOC-heading 1" indentToLevel lev\
 el:0 localTabs lT:0 rT:6000:". "  >
<style "TOC-heading 2" parent "TOC-heading 1" nextStyle "TOC-heading 2" indentT\
 oLevel firstIndent:250 level:1 localTabs lT:0 rT:6000:". "  >
<style "TOC-heading 3" parent "TOC-heading 2" nextStyle "TOC-heading 3" indentT\
 oLevel firstIndent:250 level:2 localTabs lT:0 rT:6000:". "  >
<style "toc 3" parent "toc 2" indentToLevel level:2  size:10 localTabs lT:5750:\
 "." rT:6000  >
<style "toc 2" parent "toc 1" indentToLevel firstIndent:500 leftIndent:500 righ\
 tIndent:500 level:1  size:10 localTabs lT:5750:"." rT:6000  >
<style "toc 1" parent "Normal" indentToLevel firstIndent:250 level:0  size:10 l\
 ocalTabs lT:5750:"." rT:6000  >
<style "footer" parent "Normal" indentToLevel level:0 localTabs cT:3000 rT:6000\
   >
<style "header" parent "Normal" indentToLevel level:0 localTabs cT:3000 rT:6000\
   >
<style "heading 3" parent "heading 2" indentToLevel firstIndent:250 level:2  bo\
 ld  >
<style "heading 2" parent "heading 1" indentToLevel level:1  no-underline face:\
 "Arial" size:14  >
<style "heading 1" parent "Normal" indentToLevel firstIndent:250 preParaSpacing\
 :167 level:0  bold underline face:"Arial" size:14  >
<style "Normal indent" parent "Normal" indentToLevel level:0  size:10  >
<color "Black0":0:0:0:255>
<color "Black":0:0:0:255>
<color "Blue":255:255:0:0>
<color "Cyan":255:0:0:0>
<color "Green":255:0:255:0>
<color "Magenta":0:255:0:0>
<color "Red":0:255:255:0>
<color "Yellow":0:0:255:0>
<color "White":0:0:0:0>
<color "Dark Blue":127:127:0:128>
<color "Dark Cyan":127:0:0:128>
<color "Dark Green":127:0:127:128>
<color "Dark Magenta":0:127:0:128>
<color "Dark Red":0:127:127:128>
<color "Dark Yellow":0:0:127:128>
<color "Dark Gray":0:0:0:128>
<color "Light Gray":0:0:0:63>
<end_styles>
<start_flow>
<WP400 "This file must be filtered to be read in WP 3.11">
<P "Normal" justifyCenter rightIndent:-500 >
<P "Normal" justifyCenter rightIndent:-500 >
<P "Normal" justifyCenter rightIndent:-500 >
<P "Normal" justifyCenter rightIndent:-500 >
<P "Normal" justifyCenter rightIndent:-500 >
<P "Normal" justifyCenter rightIndent:-500 >
<P "Normal" justifyCenter rightIndent:-500 >
<P "Normal" justifyCenter rightIndent:-500 >
<P "Normal" justifyCenter rightIndent:-500 >
<P "Normal" justifyCenter rightIndent:-500 >
<P "Normal" justifyCenter rightIndent:-500 >
<P "Normal" justifyCenter rightIndent:-500 >
<P "Normal" justifyCenter rightIndent:-500 >
<P "Normal" justifyCenter rightIndent:-500 >
<P "Normal" justifyCenter rightIndent:-500 >
<P "Normal" justifyCenter rightIndent:-500 >
<T "The Roman Catacombs" bold face:"Times New Roman" size:20 >
<P "Normal" justifyCenter rightIndent:-500 >
<T "BBS System for Linux" bold face:"Times New Roman" size:14 >
<P "Normal" justifyCenter rightIndent:-500 >
<T "v.1.0" bold face:"Times New Roman" size:14 >
<P "Normal" justifyCenter rightIndent:-500 >
<T "By Gregory Shaw" bold face:"Times New Roman" size:9 >
<P "Normal" justifyCenter rightIndent:-500 >
<T "shaw@manwe.fmsoft.com" face:"Times New Roman" size:7 >
<P "Normal" justifyCenter rightIndent:-500 >
<page_break>
<T "Table of Contents" bold face:"Times New Roman" size:14 >
<P "Normal" justifyCenter rightIndent:-500 >
<S_F>
<T "make_TOC -styles \"heading 3,heading 2,heading 1\" -dotTab">
<FV>
<T "Introduction^aj 3">
<P "TOC-heading 1">
<T "Background^aj 3">
<P "TOC-heading 2">
<T "Requirements^aj 4">
<P "TOC-heading 2">
<T "Multiline capabilities^aj 4">
<P "TOC-heading 2">
<T "External requirements^aj 4">
<P "TOC-heading 2">
<T "Design decisions^aj 4">
<P "TOC-heading 2">
<T "Where do I start?^aj 5">
<P "TOC-heading 2">
<T "Setup and Compilation^aj 5">
<P "TOC-heading 1">
<T "Adding the BBS User and BBS Group^aj 5">
<P "TOC-heading 3">
<T "Where to install?^aj 6">
<P "TOC-heading 2">
<T "Unpacking the archive^aj 6">
<P "TOC-heading 2">
<T "Installing Shadow Passwords^aj 7">
<P "TOC-heading 3">
<T "Selecting a different language^aj 7">
<P "TOC-heading 2">
<T "Selecting a language as a default^aj 8">
<P "TOC-heading 2">
<T "Compiling the System^aj 8">
<P "TOC-heading 2">
<T "Adding the 'new' user logon^aj 9">
<P "TOC-heading 2">
<T "Adding the 'bbs user' group^aj 9">
<P "TOC-heading 2">
<T "Basic Configuration^aj 10">
<P "TOC-heading 1">
<T "Linux FAQs^aj 10">
<P "TOC-heading 3">
<T "Modem configuration^aj 10">
<P "TOC-heading 3">
<T "Serial configuration^aj 10">
<P "TOC-heading 3">
<T "A warning about gettys^aj 11">
<P "TOC-heading 3">
<T "Initial Logon^aj 11">
<P "TOC-heading 3">
<T "Logon Scripts^aj 12">
<P "TOC-heading 3">
<T "Users^aj 13">
<P "TOC-heading 3">
<T "BBS Daemons^aj 14">
<P "TOC-heading 2">
<T "Advanced Configuration^aj 14">
<P "TOC-heading 1">
<T "The Options (bbsinfo) File^aj 14">
<P "TOC-heading 3">
<T "Card Usage^aj 17">
<P "TOC-heading 3">
<T "Automatic Validation^aj 18">
<P "TOC-heading 3">
<T "Re-Validation^aj 18">
<P "TOC-heading 3">
<T "System messages^aj 19">
<P "TOC-heading 3">
<T "Menus^aj 19">
<P "TOC-heading 3">
<T "Detailed Menu Command Definitions^aj 23">
<P "TOC-heading 3">
<T "Menu Macro Definition^aj 25">
<P "TOC-heading 3">
<T "Colorizing the BBS^aj 27">
<P "TOC-heading 3">
<T "Files Areas^aj 29">
<P "TOC-heading 3">
<T "CD-ROM Files Sections^aj 30">
<P "TOC-heading 3">
<T "Interfacing with External Programs^aj 31">
<P "TOC-heading 3">
<T "Uploading and Downloading^aj 31">
<P "TOC-heading 3">
<T "Using the Chat System^aj 32">
<P "TOC-heading 2">
<T "Testing and Normal Usage^aj 34">
<P "TOC-heading 1">
<T "Using the System^aj 34">
<P "TOC-heading 2">
<T "Security^aj 35">
<P "TOC-heading 1">
<T "How the BBS uses Unix security^aj 35">
<P "TOC-heading 2">
<T "Security Holes - external programs^aj 35">
<P "TOC-heading 2">
<T "Being a System Operator (SysOp)^aj 36">
<P "TOC-heading 1">
<T "SysOp Utilities^aj 36">
<P "TOC-heading 2">
<T "User Editing^aj 37">
<P "TOC-heading 2">
<T "Watching for Problems^aj 37">
<P "TOC-heading 2">
<T "Troubleshooting^aj 38">
<P "TOC-heading 1">
<T "Potential Problems^aj 38">
<P "TOC-heading 2">
<T "Additional Information^aj 38">
<P "TOC-heading 1">
<T "File Formats^aj 38">
<P "TOC-heading 2">
<T "Linking External Programs to your BBS^aj 40">
<P "TOC-heading 1">
<T "Useful programs^aj 40">
<P "TOC-heading 2">
<T "Using UQWK for offline Mail and News^aj 41">
<P "TOC-heading 2">
<T "^aj 41">
<P "TOC-heading 2">
<T "BBS Doors^aj 41">
<P "TOC-heading 2">
<T "Installing the BattleField^aj 41">
<P "TOC-heading 3">
<T "Other Information^aj 42">
<P "TOC-heading 1">
<T "How to connect to FIDONet^aj 42">
<P "TOC-heading 2">
<T "UUCP, Mail and News^aj 42">
<P "TOC-heading 2">
<T "To Do^aj 42">
<P "TOC-heading 2">
<T "More than two serial lines^aj 42">
<P "TOC-heading 2">
<T "Multiple Machines and Large Setups^aj 42">
<P "TOC-heading 2">
<T "Compiling the BBS for multiple machines^aj 42">
<P "TOC-heading 3">
<T "Using a restricted shell^aj 43">
<P "TOC-heading 3">
<T "Monitoring through IP sockets^aj 43">
<P "TOC-heading 3">
<T "Terminal Servers^aj 43">
<P "TOC-heading 3">
<T "The Roman Catacombs Setup^aj 44">
<P "TOC-heading 2">
<T "Updating from rocat 0.75^aj 45">
<P "TOC-heading 1">
<T "Updating from rocat 0.80^aj 45">
<P "TOC-heading 1">
<T "Updating from rocat-0.85^aj 46">
<P "TOC-heading 1">
<T "Updating from rocat-0.86^aj 46">
<P "TOC-heading 1">
<T "Updating from 0.90-0.92^aj 47">
<P "TOC-heading 1">
<T "Updating from 0.92^aj 47">
<P "TOC-heading 1">
<T "Updating from 0.95/0.96^aj 47">
<P "TOC-heading 1">
<T "BBS revision history (and future)^aj 48">
<P "TOC-heading 1">
<T "Conclusion^aj 48">
<P "TOC-heading 1">
<T "To Contact Me^aj 48">
<P "TOC-heading 1">
<E_F>
<page_break>
<T "Reading this Document">
<P "heading 1" rightIndent:-500 >
<T "^ajWhen reading this document, please keep in mind the following items:">
<P "Normal" rightIndent:-500 >
<P "Normal" leftIndent:250 rightIndent:-500 >
<T "^lh" face:"Symbol" >
<T "^ajI refer to the user as 'he' or occasionally 'she'.  I treat them both as\
  neuter in this case; my use of 'he' or 'she' is entirely arbitrary.  I unders\
 tand that a user (or the SysOp!) may be of any gender.">
<P "Normal" firstIndent:0 leftIndent:250 rightIndent:-500 >
<T "^lh" face:"Symbol" >
<T "^ajI try to explain items as well as possible.  If it is something tricky, \
 I try to put more description into the explanation.   ">
<P "Normal" firstIndent:0 leftIndent:250 rightIndent:-500 >
<T "Introduction" face:"Times New Roman" >
<P "heading 1" rightIndent:-500  face:"Times New Roman" >
<T "^ajWelcome to the newest (working) BBS package available for Linux (Unix)! \
  The Roman Catacombs BBS offers the following features:" face:"Times New Roman\
 " >
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "^lh" face:"Symbol" >
<T "^ajA familiar BBS interface for those who do not understand Unix." face:"Ti\
 mes New Roman" >
<P "Normal" firstIndent:0 leftIndent:250 rightIndent:-500 >
<T "^lh" face:"Symbol" >
<T "^ajBatch upload and download through the use of external protocols." face:"\
 Times New Roman" >
<P "Normal" firstIndent:0 leftIndent:250 rightIndent:-500 >
<T "^lh" face:"Symbol" >
<T "^ajAutomatic user addition to the BBS" face:"Times New Roman" >
<P "Normal" firstIndent:0 leftIndent:250 rightIndent:-500 >
<T "^lh" face:"Symbol" >
<T "^ajA very configurable BBS with many levels of security and access.">
<P "Normal" firstIndent:0 leftIndent:250 rightIndent:-500 >
<T "^lh" face:"Symbol" >
<T "^ajMultiline capabilities" face:"Times New Roman" >
<P "Normal" firstIndent:0 leftIndent:250 rightIndent:-500 >
<T "^lh" face:"Symbol" >
<T "^ajProfessional code quality with future maintenance in mind." face:"Times \
 New Roman" >
<P "Normal" firstIndent:0 leftIndent:250 rightIndent:-500 >
<T "^lh" face:"Symbol" >
<T "^ajAn integrated chat subsystem." face:"Times New Roman" >
<P "Normal" firstIndent:0 leftIndent:250 rightIndent:-500 >
<T "^lh" face:"Symbol" >
<T "^ajFull error logging.">
<P "Normal" firstIndent:0 leftIndent:250 rightIndent:-500 >
<T "^lh" face:"Symbol" >
<T "^ajColor">
<P "Normal" leftIndent:250 rightIndent:-500 >
<T "^lh" face:"Symbol" >
<T "^ajAn elegant design that allows many additional features to be added witho\
 ut requiring a major rewrite of the code." face:"Times New Roman" >
<P "Normal" firstIndent:0 leftIndent:250 rightIndent:-500 >
<P "Normal" leftIndent:250 rightIndent:-500 >
<T "And many many more features." face:"Times New Roman" >
<P "Normal" leftIndent:250 rightIndent:-500 >
<P "Normal" leftIndent:250 rightIndent:-500 >
<T "Background" face:"Times New Roman" >
<P "heading 2" rightIndent:-500  face:"Times New Roman" >
<T "^ajI've been running a BBS since late 1987.  I started on Macintosh compute\
 rs, and proceeded to write some externals for the BBS package that I was using\
 .  I wrote one game and a couple of utilities, most of which were shareware, w\
 hich brought in enough money to keep the habit going." face:"Times New Roman" \
 >
<P "Normal" rightIndent:-500 >
<T "^ajIn 1993, I got fed up with the Macintosh for two reasons:" face:"Times N\
 ew Roman" >
<P "Normal" rightIndent:-500 >
<T "1.  Any failure on the part of the BBS (generally) resulted in a system cra\
 sh.  This made the BBS very unreliable." face:"Times New Roman" >
<P "Normal" firstIndent:1000 leftIndent:1000 rightIndent:-500 >
<T "^aj^aj2.  The software was very limited and didn't do what I wanted to do w\
 ith a BBS." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "^ajAt that point, I was doing serious software development under Unix (Inte\
 ractive SysVr3.2 for the curious).  I was using C++, and thought that an objec\
 t oriented design for a BBS would allow a lot of flexibility.  So, I started d\
 eveloping a BBS." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajI cut over to the BBS package late in 1993.  It was a bit bare, and full\
  of bugs, but it was a usable BBS system.  I loved how any error in the BBS (e\
 .g. a crash) logged out the user, and reset the line for the 'next' caller rat\
 her than crashing the operating system." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajLate in the year, I got caught up in Linux.  One of the major problems w\
 ith writing the BBS for Interactive Unix was the number of users using the OS.\
   I didn't want to create a BBS for a very small market.  So, I cut over to Li\
 nux, and started the port." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajAfter a few months of pulling my hair out because POSIX is different tha\
 n BSD and SVID (and there are a few gaps in POSIX), I worked around most of th\
 e problems caused by POSIX.  " face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajFrom that time until the present, I've been adding features to the BBS. \
  I consider the BBS to be " face:"Times New Roman" >
<T "very" italic face:"Times New Roman" >
<T " reliable; I currently run a 3 line BBS with the software." face:"Times New\
  Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajOf course, I don't claim that the BBS is bug free.  " face:"Times New Ro\
 man" >
<T "Far from it!" bold face:"Times New Roman" >
<T "  I do claim, however, that the BBS is an excellent solution, and offers ma\
 ny options to a person wanting to setup a " face:"Times New Roman" >
<T "reliable, feature filled  " italic face:"Times New Roman" >
<T "BBS." face:"Times New Roman" >
<P "Normal" rightIndent:0 >
<T "Requirements" face:"Times New Roman" >
<P "heading 2" rightIndent:-500  face:"Times New Roman" >
<T "^ajThe BBS has very few requirements, machine wise.  Most of this has to do\
  with Linux.  If you can get Linux to run on your machine, and you've got a mo\
 dem, you can generally use the rocat system.  The basic requirements are:" fac\
 e:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj386 or better (preferably a DX)" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajModem" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajDevelopment system installed (GNU c and c++) (for compiling from scratch\
 )" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj5 megabytes of free disk space" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajFamiliar with basic Linux (Unix)" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajTCP/IP installed (minimally)" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajRoot privileges" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajMan pages installed" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajThe Linux  Frequently Asked Questions and HOWTOs available.">
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "Not required, but nice:" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj8 megabytes RAM or better (for compilation)" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajA 486 or better processor (for the chat system)" face:"Times New Roman" \
 >
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "Multiline capabilities" face:"Times New Roman" >
<P "heading 2" rightIndent:-500  face:"Times New Roman" >
<T "^ajDue to the inherent multi-user capabilities of Linux (Unix), it is possi\
 ble to have multiple persons using your BBS at the same time.  rocat was desig\
 ned to introduce very little system load on your BBS.  In most cases, should y\
 ou be using your machine for (real?) work, you will probably not notice that s\
 omeone is using your BBS." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "External requirements" face:"Times New Roman" >
<P "heading 2" rightIndent:-500  face:"Times New Roman" >
<T "^ajExternal programs are a major part of any BBS.  Due to the flexibility a\
 vailable in editors, news readers and mail systems, all of this capability has\
  been left out of the BBS, so that you can pick and choose your own 'flavor' o\
 f BBS.   The externals that are necessary are:" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajeditors (vi, emacs, pico, joe, ee ... pick your flavor)" face:"Times New\
  Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajmail readers (elm, mailx, mh ...)" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "Design decisions" face:"Times New Roman" >
<P "heading 2" rightIndent:-500  face:"Times New Roman" >
<T "^ajI made some design decisions regarding this BBS.  In other words, I want\
 ed the BBS to be what I envisioned to be the 'perfect' BBS for myself.  Some o\
 f the more esoteric features of some BBS packages haven't been built into roca\
 t simply because I didn't feel they were necessary for my BBS.  Some of the cr\
 itical design decisions were:" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "^ajThe Linux (Unix) system is used whenever possible.  This is due to the s\
 ophistication of the system (and those features) as a whole.  The following su\
 bsystems are not part of the BBS, but are expected to be used by the BBS:" fac\
 e:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^lh" face:"Symbol" >
<T "^ajMail (sendmail, smail, elm, mailx, etc.)" face:"Times New Roman" >
<P "Normal" firstIndent:750 leftIndent:250 rightIndent:-500 >
<T "^lh" face:"Symbol" >
<T "^ajNews (fido, Internet news)" face:"Times New Roman" >
<P "Normal" firstIndent:750 leftIndent:250 rightIndent:-500 >
<T "^lh" face:"Symbol" >
<T "^ajInternet Chatting (Internet Relay Chat (IRC))" face:"Times New Roman" >
<P "Normal" firstIndent:750 leftIndent:250 rightIndent:-500 >
<T "^lh" face:"Symbol" >
<T "^ajDownload protocols (rz, sz, kermit, xmodem, etc.)" face:"Times New Roman\
 " >
<P "Normal" firstIndent:750 leftIndent:250 rightIndent:-500 >
<T "^lh" face:"Symbol" >
<T "^aj" face:"Times New Roman" >
<T "Background processing (at, cron)">
<P "Normal" firstIndent:750 leftIndent:250 rightIndent:-500 >
<T "^lh" face:"Symbol" >
<T "^ajLogin facilities (getty, login, etc.)" face:"Times New Roman" >
<P "Normal" firstIndent:750 leftIndent:250 rightIndent:-500 >
<T "^lh" face:"Symbol" >
<T "^ajModem control (flow control)" face:"Times New Roman" >
<P "Normal" firstIndent:750 leftIndent:250 rightIndent:-500 >
<T "^lh" face:"Symbol" >
<T "^ajAccount Passwords" face:"Times New Roman" >
<P "Normal" firstIndent:750 leftIndent:250 rightIndent:-500 >
<P "Normal" firstIndent:750 leftIndent:250 rightIndent:-500 >
<T "^aj^ajThe BBS uses a modified 'system()' function.  This assumes that the c\
 ommand executed is available and will behave properly (e.g. an external will n\
 ot allow shell access)  This has been done to allow interfacing with external \
 system commands (see above).  This is also a HUGE security hole, if used impro\
 perly.">
<P "Normal" firstIndent:0 leftIndent:0 rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "Where do I start?" face:"Times New Roman" >
<P "heading 2" rightIndent:-500  face:"Times New Roman" >
<T "^ajConfiguring and administering a BBS is a lot of work.  I can't emphasize\
  this enough:  No matter how good the software, being a SysOp is a ">
<T "lot" bold >
<T " of work.  If you don't have a lot of time, you should stop reading this do\
 cument and go do something that requires less time  (write an encyclopedia, fo\
 r example).">
<P "Normal" rightIndent:-500 >
<T "^ajStill here?  Ok.  Let's say that you want to setup a minimal BBS ">
<T "right now" bold >
<T ".  Your boss (spouse?) is breathing down your neck with deadlines and reque\
 sts that this be ">
<T "quick" bold >
<T ".  To setup a minimal BBS, follow the following section up to the bbsinfo s\
 ection.  After that point, copy all of the menus from $BBSDIR/examples/menus t\
 o $BBSDIR/menus and you should have a working BBS.  This will give you a worki\
 ng BBS, however, I'd rather you not build a BBS with my menus.  I've worked ha\
 rd to establish a completely unique BBS; copies of the BBS running elsewhere d\
 etract from the unique nature of my BBS. (it's an artist-thing)">
<P "Normal" rightIndent:-500 >
<T "^ajOnce you've got a working BBS, be sure to consult the other sections to \
 the manual.  A basic BBS isn't what most people want; most people want a syste\
 m that is unique to their personality (or at least a unique system tailored to\
  the task at hand).  ">
<P "Normal" rightIndent:-500 >
<T "^ajI hope you enjoy what you're able to create from this BBS construction k\
 it.  Being a SysOp is very frustrating, irritating and all-around work.  But, \
 it can be one of the most rewarding jobs you'll ever have.  One message from a\
  user thanking you for your wonderful BBS can make all of you labors worthwhil\
 e.">
<P "Normal" rightIndent:-500 >
<T "Setup and Compilation" face:"Times New Roman" >
<P "heading 1" rightIndent:-500  face:"Times New Roman" >
<T "Adding the BBS User and BBS Group" face:"Times New Roman" >
<P "heading 3" rightIndent:-500  face:"Times New Roman" >
<T "^ajA BBS administrator login and BBS administrator group is necessary for t\
 he BBS to be installed correctly.  Do the following steps to add the BBS user \
 and group:" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj1.  su to root" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^ajsu" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^aj< enter root password >" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj2.  Execute the groupadd program in /usr/sbin" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^aj/usr/sbin/groupadd bbs" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj3.  Look at the file /etc/group.  There is a number in the third field t\
 hat is the GID (group id) for group BBS.  Remember this number, you'll need it\
  for adding the BBS Admin account." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^ajcat /etc/group" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj4.  Execute the adduser program in /sbin." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^aj/sbin/adduser " face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj5.  The name of the user should be 'bbs'." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj6.  The full name should be 'BBS Administrator', but can be anything you\
  like (BBS Admin, etc.)" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj7.  The GID should be the same as you saw in the /etc/group file above."\
  face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj8.  The UID (user id) can be anything, but I set mine up to start at 100\
 0.  Enter 1000." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj9.  The home directory should be /bbs/admin." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj10.  The shell can be your favorite shell (I prefer /bin/tcsh).  You'll \
 be using this account in the future, so use something that you're familiar wit\
 h." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj11.  Enter a password you can remember.  Please don't make it simple; cr\
 ackers LOVE to eat BBSs for breakfast (at 3am)." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj12.  In the unpacking step, the .cshrc and .profile for the BBS Administ\
 rator will be unpacked from the archive." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "NOTE: All further steps (unless otherwise noted) should be done by the BBS \
 Administrator account.  He will 'own' all of the files involved with the BBS, \
 so you should get used to being 'him' (or 'her').  You may get to that user by\
  the following command:" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajsu - bbs" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj< enter BBS Administrator password >" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "^ajOr, alternatively, you may login as 'bbs'." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "^aj(sub-note: don't do it until the BBS Administrator's account is availabl\
 e.  It won't be available until the next step is completed)" face:"Times New R\
 oman" >
<P "Normal" rightIndent:-500 >
<T "Where to install?" face:"Times New Roman" >
<P "heading 2" rightIndent:-500  face:"Times New Roman" >
<T "^ajInstallation of the BBS should be done on a separate disk partition, if \
 possible.  This allows the BBS to exist in it's own 'area'.  The following is \
 the setup of The Roman Catacombs BBS (my BBS):" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj/^ajboot disk" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj/usr^ajanother disk" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj/bbs^ajthe BBS disk." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "^ajThe BBS disk contains everything relating to the BBS, executables, heade\
 rs, files, etc." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajI'd recommend using a separate partition, if at all possible.  This will\
  allow the BBS to use the disk caching of the device." face:"Times New Roman" \
 >
<P "Normal" rightIndent:-500 >
<T "^ajIf that isn't possible, pick a place to install the bbs, and make a symb\
 olic link to /bbs." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajThis is accomplished by the following steps:" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^aj1.  mkdir my_bbs_dir" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^aj2.  cd /" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^aj3.  su (you need root privileges to make a link in the root directory\
 )" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^aj4.  ln -s path_to_my_bbs_dir/my_bbs_dir /bbs" face:"Times New Roman" \
 >
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "^ajYou'll also want to make sure that the BBS Administrator and the BBS gro\
 up own the BBS home directory:" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^ajchown bbs.bbs path_to_my_bbs_dir/my_bbs_dir" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "Unpacking the archive" face:"Times New Roman" >
<P "heading 2" rightIndent:-500  face:"Times New Roman" >
<T "^ajThe archive will come in a file named 'rocat-X.YY.tar.gz' or 'rocat-X.YY\
 .tgz', where X represents the major version and Y the minor version.  Both of \
 these filenames represent the same file compression.  To uncompress:" face:"Ti\
 mes New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj1.  su to the BBS Administrator (all files should be owned by the admini\
 strator):" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^ajsu bbs" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^aj<enter the BBS Administrator password>" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj2.  Copy the file to the BBS directory." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^ajcp /some_path/rocat-X.YY.tar.gz /bbs" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj3.  Change directory to /bbs" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^ajcd /bbs" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj4.  Untar the BBS.  " face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^ajtar xvfoz rocat-X.YY.tar.gz" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^ajNote:  If tar complains about 'unknown option z', you need to gunzip \
 the file prior to untarring the file:" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^ajgunzip rocat.tar" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^ajtar xvfo rocat-X.YY.tar">
<P "Normal" rightIndent:-500 >
<T "^aj5.  Change into the newly created directory." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^ajcd rocat-X.YY" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj6.  Move the entire structure back one directory." face:"Times New Roman\
 " >
<P "Normal" rightIndent:-500 >
<T "^aj^ajmv * .." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "^ajAt this point, much of the BBS structure will be created.  Additionally,\
  the BBS Administrator's setup information (.cshrc, .profile, etc) will be cop\
 ied to /bbs/admin.  You'll want to log out and log back in as the BBS Administ\
 rator before continuing the process. " face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "Installing Shadow Passwords" face:"Times New Roman" >
<P "heading 3" rightIndent:-500  face:"Times New Roman" >
<T "^ajIncluded with the BBS source is the source to the shadow-password suite.\
   By default, most Linux distributions do not include shadow passwords.  In th\
 e 1.0 release of rocat, shadow passwords are required by the BBS.  This result\
 s in a much more secure BBS system.  To install the shadow passwords, use the \
 following steps:">
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "^aj1. Change directory to the shadow source">
<P "Normal" rightIndent:-500 >
<T "^aj^ajcd /bbs/src/utilities/shadow-mk">
<P "Normal" rightIndent:-500 >
<T "^aj2.  Follow the directions in README.linux for installation.  The instruc\
 tions are very straightforward.">
<P "Normal" rightIndent:-500 >
<T "^aj3.  After you've installed the shadow passwords, make sure to do a 'make\
  clean' in the directory.  The .o (object) files are no longer necessary.">
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "Selecting a different language" face:"Times New Roman" >
<P "heading 2" rightIndent:-500  face:"Times New Roman" >
<T "^ajIf your BBS is going to be english only, you may skip this section.  The\
  BBS uses english by default." face:"Times New Roman" >
<P "Normal">
<T "^ajNew to version 0.86 of rocat is the ability to display text in any (avai\
 lable) language. ">
<P "Normal">
<T "^ajPrior to this time, changing the language that the BBS used meant going \
 through the BBS and changing every string to the other language.  In 0.86, I'v\
 e extracted all of the strings and replaced them with (hopefully meaningful) m\
 arkers.  If you'll notice, there is a lang directory found under the /bbs and \
 the /bbs/src directories.  This file contains a language file, " face:"Times N\
 ew Roman" >
<T "english" underline face:"Times New Roman" >
<T ", that is used as the default language." face:"Times New Roman" >
<P "Normal">
<T "^ajIf english is not your primary language, you may find language files shi\
 pped with the BBS.  Please note that these files are shipped as a basis for pe\
 rsons to use with their own BBS.  Most of these files are out of date (I am un\
 able to update them as I am not multilingual).  Due to this, you may want to l\
 ook at this file and update it to the current rocat revision.  " face:"Times N\
 ew Roman" >
<P "Normal">
<P "Normal">
<T "To create your own language file:" face:"Times New Roman" >
<P "Normal">
<T "^aj1.  Copy " face:"Times New Roman" >
<T "english" underline face:"Times New Roman" >
<T " to <your language>" face:"Times New Roman" >
<P "Normal">
<T "^aj2.  Go through the file, changing the strings to your language.  I'm sor\
 ry if the text isn't descriptive; it is descriptive in the context that it is \
 used.  I've tried to explain where to find the text as much as possible.  Note\
  that you can do whole ranges of text.  Where there are paragraphs in the file\
 , I've tried to put them together so that you can edit them as you'd like." fa\
 ce:"Times New Roman" >
<P "Normal">
<T "^aj3.  Edit the file /bbs/config/languages" face:"Times New Roman" >
<P "Normal">
<T "^aj4.  The file looks like the following:" face:"Times New Roman" >
<P "Normal">
<T "^aj^ajA|english|1|1.  English" face:"Times New Roman" >
<P "Normal">
<T "^aj^ajN|spanish|2|2.  Spanish" face:"Times New Roman" >
<P "Normal">
<T "^aj^aj..." face:"Times New Roman" >
<P "Normal">
<T "^aj^ajYou'll notice that this file is very close in format to the /bbs/conf\
 ig/protocols file." face:"Times New Roman" >
<P "Normal">
<T "^aj^aj" face:"Times New Roman" >
<T "Field" underline face:"Times New Roman" >
<T "^aj" face:"Times New Roman" >
<T "What" underline face:"Times New Roman" >
<P "Normal">
<T "^aj^aj1.^ajThe active flag.  An A means that the file is available and that\
  the user" face:"Times New Roman" >
<P "Normal">
<T "^aj^aj^ajshould be able to select that language.  Anything else is consider\
 ed" face:"Times New Roman" >
<P "Normal">
<T "^aj^aj^aja comment." face:"Times New Roman" >
<P "Normal">
<T "^aj^aj2.^ajThe name of the file found in /bbs/lang.  The name must match " \
 face:"Times New Roman" >
<T "exactly" bold face:"Times New Roman" >
<T ".  " face:"Times New Roman" >
<P "Normal">
<T "^aj^aj3.^ajThe key that will select that language." face:"Times New Roman" \
 >
<P "Normal">
<T "^aj^aj4.^ajThe text that will be shown to the user." face:"Times New Roman"\
  >
<P "Normal">
<T "^aj5.  Due to the object layout within the BBS, there are a number of strin\
 gs that cannot be dynamically selected.  Edit the file bbsstring.h found in /b\
 bs/src/lang.  The strings found in this file will be hard-coded into the BBS e\
 xecutable, so you'll want these strings to be as 'common' as possible.  Thankf\
 ully, there are only a few strings in the file." face:"Times New Roman" >
<P "Normal">
<T "^aj4.  Recompile.  The BBS should now be using the strings that you selecte\
 d in bbsstring.h.  If you log into the BBS as a new user, you'll be asked to s\
 elect a language." face:"Times New Roman" >
<P "Normal">
<T "^aj5.  " face:"Times New Roman" >
<T "Send the language file to me for inclusion into the BBS distribution." bold\
  face:"Times New Roman" >
<T "  Your file may be out of date with respect to BBS development, but it will\
  save another person hours of configuration and will serve as a starting point\
  for their language changes." face:"Times New Roman" >
<P "Normal">
<T "^aj" face:"Times New Roman" >
<T "Gotchas:" bold face:"Times New Roman" >
<P "Normal">
<T "^aj^aj" bold face:"Times New Roman" >
<T "Please watch out for the following problems when dealing with different lan\
 guages." face:"Times New Roman" >
<P "Normal">
<T "^aj^aj1.  The paragraphs in the languages file will have all whitespace aro\
 und them deleted.  So, everything will be left justified when shown to the use\
 r." face:"Times New Roman" >
<P "Normal">
<T "^aj^aj2.  If you're upgrading from 0.85, please see the section on upgradin\
 g.  The userlog file format has been changed." face:"Times New Roman" >
<P "Normal">
<T "^aj^aj3.  Make sure that every string in the english file has a counterpart\
  in your language file.  The BBS will continue to run if a string isn't found \
 (It will send an empty string), but that can be very cryptic to the users.  No\
 te that the BBS will log errors of this sort if at all possible." face:"Times \
 New Roman" >
<P "Normal">
<P "Normal">
<T "^ajNew to 0.90 is a german language file.  A warning:  You " face:"Times Ne\
 w Roman" >
<T "MUST " bold face:"Times New Roman" >
<T "check the language file against the current revision of the english file.  \
 I commonly add strings to the BBS while I am developing that are required for \
 new sections of the BBS.  As I stated before, I am not multilingual.  Due to t\
 his, I cannot update these files.  In other words, I'll include language files\
  with the distribution, however, " face:"Times New Roman" >
<T "you use these files at your own risk" underline face:"Times New Roman" >
<T "." face:"Times New Roman" >
<P "Normal">
<P "Normal">
<T "Selecting a language as a default" face:"Times New Roman" >
<P "heading 2" face:"Times New Roman" >
<T "^aj">
<T "You may want to forego the above and select a single language as your defau\
 lt language.  It doesn't need to be english.  To select english as your defaul\
 t language, edit " face:"Times New Roman" >
<T "bbs.h" underline face:"Times New Roman" >
<T " in the source area.  Change the 'undef' for the line that reads:" face:"Ti\
 mes New Roman" >
<P "Normal">
<T "^aj#undef ONE_LANGUAGE_ONLY" face:"Times New Roman" >
<P "Normal">
<T "^ajTo:" face:"Times New Roman" >
<P "Normal">
<T "^aj#define ONE_LANGUAGE_ONLY" face:"Times New Roman" >
<P "Normal">
<T "^aj" face:"Times New Roman" >
<P "Normal">
<T "^ajThis will make english the only language available.  It will not allow a\
  user to select a language." face:"Times New Roman" >
<P "Normal">
<T "^ajTo configure this for a different language, go through the previous sect\
 ion, but change the following line in  " face:"Times New Roman" >
<T "bbshdr.h." underline face:"Times New Roman" >
<T " " face:"Times New Roman" >
<P "Normal">
<T "^aj#define DEFAULT_LANGUAGE \"english\"" face:"Times New Roman" >
<P "Normal">
<T "^ajChange english to the filename of your language file." face:"Times New R\
 oman" >
<P "Normal">
<T "^ajNote that you can change the language loaded by the BBS by default (as s\
 een by a new user prior to being asked to choose a language) by changing the a\
 bove to your language file.  This will allow a new user to see the language th\
 at they are familiar with upon connecting for the first time." face:"Times New\
  Roman" >
<P "Normal">
<T "^ajNote also that changing the login.scr is necessary for language changes.\
   There are questions and other text within that script that need to be change\
 d for the BBS to be seen in another language.">
<P "Normal">
<T "Compiling the System" face:"Times New Roman" >
<P "heading 2" rightIndent:-500  face:"Times New Roman" >
<T "^ajCompiling the system is the easy part.  There is very little that needs \
 to be done prior to compiling the code.  There are some limits setup in the ma\
 in header file and spread out here and there in the code.  For the most part, \
 you won't need to mess with these settings.  If you really feel you need to mu\
 ck around with the code, feel free.  Be warned, however, that the rocat system\
  is a " face:"Times New Roman" >
<T "very" bold face:"Times New Roman" >
<T " complex beast, and a fickle one, if changed indiscriminately.  Save an ori\
 ginal copy of the BBS prior to making any changes." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajThe following steps should result in a set of BBS executables:" face:"Ti\
 mes New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj1.  cd to the src directory." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^ajcd src/rocat" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj2.  Do a 'make depend'.  This will generate include file dependencies." \
 face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^ajmake depend" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj3.  Do a make. This should start the build process." face:"Times New Rom\
 an" >
<P "Normal" rightIndent:-500 >
<T "^aj^ajmake" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajCome back in a couple minutes (on a Pentium with 20 megabytes of memory)\
  or a couple of hours (386SX-16 with 4 megabytes of memory).  " face:"Times Ne\
 w Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj4.  Do a 'make install'.  This will copy the files to their destinations\
 ." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^ajmake install" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj5.  Change to the root user.">
<P "Normal" rightIndent:-500 >
<T "^aj^ajsu">
<P "Normal" rightIndent:-500 >
<T "^aj^aj<enter root password>">
<P "Normal" rightIndent:-500 >
<T "^aj6.  Do a 'make anu.install'.  This will change the permissions on the 'a\
 nu' program to allow insertion of new user records to the passwd file.">
<P "Normal" rightIndent:-500 >
<T "^aj^ajmake anu.install">
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "Note:  You will get some messages.  \"Warning: ...\" messages are just that\
 ; warnings.  An error is something that causes the BBS to fail to build (\"Err\
 or: ...\")" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "If you get errors, make sure of the following:" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "^aj1.  The development system is installed.  This includes GNU C, GNU C++ a\
 nd GNU LIBG++.  rocat is written in C++, and requires all of the C++ facilitie\
 s to compile.  I recommend using the GNU compiler version 2.7.0 or higher.  In\
  particular, the 2.5.8 release of GCC has bugs, and will " face:"Times New Rom\
 an" >
<T "not" bold face:"Times New Roman" >
<T " build the BBS.  You may check your compiler version by typing:" face:"Time\
 s New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajgcc --version">
<P "Normal" rightIndent:-500 >
<T "^ajIt should come back with the version of the compiler.  In my case it is \
 '2.7.0'.">
<P "Normal" rightIndent:-500 >
<T "^aj2.  Your path has the compilers in it.  'make' depends on your path to e\
 xecute commands.  If you can't execute the command, make won't be able to exec\
 ute it either.  Your path should contain (at least) /bin, /usr/bin, and /usr/l\
 ocal/bin." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj3.  The bbs user owns the entire rocat directory structure.  If bbs does\
 n't own the directories, you won't be able to make any changes to the files an\
 d/or directories.  (and generally, things will be pretty broken from here on)"\
  face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "Adding the 'new' user logon" face:"Times New Roman" >
<P "heading 2" rightIndent:-500  face:"Times New Roman" >
<T "^aj">
<T "The 'new' user logon must be added to allow users to log into your BBS for \
 the first time.  To add the 'new' user logon, do the following steps." face:"T\
 imes New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj1.  su to root" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^ajsu" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^aj< enter root password >" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj2.  Enter the following command:">
<P "Normal" rightIndent:-500 >
<T "^aj^ajuseradd new -d /bbs -g bbs -s /bbs/scripts/login.scr -u 999">
<P "Normal" rightIndent:-500 >
<T "^aj^ajYou may use any number for the '999' number.  If 999 is in use on you\
 r system, use a different number.  (note: you should use a number above 500)">
<P "Normal" rightIndent:-500 >
<T "^aj3.  Delete the new users password.">
<P "Normal" rightIndent:-500 >
<T "^aj^ajvi /etc/passwd">
<P "Normal" rightIndent:-500 >
<T "^aj^aj/new:">
<P "Normal" rightIndent:-500 >
<T "^aj^aj/\\*">
<P "Normal" rightIndent:-500 >
<T "^aj^ajx">
<P "Normal" rightIndent:-500 >
<T "^aj^aj:wq!">
<P "Normal" rightIndent:-500 >
<T "^aj4.  Delete the information in the shadow file.">
<P "Normal" rightIndent:-500 >
<T "^aj^ajvi /etc/shadow">
<P "Normal" rightIndent:-500 >
<T "^aj^aj/new:">
<P "Normal" rightIndent:-500 >
<T "^aj^ajdd">
<P "Normal" rightIndent:-500 >
<T "^aj^aj:wq!">
<P "Normal" rightIndent:-500 >
<T "^aj^aj">
<P "Normal" rightIndent:-500 >
<T "^ajIf the information isn't deleted, the system will prompt for a new passw\
 ord for new -- but it won't allow it, basically not allowing anybody to log in\
 to your BBS for the first time!">
<P "Normal" rightIndent:-500 >
<T "Adding the 'bbs user' group" face:"Times New Roman" >
<P "heading 2" rightIndent:-500  face:"Times New Roman" >
<T "^aj^aj">
<T "The 'bbs' user group must be added to keep the BBS user's group different f\
 rom the 'BBS' group.  Many of the permissions on files are open to the 'bbs' g\
 roup.  Users should be part of the 'bbsusers' group so that, for example, shou\
 ld they get a interactive shell, they can't destroy your BBS (inadvertently or\
  no).  To add the 'bbs' user group, do the following steps." face:"Times New R\
 oman" >
<P "Normal" rightIndent:-500 >
<T "^aj1.  su to root" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^ajsu" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^aj< enter root password >" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj2.  Edit the file /etc/group" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^ajvi /etc/group">
<P "Normal" rightIndent:-500 >
<T "^aj3.  Add the following line:" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^ajbbsuser::105:">
<P "Normal">
<T "^ajThe group number (105) is entirely relative.  If 105 is in use on your s\
 ystem, use some other (unused) number.">
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "As new users log onto the BBS, the addbbsuser will assign them to the bbsus\
 er group.">
<P "Normal" rightIndent:-500 >
<P "Normal">
<T "Basic Configuration" face:"Times New Roman" >
<P "heading 1" rightIndent:-500  face:"Times New Roman" >
<T "Linux FAQs" face:"Times New Roman" >
<P "heading 3" rightIndent:-500  face:"Times New Roman" >
<T "^ajNote:  In the below configuration and examples, I'm assuming that you're\
  familiar with adding modems and configuring gettys.">
<P "Normal indent" rightIndent:-500 >
<T "^ajIf you're not familiar with these items, I recommend the Linux FAQs.  Th\
 ey're invaluable information for those starting from scratch.  The FAQs are av\
 ailable as part of the Slackware distribution, and, should you install them, a\
 re found in /usr/doc/faq.  If you don't use Slackware, and have access to news\
 , please look in the comp.news.answers newsgroup for Linux FAQs.">
<P "Normal indent" rightIndent:-500 >
<T "Modem configuration" face:"Times New Roman" >
<P "heading 3" rightIndent:-500  face:"Times New Roman" >
<T "^ajConfiguration of the modems is very important to the BBS.  If the modem \
 isn't configured correctly, the BBS will never know that there is a user on th\
 e system!">
<P "Normal indent" rightIndent:-500 >
<T "^ajAt this point, I'm using a ZyXEL U-1496+ on my BBS.  However, I won't go\
  into the configuration of the modem in detail; all you really need to know is\
  the generic parameters that are necessary for the modem to work.  I've includ\
 ed the items that are generic to most modems in parenthesis at the end of the \
 description.  The following are the key configuration items for your modem:">
<P "Normal indent" rightIndent:-500 >
<T "^aj">
<T "A GOOD MODEM CABLE" bold >
<T "  (one that has all pins straight through is the best)">
<P "Normal indent" rightIndent:-500 >
<T "^ajSerial speed (DTE-DCE) speed should be locked at 19.2Kbps or faster spee\
 d.  I lock my 28.8Kbps modems at 115Kbps.  (see the serial-HOWTO for more info\
 rmation)">
<P "Normal indent" rightIndent:-500 >
<T "^ajHardware flow control should be on.">
<P "Normal indent" rightIndent:-500 >
<T "^ajThe modem should reset upon loss of DTR. (AT&D3)">
<P "Normal indent" rightIndent:-500 >
<T "^ajThe modem should respond to carrier-detect (CD). (AT&C1)">
<P "Normal indent" rightIndent:-500 >
<T "^ajThe modem should answer the phone on the first ring. (ATS0=1)">
<P "Normal indent" rightIndent:-500 >
<T "^ajIf possible, error-free and data compression should be enabled.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajIt's possible (and sadly, probable) that some of the above items will go\
  by different names.">
<P "Normal indent" rightIndent:-500 >
<T "^ajRemember the speed you've locked the modem at.  You'll need it for the s\
 erial configuration.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "Serial configuration" face:"Times New Roman" >
<P "heading 3" rightIndent:-500  face:"Times New Roman" >
<T "^ajSerial configuration involves telling the computer where your modems are\
 , and, what speed they're running at.  At this point, I'm assuming you've got \
 your modem(s) configured, and are ready to test the logon capabilities of your\
  machine.">
<P "Normal indent" rightIndent:-500 >
<T "^ajSerial configuration involves the following steps:">
<P "Normal indent" rightIndent:-500 >
<T "^aj1.  Configuring the /etc/gettydefs file.">
<P "Normal indent" rightIndent:-500 >
<T "^aj2.  Turning on 'getty' processes for your modem.">
<P "Normal indent" rightIndent:-500 >
<T "^aj3.  Changing the /etc/issue file">
<P "Normal indent" rightIndent:-500 >
<T "^aj4.  Testing (if possible)">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "Configuration of the /etc/gettydefs file is easy.  Simply add the following\
  line to your gettydefs file:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "#  Modem locked at 38400:" face:"Courier" >
<P "Normal indent" rightIndent:-500  face:"Courier" >
<T "#" face:"Courier" >
<P "Normal indent" rightIndent:-500  face:"Courier" >
<T "38400# B38400 CS8 CRTSCTS # B38400 SANE -ISTRIP CRTSCTS #@S login: #38400" \
 face:"Courier" >
<P "Normal indent" rightIndent:-500  face:"Courier" >
<P "Normal indent" rightIndent:-500 >
<T "^ajOf course, if you are running at a different baud rate, you'll want to c\
 hange all occurrences in the above file to the baud rate you wish to use.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajTo turn on a 'getty' process for your modem, edit the /etc/inittab file.\
   In that file you should see something similar:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "# Serial lines" face:"Courier" >
<P "Normal indent" rightIndent:-500  face:"Courier" >
<T "s1:45:respawn:/etc/uugetty -t 90 ttyS0 38400" face:"Courier" >
<P "Normal indent" rightIndent:-500  face:"Courier" >
<T "s2:45:respawn:/etc/uugetty -t 90 ttyS1 38400" face:"Courier" >
<P "Normal indent" rightIndent:-500  face:"Courier" >
<P "Normal indent" rightIndent:-500 >
<T "^ajThe above two lines are for COM1 and COM2 ports (DOS-style).  The above \
 lines mean:">
<P "Normal indent" rightIndent:-500 >
<T "^aj1.  Spawn a 'getty' for the port ttyS0 running from the '38400' gettytab\
  entry when in run level 4 or 5.  ">
<P "Normal indent" rightIndent:-500 >
<T "^aj2.  If you get a carrier detect on the line, and nothing happens for 90 \
 seconds, go ahead and hang up the phone.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajNote:  Linux goes into run level 4 or 5 by default on most configuration\
 s.">
<P "Normal indent" rightIndent:-500 >
<T "^ajNote:  Make sure that the files /dev/ttyS0 and /dev/ttyS1 exist.  They s\
 hould look like this:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "crw-rw-rw-   1 root     root       4,  64 May 21 19:43 /dev/ttyS0" face:"Co\
 urier" >
<P "Normal indent" rightIndent:-500  face:"Courier" >
<T "crw-rw-rw-   1 root     root       4,  65 May 21 19:43 /dev/ttyS1" face:"Co\
 urier" >
<P "Normal indent" rightIndent:-500  face:"Courier" >
<P "Normal indent" rightIndent:-500 >
<T "^ajIf these files don't exist, the 'getty' program will error off, and you'\
 ll see errors on the console regarding the problem entry.  If they don't exist\
 , see the Linux FAQs for creating device files.">
<P "Normal indent" rightIndent:-500 >
<T "^ajIf you make any changes in the /etc/inittab file, be sure to issue a 'in\
 it q' command so that init will re-read the file and recognize the changes.">
<P "Normal indent" rightIndent:-500 >
<T "^ajNote:  For new users to log on (via the 'new' account), the tty line mus\
 t be entered in the /etc/securetty file.  The 'new' user runs as root, and wit\
 hout the securetty entry, root logon will be denied on that tty.  Do a 'man lo\
 gin' for more information.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajA default issue file can be found in /bbs/text/issue.  Edit this file an\
 d copy it to /etc/issue to activate the message prior to logon.  ">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajIf possible, you should have a friend log into your BBS.  If you have tr\
 ouble, please reference the FAQs about turning on dialup services.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "A warning about gettys" face:"Times New Roman" >
<P "heading 3" rightIndent:-500 >
<T "^ajMany people have been frustrated by gettys.  Over the past year, I've fo\
 und a few bugs in the gettys commonly available through Linux distributions.  \
 Should you be frustrated by getty not working correctly (for whatever reason),\
  please make sure you've got at least the following versions of getty:">
<P "Normal" rightIndent:-500 >
<T "^aj">
<T "Program" underline >
<T "^aj^aj">
<T "Distribution" underline >
<P "Normal" rightIndent:-500 >
<T "^ajgetty^aj^ajagetty-1.9.1a">
<P "Normal" rightIndent:-500 >
<T "^ajgetty^aj^ajgetty-ps-2.07f">
<P "Normal" rightIndent:-500 >
<T "^ajmgetty^aj^ajmgetty+sendfax-0.22">
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "^ajIf you are not sure about what versions you have (and I have no way to s\
 how what versions you have), please grab one of the above from ftp://sunsite.u\
 nc.edu/pub/Linux/system/serial.   You will save yourself much grief by using t\
 he latest versions.">
<P "Normal" rightIndent:-500 >
<T "Initial Logon" face:"Times New Roman" >
<P "heading 3" rightIndent:-500  face:"Times New Roman" >
<T "^ajThe initial logon process is documented below:">
<P "Normal indent" rightIndent:-500 >
<T "^aj1.  The user logs in as 'new'. ">
<P "Normal indent" rightIndent:-500 >
<T "^aj2.  The user is given a 'welcome to the BBS' message.">
<P "Normal indent" rightIndent:-500 >
<T "^aj3.  He is asked if he already has an account, and is unable to logon.">
<P "Normal indent" rightIndent:-500 >
<T "^aj4.  If this is the case, he's asked for some information, and is able to\
  send mail to the SysOp of the BBS.  He is then logged out.">
<P "Normal indent" rightIndent:-500 >
<T "^aj5.  If the above was not the case, he's shown a file (/bbs/text/bbswelco\
 me) describing the focus of the BBS.  ">
<P "Normal indent" rightIndent:-500 >
<T "^aj6.  He is asked \"Would you like to become part of the BBS?\".">
<P "Normal indent" rightIndent:-500 >
<T "^aj7.  If anything other than 'Yes' (or something starting with 'y') is ent\
 ered, he is logged out.">
<P "Normal indent" rightIndent:-500 >
<T "^aj8.  He is then asked his first name and last name.  Checking is done fro\
 m the file /bbs/text/badwords to make sure that there isn't an illegal word in\
  his name.  This prevents logins of the form 'Doctor Death' and 'Joe Mama' fro\
 m becoming usable logins.">
<P "Normal indent" rightIndent:-500 >
<T "^aj9.  His first name and last name are joined together to form a unique lo\
 gin ID for him.  It generally takes the form first inital and last name, but i\
 f you should have a logon of that nature, it will attempt to put additional fi\
 rst name characters along with the last name.  Note that only 8 characters are\
  used.  A sample:">
<P "Normal indent" rightIndent:-500 >
<T "^aj">
<T "Name" underline >
<T "^aj^aj^aj^aj">
<T "Logon" underline >
<P "Normal indent" rightIndent:-500 >
<T "^ajJohn Smith^aj^aj^ajjsmith">
<P "Normal indent" rightIndent:-500 >
<T "^ajJohn Smith (number two)^aj^ajjosmith">
<P "Normal indent" rightIndent:-500 >
<T "^ajAlfred Neumann^aj^aj^ajaneumann">
<P "Normal indent" rightIndent:-500 >
<T "^ajAlfred Neumann (two)^aj^ajalneuman">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "Note:  It is possible to get in a loop.  If you have a short name, and all \
 possible combinations have been used, it will cycle endlessly, trying for a co\
 mbination.  Since this is very improbable, I've left this 'bug' in the system.\
 ">
<P "Normal indent" rightIndent:-500 >
<T "^aj10.  The user is given his login ID.">
<P "Normal indent" rightIndent:-500 >
<T "^aj11.  The user is then logged out.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "When he logs in, the following happens:">
<P "Normal indent" rightIndent:-500 >
<T "^aj1.  Since there is no password for their account, the BBS prompts for a \
 password.  It loops until a valid password is entered.">
<P "Normal indent" rightIndent:-500 >
<T "^aj2.  Since he is not found in the userlog (/bbs/admin/userlog), the BBS a\
 sks whether he wants to be part of the BBS.  ">
<P "Normal indent" rightIndent:-500 >
<T "^aj3.  If not, he's logged off.">
<P "Normal indent" rightIndent:-500 >
<T "^aj4.  If the BBS supports multiple languages, he is asked what language he\
  uses.">
<P "Normal indent" rightIndent:-500 >
<T "^aj5.  He is asked for the city he is calling from.">
<P "Normal indent" rightIndent:-500 >
<T "^aj6.  He is asked for the state he is calling from.">
<P "Normal indent" rightIndent:-500 >
<T "^aj7.  He is shown a message describing what terminal types are, and asked \
 for the terminal type his software supports.">
<P "Normal indent" rightIndent:-500 >
<T "^aj8.  He is asked whether his software supports color.">
<P "Normal indent" rightIndent:-500 >
<T "^aj9.  He is shown a file describing the editors available on the system (/\
 bbs/text/editors) and asked which one he'd like to use.">
<P "Normal indent" rightIndent:-500 >
<T "^aj10.  He is asked for an alias.">
<P "Normal indent" rightIndent:-500 >
<T "^aj11.  He is asked how many lines are available on his screen.">
<P "Normal indent" rightIndent:-500 >
<T "^aj12.  He is asked how many columns are available on his screen.">
<P "Normal indent" rightIndent:-500 >
<T "^aj13.  He is prompted with the above information, and asked whether it is \
 correct.  If not, it goes back to 3.">
<P "Normal indent" rightIndent:-500 >
<T "^aj14.  He is logged into the BBS (saved).  ">
<P "Normal indent" rightIndent:-500 >
<T "^aj15.  He is shown the 'welcome' message.  (/bbs/text/welcome)">
<P "Normal indent" rightIndent:-500 >
<T "^aj16.  His personal information is displayed.">
<P "Normal indent" rightIndent:-500 >
<T "^aj17.  He is walked through system1.msg through system3.msg.">
<P "Normal indent" rightIndent:-500 >
<T "^aj^aj(Note:  this can be turned off through the config file)">
<P "Normal indent" rightIndent:-500 >
<T "^aj18.  He is given an optional 'fortune'.">
<P "Normal indent" rightIndent:-500 >
<T "^aj19.  At this point, the BBS runs the menu 'main', and the BBS operates n\
 ormally.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "Logon Scripts" face:"Times New Roman" >
<P "heading 3" rightIndent:-500  face:"Times New Roman" >
<T "^ajYou'll want to edit your logon script to represent 'your' BBS.  The scri\
 pt I am talking about is found in /bbs/scripts/login.scr.  There is a 'Welcome\
  to The Roman Catacombs!' message found in there that you'll want to change to\
  your BBS name.">
<P "Normal indent" rightIndent:-500 >
<T "^ajYou'll also want to edit the '/bbs/bbs' file.  This file is the pipe tha\
 t allows users to use the BBS effectively.  The file is as follows:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "#!/bin/sh" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "#" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# file to execute prior to starting main bbs program" face:"Courier" size:8\
  >
<P "Normal" face:"Courier" size:8 >
<T "#" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "IFS=\"\"" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "PATH=/bin:/usr/bin:/usr/games:/usr/local/bin:/usr/ucb:/bbs/bin" face:"Couri\
 er" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "export PATH" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "BBSDIR=/bbs" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "SYSOP=shaw" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "export BBSDIR SYSOP IFS" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "SHELL=$BBSDIR/rocat" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "export SHELL" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# check for a password on the account.  If no password, force them to enter\
 " face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# a password." face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "found=`anu $LOGNAME | wc -c`" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "while [ \"$found\" -le \"2\" ]" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "do" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "        echo We will now setup a password for your account." face:"Courier"\
  size:8 >
<P "Normal" face:"Courier" size:8 >
<T "        echo Please enter a password." face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "        passwd" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "        found=`fgrep $LOGNAME /etc/passwd | cut -f2 -d\":\" | wc -c`" face:\
 "Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "done" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# hack to get around the getty's problem with not setting CRTSCTS" face:"Co\
 urier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# #*(@&#%(*&#.  Why can't ANYBODY figure this SIMPLE thing out?" face:"Cour\
 ier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# setup default terminal settings" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "stty sane" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "stty erase \"^^H\" kill \"^^U\" intr \"^^C\" eof \"^^D\"" face:"Courier" si\
 ze:8 >
<P "Normal" face:"Courier" size:8 >
<T "stty hupcl ixon ixoff crtscts" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "exec $SHELL" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500 >
<T "^ajIn the above file, you should change the SYSOP variable, and any other o\
 ptions you feel it is necessary to change.  I've got the editor set to 'ee' at\
  this point, as it is an easy to use editor with excellent help.">
<P "Normal indent" rightIndent:-500 >
<T "Users" face:"Times New Roman" >
<P "heading 3" rightIndent:-500  face:"Times New Roman" >
<T "^ajThe users of a BBS must have some place to store their configuration fil\
 es and any other miscellaneous files.  This is accomplished through the use of\
  user directories.  The current implementation uses the following directory st\
 ructure:">
<P "Normal indent" rightIndent:-500 >
<T "^aj/bbs/users - the root directory for BBS users.">
<P "Normal indent" rightIndent:-500 >
<T "^aj^aj[a-z] - the first initial of the user's name.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajNote:  The BBS doesn't come with the [a-z] directories created.  Look in\
  /bbs/scripts for the mkuserdirs command.  It's a small shell script that will\
  create the directories automatically.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "An example:  If Alfred E. Neumann logs onto the BBS through the 'new' user \
 logon, his home directory would be:">
<P "Normal indent" rightIndent:-500 >
<T "^aj/bbs/users/a/aneumann">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajThe initial logon scripts copy the following files to the user's account\
 :">
<P "Normal indent" rightIndent:-500 >
<T "^aj^aj/etc/stdprofile as $HOME/.profile">
<P "Normal indent" rightIndent:-500 >
<T "^aj^aj/etc/stdlogin as $HOME/.login">
<P "Normal indent" rightIndent:-500 >
<T "^aj^aj/etc/stdcshrc as $HOME/.cshrc">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajNote that these files aren't used when the user has the BBS as his shell\
 .  These files will only be used should the user get a shell (csh, bash, tcsh,\
  etc) from you.">
<P "Normal indent" rightIndent:-500 >
<T "^ajNote also that these files don't exist as a standard Linux item.  You'll\
  need to configure these scripts when you figure out how you want to handle sh\
 ell-logins.  (e.g. users that log into the Linux (Unix) OS rather than the BBS\
 )">
<P "Normal indent" rightIndent:-500 >
<T "^ajThe next utility is a bit easier to digest.  The errlogd program is the \
 BBS error logger.  You want to start this when the BBS is running.  It generat\
 es no output; it collects error and status messages from BBS processes and pla\
 ces them in /bbs/admin/bbserr.">
<P "Normal indent" rightIndent:-500 >
<T "BBS Daemons">
<P "heading 2" rightIndent:-500 >
<T "^ajThe BBS comes with a number of background processing programs (daemons, \
 pronounced DE-mons).  Most of these programs will be useful to you, to say the\
  least.">
<P "Normal indent" rightIndent:-500 >
<T "^ajThe first (and most important) daemon is the error logging daemon.  This\
  program will log all acces to your BBS.  You will save yourself hours of grie\
 f by starting this prior to doing any further BBS configuration/debugging.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajTo start the program, use the following command line (as the BBS Adminis\
 trator):">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "^aj/bbs/bin/errlogd &" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "^aj">
<P "Normal indent" rightIndent:-500 >
<T "^ajThe above starts the error logger and pushes it into the background.  Se\
 e the below section for a more succinct description of the errlogd utility.">
<P "Normal indent" rightIndent:-500 >
<T "^ajThe other daemons are:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^aj">
<T "Utility" underline >
<T "^aj^aj">
<T "Description" underline >
<P "Normal indent" rightIndent:-500 >
<T "^ajrochatd^aj^ajChatting input/output">
<P "Normal indent" rightIndent:-500 >
<T "^ajropchatd^aj^ajPrivate chat input/output">
<P "Normal indent" rightIndent:-500 >
<T "^ajrobcastd^aj^ajBroadcasts and messages between users">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajThe other daemons are described later in the document.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajHere's a small way to have the error logger started when your machine bo\
 ots.  Put the following lines at the end of /etc/rc.d/rc.local:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "# start BBS error logging daemon" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "su bbs -c /bbs/bin/errlogd &" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500 >
<T "^ajYou'll want to configure the first item in the bbsinfo file prior to exe\
 cuting the above program.  (see the next section for more information)">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "Advanced Configuration">
<P "heading 1" rightIndent:-500 >
<T "^ajThe previous section showed you how to configure your BBS.  At this poin\
 t, you (should) have a marginally working BBS.  However, there are many featur\
 es that haven't been configured yet.  To make the most use of your BBS (and ma\
 ke your BBS better reflect what you want it to be), you'll want to continue th\
 rough the reading through the rest of the section.">
<P "Normal indent" rightIndent:-500 >
<T "The Options (bbsinfo) File" face:"Times New Roman" >
<P "heading 3" rightIndent:-500  face:"Times New Roman" >
<T "^ajAlmost all options for the BBS program are found in the options file, /b\
 bs/config/bbsinfo.  The file is a simple text file, with comments describing w\
 hat the features are, and how to enter the features.  The features file found \
 on the Roman Catacombs BBS follows:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "# this file contains the bbs pathing and machine information" face:"Courier\
 " size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# setup as you desire" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# it should be in the format: NAME <tab> value" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# blanks and lines starting with # are ignored" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# host where error logger is running" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "LOGHOST manwe" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# host where sysop's watch program is running" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "WATCHHOST       manwe" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# host where chat daemon runs" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "CHATHOST        manwe" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# upload to download ratio      (7.0 is 7 downloads for each upload)" face:\
 "Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# negative numbers refers to how the ratio is done - if it's" face:"Courier\
 " size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# negative, then the ratio is enforced *BEFORE* the user downloads" face:"C\
 ourier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# the ratio number of files (in the case of -7.0, he has to upload" face:"C\
 ourier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# before he can download the 7 files possible." face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# normal (aka positive) numbers refers to a normal upload ratio." face:"Cou\
 rier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# meaning the ratio won't be enforced until after the even number" face:"Co\
 urier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# of files has been downloaded (e.g. on the 8th file he wouldn't" face:"Cou\
 rier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# be able to download." face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# set below to 1000 or some such number for no ratio." face:"Courier" size:\
 8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "RATIO   7.0" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# default access level for a new user on the bbs" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "DEFACL  100" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# default terminal type for new user on BBS" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "DEFTERM ansi" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# default foreground" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# available:  black red green yellow blue magenta cyan white" face:"Courier\
 " size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "DEFFOREGROUND   green" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# default background" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# available:  black red green yellow blue magenta cyan white" face:"Courier\
 " size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "DEFBACKGROUND   black" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# default color attribute" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# pick only one" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# available:  normal bold blink inverse" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "DEFATTRIBUTE    normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# time that a user's time limit is good for." face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# this is the amount of time that a user may use his 60 minutes for." face:\
 "Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# ex: if you set it to 24 hours, he gets 60 minutes every 24 hours." face:"\
 Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "WAITTIME        12" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# credit chat time with sysop?" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# 0 for false, 1 for true" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "CREDITCHAT      1" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# credit upload time?" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "CREDITUPLOADS   1" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# the pager to use on your system (use 'more' or 'less' or whatever" face:"\
 Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# you like.  Note that the default user path must have this command" face:"\
 Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# available for it to be accessible.  (e.g. if you have 'less' in" face:"Co\
 urier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# /usr/local/bin, /usr/local/bin *MUST* be part of the default login path" \
 face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# Note:  Fully qualifying the path won't work.  Only 15 chars are allocated\
 " face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# to the 'pager' variable." face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "SYSTEMPAGER     more" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# the validation program to be used when the user logs on initially" face:"\
 Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# and when the user has been expired." face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# set to 'none' to skip validation" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# NOTES:" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "#       1.  it *MUST* be set to exactly \"none\" for no validation program"\
  face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# to work correctly (no spaces after it, etc)" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "#       2.  a full path is recommended (if not required)" face:"Courier" si\
 ze:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "VALIDATION      none" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# login name of the sysop" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "SYSOP   shaw" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# the following flags determine whether to show the user the system.X" face\
 :"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# (where X < 4) messages are shown to the user at each logon or only once" \
 face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# if 1, message will be shown at initial logon only.  0 for every time" fac\
 e:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "SYSTEM1MSGONCE  0" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "SYSTEM2MSGONCE  0" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "SYSTEM3MSGONCE  0" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# sysop's chat hours.  If the user hits 'chat' outside of these hours, he" \
 face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# will be told you are not available and to leave a message." face:"Courier\
 " size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# time is in military.  1900 is 7pm, 2200 is 10pm" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "CHATON  0000" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "CHATOFF 2400" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# the below are the different things you can put on the command prompt" fac\
 e:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# line when at the end of a menu." face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# turn on SHOWTIMELEFT to show the amount of time the user has left" face:"\
 Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# turn on SHOWVALIDKEYS to show the valid hot keys to the user" face:"Couri\
 er" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# USERPROMPT is the text that will prompt the user to hit a key." face:"Cou\
 rier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# ex: with all turned on," face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "#  (15 Minutes left) Command? (a,b,d,i,k,t)  <--- user prompt here" face:"C\
 ourier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "SHOWTIMELEFT    1" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "SHOWVALIDKEYS   1" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "USERPROMPT      Command?" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# the following determines the default card type for a new user" face:"Cour\
 ier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "DEFCARD blue" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# the following determine the amount of time and downloads that a user" fac\
 e:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# may have for different access levels.  Define as you wish." face:"Courier\
 " size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# the format is:" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# card color, access level, timelimit, additional flags," face:"Courier" si\
 ze:8 >
<P "Normal" face:"Courier" size:8 >
<T "# max downloads (k) per day, amount of downloads (k) per validation," face:\
 "Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# days account is valid," face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# total time available to account (hours)," face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# months until account expired," face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# max files downloadable during period (hard number)" face:"Courier" size:8\
  >
<P "Normal" face:"Courier" size:8 >
<T "# time of day during which account available (0000-2400)" face:"Courier" si\
 ze:8 >
<P "Normal" face:"Courier" size:8 >
<T "# flags is a hex value that will be added to the user's flags upon logon" f\
 ace:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# (e.g. for flag 12 on for additional access, it would be 400)" face:"Couri\
 er" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# a -1 value in a limit field means 'don't enforce'" face:"Courier" size:8 \
 >
<P "Normal" face:"Courier" size:8 >
<T "#" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# color         acl     tl/day  flags   k/day   k/val   day/val tot_tim mo/\
 val d" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "l/val  start    end" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "REDCARD         100     20      0       0       0       30      2       12"\
  face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "200     0000    2400" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "BLUECARD        200     10      0       2500    10000   -1      -1      12"\
  face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "200     0000    2400" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "GREENCARD       200     60      1       2500    10000   -1      -1      12"\
  face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "200     0000    2400" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "WHITECARD       400     60      1       -1      10000   -1      -1      12"\
  face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "200     0000    2400" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# I don't use the below.  Use them as you want." face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "GREYCARD        500     0       0       0       -1      -1      -1      -1"\
  face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "200     0000    2400" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "PINKCARD        600     0       0       0       -1      -1      -1      -1"\
  face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "200     0000    2400" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "YELLOWCARD      700     0       0       0       -1      -1      -1      -1"\
  face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "200     0000    2400" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "ROSECARD        800     0       0       0       -1      -1      -1      -1"\
  face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "200     0000    2400" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "VIOLETCARD      900     0       0       0       -1      -1      -1      -1"\
  face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "200     0000    2400" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "AZURECARD       1000    0       0       0       -1      -1      -1      -1"\
  face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "200     0000    2400" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "BROWNCARD       1100    0       0       0       -1      -1      -1      -1"\
  face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "200     0000    2400" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "PEACHCARD       1200    0       0       0       -1      -1      -1      -1"\
  face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "200     0000    2400" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# this is the sysop's card" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "BLACKCARD       10000   255     0       -1      -1      -1      -1      -1"\
  face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "-1     0000    2400" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# check for mail?" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "CHECKMAIL       1" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# location of the mail spool file" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "MAILSPOOL       /usr/mail" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# minimum wait time between new mail checks (in seconds)" face:"Courier" si\
 ze:8 >
<P "Normal" face:"Courier" size:8 >
<T "MAILCHECK       30" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# 'talk' program for chatting with the SysOp" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "TALKPROG        talk" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# show the user his 'fortune' upon logon?" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "SHOWFORTUNE     1" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# Number of minutes of inactivity before user logged out" face:"Courier" si\
 ze:8 >
<P "Normal" face:"Courier" size:8 >
<T "# 0 for no inactivity" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "INACTIVITY      5" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# percentage 'fudge' factor for user while downloading." face:"Courier" siz\
 e:8 >
<P "Normal" face:"Courier" size:8 >
<T "# if at 10 (10%), it will give the user an additional 10% prior to aborting\
 " face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# his download if his time has expired." face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "FUDGETIMELIMIT  5" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# Max number of K the user may download with one batch" face:"Courier" size\
 :8 >
<P "Normal" face:"Courier" size:8 >
<T "MAXK    2500" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# Max number of K the user may download in one day" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "MAXK_DAY        2500" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# Max number of files the user may download in one batch" face:"Courier" si\
 ze:8 >
<P "Normal" face:"Courier" size:8 >
<T "MAXFILES        10" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# Should the BBS log the menu accesses?" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# (good for debugging)" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "LOG_MENU_ACCESSES       1" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# Should the BBS log external program accesses?" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "LOG_EXTERNALS           1" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "# don't delete this line!" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "^ajAs you can see, there are quite a few options.  Edit the above file howe\
 ver you wish.  Note that at this time, there are only 12 user card colors.  No\
  more colors can be added without changing the code.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajSee the section on account expiration/limits for more information about \
 the card fields shown above..">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajNote:  If you want to edit the user to give him additional access (say a\
 ccess 500 when he's using a blue card with access 200), the BBS will ">
<T "not " italic >
<T "drop his access.  The cards are used as a minimal access value system only.\
   If a value is less than a card's value, it will be set to the card's value. \
  If a value is higher than a card's value, it will be left alone.  This is to \
 assume that you (the SysOp) have changed his access level for some reason.  Th\
 is is true for all values found in the cards.">
<P "Normal indent" rightIndent:-500 >
<T "Card Usage" face:"Times New Roman" >
<P "heading 3" rightIndent:-500  face:"Times New Roman" >
<T "^ajRocat uses access cards to make grouping of users into catagories of acc\
 ess easier.  As you see below, there are many parts of the card structure foun\
 d in the bbsinfo file.  As you see below, each card has the following characte\
 ristics:">
<P "Normal" rightIndent:0 >
<P "Normal" rightIndent:0 >
<T "# color         acl     tl/day  flags   k/day   k/val   day/val tot_tim mo/\
 val dl/val  start    end" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "REDCARD         100     20      0       0       0       30      2       12 \
      200     0000    2400" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500 >
<T "In a broken down form:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "Item" underline >
<T "^aj^aj">
<T "Description" underline >
<P "Normal indent" rightIndent:-500 >
<T "color^aj^ajCard color (not changeable)">
<P "Normal indent" rightIndent:-500 >
<T "acl^aj^ajMinimum access level for this card">
<P "Normal indent" rightIndent:-500 >
<T "tl/day^aj^ajTimelimit (minutes) per period (period defined by WAITTIME in b\
 bsinfo)">
<P "Normal indent" rightIndent:-500 >
<T "flags^aj^ajAdditional flags that this card gives">
<P "Normal indent" rightIndent:-500 >
<T "k/day^aj^ajMax downloadable K per period">
<P "Normal indent" rightIndent:-500 >
<T "k/val^aj^ajThe total amount of K the person may download while account is v\
 alid.">
<P "Normal indent" rightIndent:-500 >
<T "^aj^aj^ajThis is a max limit - once the person has surpassed this, they wil\
 l no longer be able to">
<P "Normal indent" rightIndent:-500 >
<T "^aj^aj^ajdownload.">
<P "Normal indent" rightIndent:-500 >
<T "day/val^aj^ajThe number of days the account is valid.">
<P "Normal indent" rightIndent:-500 >
<T "tot_tim^aj^ajTotal time available to the account (in hours).">
<P "Normal indent" rightIndent:-500 >
<T "mo/val^aj^ajThe number of months that the account is valid. ">
<P "Normal indent" rightIndent:-500 >
<T "dl/val^aj^ajThe total number of files a user may download while account is \
 valid.">
<P "Normal indent" rightIndent:-500 >
<T "start^aj^ajStarting time account may be used.">
<P "Normal indent" rightIndent:-500 >
<T "end^aj^ajEnding time account may be used.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "Notes:">
<P "Normal indent" rightIndent:-500 >
<T "1.  I don't expect you to use all of the above.  I've put the above in for \
 those with more esoteric usage ideas. ">
<P "Normal indent" firstIndent:250 leftIndent:500 rightIndent:-500 >
<T "2.  day/val and mo/val are individual items.  They are assumed to be mutual\
 ly exclusive.  That is, only one may be used at any one time.  If both values \
 are set to some value, day/val is checked prior to mo/val.">
<P "Normal indent" firstIndent:250 leftIndent:500 rightIndent:-500 >
<T "3.  k/val, tot_time, and dl/val are all cumulative values.  Once these valu\
 es have been exceeded, that function will not be allowed.  Example: If the use\
 r uses 8 hours, and tot_time is set to 8, they will not be allowed to log in w\
 ithout being re-validated.">
<P "Normal indent" firstIndent:250 leftIndent:500 rightIndent:-500 >
<T "4.  Validation requires that a validation program exists.  If the program d\
 oes not exist (e.g. it is set to 'none'), the BBS will leave access at DEFCARD\
  (shown above in bbsinfo).   See the below section for information on how auto\
 matic validation/expiration works.">
<P "Normal indent" firstIndent:250 leftIndent:500 rightIndent:-500 >
<T "5.  Any field set to -1 is ignored.  (e.g. no limit is set)">
<P "Normal indent" firstIndent:250 leftIndent:500 rightIndent:-500 >
<T "6. ACL and timelimit acces are cumulative.  If the ACL and/or timelimit of \
 the user are less than what their card allows, their access will be updated.  \
 If it is not, their access will not be changed.  This allows the SysOp to upda\
 te access of a particular user without having to resort to many different card\
 s.">
<P "Normal indent" firstIndent:250 leftIndent:500 rightIndent:-500 >
<T "7.  The start and end times are in military times.  0000 means midnight, 24\
 00 means midnight the next night (e.g. 0000-2400 means no restriction on time \
 of call) ">
<P "Normal indent" firstIndent:250 leftIndent:500 rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "Automatic Validation" face:"Times New Roman" >
<P "heading 3" rightIndent:-500  face:"Times New Roman" >
<T "^ajNew to version 1.0 of rocat is the ability to automatically validate use\
 rs.  This allows users to be checked automatically upon logon and to gain imme\
 diate access to the BBS.">
<P "Normal" rightIndent:-500 >
<T "^ajThe validation program may be a script or a program.  The script/program\
  must return the following to the BBS:">
<P "Normal" rightIndent:-500 >
<T "^aj0 ^aj^ajValidation  failed.">
<P "Normal" rightIndent:-500 >
<T "^aj1^aj^ajValidation was successful; give the user a red card.">
<P "Normal" rightIndent:-500 >
<T "^aj2^aj^ajValidation was successful; give the user a blue card.">
<P "Normal" rightIndent:-500 >
<T "^aj3^aj^ajValidation was successful; give the user a green card.">
<P "Normal" rightIndent:-500 >
<T "^aj4^aj^ajValidation was successful; give the user a white card.">
<P "Normal" rightIndent:-500 >
<T "^aj5^aj^ajValidation was successful; give the user a grey card.">
<P "Normal" rightIndent:-500 >
<T "^aj6^aj^ajValidation was successful; give the user a pink card.">
<P "Normal" rightIndent:-500 >
<T "^aj7^aj^ajValidation was successful; give the user a yellow card.">
<P "Normal" rightIndent:-500 >
<T "^aj8^aj^ajValidation was successful; give the user a rose card.">
<P "Normal" rightIndent:-500 >
<T "^aj9^aj^ajValidation was successful; give the user a violet card.">
<P "Normal" rightIndent:-500 >
<T "^aj10^aj^ajValidation was successful; give the user a azure card.">
<P "Normal" rightIndent:-500 >
<T "^aj11^aj^ajValidation was successful; give the user a brown card.">
<P "Normal" rightIndent:-500 >
<T "^aj12^aj^ajValidation was successful; give the user a black card.">
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "^ajThe validation program can do whatever you wish.  You can write a callba\
 ck-verifier, a credit-card checking/authorization program or even the standard\
  \"fill out this form and I'll get back to you one day\" many BBSs use.  The u\
 se of the validation program is up to you.">
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "Re-Validation" face:"Times New Roman" >
<P "heading 3" rightIndent:-500  face:"Times New Roman" >
<T "^ajOnce a user has used up all of their resources (any or all), they must b\
 e re-validated.  This can be VERY tricky for the following reasons:">
<P "Normal" rightIndent:-500 >
<T "^aj^aj1.  Once a user has exceeded absolute limits for their card, the bbs \
 can not zero those limits.  Those  fields are hard limits and not changeable. \
  They may only increase.">
<P "Normal" rightIndent:-500 >
<T "^aj^aj2.  There is no (current) way to pass in the current access of the us\
 er.">
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "^ajI only see this as a problem for those pay-oriented BBSs.  In that case,\
  the BBS is leaving it in the hands of the validation program to 'do the right\
  thing'.  It shouldn't be difficult to have the validation program offer a lis\
 t of services (for different pay levels).  It would be up to the user at that \
 point to figure out how much they've used and to buy more access than what the\
 y had previously.">
<P "Normal" rightIndent:-500 >
<T "^ajIf this really becomes an issue, send me a message.  I might put an opti\
 on into the BBS to call the validation program with the current card number (o\
 r something similar).">
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "Notes:">
<P "Normal" rightIndent:-500 >
<T "^ajThe validation system splits expiration into two distinct areas:">
<P "Normal" rightIndent:-500 >
<T "Level" underline >
<T "^aj">
<T "Description" underline >
<P "Normal" firstIndent:625 leftIndent:1500 rightIndent:-500 >
<T "Critical^ajThe user is unable to access the BBS due to expiration/limits.  \
 Example: The user has used all of their available time.">
<P "Normal" firstIndent:625 leftIndent:1500 rightIndent:-500 >
<T "Nuisance^ajThe user can access the BBS, but they are unable to use some par\
 t of the BBS due to some limit exceeded.  Example: The user has used all of th\
 eir download credit, but can still access the BBS.">
<P "Normal" firstIndent:625 leftIndent:1500 rightIndent:-500 >
<P "Normal" firstIndent:0 leftIndent:0 rightIndent:-500 >
<T "^ajIn the above, critical means that the user is forced to re-validate.  In\
  a nuisance setting the user may re-validate, but is not forced to re-validate\
 .">
<P "Normal" rightIndent:-500 >
<T "System messages" face:"Times New Roman" >
<P "heading 3" rightIndent:-500  face:"Times New Roman" >
<T "^ajNote:  All text files are found in /bbs/text.">
<P "Normal indent" rightIndent:-500 >
<T "^ajThere are quite a few text files that are used regularly in the BBS.  Th\
 ey are:">
<P "Normal indent" rightIndent:-500 >
<T "^aj">
<P "Normal indent" rightIndent:-500 >
<T "^aj">
<T "Filename" underline >
<T "^aj">
<T "Contents" underline >
<P "Normal indent" rightIndent:-500 >
<T "^ajbadwords^ajthose words deemed inappropriate for logon names">
<P "Normal indent" rightIndent:-500 >
<T "^ajbbsinfo^aj^aja short description of the BBS hardware (optional)">
<P "Normal indent" rightIndent:-500 >
<T "^ajbbswelcome^aja short blurb on the BBS used prior to logging in the first\
  time">
<P "Normal indent" rightIndent:-500 >
<T "^ajeditors^aj^aja list of editors available on the system">
<P "Normal indent" rightIndent:-500 >
<T "^ajlogoff^aj^ajthe logoff message given to the user upon exit">
<P "Normal indent" rightIndent:-500 >
<T "^ajnewuser.msg^ajshown to the user on initial logon">
<P "Normal indent" rightIndent:-500 >
<T "^ajsystem1-3.msg^ajstatus messages about the BBS (optional)">
<P "Normal indent" rightIndent:-500 >
<T "^ajwelcome^aja mood-setting intro blurb shown on each logon">
<P "Normal indent" rightIndent:-500 >
<T "^aj">
<P "Normal indent" rightIndent:-500 >
<T "^ajAll of the above files are customizable in any fashion you see fit.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajYou'll end up modifying almost all of them.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "Menus" face:"Times New Roman" >
<P "heading 3" rightIndent:-500  face:"Times New Roman" >
<T "^ajThe menus are how a user interacts with the BBS program.  Because of thi\
 s, the entire 'feel' of your BBS is how you setup the menus.  This is the plac\
 e where you differentiate your BBS from other BBSs.  Well, enough soap-box.  L\
 et's get started.">
<P "Normal indent" rightIndent:-500 >
<T "^ajWhen the BBS program starts, it displays the user information, the syste\
 m messages, and then calls the mandatory 'main' menu.  This menu serves as the\
  keystone menu; a place to start.">
<P "Normal indent" rightIndent:-500 >
<T "^ajLet me start with what a menu does.  Basically, a BBS menu shows the use\
 r a list of options, and, when an option is selected, tells the BBS to do some\
 thing.  That something can be as simple as 'transfer to another menu', or as c\
 omplex as 'call the external mailer program to send a message to the SysOp'.  \
 It is all up to you on how complex you wish your menus to be.  ">
<P "Normal indent" rightIndent:-500 >
<T "^ajA menu, as described above, is made up of 'options'.  These options take\
  the form of individual items, each found on an individual line.  A typical me\
 nu looks like the following:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "0||||||| Roman Catacombs                                                 En\
 try Vault" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0||||||| ------------------------------------------------------------------\
 ---------" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                                   Exit" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                                      <G>" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                        ----------------------------" face:"Courier\
 " size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                        H>elp" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                    <W> P>rivate Mail              <E>" face:"Couri\
 er" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||          Art Studio -- R>egistration Instructions -- Computer File\
 s" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                        U>tilities" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0||400|>||||                        S<Y>sop's Area" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                        C>hat with SysOp" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                        ----------------------------" face:"Courier\
 " size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                                      <S>" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                               News and Games" face:"Courier" size:\
 8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0||||||| ------------------------------------------------------------------\
 ---------" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0||||||| <-> Previous Menu     <F> Feedback to SysOp   <G> Quick Logout" fa\
 ce:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "1|g||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "3|-||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "8|c||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "2|y|400|>|||sysop|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "2|e|||||computerfiles|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "2|w|||||art_studio|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "2|s|||||newsngames|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "2|u|||||utilities|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "21|f|||||elm -s feedback shaw|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "2|p|||||mail|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "10|r|||||reg.instr|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "2|h|||||helptop|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "2|h|||||helptop|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500 >
<T "^ajThe above was once main menu for The Roman Catacombs.">
<P "Normal indent" rightIndent:-500 >
<T "^ajThe current TRC menu uses color, but to keep things simple, I'm using an\
  older menu.">
<P "Normal indent" rightIndent:-500 >
<T "  ">
<P "Normal indent" rightIndent:-500 >
<T "^ajLet's dissect a particular line:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "0||||||| Roman Catacombs                                                 En\
 try Vault" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "^ajIn the above line, there is a number, followed by a number of pipe-lette\
 rs (|), followed by some text.  In the above line, you find eight fields separ\
 ated by the pipe letters.  The fields are:">
<P "Normal indent" rightIndent:-500 >
<T "^aj1.  Command Number">
<P "Normal indent" rightIndent:-500 >
<T "^aj2.  Key used to select item">
<P "Normal indent" rightIndent:-500 >
<T "^aj3.  Access level to see item">
<P "Normal indent" rightIndent:-500 >
<T "^aj4.  Access level modifier">
<P "Normal indent" rightIndent:-500 >
<T "^aj5.  Flags required to see item">
<P "Normal indent" rightIndent:-500 >
<T "^aj6.  Flags modifier">
<P "Normal indent" rightIndent:-500 >
<T "^aj7.  Optional data">
<P "Normal indent" rightIndent:-500 >
<T "^aj8.  The text for the item.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajIn the above line, 0 is the command number (which is a text-only command\
 ), and fields 2-7 are blank (e.g. unused), and field 8 is the text to display.\
 ">
<P "Normal indent" rightIndent:-500 >
<T "^ajThe user doesn't see anything but field 8.  If field 8 is empty, he sees\
  nothing.">
<P "Normal indent" rightIndent:-500 >
<T "^ajWhen a field is blank, it's assumed that everything is available.  For e\
 xample, field 2 was the key to select the item.  Since it's an output only ite\
 m, having a key there would be pretty useless, hence it's empty.  ">
<P "Normal indent" rightIndent:-500 >
<T "^ajLet me define the fields in human terms:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "Field" underline >
<T "^aj">
<T "Formal Description" underline >
<T "^aj^aj">
<T "Use" underline >
<P "Normal indent" rightIndent:-500 >
<T "1.^ajCommand Number^aj^ajTell the BBS what operation to perform">
<P "Normal indent" rightIndent:-500 >
<T "2.^ajSelection Key^aj^aj^ajKey used to select menu item.">
<P "Normal indent" rightIndent:-500 >
<T "3.^ajAccess Level^aj^aj^ajAccess level required to see/use item.">
<P "Normal indent" rightIndent:-500 >
<T "4.^ajAccess Flags^aj^aj^ajDefine how to use Access Level">
<P "Normal indent" rightIndent:-500 >
<T "5.^ajFlags^aj^aj^aj^ajFlags necessary to see/use item.">
<P "Normal indent" rightIndent:-500 >
<T "6.^ajFlags Modifier^aj^aj^ajDefine how to use Flags.">
<P "Normal indent" rightIndent:-500 >
<T "7.^ajOptional Data^aj^aj^aj(command specific usage)">
<P "Normal indent" rightIndent:-500 >
<T "8.^ajText^aj^aj^aj^ajText to show user.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajLet me do a few more examples:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "2|e|||||computerfiles|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "^ajIn the above line, 2 is the command (which means change to another menu)\
 , 'e' is the key used to activate the item, and all the rest of the fields are\
  null.  Note how the 'e' goes with the item found above it:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "0|||||||                    <W> P>rivate Mail              <E>" face:"Couri\
 er" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||          Art Studio -- R>egistration Instructions -- Computer File\
 s" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500 >
<T "^ajThe user would select 'e' to go to the 'Computer Files' area (a menu in \
 this case).  ">
<P "Normal indent" rightIndent:-500 >
<T "^ajThis is how menus work.  They define the text that a user sees, and, def\
 ine what happens when a user activates that menu item.  ">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajOf course, there are times when you want certain users to be able to use\
  a command, and, times when only you should be able to use a command.  General\
 ly, these are defined by the security of the BBS.  There are commands that sho\
 uld only be executed only by the SysOp (or someone very trustworthy).  For thi\
 s reason, there are fields 3 through 6.  These fields allow you to define who \
 gets to see and use what commands, based on access level and flags.  Let me de\
 fine fields 3 through 6 a little better:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajField 3 sets the access level for the command.  This and field 4 define \
 the access level required to see/use the command.  An example:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "2|y|400|>|||sysop|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500 >
<T "^ajThe above item defines a switch to another menu, the 'SysOp' menu.  Of c\
 ourse, you don't want just anybody accessing this menu.  That is why the 400 a\
 nd the '>' symbol are there.  The 400 is the access level (ACL), and the '>' m\
 eans that the user's access level must be greater than or equal to 400 to see \
 and access this menu item.">
<P "Normal indent" rightIndent:-500 >
<T "^ajBy the same token, the flags required to see/use an item are selected th\
 e same way:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "2|y|||1|=|sysop|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500 >
<T "^ajThe above item has flag 1 in the flags area and '=' in the modifiers.  T\
 his means that the user must have flag 1 set before he may see/use the item.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajThe fields will accept the following:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "Field" underline >
<T "^aj^aj">
<T "Valid Contents" underline >
<T "^aj^aj">
<T "Meaning" underline >
<P "Normal indent" rightIndent:-500 >
<T "ACL^aj^aj0-32767">
<P "Normal indent" rightIndent:-500 >
<T "ACL Modifier^aj>^aj^aj^ajUser must have ACL greater or equal to ACL">
<P "Normal indent" rightIndent:-500 >
<T "^aj^aj<^aj^aj^ajUser must have ACL less than ACL">
<P "Normal indent" rightIndent:-500 >
<T "^aj^aj=^aj^aj^ajUser must have ACL equal to ACL">
<P "Normal indent" rightIndent:-500 >
<T "Flags^aj^aj1-32^aj^aj^aj">
<P "Normal indent" rightIndent:-500 >
<T "Flags Modifier^aj=^aj^aj^ajUser must have flag set">
<P "Normal indent" rightIndent:-500 >
<T "^aj^aj!^aj^aj^ajUser must not have flag set">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajBased on the above, you can have all sorts of permutations based on the \
 user's capabilities.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajThe official definitions for the command numbers (the first field) follo\
 ws:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "Command" underline >
<T "^aj">
<T "Description" underline >
<T "^aj^aj^aj^aj^aj">
<T "Optional Data" underline >
<P "Normal indent" rightIndent:-500 >
<T "0^aj^ajOutput only^aj^aj^aj^aj^ajn/a">
<P "Normal indent" rightIndent:-500 >
<T "1^aj^ajLog out of BBS^aj^aj^aj^aj^ajn/a">
<P "Normal indent" rightIndent:-500 >
<T "2^aj^ajBranch to another menu^aj^aj^aj^ajmenu name">
<P "Normal indent" rightIndent:-500 >
<T "3^aj^ajExit to previous menu^aj^aj^aj^ajn/a">
<P "Normal indent" rightIndent:-500 >
<T "4^aj^ajSearch userlog for user information^aj^aj^ajn/a">
<P "Normal indent" rightIndent:-500 >
<T "5^aj^ajList users in userlog^aj^aj^aj^ajn/a">
<P "Normal indent" rightIndent:-500 >
<T "6^aj^ajDisplay user information^aj^aj^aj^ajn/a">
<P "Normal indent" rightIndent:-500 >
<T "7^aj^ajRe-enter user information^aj^aj^aj^ajn/a">
<P "Normal indent" rightIndent:-500 >
<T "8^aj^ajChat with SysOp (via the 'talk' command)^aj^ajn/a">
<P "Normal indent" rightIndent:-500 >
<T "9^aj^ajChange to another root menu (new to 0.85)^aj^ajmenu name">
<P "Normal indent" rightIndent:-500 >
<T "10^aj^ajDisplay a file (paged)^aj^aj^aj^ajfilename">
<P "Normal indent" rightIndent:-500 >
<T "11^aj^ajDisplay a file (not paged)^aj^aj^aj^ajfilename">
<P "Normal indent" rightIndent:-500 >
<T "12^aj^ajTransfer to another menu directly (ignore stack)^ajmenu name">
<P "Normal indent" rightIndent:-500 >
<T "13^aj^ajChat with SysOp (through chat facility)^aj^ajn/a">
<P "Normal indent" rightIndent:-500 >
<T "^aj^ajSysOp must be logged into BBS">
<P "Normal indent" rightIndent:-500 >
<T "14^aj^ajNot Used">
<P "Normal indent" rightIndent:-500 >
<T "15^aj^ajInclude another menu (new to 0.90)^aj^aj^ajfilename">
<P "Normal indent" rightIndent:-500 >
<T "16^aj^ajDefine a macro (new to 0.90) (see Macros)^aj^ajmacro definition">
<P "Normal indent" rightIndent:-500 >
<T "17^aj^ajUndefine a macro (new to 0.90) (see Macros)^ajn/a">
<P "Normal indent" rightIndent:-500 >
<T "18-20^aj^ajUnused (don't used)">
<P "Normal indent" rightIndent:-500 >
<T "21^aj^ajLaunch external program^aj^aj^aj^ajexternal program">
<P "Normal indent" rightIndent:-500 >
<T "22^aj^ajLaunch BBS-door external^aj^aj^aj^ajexternal program">
<P "Normal indent" rightIndent:-500 >
<T "24^aj^ajNot Used">
<P "Normal indent" rightIndent:-500 >
<T "25^aj^ajList new files with option to download^aj^ajfiles section">
<P "Normal indent" rightIndent:-500 >
<T "26^aj^ajList new files without option to download^aj^ajfiles section">
<P "Normal indent" rightIndent:-500 >
<T "27^aj^ajList all files with option to download^aj^ajfiles section">
<P "Normal indent" rightIndent:-500 >
<T "28^aj^ajList all files without option to download^aj^ajfiles section">
<P "Normal indent" rightIndent:-500 >
<T "29^aj^ajSearch for string in files area (w/ option)^aj^ajfiles section">
<P "Normal indent" rightIndent:-500 >
<T "30^aj^aj\"                                       \" (w/o option)^aj^ajfiles\
  section">
<P "Normal indent" rightIndent:-500 >
<T "31^aj^ajView detailed information on file^aj^aj^ajfiles section">
<P "Normal indent" rightIndent:-500 >
<T "32^aj^ajDownload file(s)^aj^aj^aj^aj^ajfiles section">
<P "Normal indent" rightIndent:-500 >
<T "33^aj^ajUpload file(s)^aj^aj^aj^aj^ajfiles section">
<P "Normal indent" rightIndent:-500 >
<T "34^aj^ajDelete a file that you uploaded (not implemented)">
<P "Normal indent" rightIndent:-500 >
<T "35^aj^ajDownload a single file (with ratio checking)^aj^ajfull path and fil\
 ename">
<P "Normal indent" rightIndent:-500 >
<T "36^aj^ajDownload a single file (without ratio checking)^ajfull patch and fi\
 lename">
<P "Normal indent" rightIndent:-500 >
<T "37^aj^ajUpload a file to the BBS without adding to a ">
<P "Normal indent" rightIndent:-500 >
<T "^aj^ajfiles section^aj^aj^aj^aj^ajdirectory to upload to">
<P "Normal indent" rightIndent:-500 >
<T "38^aj^ajUpload to a file to '/bbs/tmp/$LOGNAME' ^aj^ajn/a">
<P "Normal indent" rightIndent:-500 >
<T "^aj^ajwithout adding to a files section.">
<P "Normal indent" rightIndent:-500 >
<T "39^aj^ajNot Used">
<P "Normal indent" rightIndent:-500 >
<T "40^aj^ajSearch for users to edit/delete^aj^aj^ajn/a">
<P "Normal indent" rightIndent:-500 >
<T "41^aj^ajDelete inactive users^aj^aj^aj^ajn/a">
<P "Normal indent" rightIndent:-500 >
<T "42^aj^ajList inactive users^aj^aj^aj^ajn/a">
<P "Normal indent" rightIndent:-500 >
<T "43^aj^ajList users for edit/delete^aj^aj^aj^ajn/a">
<P "Normal indent" rightIndent:-500 >
<T "44^aj^ajInvoke BBS monitor (not enabled)">
<P "Normal indent" rightIndent:-500 >
<T "45-69^aj^ajNot Used">
<P "Normal indent" rightIndent:-500 >
<T "70^aj^ajDisplay chat server status (SysOp status)^aj^ajn/a">
<P "Normal indent" rightIndent:-500 >
<T "71^aj^ajDisplay private chat server status (SysOp)^aj^ajn/a">
<P "Normal indent" rightIndent:-500 >
<T "72^aj^ajDisplay broadcast server status (SysOp)^aj^ajn/a">
<P "Normal indent" rightIndent:-500 >
<T "73^aj^ajDisplay usage information for all rooms^aj^ajn/a">
<P "Normal indent" rightIndent:-500 >
<T "74^aj^ajDisplay usage information for one room^aj^ajroom number">
<P "Normal indent" rightIndent:-500 >
<T "75^aj^ajSend a broadcast to all users (SysOp)^aj^ajn/a">
<P "Normal indent" rightIndent:-500 >
<T "76^aj^ajSend a broadcast to one user (SysOp)^aj^ajn/a">
<P "Normal indent" rightIndent:-500 >
<T "77^aj^ajChange the password (or ACL list) for a club^ajclub number">
<P "Normal indent" rightIndent:-500 >
<T "78^aj^ajConnect to a club (asks for password)^aj^ajclub number">
<P "Normal indent" rightIndent:-500 >
<T "79^aj^ajConnect to a dynamically created room^aj^ajn/a">
<P "Normal indent" rightIndent:-500 >
<T "^aj^aj(prompts for room number to connect to)">
<P "Normal indent" rightIndent:-500 >
<T "80^aj^ajConnect to a public room^aj^aj^aj^ajroom number">
<P "Normal indent" rightIndent:-500 >
<T "81^aj^ajChat with another person privately^aj^aj^ajn/a">
<P "Normal indent" rightIndent:-500 >
<T "82^aj^ajCreate a dynamic room^aj^aj^aj^ajn/a">
<P "Normal indent" rightIndent:-500 >
<T "83^aj^ajEdit the chat kill file^aj^aj^aj^ajn/a">
<P "Normal indent" rightIndent:-500 >
<T "84^aj^ajBreak into chat with a user (SysOp)^aj^aj^ajn/a">
<P "Normal indent" rightIndent:-500 >
<T "85^aj^ajChange the colors seen by other users in chat^ajn/a">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajNow that you've seen the entire list, you know what is available for you\
 r menus.  Let's go on to dissect the rest of the main menu:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "0|||||||                        H>elp" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                    <W> P>rivate Mail              <E>" face:"Couri\
 er" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||          Art Studio -- R>egistration Instructions -- Computer File\
 s" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0||||||| ------------------------------------------------------------------\
 ---------" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0||||||| <-> Previous Menu     <F> Feedback to SysOp   <G> Quick Logout" fa\
 ce:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "1|g||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "3|-||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "8|c||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "2|e|||||computerfiles|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "2|w|||||art_studio|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "21|f|||||elm -s feedback shaw|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "2|p|||||mail|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "10|r|||||reg.instr|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "2|h|||||helptop|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500 >
<T "^ajIn the above menu fragment , you see a number of menu items.  Let me fir\
 st say that I've taken the philosophy of breaking the text display and the com\
 mands into two different sections.  This allows me to see what the user sees w\
 ithout going into the BBS to check.  The first 3 items are the 'text' that is \
 shown to the user to select an item.  The last 9 items are the items that are \
 available for selection.  ">
<P "Normal indent" rightIndent:-500 >
<T "^ajHelp is a menu transfer command (2) and will transfer the user to the me\
 nu 'helptop'.  ">
<P "Normal indent" rightIndent:-500 >
<T "^ajHitting 'w' will move the user to the 'art studio' (a place for picture \
 files).  The name of the menu is 'art_studio'.  This name is the same name fou\
 nd in the directory /bbs/menus.  It is assumed that all menus are found in the\
  /bbs/menus directory.  ">
<P "Normal indent" rightIndent:-500 >
<T "^ajA completely different command is command 8, which will execute the 'cha\
 t' program with the sysop's name.  At this time, I have it configured to use '\
 talk', but you may change this as you wish.  See the 'config' file section on \
 how to do this.">
<P "Normal indent" rightIndent:-500 >
<T "^ajSpecifically note command 21, which executes feedback to the SysOp.  Thi\
 s command is simply a 'execute external' command.  This command is passed to t\
 he system as if it were typed from and command line.  In this case, it is doin\
 g 'elm -s feedback shaw', which calls the 'elm' mailer (an easy to use mailer)\
  with 'feedback' as the subject of a message to the SysOp (shaw).">
<P "Normal indent" rightIndent:-500 >
<T "^ajA special note about menu entry-exit.  The proper way to enter/exit menu\
 s is to use a command '2' to transfer to a menu, and a command '3' to return f\
 rom that menu.  This is so that if you have many menus going to the same locat\
 ion, when you exit that menu, you return to where you were last.  In computer \
 terms, the menu system is a 'stack' of menus.  When transferring to a new menu\
 , that menu is put on 'top' of the stack.  When you exit that menu, the old me\
 nu is taken from the stack, returning you to the last previous menu.  Note tha\
 t it is possible to transfer between menus using '2' commands all the time; ho\
 wever, it is ">
<T "not" italic >
<T " a good idea.  The stack will continue to fill, and when it hits 50 (the cu\
 rrent stack size), the program will probably die.  If you must do this, use me\
 nu command '12' rather than '2'.">
<P "Normal indent" rightIndent:-500 >
<T "^ajPlease see the section on editing users for commands 40-43">
<P "Normal indent" rightIndent:-500 >
<T "^ajA small sub-note.  It is not necessary for the stack of menus to be empt\
 y when the user logs out of the BBS.  They can log out at any time without cau\
 sing problems with the BBS.  (In fact, they can drop carrier at any time witho\
 ut causing problems)">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "Detailed Menu Command Definitions" face:"Times New Roman" >
<P "heading 3" face:"Times New Roman" >
<T "The following offers detailed information on the menu commands available to\
  the BBS:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "Command" underline >
<T "^aj">
<T "Description" underline >
<P "Normal indent" rightIndent:-500 >
<T "0^ajThis command dumps the contents of a command to the screen. It's a 'dum\
 my command' meant only to display text on the screen.">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "1^ajLog out from the BBS.">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "2^ajBranch to another menu.  This pushes a menu onto the 'menu stack' and b\
 ranches to another menu.">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "3^ajExit to previous menu.  This removes the top menu from the menu stack, \
 effectively returning the user to the menu he was previously using. ">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "4^ajSearch userlog for a user's name.  Display resulting information.">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "5^ajList users in userlog sequentially.">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "6^ajDisplay current user's configuration information (similar to that seen \
 when the user logs on)">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "7^ajAllow user to edit user configuration information.">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "8^ajUse the unix command 'talk' to attempt to chat with the SysOp.  The hou\
 rs that the SysOp enters in 'bbsinfo' are checked prior to executing the comma\
 nd.">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "9^ajChange to another root menu (new to 0.85).  This allows a SysOp to have\
  a 'main' menu that would be used to get some information.  In particular, bas\
 ed on what the user selects in the menu, the main menu transfers to another me\
 nu.  (e.g. if you support multiple languages, you could have the main menu be \
 a selection of what language to use.  Once they select the language, they're t\
 ransferred to a new 'main' menu, which then becomes the base of the system)">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "10^ajDisplay a file using the system pager (configured in bbsinfo)">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "11^ajDisplay a file without paging text (good for an ASCII download capabil\
 ity)">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "12^ajTransfer to another menu directly (ignore stack).  This is good for a \
 'question' menu that the user wouldn't want to see upon returning back through\
  the menu system.  Example:  I have an adult section in the BBS.  Prior to a p\
 erson entering the section, I display a menu that requires them to select OK. \
  If they are not old enough, they may select 'exit'.  Once they've gone past t\
 he menu, however, the menu shouldn't be displayed again, which this command al\
 lows me to do.">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "13^ajChat with SysOp using the BBS 'chat' functions.  Note:  The SysOp must\
  be logged into the BBS for this command to work.  See command '8' for a less \
 restrictive 'chat'.">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "14^ajDon't Use (reserved)">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "15^ajInclude another menu (new to 0.90).  This allows a SysOp to build menu\
 s with pieces of menus.  See the macro section for more information.">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "16^ajDefine a macro (new to 0.90) (see Macros)^ajmacro definition">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "17^ajUndefine a macro (new to 0.90) (see Macros)^ajn/a">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "18-20^ajUnused (don't used)">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "21^ajLaunch a program external to the BBS (a game, newsreader, etc).">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "22^ajLaunch a door (writes a door.sys file)">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "23-24^ajDon't Use (reserved)">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "25^ajList new files with option to download">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "26^ajList new files without option to download">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "27^ajList all files with option to download">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "28^ajList all files without option to download">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "29^ajSearch for string in files area (w/ option)">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "30^aj\"                                       \" (w/o option)">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "31^ajView detailed information on file">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "32^ajDownload file(s)">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "33^ajUpload file(s)">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "34^ajDelete a file that you uploaded (not implemented)">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "35^ajDownload a single file (with ratio checking).  This allows a person to\
  download a file that isn't part of a files section (like a weather map, or ot\
 her frequently updated text file that doesn't really belong in a files section\
 )">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "36^ajDownload a single file (without ratio checking)  This allows a person \
 to do the above, but it doesn't enforce ratios.  This is handy for those files\
  that need to be downloaded regularly, but you don't care how many times it is\
  downloaded.  I currently use this to download QWK packets for off-line readin\
 g.">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "37^ajUpload a file to the BBS without adding to a files section.  This is u\
 seful for uploading a file to overwrite an existing file.  This command should\
  be used with caution, as it is possible to overwrite a file using this comman\
 d.">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "38^ajUpload to a file to '/bbs/tmp/$LOGNAME' without adding to a files sect\
 ion.  This is handy for uploading QWK reply packets to the BBS for processing/\
 adding to news/email sections of the BBS.">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "39^ajDon't Use (reserved)">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "40^ajSearch for users to edit/delete.  This command should be used only by \
 SysOps and sub-Ops.">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "41^ajDelete inactive users.  This command should be used only by SysOps and\
  sub-Ops.  Note that this command does not delete users from the /etc/passwd f\
 ile.  The BBS would require 'root' permission to do this.  See the /bbs/script\
 s directory for a script that checks the userlog against the BBS userlog file.\
 ">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "42^ajList inactive users.  This command should be used only by SysOps and s\
 ub-Ops.">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "43^ajList users for edit/delete.  This command should be used only by SysOp\
 s and sub-Ops.">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "44^ajInvoke BBS Monitor (not enabled in 1.0)">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "45-69^ajDon't Use (reserved)">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "70^ajDisplay chat server status.  This command causes the chat server to du\
 mp the usage information contained within the program.">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "71^ajDisplay private chat server status.  This command causes the private c\
 hat server to dump the status information contained within the program.">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "72^ajDisplay broadcast server status.  This command causes the broadcast se\
 rver to dump the status information contained within the program.">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "73^ajDisplay usage information for all rooms.  This is a handy command to a\
 llow users to find those rooms that are in use.  See the chat section for more\
  information.">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "74^ajDisplay usage information for one room.  This allows a user to display\
  who is in a chat 'room'.">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "75^ajSend a broadcast to all users.  This is primarily intended for the Sys\
 Op to announce system events.  See the man page for 'wall' for a 'better' broa\
 dcast command.  This command could be used by users wishing to announce someth\
 ing (e.g. the Star Trek conference room is now open!  Go to dynamic room 1142 \
 to chat)">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "76^ajSend a broadcast to one user.  This could be used by users that wish t\
 o send a message to a friend.  Note that broadcasts don't reach other users wh\
 en they're downloading or in an external application (like reading news).  Bro\
 adcasts are expired after some amount of time has passed without a person to g\
 et the broadcast.">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "77^ajChange the password (or ACL list) for a club.  This is primarily inten\
 ded for the SysOp to allow sub-Ops to maintain security lists for private club\
  rooms.">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "78^ajConnect to a club.  A Club room requires that the person be on the acc\
 ess list (guest list?), or, to know a password to get into the room.  This com\
 mand connects to a club, and checks the list or a password prior to giving acc\
 ess.">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "79^ajConnect to a dynamically created room.  This allows a person to connec\
 t to a room dynamically created by another user.  See the chat system for more\
  information.">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "80^ajConnect to a public room.  This connects a user to a public chat room.\
 ">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "81^ajChat with another person privately.  This attempts to chat with anothe\
 r user.  It sends a broadcast to another user, and, if the user accepts, both \
 users are transported to a private chat room.">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "82^ajCreate a dynamic room.  This allows a user to create a dynamic room.  \
 This could add spontaneity to a BBS -- people could create dynamic rooms to su\
 ite their 'whim'.  Note that any BBS room not in use is de-allocated.">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<T "83^ajEdit the chat kill file.  This command allows a person to edit their '\
 chat kill' file.  See the chatting section for more information.">
<P "Normal indent" firstIndent:0 leftIndent:1500 rightIndent:-500 >
<T "84^ajBreak into chat with a user.  This allows the SysOp to break into chat\
  with a user immediately, with no user intervention.  Handy for helping users \
 having trouble.">
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<P "Normal indent" leftIndent:1500 rightIndent:-500 >
<P "Normal">
<T "Menu Macro Definition" face:"Times New Roman" >
<P "heading 3" face:"Times New Roman" >
<T "^ajNew to 0.90 is the following abilities:">
<P "Normal indent">
<T "^aj^lh  Inclusion of other menu files within a menu.">
<P "Normal indent">
<T "^aj^lh  Macro definition within menus">
<P "Normal indent">
<P "Normal indent">
<T "^ajThe above allow you to build menus from sets of prototype menus.  For in\
 stance, you can have a standard header file with the common title of your BBS.\
   Add macro definitions, and you can create menus from prototypes that are uni\
 que and customized for each menu.">
<P "Normal indent">
<T "^ajFor instance, there exists a header file in your menus directory:">
<P "Normal indent">
<P "Normal indent">
<T "0||||||| Roman Catacombs                                                   \
       \\ma" face:"Courier" size:8 >
<P "Normal indent" face:"Courier" size:8 >
<T "0||||||| ------------------------------------------------------------------\
 ---------" face:"Courier" size:8 >
<P "Normal indent" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500 >
<T "^ajNote the \\ma at the end of the first line.  This means to put what is i\
 n macro 'a' at this location when the menu is displayed.  ">
<P "Normal indent" rightIndent:-500 >
<T "^ajIf you use this file in your menus, as shown below, it will show up like\
  it was in the menu from the start.  The user will never know what the BBS wen\
 t through to build this menu for them.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "16|a||||Macintosh Applications|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "15||||||header|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                        ----------------------------" face:"Courier\
 " size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                        N>ew Files" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                    <W> L>ist Files" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||         Apple Pie  --- S>earch for File" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                        I>nformation on File" face:"Courier" size:8\
  >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0||199|>||||                        D>ownload file(s)" face:"Courier" size:\
 8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0||199|>||||                        U>pload File(s)" face:"Courier" size:8 \
 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                        H>elp" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                        ----------------------------" face:"Courier\
 " size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0||||||| ------------------------------------------------------------------\
 -----" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "----" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0||||||| <-> Previous Menu     <F> Feedback to SysOp   <G> Quick Logout" fa\
 ce:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "1|g||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "3|-||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "21|f|||||elm -s feedback shaw|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "3|w|||||appletop|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "25|n|199|>|||macapps|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "26|n|200|<|||macapps|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "27|l|199|>|||macapps|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "28|l|200|<|||macapps|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "...">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajCommand 16 defines macro 'a' to be \"Macintosh Applications\".  Command \
 15 reads the file 'header' from the /bbs/menus directory at this point.  The m\
 enu then consists of the following:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "0||||||| Roman Catacombs                                      Macintosh App\
 lications" face:"Courier" size:8 >
<P "Normal indent" face:"Courier" size:8 >
<T "0||||||| ------------------------------------------------------------------\
 ---------" face:"Courier" size:8 >
<P "Normal indent" face:"Courier" size:8 >
<T "0|||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                        ----------------------------" face:"Courier\
 " size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                        N>ew Files" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                    <W> L>ist Files" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||         Apple Pie  --- S>earch for File" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "...">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajThe user sees the above (without the command structure, of course) and h\
 as no idea how the menu was built.  ">
<P "Normal indent" rightIndent:-500 >
<T "^ajNote:  You'll soon run into the situation where you've got some amount o\
 f characters at the end of a line on the menu which wrap around, making the me\
 nu really ugly.  This is the one problem with the macro definitions:  If you'v\
 e got spaces hard coded into the menu header and you define a set of text, it'\
 s possible that the text will be too long or otherwise, resulting in an ugly m\
 enu.  To solve this problem, I've added a right-justified movement command in \
 the color area.  This will allow you to say \"go to column 80 and put the text\
  there and make it fit to the right edge\".  ">
<P "Normal indent" rightIndent:-500 >
<T "^ajAnother (">
<T "big" bold >
<T ") Note:  Macro definition is not meant for simple text replacement only.  Y\
 ou can define macros within commands, macros within other macros ... macros an\
 ywhere.  Basically, this could allow you to redefine your menu structure to so\
 mething that is unique to your BBS.  This is really too big of a subject to ju\
 mp into (using recursive macro definition is an art).  Let me give a few simpl\
 e examples and I'll leave it to the Wizard BBS SysOps out there to stress the \
 macro capabilities of rocat.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajOn The Roman Catacombs (TRC), I've got a ">
<T "lot" bold >
<T " of menus for files areas.  If you use a CD-ROM drive and/or disk space, yo\
 u can create quite a few files areas in your BBS.  Well, this means I've got a\
  lot of menus that are basically the same:  You can look at files (using file \
 section commands), download files, etc.  About the only thing different is the\
  name of the files section itself.  This screams for the macro inclusion facil\
 ity:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "A current menu:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "15|a|||||Main Menu|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                        ----------------------------" face:"Courier\
 " size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                        N>ew Files" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                    <W> L>ist Files" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||         Apple Pie  --- S>earch for File" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                        I>nformation on File" face:"Courier" size:8\
  >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0||199|>||||                        D>ownload file(s)" face:"Courier" size:\
 8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0||199|>||||                        U>pload File(s)" face:"Courier" size:8 \
 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                        H>elp" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                        ----------------------------" face:"Courier\
 " size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0||||||| ------------------------------------------------------------------\
 ---------" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0||||||| <-> Previous Menu     <F> Feedback to SysOp   <G> Quick Logout" fa\
 ce:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "1|g||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "3|-||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "21|f|||||elm -s feedback shaw|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "3|w|||||appletop|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "25|n|199|>|||macapps|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "26|n|200|<|||macapps|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "27|l|199|>|||macapps|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "28|l|200|<|||macapps|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "29|s|199|>|||macapps|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "30|s|200|<|||macapps|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "31|i|||||macapps|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "32|d|199|>|||macapps|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "33|u|199|>|||macapps|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "2|h|||||helptop|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500 >
<T "^ajAs you can see, I'm a bit behind in my menu system.  Note, however, that\
  the menu is very similar to a generic files menu.  You've got all of the same\
  commands.  If you were to replace all instances of macapps with \\mb, and def\
 ine \\mb to be macapps, you could extract the menu structure from the menu its\
 elf and have a files menu that was easily maintainable (after all, you only ne\
 ed one copy at this point).">
<P "Normal indent" rightIndent:-500 >
<T "^ajI'm sure you've got ideas of your own with respect to menu systems and h\
 ow to use them.  If you find something really unique (a couple of things come \
 to mind), send me a message.  I'd like to hear of unique ways to configure the\
  menu system.">
<P "Normal indent" rightIndent:-500 >
<T "^ajOne quick note:  At this point, there is no way to put the up and down c\
 haracter (|) in a macro.  After all, the BBS wouldn't be able to tell what was\
  macro and what was command delimiters.  ">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "Colorizing the BBS" face:"Times New Roman" >
<P "heading 3" face:"Times New Roman" >
<T "^ajNew to 0.90 are the color and movement capabilities of ANSI.  With these\
  embedded color commands, you can colorize the entire BBS.  The following term\
 s define whether ANSI codes are sent to the user:">
<P "Normal indent">
<T "^aj1.  The user is using the 'ansi' terminal type.">
<P "Normal indent">
<T "^aj2.  The user has enabled color in their profile.">
<P "Normal indent">
<P "Normal indent">
<T "^ajThere is one setup item that you must setup prior to using color in your\
  BBS.  The default color entry for the terminal type 'ANSI' doesn't allow colo\
 r while in curses mode.  (pretty useless, if you ask me)  To fix this, do the \
 following commands to replace your 'ansi' entry with a more usable version.">
<P "Normal indent">
<P "Normal indent">
<T "^aj0.  su to root">
<P "Normal indent">
<T "^aj^ajsu">
<P "Normal indent">
<T "^aj^aj<enter root password>">
<P "Normal indent">
<T "^aj1.  cd to /usr/lib/terminfo/a">
<P "Normal indent">
<T "^aj^ajcd /usr/lib/terminfo/a">
<P "Normal indent">
<T "^aj2.  rename ansi to ansi.orig">
<P "Normal indent">
<T "^aj^ajmv ansi ansi.orig">
<P "Normal indent">
<T "^aj3.  copy in the Linux console entry as the new 'ansi'">
<P "Normal indent">
<T "^aj^ajcp ../l/linux ansi">
<P "Normal indent">
<P "Normal indent">
<T "^ajThis will allow color while in the chat system.  If the above isn't done\
 , chat will always be in black and white, regardless of whether the BBS is is \
 color otherwise.">
<P "Normal indent">
<P "Normal indent">
<T "^ajThe color commands are setup similarly to the macro definitions found in\
  the menu module.  The color and movement commands use the following structure\
 :">
<P "Normal indent">
<T "^aj\\<character><color/formatting information>">
<P "Normal indent">
<P "Normal indent">
<T "^ajThe BBS supports the following color and movement commands:">
<P "Normal indent">
<T "Command" underline >
<T "^aj">
<T "Format" underline >
<T "^aj^aj^aj">
<T "Use" underline >
<P "Normal indent">
<T "f^aj^aj\\f<num>^aj^aj^ajSet foreground color">
<P "Normal indent">
<T "b^aj^aj\\b<num>^aj^ajSet background color">
<P "Normal indent">
<T "l^aj^aj\\l^aj^aj^ajSet blinking">
<P "Normal indent">
<T "o^aj^aj\\o^aj^aj^ajSet bold (high intensity)">
<P "Normal indent">
<T "i^aj^aj\\i^aj^aj^ajSet inverse (reverse video)">
<P "Normal indent">
<T "u^aj^aj\\u^aj^aj^ajSet underline (monochrome only)">
<P "Normal indent">
<T "d^aj^aj\\d^aj^aj^ajSet dim (opposite of bold)">
<P "Normal indent">
<T "n^aj^aj\\n^aj^aj^ajReset to 'normal' colors">
<P "Normal indent">
<T "c^aj^aj\\c<num><num>^aj^ajSet foreground and background">
<P "Normal indent">
<T "a^aj^aj\\a<num>,<num>^ajAbsolute movement">
<P "Normal indent">
<T "j^aj^aj\\j<num>,<num>^aj^ajRight justified movement ">
<P "Normal indent">
<P "Normal indent">
<T "^ajNum in the above example refers to the color number.  They are:">
<P "Normal indent">
<P "Normal indent">
<T "^aj1.^ajBlack">
<P "Normal indent">
<T "^aj2.^ajRed">
<P "Normal indent">
<T "^aj3.^ajGreen">
<P "Normal indent">
<T "^aj4.^ajYellow">
<P "Normal indent">
<T "^aj5.^ajBlue">
<P "Normal indent">
<T "^aj6.^ajMagenta">
<P "Normal indent">
<T "^aj7.^ajCyan">
<P "Normal indent">
<T "^aj8.^ajWhite">
<P "Normal indent">
<P "Normal indent">
<T "Notes:">
<P "Normal indent">
<T "^ajThe foreground and background color command (\\c) doesn't have a comma. \
  For instance, to set green foreground and black background, the command would\
  be">
<P "Normal indent">
<T "^aj\\c31">
<P "Normal indent">
<T "^ajNote that there is no space in the command.">
<P "Normal indent">
<T "^ajThe absolute movement commands operate from the upper left corner of the\
  screen, 0,0.  The X coordinate is first, and the Y coordinate second.  The up\
 per right corner is 80,0 and the lower left 80,25.  Use these numbers in the a\
 bsolute and right justified movement commands.">
<P "Normal indent">
<T "^ajThe right justified movement command is rather unique.  It allows the Sy\
 sOp to position text, right justified from some point on the screen.  For inst\
 ance, if you had a string:">
<P "Normal indent">
<T "^ajThis is text \\j4,79 at position 80,4.">
<P "Normal indent">
<T "^ajThe first part of the string would appear where the current cursor was. \
  However, the last part would start at X coordinate 79 and line 4.  It may be \
 easier to think of it this way:  When you issue the command, the length of the\
  rest of the line is subtracted from the X coordinate.  That position is where\
  the text starts, with the last character of the text appearing at the coordin\
 ate that you selected.">
<P "Normal indent">
<T "^ajThis command was created for one purpose:  In my menu system, I've got t\
 he menu name in the upper right of the screen.  If I define my menus with sepa\
 rate headers and trailers defining common items, I want to be able to put the \
 title of the menu in the header as a macro.  Then, I define the macro in the (\
 real) menu itself, so that it looks like each menu is unique.  However, I want\
 ed the menu to look professional.  If I place the title macro in a certain pos\
 ition in the menu, I want the text of the macro to show up in the upper right \
 corner, just as if I had placed it there manually.  An example from the previo\
 us section:">
<P "Normal indent">
<P "Normal indent">
<T "0||||||| Roman Catacombs                                                   \
       \\ma" face:"Courier" size:8 >
<P "Normal indent" face:"Courier" size:8 >
<T "0||||||| ------------------------------------------------------------------\
 ---------" face:"Courier" size:8 >
<P "Normal indent" face:"Courier" size:8 >
<P "Normal indent">
<T "The above will place the macro in a position some number of spaces from the\
  words 'Roman Catacombs'.  If I do the following, however, the text will alway\
 s show up in the upper right corner:">
<P "Normal indent">
<P "Normal indent">
<T "0||||||| Roman Catacombs               \\j79,0\\ma" face:"Courier" size:8 >
<P "Normal indent" face:"Courier" size:8 >
<T "0||||||| ------------------------------------------------------------------\
 ---------" face:"Courier" size:8 >
<P "Normal indent" face:"Courier" size:8 >
<P "Normal indent">
<T "^ajThis allows me to create 'custom' menus using menu templates.  Believe m\
 e, if you configure your menu system this way, it will save you lots of grief.\
   Some advantages:">
<P "Normal indent">
<T "^aj^lh  A change in the header and trailer will only need one change rather\
  than a change to every menu.">
<P "Normal indent">
<T "^aj^lh  The number of menus you need will remain the same, however, defines\
  for whole sections (and macros for those sections) will allow you to build a \
 menu in a few lines rather than many large menus.">
<P "Normal indent">
<P "Normal indent">
<T "^ajThe following menu is the current main menu for TRC:">
<P "Normal indent">
<P "Normal indent">
<T "16|a|||||Central Atrium|" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "15||||||header|" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "0|||||||" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "0|||||||  \\o\\c86Messages and Electronic Mail:\\n" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "0|||||||    \\o\\c86<\\f7A\\f8> Messages and Internet News \\n         \\o\\
 \c42Files Ar" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "eas:\\n" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "0|||||||    \\o\\c86<\\f7B\\f8> Electronic Mail            \\n           \\\
 o\\c42<\\f7D\\" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "f4> Linux (a free Unix-like OS)   \\n" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "0|||||||    \\o\\c86<\\f7C\\f8> Group and Personal Chatting\\n           \\\
 o\\c42<\\f7E\\" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "f4> Macintosh Files\\n" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "0|||||||                                              \\o\\c42<\\f7F\\f4> M\
 icrosoft" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "Windows  \\n" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "0|||||||  \\o\\c85Roman Catacombs:\\n                            \\o\\c42<\\
 \f7G\\f4> Pi" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "ctures \\n" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "0|||||||    \\o\\c85<\\f71\\f8> User Environment Changes       \\n       \\\
 o\\c42<\\f7H\\" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "f4> DOS/PC Files  \\n" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "0|||||||    \\o\\c85<\\f72\\f8> User Information               \\n       \\\
 o\\c42<\\f7I\\" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "f4> CD-ROM Files  \\n" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "0|||||||    \\o\\c85<\\f73\\f8> Registration Information       \\n       \\\
 o\\c42<\\f7J\\" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "f4> Files from Internet News   \\n" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "0|||||||    \\o\\c85<\\f74\\f8> Roman Catacombs BBS Information\\n       \\\
 o\\c42<\\f7K\\" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "f4> Other Files\\n" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "0|||||||    \\o\\c85<\\f75\\f8> Chat with the SysOp            \\n" face:"C\
 ourier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "0|||||||    \\o\\c85<\\f7+\\f8> Help with the BBS              \\n" face:"C\
 ourier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "0||400|>||||    \\o\\c85<\\f70\\f8> Sysop's Area                   \\n" fac\
 e:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "0|||||||                                              \\o\\c25Recreation:\\\
 n" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "0|||||||                                              \\o\\c25<\\f7L\\f2> G\
 ames Area" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "\\n" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "0|||||||" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "15||||||footer|" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "2|0|400|>|||sysop|" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "2|a|||||messages/news|" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "2|b|||||messages/email|" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "2|c|||||messages/chat|" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "2|d|||||files/top_linux|" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "2|e|||||files/top_macintosh|" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "2|f|||||files/top_windows|" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "2|g|||||files/top_pictures|" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "2|h|||||files/top_dos|" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "2|i|||||files/top_cdrom|" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "2|j|||||files/top_news|" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "2|k|||||files/top_other|" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "2|l|||||games|" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "2|1|||||rocat/environment|" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "2|2|||||rocat/information|" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "10|3|||||reg.instr|" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "2|4|||||rocat/rocat|" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "21|5|||||talk shaw|" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal indent">
<T "^ajIn the current distribution, I include a full set of the menus (less the\
  adult menu areas) from TRC.  They are up to date and current.  They make grea\
 t examples.  Please don't use them as your BBS, however.  I don't appreciate s\
 omeone setting up an exact duplicate of my BBS.">
<P "Normal indent">
<T "^aj">
<P "Normal indent" rightIndent:-500 >
<T "Files Areas" face:"Times New Roman" >
<P "heading 3" rightIndent:-500  face:"Times New Roman" >
<T "^ajA major part of most BBS systems is the ability to send and receive file\
 s.  Of course, this functionality is built into the rocat BBS system.  The BBS\
  supports all external protocols that are possible on Linux (Unix) systems.  "\
 >
<P "Normal indent" rightIndent:-500 >
<T "^ajConfiguration of the files system involves two steps:">
<P "Normal indent" rightIndent:-500 >
<T "^aj1.  Configuration of the external protocols file.  (/bbs/config/protocol\
 s)">
<P "Normal indent" rightIndent:-500 >
<T "^aj2.  Configuration of the main BBS files header file (/bbs/filehdr/bbs_fi\
 les_hdr)">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajA sample protocols files follows:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "# this file describes the external protocols to be used by the bbs and" fac\
 e:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "# the command to be used to invoke it." face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "# the format is:" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "# UPLOAD|command|needs filename (y or n)|key to select|text description for\
  user" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "# DOWNLOAD|command|key to select|text description for user" face:"Courier" \
 size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "# Note that if a command needs a filename, multiple file uploads are not" f\
 ace:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "# allowed.  (this is the case with the below protocols.  If something" face\
 :"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "# different is found, then it can be changed)" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "U|rz|n|1|1. Zmodem" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "U|rb|n|2|2. Ymodem" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "U|rx|y|3|3. Xmodem" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "U|kermit -rb|y|4|4. Kermit" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "D|sz|1|1. Zmodem" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "D|sb|2|2. Ymodem" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "D|sb -k|3|3. Ymodem-1K" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "D|sb|4|4. Ymodem-G" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "D|sx|5|5. Xmodem" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "D|sx -k|6|6. Xmodem-1K" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "D|kermit -sb|7|7. Kermit" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500 >
<T "^ajAs you see above, to add additional protocols, simply enter the upload a\
 nd download commands as described in the above file.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajConfiguration of the main BBS files header file is also simple.  Another\
  sample file follows:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "#" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "# files header for the BBS.  Should contain one entry for every files area"\
  face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "# on the BBS" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "#" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "# format: filename [R|C] absolute_path_to_files.bbs sysop_name access_level\
  down load_path upload_path age_to_delete_files long_name_of_area" face:"Couri\
 er" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "#" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "# dashes fill non applicable positions" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "# dos files areas" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "[ dosapps R - shaw 0 dos/apps uploads 0 Dos Applications ]" face:"Courier" \
 size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "[ doscomm R - shaw 0 dos/comm uploads 0 Dos Communications Programs ]" face\
 :"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "[ doscomp R - shaw 0 dos/compress uploads 0 Dos Compression Programs ]" fac\
 e:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "[ dosdrivrs R - shaw 0 dos/drivrs uploads 0 Dos Drivers ]" face:"Courier" s\
 ize:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "[ cdromgames C /cdrom/dos/games/files.bbs shaw 0 dos/games uploads 0 Dos Ga\
 mes ]" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-1250  face:"Courier" size:8 >
<T "[ dossounds R - shaw 0 dos/sounds uploads 0 Dos Sounds ]" face:"Courier" si\
 ze:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "[ dosutils R - shaw 0 dos/utils uploads 0 Dos Utilities ]" face:"Courier" s\
 ize:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<P "Normal indent" rightIndent:-1125 >
<T "^ajThis one is a bit more tricky.  The fields that make up the file are:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^aj1.  The name of the files section.  This is the name entered in field 7 \
 of a menu. ^ajThis is also the name of the associated files header found in /b\
 bs/filehdr when the section is a rocat section.">
<P "Normal indent" rightIndent:-500 >
<T "^aj2.  The type of files section C for CDROM or R for rocat.">
<P "Normal indent" rightIndent:-500 >
<T "^aj3.  The absolute path to the files.bbs file for CDROM sections.">
<P "Normal indent" rightIndent:-500 >
<T "^aj4.  The sysop's name.  Not used at this point.">
<P "Normal indent" rightIndent:-500 >
<T "^aj5.  The access level required to use the files section.  Note that this \
 is a minimal ">
<P "Normal indent" rightIndent:-500 >
<T "^ajnumber; if a user's access level is below this value, he will be denied \
 access.">
<P "Normal indent" rightIndent:-500 >
<T "^aj6.  The relative path to the directory where the files are stored.  Note\
  that you ^ajmust create this directory yourself.  The whole path is /bbs/file\
 s/relative_path.">
<P "Normal indent" rightIndent:-500 >
<T "^ajex: dosapps is found at /bbs/files/dos/apps.">
<P "Normal indent" rightIndent:-500 >
<T "^aj7.  Age to automatically delete files found in the section.  This option\
  is available ">
<P "Normal indent" rightIndent:-500 >
<T "^ajfor material that is dated (such as ski reports) and that can be automat\
 ically ">
<P "Normal indent" rightIndent:-500 >
<T "^ajdeleted after some period (in days).  Note that this operation isn't sup\
 ported as ">
<P "Normal indent" rightIndent:-500 >
<T "^ajyet.">
<P "Normal indent" rightIndent:-500 >
<T "^aj8.  Name of the files section (as reported to users).  This can be a ver\
 y long ">
<P "Normal indent" rightIndent:-500 >
<T "^ajname, but it would be better if it were short.  Most programs limit it t\
 o about 20 ">
<P "Normal indent" rightIndent:-500 >
<T "^ajcharacters.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "CD-ROM Files Sections" face:"Times New Roman" >
<P "heading 3" face:"Times New Roman" >
<T "^ajAs you can see above, the rocat BBS system supports CD-ROM (read-only) f\
 iles sections.  These sections are unique in that they never change (until you\
  get a new CD-ROM) and they already have filenames and descriptions on the CD-\
 ROM.">
<P "Normal indent">
<T "^ajrocat will read the files.bbs that is found in every directory that has \
 BBS readable files.  Simply enter the files.bbs as shown in the above example.\
   Note that a files section header file is not required, nor is it generated."\
 >
<P "Normal indent">
<T "^ajThere are some extenuating circumstances that rocat checks for automatic\
 ally:">
<P "Normal indent">
<T "^aj">
<P "Normal indent">
<T "^ajShould the CD-ROM be unavailable (you forgot to mount it or you have ano\
 ther CD-ROM online in it's place), access of the CD-ROM section will generate \
 a message to the user telling him that the section is unavailable. ">
<P "Normal indent">
<T "^ajUploads are not possible for CD-ROM sections.   I have made the assumpti\
 on that you have your own files sections that would be used for uploading file\
 s that would reside in that section.">
<P "Normal indent">
<T "^ajThe fileutil program, when scanning sections skips CD-ROM sections.  ">
<P "Normal indent">
<P "Normal indent">
<T "^ajOther than that, CD-ROM filesections operate as they would with a rocat \
 files section.  ">
<P "Normal indent">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "Interfacing with External Programs" face:"Times New Roman" >
<P "heading 3" rightIndent:-500  face:"Times New Roman" >
<T "^ajInterfacing with external programs is simple.  When a user selects an ex\
 ternal program, that program is called from within the BBS.  To him, it appear\
 s like the program is built into the BBS.  See command (21) above for more inf\
 ormation.">
<P "Normal indent" rightIndent:-500 >
<T "^ajWARNING:  External programs that are not compiled with security turned o\
 n are ">
<T "huge" bold >
<T " security holes.  An example that I found recently:">
<P "Normal indent" rightIndent:-500 >
<T "^ajI use the 'tin' news reader.  As part of tin, it's possible to do a shel\
 l command (via the '!' character).  If you compile tin to turn this off (which\
  you should), then you will not have problems.  However, I was able to type 'c\
 hsh -s /bin/tcsh', and the shell command changed my shell from the BBS to a sh\
 ell account.  It was this simple.">
<P "Normal indent" rightIndent:-500 >
<T "^ajSolution (in this case):  I turned off 'chsh'.  I've also tried to minim\
 ize problems through the use of a restricted BASH shell.  The BBS currently us\
 es the -r (restricted) option on BASH to gain a small amount of security  (it \
 doesn't buy much)">
<P "Normal indent" rightIndent:-500 >
<T "^ajWARNING:  When you put an external command in your BBS, you ">
<T "MUST" italic >
<T " test this command for shell-giving options.  If you do not, you are openin\
 g your system to crackers; people who break systems for the fun of it.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "Uploading and Downloading" face:"Times New Roman" >
<P "heading 3" rightIndent:-500  face:"Times New Roman" >
<T "^ajUploading and download to/from the BBS is meant to be as transparent as \
 possible.  (see the files areas section for configuration of files areas)  A t\
 ypical uploading session follows:">
<P "Normal indent" rightIndent:-500 >
<T "^ajThe user lists files in a files section.">
<P "Normal indent" rightIndent:-500 >
<T "^ajHe sees a number of files he's interested in.  He 'Marks' the files for \
 download.">
<P "Normal indent" rightIndent:-500 >
<T "^ajHe then hit's 'Download'.  He is given a list of the files he has marked\
 .  ">
<P "Normal indent" rightIndent:-500 >
<T "^ajHe then is given the list of protocols on the system.  He selects the pr\
 otocol he wishes to use.">
<P "Normal indent" rightIndent:-500 >
<T "^ajThe download commences.  Note:  at this time, all downloads are assumed \
 to be successful.  This means that if the user downloads 5 files, yet only get\
 s 1 downloaded successfully, he is marked for 5 downloads.  This error is due \
 to external file transfer programs not returning any useful information as to \
 how many files were actually sent.">
<P "Normal indent" rightIndent:-500 >
<T "^ajThe user's information is updated accordingly to reflect the files (and \
 size of the files) downloaded.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajOf course, the above is a simplistic view of how to download.  Behind th\
 e scenes, there are a lot of security features that must be satisfied prior to\
  a download taking place:">
<P "Normal indent" rightIndent:-500 >
<T "^aj1.  The user must be able to download (via the menu option).">
<P "Normal indent" rightIndent:-500 >
<T "^aj2.  He must have enough K available (via his card color) to download the\
  file(s).">
<P "Normal indent" rightIndent:-500 >
<T "^aj3.  He must keep his upload/download RATIO within BBS specifications.">
<P "Normal indent" rightIndent:-500 >
<T "^aj4.  He must not have more than MAXK of files selected for download.">
<P "Normal indent" rightIndent:-500 >
<T "^aj5.  He has the access level to access the files area (see files areas)."\
 >
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajNote that uploads are credited to the user's account (provided that opti\
 on is selected via the options file).  An example:">
<P "Normal indent" rightIndent:-500 >
<T "^ajThe user has a blue card.  This enables him to 40 minutes on-line, and 5\
 00K of download space.  The user decides to download the following files:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "Filename" underline >
<T "^aj^aj">
<T "Size" underline >
<P "Normal indent" rightIndent:-500 >
<T "a_big_gif.gif^aj^aj450K">
<P "Normal indent" rightIndent:-500 >
<T "another_big_gif^aj^aj75K">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajHe would be denied the second file, because that would be over 500K of t\
 ransfers.  Note that if he downloaded the 450K file and waited the expiration \
 time (12 hours in the example options file), he would be able to download the \
 other file.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajUploads are handled a bit differently.  Of course, a user can upload as \
 many files as he wishes.  When the user wants to upload, he goes to the sectio\
 n he wishes to place the files, and selects the 'Upload' option.  The below st\
 eps then happen:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" firstIndent:500 leftIndent:500 rightIndent:-500 >
<T "1.  He is then prompted for a file transfer protocol.  ">
<P "Normal indent" firstIndent:500 leftIndent:500 rightIndent:0 >
<T "2.  After he selects the protocols, a new directory with the user's name is\
  created in /bbs/tmp.  ">
<P "Normal indent" firstIndent:500 leftIndent:500 rightIndent:0 >
<T "3.  The protocol is then called with the upload option.  ">
<P "Normal indent" firstIndent:500 leftIndent:500 rightIndent:0 >
<T "4.  After the exit of the transfer program, the user is asked whether the u\
 pload was successful.  ">
<P "Normal indent" firstIndent:500 leftIndent:500 rightIndent:0 >
<T "5.  If the upload was not successful, the user is asked whether to keep the\
  partially uploaded files.">
<P "Normal indent" firstIndent:500 leftIndent:500 rightIndent:0 >
<T "6.  If the upload was successful, the user is prompted for each uploaded fi\
 le's description.  ">
<P "Normal indent" firstIndent:500 leftIndent:500 rightIndent:0 >
<T "7.  As the file descriptions are entered, the files are moved to the upload\
 s directory (as defined in /bbs/filehdr/bbs_files_hdr for the section).">
<P "Normal indent" firstIndent:500 leftIndent:500 rightIndent:0 >
<T "8.  If the 'credit uploads' option is turned on in the configuration file, \
 the user is ^ajcredited for upload space and upload time.">
<P "Normal indent" firstIndent:500 leftIndent:500 rightIndent:0 >
<P "Normal indent" firstIndent:500 leftIndent:500 rightIndent:-500 >
<T "Using the Chat System" face:"Times New Roman" >
<P "heading 2" face:"Times New Roman" >
<T "^aj">
<T "New to version 0.95 is a chat subsystem.  This system allows a user to chat\
  with other users on the BBS.  The chat subsystem is broken into 3 major parts\
 :" face:"Times New Roman" >
<P "Normal">
<T "^aj^lh^ajChat rooms (public and club oriented)" face:"Times New Roman" >
<P "Normal">
<T "^aj^lh^ajBroadcasts " face:"Times New Roman" >
<P "Normal">
<T "^aj^lh^ajPrivate one-on-one chatting." face:"Times New Roman" >
<P "Normal">
<P "Normal">
<T "^ajA note about chatting:  " face:"Times New Roman" >
<P "Normal">
<T "^aj^ajChatting is a very complex subsystem.  It uses 'curses', a terminal b\
 ased interface in addition to a lot of inter-process communication.  Due to th\
 is, I don't recommend chatting for BBS systems running on less than a 486 proc\
 essor.  I've tried to optimize the BBS and chat daemons to require little reso\
 urces, but the chat system simply needs more CPU." face:"Times New Roman" >
<P "Normal">
<P "Normal">
<P "Normal">
<T "^aj" face:"Times New Roman" >
<T "Chat Rooms:" bold face:"Times New Roman" >
<P "Normal">
<T "^aj^ajThe BBS supports the use of chat rooms.  These come in three flavors:\
 " face:"Times New Roman" >
<P "Normal">
<T "^aj^aj^lh^ajPublic Chat rooms." face:"Times New Roman" >
<P "Normal">
<T "^aj^aj^lh^ajAccess controlled Chat Club rooms." face:"Times New Roman" >
<P "Normal">
<T "^aj^aj^lh^ajDynamically created Chat rooms." face:"Times New Roman" >
<P "Normal">
<P "Normal">
<T "^ajPublic chat rooms are simple chat rooms configured into the menu system.\
   The user may enter or leave the chat rooms as they wish.  " face:"Times New \
 Roman" >
<P "Normal">
<T "^ajChat Club rooms are public chat rooms that have either a list of users t\
 hat may access the room, or, a password that must be entered correctly prior t\
 o entering the room." face:"Times New Roman" >
<P "Normal">
<T "^ajDynamically created chat rooms are chat rooms that are created by users.\
   A user may enter a chat room number to create the room, and then send their \
 friends mail (or a broadcast, if that is configured) telling them the new chat\
  room number.  This was added to give the BBS a more 'free-form' appearance." \
 face:"Times New Roman" >
<P "Normal">
<P "Normal">
<T "^aj" face:"Times New Roman" >
<T "Broadcasts:" bold face:"Times New Roman" >
<P "Normal">
<T "^ajBroadcasts are short, one line messages sent between users.  Broadcasts \
 may be sent to a single user or sent to all users on the BBS.  Broadcasts are \
 a way for one user to send a quick message to another user.  Some notes about \
 broadcasts:" face:"Times New Roman" >
<P "Normal">
<T "^aj^lh Broadcasts are not guarenteed to make it to their destination.  If a\
  user is using an external application (downloading, reading news, etc), they \
 will not get the broadcast.  This is done so that one user cannot cause anothe\
 r user's download to fail, intentionally or otherwise." face:"Times New Roman"\
  >
<P "Normal">
<T "^aj^lh Broadcasts are expired after a period of time.  If a broadcast is a \
 person-to-person broadcast, and the receiving person gets the broadcast, the b\
 roadcast is immediately dequeued.  If the broadcast isn't received within a ce\
 rtain time frame (configurable in the broadcast daemon), the broadcast is also\
  dequeued." face:"Times New Roman" >
<P "Normal">
<T "^aj^lh Broadcasts only work within the BBS.  If a user has shell access and\
  is not in the BBS program itself, they will not get the broadcast." face:"Tim\
 es New Roman" >
<P "Normal">
<P "Normal">
<T "^aj" face:"Times New Roman" >
<T "Private One-on-One Chatting:" bold face:"Times New Roman" >
<P "Normal">
<T "^ajThe BBS supports private chat between two persons.  This is done through\
  the creation of a chat room for those persons to chat.  This is done by invit\
 ation only." face:"Times New Roman" >
<P "Normal">
<T "^ajIf a user wishes to chat with another person directly, they may select p\
 rivate chatting from a menu.  They are then asked whom they wish to chat with.\
   A broadcast message is then sent to that person, asking them if they wish to\
  chat.  They user is interrupted, and asked whether they wish to chat.  If the\
 y wish to chat, both users are then moved to a private chat room where they ma\
 y converse privately.  If the user does not wish to chat the originating user \
 is informed of their decision." face:"Times New Roman" >
<P "Normal">
<T "^ajNotes about private chat:" face:"Times New Roman" >
<P "Normal">
<T "^aj^lh Private chat uses broadcasts to initiate connections.  See the broad\
 casts section above for broadcast limitations" face:"Times New Roman" >
<P "Normal">
<P "Normal">
<T "^aj" face:"Times New Roman" >
<T "Configuration of the Chat Subsystem:" bold face:"Times New Roman" >
<P "Normal">
<T "^ajYou must edit the /bbs/config/bbsinfo file to configure your chat system\
 .  In particular the CHATHOST line must be changed to the name of your chat se\
 rver machine." face:"Times New Roman" >
<P "Normal">
<P "Normal">
<T "^ajIf you want to use 'clubs' to control access to certain rooms, you need \
 to edit the file /bbs/admin/clubfile.  The format of the file is:" face:"Times\
  New Roman" >
<P "Normal">
<P "Normal">
<T "club_number|\"password\"" face:"Times New Roman" >
<P "Normal">
<T "or" face:"Times New Roman" >
<P "Normal">
<T "club_number|name,name2,name3" face:"Times New Roman" >
<P "Normal">
<P "Normal">
<T "^ajThe two formats allow more flexibility when accessing the clubs.  If you\
  have a list of names, anybody that is not on that list will be denied access \
 to the club chat room.  If you have a password (and the quotes are " face:"Tim\
 es New Roman" >
<T "mandatory" bold face:"Times New Roman" >
<T "), it will ask that user the password for that room.  If the password isn't\
  entered correctly, they will be denied access.  See the file for more informa\
 tion." face:"Times New Roman" >
<P "Normal">
<T "^ajNote that clubs aren't any different than any other room.  If you have a\
  club chat room 10, for example, and use the 'enter public room' command (80) \
 instead of the club connect command (78), it will not ask for a password.  The\
  distinction is entirely up to you." face:"Times New Roman" >
<P "Normal">
<P "Normal">
<T "^ajIt is not necessary to use all of the pieces of the chat subsystem.  If \
 you don't wish to support broadcasts, you may leave that daemon out.  The chat\
  daemons are the following:" face:"Times New Roman" >
<P "Normal">
<T "^aj" face:"Times New Roman" >
<P "Normal">
<T "Daemon" underline face:"Times New Roman" >
<T "^aj" face:"Times New Roman" >
<T "^aj" no-underline face:"Times New Roman" >
<T "Description" underline face:"Times New Roman" >
<P "Normal">
<T "rochatd^aj^ajThe public chat daemon">
<P "Normal">
<T "ropchatd^aj^ajThe private chat daemon" face:"Times New Roman" >
<P "Normal">
<T "robcastd^aj^ajThe broadcast daemon" face:"Times New Roman" >
<P "Normal">
<P "Normal">
<T "^ajThe private chat daemon will not work without the broadcast daemon.  In \
 all other sitations, the systems operate independantly, and do not require one\
  another to operate correctly.  The daemons all use the error logging daemon (\
 errlogd) as their logging mechanism." face:"Times New Roman" >
<P "Normal">
<T "^ajYou may start the daemons at system boot time by adding the following co\
 mmands to the file /etc/rc.d/rc.local" face:"Times New Roman" >
<P "Normal">
<P "Normal">
<T "^aj# start the chat daemon" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "^ajsu bbs -c /bbs/bin/rochatd" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "^aj# start the private chat daemon" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "^ajsu bbs -c /bbs/bin/ropchatd" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "^aj# start the broadcast daemon" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "^ajsu bbs -c /bbs/bin/robcastd" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal">
<T "^ajNote that the above should be started " face:"Times New Roman" >
<T "after" bold face:"Times New Roman" >
<T " the error logging daemon (errlogd)." face:"Times New Roman" >
<P "Normal">
<P "Normal">
<T "^ajThere is one optional file that you may configure to allow the BBS to be\
  more friendly.  In /bbs/config/roomnames, you may 'name' your rooms.  The for\
 mat of the file is such:" face:"Times New Roman" >
<P "Normal">
<P "Normal">
<T "^ajroom_number^ajroom_name" face:"Times New Roman" >
<P "Normal">
<P "Normal">
<T "^ajThat is, the room number (as used within your menus) is on the left, sep\
 arated by a space or tab from the name of the room.  See the file for more inf\
 ormation.  This information is used when looking at room information.  When th\
 e user lists the users in a room, the name of the room is used, if possible." \
 face:"Times New Roman" >
<P "Normal">
<P "Normal">
<T "^aj" face:"Times New Roman" >
<T "Using the Chat Subsystem:" bold face:"Times New Roman" >
<P "Normal">
<T "^ajUse of the chat subsystem is very simple.  Enter the commands to access \
 a room (or set of rooms) in the menus, make sure the daemons are running, and \
 the chat system is up and running." face:"Times New Roman" >
<P "Normal">
<T "^ajFor users, the most important part of the chat subsystem is their termin\
 al type.  The chat subsystem uses 'ncurses', a terminal control system.  If th\
 e user's terminal isn't a good implementation, or the system doesn't have an e\
 ntry for that terminal in the terminfo(5) database, or the user doesn't have h\
 is package configured correctly, that user could have difficulty chatting.  Th\
 e terminal interface software (ncurses) expects the terminal to behave by the \
 specifications of that terminal entry.  If it does not, the screen can get rea\
 lly messed up through the use of cursor control characters.  See the terminfo(\
 5) manual page for more information." face:"Times New Roman" >
<P "Normal">
<P "Normal">
<T "^ajReconfiguring the ANSI terminal type:" bold >
<P "Normal" bold >
<T "^ajNew to version 1.0 of the chat subsystem is the capability to display co\
 lor.  Any user may pick any of the ANSI colors as the colors they wish to see \
 as their own 'chat' colors.  However, the ANSI terminal type, as shipped with \
 Linux (Slackware 2.3 in particular) isn't especially accurate.  See the sectio\
 n on 'Colorizing the BBS' for more information.">
<P "Normal">
<P "Normal">
<T "^aj" face:"Times New Roman" >
<T "Limitations of the Chat Subsystem:" bold face:"Times New Roman" >
<P "Normal">
<T "^ajThe following limits are built into the BBS:" face:"Times New Roman" >
<P "Normal">
<T "^aj30 Public chat rooms" face:"Times New Roman" >
<P "Normal">
<T "^aj30 Private chat rooms" face:"Times New Roman" >
<P "Normal">
<T "^aj10 clients possible per public chat room (300 clients)" face:"Times New \
 Roman" >
<P "Normal">
<T "^aj" face:"Times New Roman" >
<P "Normal">
<T "^ajYou may edit the file \"bbshdr.h\" to change the above.  Change the defi\
 nition for MAX_CHAT_ROOMS.  All of the above will change automatically.  Simpl\
 y recompile the BBS and reinstall." face:"Times New Roman" >
<P "Normal">
<P "Normal">
<T "^ajThe Chat subsystem is a cpu-hungry set of programs.  Caution should be u\
 sed when creating a large chat system that the machine used as a chat server i\
 s capable of handling the load.  Some ideas on load balancing (for a large bbs\
  system):">
<P "Normal" rightIndent:-500 >
<T "^ajTry to split the chatting into manageable chunks.  In particular, in a l\
 arge, busy BBS system, the machine used could become overloaded with both BBS \
 and chatting.  Use another machine to handle the chat servers.  This will allo\
 w the BBS to run without being impacted by the chatting system.">
<P "Normal" rightIndent:-500 >
<T "Testing and Normal Usage" face:"Times New Roman" >
<P "heading 1" rightIndent:-500  face:"Times New Roman" >
<T "Using the System" face:"Times New Roman" >
<P "heading 2" rightIndent:-500  face:"Times New Roman" >
<T "^ajGenerally, a user will log into the system and use it normally without p\
 roblems.  However, there exceptions.  When a user has a shell account, and wis\
 hes to access the BBS, how does he do that?  How does he upload without upload\
 ing through the BBS itself?">
<P "Normal indent" rightIndent:-500 >
<T "^ajThe answer to these questions is to mimic how the BBS works normally.">
<P "Normal indent" rightIndent:-500 >
<T "^ajFor a user to log into the BBS from a shell account, he can type ">
<P "Normal indent" rightIndent:-500 >
<T "^aj/bbs/bbs">
<P "Normal indent" rightIndent:-500 >
<T "^ajAnd he will see the BBS just like everybody that has /bbs/bbs as their l\
 ogin shell.">
<P "Normal indent" rightIndent:-500 >
<T "^ajSimilarly, uploading to the BBS via the command line is accomplished by \
 doing what the BBS does normally.  When a user uploads via the command line, h\
 e should do the following:">
<P "Normal indent" rightIndent:-500 >
<T "^aj1.  Upload the files as he normally would via the command line.">
<P "Normal indent" rightIndent:-500 >
<T "^aj^ajrz">
<P "Normal indent" rightIndent:-500 >
<T "^aj2.  Make a directory in /bbs/tmp with his login name as the name.">
<P "Normal indent" rightIndent:-500 >
<T "^aj^ajmkdir /bbs/tmp/myloginname">
<P "Normal indent" rightIndent:-500 >
<T "^aj3.  Copy the files that are for a particular files section to that direc\
 tory.">
<P "Normal indent" rightIndent:-500 >
<T "^aj^ajcp * /bbs/tmp/myloginname">
<P "Normal indent" rightIndent:-500 >
<T "^aj4.  Enter the BBS.">
<P "Normal indent" rightIndent:-500 >
<T "^aj^aj/bbs/bbs">
<P "Normal indent" rightIndent:-500 >
<T "^aj5.  Go to the files area where the files are to be put.">
<P "Normal indent" rightIndent:-500 >
<T "^aj6.  Select 'upload'.  ">
<P "Normal indent" rightIndent:-500 >
<T "^aj7.  Select zmodem as the protocol.">
<P "Normal indent" rightIndent:-500 >
<T "^aj8.  Type ctrl-x a number of times.  This will abort the upload.">
<P "Normal indent" rightIndent:-500 >
<T "^aj9.  The BBS will ask 'Was the upload successful?'.  Type 'y'.">
<P "Normal indent" rightIndent:-500 >
<T "^aj10.  The BBS will then prompt you for descriptions for all files found i\
 n the ">
<P "Normal indent" rightIndent:-500 >
<T "^aj/bbs/tmp/myloginname directory.">
<P "Normal indent" rightIndent:-500 >
<T "Security" face:"Times New Roman" >
<P "heading 1" rightIndent:-500  face:"Times New Roman" >
<T "How the BBS uses Unix security" face:"Times New Roman" >
<P "heading 2" rightIndent:-500  face:"Times New Roman" >
<T "^ajThe BBS works with the Unix security system so that unusual protection m\
 ethods are not necessary.  Basically, the BBS allows users to access and chang\
 e BBS files via running set-group-id (SGID) 'bbs'.  All files that can be modi\
 fied by users within the BBS must be owned by group BBS, and writable by group\
  BBS.  Directories must have the group write and group execute permissions for\
  user access.  The directory structure and permissions follow:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "The BBS root directory:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "drwxrwx---   7 bbs      bbs          1024 May 22 22:17 admin/" face:"Courie\
 r" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "-rwxr-xr-x   1 bbs      users         516 May 16 20:32 bbs*" face:"Courier"\
  size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "drwxr-xr-x   2 bbs      bbs          1024 May 22 22:01 bin/" face:"Courier"\
  size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "drwxr-xr-x   2 bbs      bbs          1024 May 25 17:21 config/" face:"Couri\
 er" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "drwxrwxr-x   2 bbs      bbs          2048 May 22 22:10 filehdr/" face:"Cour\
 ier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "drwxr-xr-x   8 bbs      bbs          1024 Apr 17 11:54 files/" face:"Courie\
 r" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "drwxr-xr-x   3 bbs      bbs          2048 May 17 21:01 menus/" face:"Courie\
 r" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "drwxr-xr-x   2 bbs      bbs          1024 Feb 23 17:40 new/" face:"Courier"\
  size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "drwxr-xr-x   5 bbs      bbs          1024 Feb 23 16:55 othermounts/" face:"\
 Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "-rwxr-sr-x   1 bbs      bbs        259076 May 22 21:32 rocat*" face:"Courie\
 r" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "drwxr-xr-x   2 bbs      bbs          1024 May 21 22:04 scripts/" face:"Cour\
 ier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "drwxr-xr-x  17 root     root         1024 May 15 20:00 spool/" face:"Courie\
 r" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "drwxr-xr-x   2 bbs      bbs          1024 Apr 20 22:10 text/" face:"Courier\
 " size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "drwxrwxrwt   3 bbs      bbs          1024 May 20 01:08 tmp/" face:"Courier"\
  size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "drwxrwxr-x   2 bbs      bbs          1024 May 22 22:07 uploads/" face:"Cour\
 ier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "drwxr-xr-x  28 bbs      bbs          1024 Feb 24 20:09 users/" face:"Courie\
 r" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500 >
<T "^ajNote that rocat (the BBS program itself) is SGID.  Everything else that \
 needs to be writable (filehdr for files headers, and uploads for new uploads) \
 are writable by the BBS group.  Nothing else should be writable by the BBS gro\
 up, nor should it require BBS write access.">
<P "Normal indent" rightIndent:-500 >
<T "^ajNote that the admin directory permissions are 770.  If your admin direct\
 ory doesn't have exactly the same permissions as above, your BBS will not work\
 .  This is a common problem: BBS users can log in, but they must enter their i\
 nformation every time.  This refers to the permissions of the rocat program an\
 d/or the admin directory.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajNote: Check the above very carefully.  Your permissions should match exa\
 ctly.  Most of the problems I've seen in failed installations was due to the a\
 bove permissions being incorrect." bold size:14 >
<P "Normal indent" rightIndent:-500  bold size:14 >
<T "Security Holes - external programs" face:"Times New Roman" >
<P "heading 2" rightIndent:-500  face:"Times New Roman" >
<T "^ajI can't stress this enough:  ">
<T "WATCH OUT FOR EXTERNAL PROGRAMS" bold >
<T ".  This is how many crackers gain unauthorized access to your system.  In t\
 he directory /bbs/src/utilities can be found notes on how to modify some commo\
 n programs to close some security holes.">
<P "Normal indent" rightIndent:-500 >
<T "Being a System Operator (SysOp)" face:"Times New Roman" >
<P "heading 1" rightIndent:-500  face:"Times New Roman" >
<T "SysOp Utilities" face:"Times New Roman" >
<P "heading 2" rightIndent:-500  face:"Times New Roman" >
<T "^ajThere are a number of utilities I've written to make the BBS easier to m\
 aintain.  They are:">
<P "Normal indent" rightIndent:-500 >
<T "^aj">
<T "Program" underline >
<T "^aj">
<T "Description" underline >
<P "Normal indent" rightIndent:-500 >
<T "^ajfileutil^aj^aja utility for maintaining files areas">
<P "Normal indent" rightIndent:-500 >
<T "^ajerrlogd^aj^ajthe BBS error logger">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajLet's begin with fileutil.  I wrote fileutil to give me more information\
  about my files areas without having to look at the files areas manually.  The\
  options available are c, n, m, u and d.  They are:">
<P "Normal indent" rightIndent:-500 >
<T "^aj">
<T "Option" underline >
<T "^aj^aj">
<T "Description" underline >
<P "Normal indent" rightIndent:-500 >
<T "^ajc^aj^ajcreate files areas.  For ">
<T "INITIAL SETUP ONLY" bold >
<T ".  This option ">
<P "Normal indent" rightIndent:-500 >
<T "^aj^aj^ajwill scan the directories that are supposed to have files in them,\
  ">
<P "Normal indent" rightIndent:-500 >
<T "^aj^aj^ajand automatically add those files to the files area automatically \
 ">
<P "Normal indent" rightIndent:-500 >
<T "^aj^aj^aj(with blank descriptions).  This requires a files area name (just \
 to ">
<P "Normal indent" rightIndent:-500 >
<T "^aj^aj^ajmake sure you want to do this)">
<P "Normal indent" rightIndent:-500 >
<T "^ajn^aj^ajList the new files in all files sections to a file.  Requires a "\
 >
<P "Normal indent" rightIndent:-500 >
<T "^aj^aj^ajfilename to save the list to.">
<P "Normal indent" rightIndent:-500 >
<T "^ajm^aj^ajList the most popular files on the BBS.  Requires a filename to "\
 >
<P "Normal indent" rightIndent:-500 >
<T "^aj^aj^ajsave the list to.">
<P "Normal indent" rightIndent:-500 >
<T "^aju^aj^ajUpdate all files areas for new files and delete those files with \
 ">
<P "Normal indent" rightIndent:-500 >
<T "^aj^aj^ajzero length in their descriptions.">
<P "Normal indent" rightIndent:-500 >
<T "^ajd^aj^ajDelete files that exist in the headers but do not exist in the fi\
 les ^aj^aj^aj^ajdirectory.  You want to do this occasionally to clean out fail\
 ed ^aj^aj^aj^ajuploads and files you may have deleted.  Note:  You want to ">
<P "Normal indent" rightIndent:-500 >
<T "^aj^aj^ajclean up the uploads area prior to executing this command.  If ">
<P "Normal indent" rightIndent:-500 >
<T "^aj^aj^ajyou do not put the files found in the upload area in the files">
<P "Normal indent" rightIndent:-500 >
<T "^aj^aj^ajdirectory, the description for the file will be deleted.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajHere is a sample output from a typical 'new files listing:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "New files in the last 7 days.  (05/25/94)" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "Name           Section                     Date   by    Downloads" face:"Co\
 urier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "cyclone1.cpt   Macintosh Games           05/20/94 sruby     0" face:"Courie\
 r" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "cyclone2.cpt   Macintosh Games           05/20/94 sruby     0" face:"Courie\
 r" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "modvoicer1.1.c Macintosh Sounds          05/22/94 sruby     0" face:"Courie\
 r" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "mono2stereo.cp Macintosh Sounds          05/22/94 sruby     0" face:"Courie\
 r" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "2WayTalker2.1. Macintosh Sounds          05/22/94 sruby     0" face:"Courie\
 r" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "99bottlesofbee Macintosh Sounds          05/22/94 sruby     0" face:"Courie\
 r" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "note           Macintosh Utilities       05/20/94 sruby     0" face:"Courie\
 r" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "eyeballs.sea   Macintosh Utilities       05/20/94 sruby     0" face:"Courie\
 r" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "numbercrunch.s Macintosh Utilities       05/20/94 sruby     0" face:"Courie\
 r" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "todo3.03.sit   Macintosh Utilities       05/20/94 sruby     0" face:"Courie\
 r" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "windows3.0.cpt Macintosh Utilities       05/20/94 sruby     0" face:"Courie\
 r" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "poor-mans-newt Macintosh Utilities       05/20/94 sruby     0" face:"Courie\
 r" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "chemcalc.sit   Macintosh Utilities       05/20/94 sruby     0" face:"Courie\
 r" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "clik'x.sit     Macintosh Utilities       05/20/94 sruby     0" face:"Courie\
 r" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "periodictable. Macintosh Utilities       05/20/94 sruby     0" face:"Courie\
 r" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "intrslip.sea   Macintosh Utilities       05/20/94 sysop     0" face:"Courie\
 r" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "^ajThe 'most popular' listing is similar.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajTypically, you'll run 'new' files, 'most popular' files and 'update' fil\
 es options nightly via cron.  Here is the crontab I use on the BBS to generate\
  the reports automatically to system text files:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "# bbs crontab -- automatic bbs maintenance" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "#" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "# update file sections for new files" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0 3 * * *       setenv BBSDIR /bbs; /bbs/bin/fileutil -u" face:"Courier" si\
 ze:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "#" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "# update new files listing" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "1 3 * * *       setenv BBSDIR /bbs; /bbs/bin/fileutil -n /bbs/text/system2.\
 msg" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "#" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "# update most popular files listing" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "2 3 * * *       setenv BBSDIR /bbs; /bbs/bin/fileutil -m /bbs/text/system3.\
 msg" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500 >
<T "^ajNote how the BBSDIR environment variable is set prior to executing the c\
 ommand.  Mail is sent nightly to 'bbs' for the first command, and the output f\
 or the next two commands go to system2.msg and system3.msg so that users see t\
 he new files and most popular files upon logon.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "User Editing" face:"Times New Roman" >
<P "heading 2" face:"Times New Roman" >
<T "^ajEditing of users is now part of the BBS system itself.  Please refer to \
 the example SysOp menu found in the examples/menus directory.  The menu comman\
 ds you should look at closely are commands 40-43.">
<P "Normal indent">
<P "Normal indent">
<T "40^aj^ajSearch for users to edit/delete">
<P "Normal indent" rightIndent:-500 >
<T "41^aj^ajDelete inactive users">
<P "Normal indent" rightIndent:-500 >
<T "42^aj^ajList inactive users">
<P "Normal indent" rightIndent:-500 >
<T "43^aj^ajList users for edit/delete">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "Notes:">
<P "Normal indent" rightIndent:-500 >
<T "^ajNew to version 1.0 is the automatic editing update of online users.  Sho\
 uld you want to edit a user online, simply edit them as you normally would.  O\
 nce you are done, a file is written to tell the BBS that the user's informatio\
 n has changed and to update their information immediately.">
<P "Normal indent" rightIndent:-500 >
<T "^ajThe above commands will allow you to delete users from your BBS.  Howerv\
 er, they will ">
<T "not " italic >
<T "delete users from the /etc/password.  To do this would require the BBS syst\
 em to run as root (or have some piece that runs as root), which would be an im\
 mense security hole.  The BBS comes with a script in ">
<T "/bbs/scripts/checkpw.pl" italic >
<T " that will check the password and shadow files against the userlog, deletin\
 g the users of the BBS that are no longer in the userlog.  In other words:">
<P "Normal indent">
<T "^aj1.  As the BBS Administrator, run a command 43 from the sysop menu.">
<P "Normal indent">
<T "^aj2.   Get out of the BBS.">
<P "Normal indent">
<T "^aj3.  'su' to root.">
<P "Normal indent">
<T "^aj^ajsu">
<P "Normal indent">
<T "^aj^aj<enter root password>">
<P "Normal indent">
<T "^aj4.  cd to tmp">
<P "Normal indent">
<T "^aj^ajcd /tmp">
<P "Normal indent">
<T "^aj5.  Run the script.">
<P "Normal indent">
<T "^aj^aj/bbs/scripts/checkpw.pl">
<P "Normal indent">
<T "^aj6.  Save your old passwd and shadow.">
<P "Normal indent">
<T "^aj^ajmv /etc/passwd /etc/passwd.old">
<P "Normal indent">
<T "^aj^ajmv /etc/shadow /etc/shadow.old">
<P "Normal indent">
<T "^aj7.  Move your new passwd and shadow to /etc">
<P "Normal indent">
<T "^aj^ajmv ./passwd.new /etc/passwd">
<P "Normal indent">
<T "^aj^ajmv ./shadow.new /etc/shadow">
<P "Normal indent">
<T "^aj8.  Change the permissions back.">
<P "Normal indent">
<T "^aj^ajchown root /etc/passwd">
<P "Normal indent">
<T "^aj^ajchown root.bin /etc/shadow">
<P "Normal indent">
<T "^aj^ajchmod 644 /etc/passwd">
<P "Normal indent">
<T "^aj^ajchmod 640 /etc/shadow">
<P "Normal indent">
<P "Normal indent">
<T "Watching for Problems" face:"Times New Roman" >
<P "heading 2" rightIndent:-500  face:"Times New Roman" >
<T "^ajThe rocat BBS system logs all messages and errors, if at all possible.  \
 However, to do this you must turn on the error logging daemon.  This is done b\
 y logging in as the BBS Administrator, and typing the following command: (from\
  above)">
<P "Normal indent" rightIndent:-500 >
<T "^aj/bbs/bin/errlogd &">
<P "Normal indent" rightIndent:-500 >
<T "^ajThe above command will start the error logging daemon and push it into t\
 he background.  The daemon will run in the background, waiting for messages fr\
 om BBS programs about errors or status messages.">
<P "Normal indent" rightIndent:-500 >
<T "^ajThe file that is used for error logging is /bbs/admin/bbserr.  You'll wa\
 nt to check this file ">
<T "frequently" bold >
<T " in the first months of running the BBS.  This file will tell you if you've\
  got problems with menus, files areas, etc.  It will also tell you who's logge\
 d in, and what they did (within reason).  A sample output would be:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "05/20/94 10:58:30: (S8) Logon for Alpha Tester" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "05/20/94 10:58:54: (S8) Got signal 1" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "05/20/94 10:58:55: (S8) (hangup) Logoff for Alpha Tester" face:"Courier" si\
 ze:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "05/20/94 12:54:19: (S8) Logon for Bill Clinton" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "05/20/94 12:55:03: (S8) Bad line A in files area macapps" face:"Courier" si\
 ze:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "05/20/94 12:55:03: (S8) Filename was bbedit" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "05/20/94 12:56:51: (S8) Logoff for Bill Clinton" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "05/20/94 21:47:20: (S9) Logon for Alpha Tester" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "05/20/94 21:47:45: (S9) Got signal 1" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "05/20/94 21:47:45: (S9) (hangup) Logoff for Alpha Tester" face:"Courier" si\
 ze:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "05/20/94 21:48:51: (S9) Logon for Alpha Tester" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "05/20/94 21:49:06: (S9) Got signal 1" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "05/20/94 21:49:06: (S9) (hangup) Logoff for Alpha Tester" face:"Courier" si\
 ze:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500 >
<T "^ajThe above list shows what goes on in the BBS.  In the first few lines, y\
 ou see Alpha Tester log onto the BBS on tty line ttyS8.  (it was really me doi\
 ng some testing).  The BBS got signal 1 (a hangup, caused by turning off the m\
 odem), which caused the BBS to log the user off.  Note that the BBS will alway\
 s update it's information, if possible, upon logout of a user.  (e.g. if the u\
 ser decides to be tricky and download a bunch of files, and drop carrier in ho\
 pes of getting his time over again, it won't work)">
<P "Normal indent" rightIndent:-500 >
<T "^ajNote that a hangup is not a graceful way to exit the BBS.  You really do\
 n't want people doing this on a regular basis.  It breeds a sense of irrespons\
 ibility in users, and tends to irritate SysOps.">
<P "Normal indent" rightIndent:-500 >
<T "^ajNote 2:  The (S8) in the above example is will show up differently on a \
 multiple machine BBS.  See the section on multiple machine BBSs for more infor\
 mation.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "Troubleshooting" face:"Times New Roman" >
<P "heading 1" rightIndent:-500  face:"Times New Roman" >
<T "Potential Problems" face:"Times New Roman" >
<P "heading 2" rightIndent:-500  face:"Times New Roman" >
<T "^aj">
<T "Most potential problems can be attributed to permissions problems.  See the\
  directory listing of the /bbs directory.  Make sure that your listing looks "\
  face:"Times New Roman" >
<T "exactly" bold face:"Times New Roman" >
<T " the same, permissions wise." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "Additional Information" face:"Times New Roman" >
<P "heading 1" rightIndent:-500  face:"Times New Roman" >
<T "File Formats" face:"Times New Roman" >
<P "heading 2" rightIndent:-500  face:"Times New Roman" >
<T "^aj">
<T "All files found within rocat are completely editable text.  This allows you\
  (the SysOp) to go into the file and look for (and hopefully fix) problems.  I\
  don't feel the BBS is 100% bug free.  You will have corruption happen eventua\
 lly (due to a crash, invalid input, whatever).  Whether it is a bad disk block\
 , a panic of the system or even just a user with a weird combination of letter\
 s, you will see something wrong eventually." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajThere are two files that haven't been described yet, the userlog and a f\
 iles header (there are many files headers in a typical BBS installation).  Let\
 's start with the userlog." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajFor every user in the BBS, there is a userlog record.  The record is com\
 prised of 4 lines of data, space separated.  A typical line follows:" face:"Ti\
 mes New Roman" >
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "[A shaw Greg Shaw shaw CO Westminster ]" face:"Courier" size:8 >
<P "Normal" rightIndent:-500  face:"Courier" size:8 >
<T "[B vt100 769579635 1 0 0 blue 0 0 769579635 ]" face:"Courier" size:8 >
<P "Normal" rightIndent:-500  face:"Courier" size:8 >
<T "[C 0 0 0 1 vi 24 80 english ]" face:"Courier" size:8 >
<P "Normal" rightIndent:-500  face:"Courier" size:8 >
<T "[D 0 200 40 8 769579635 0 76979635 3 1 ]" face:"Courier" size:8 >
<P "Normal" rightIndent:-500  face:"Courier" size:8 >
<P "Normal" rightIndent:-500 >
<T "^ajIn the above, you see my entry.  As you can see, there is a lot of infor\
 mation in the entry, and it's not obvious about what a lot of those 0's and nu\
 mbers mean." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajBefore I jump in, I've labeled each line uniquely with A through D.  Als\
 o, every line is within square brackets.  I didn't add this when I put it into\
  this document.  This format is required for the BBS.  This allows the BBS to \
 check for errors in the Userlog file.  Every record should have an A through D\
  record.  If that format is broken, an error message will be sent to the error\
  logger, and the BBS will exit (to make sure that damage isn't propagated)." f\
 ace:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajThe line formats are:" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "[A login_name first_name last_name alias state city]" face:"Times New Roman\
 " >
<P "Normal" rightIndent:-500 >
<T "[B terminal_type last_logon_time #_of_logons downloads uploads card_color t\
 otal_kused total_timeused validation]" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "[C #_of_private_messages #_of_public_messages credited_time has_color edito\
 r lines columns]" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "[D flags access_level timelimit timeused_last_call anniversary_date K_downl\
 oaded_last_call expiration_time chat_foreground chat_background ]" face:"Times\
  New Roman" >
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "^ajThe fields are (in order of ocurrence):" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "Field" underline face:"Times New Roman" >
<T "^aj^aj" face:"Times New Roman" >
<T "Description" underline face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "(line A)" italic face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "login_name^ajThe name used to logon to the system (from the passwd file)" f\
 ace:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "first name^ajThe user's first name" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "last name^ajThe user's last name" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "alias^aj^ajThe user's alias (to be used for chatting)" face:"Times New Roma\
 n" >
<P "Normal" rightIndent:-500 >
<T "state^aj^ajThe state the user calls from" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "city^aj^ajThe city the user calls from" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "(line B)" italic face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "terminal_type^ajThe terminal type that the user's software supports" face:"\
 Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "last_logon^ajUnix time format (seconds) for when the user last logged on" f\
 ace:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "#_logons^ajThe number of times the user has logged into the system" face:"T\
 imes New Roman" >
<P "Normal" rightIndent:-500 >
<T "downloads^ajThe number of downloads by the user" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "uploads^aj^ajThe number of uploads by the user" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "card_color^ajThe access card color of the user" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "total_kused^ajThe total amount of K downloaded by the user (1.0)">
<P "Normal" rightIndent:-500 >
<T "total_timeused^ajThe total amount of time used by the user (1.0)">
<P "Normal" rightIndent:-500 >
<T "validation^ajThe date when the user was validated (1.0)">
<P "Normal" rightIndent:-500 >
<T "(line C)" italic face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "#_private^ajThe number of private messages the user has entered (not used)"\
  face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "#_public^ajThe number of public messages the user has entered (not used)" f\
 ace:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "credited_time^ajThe number of minutes of credited time the user has availab\
 le" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "has_color^ajDoes the user have color? (0 for no, 1 for yes)" face:"Times Ne\
 w Roman" >
<P "Normal" rightIndent:-500 >
<T "editor^aj^ajThe name of the user's favorite text editor" face:"Times New Ro\
 man" >
<P "Normal" rightIndent:-500 >
<T "lines^aj^ajThe number of lines on the user's display" face:"Times New Roman\
 " >
<P "Normal" rightIndent:-500 >
<T "columns^ajThe number of columns on the user's display" face:"Times New Roma\
 n" >
<P "Normal" rightIndent:-500 >
<T "language^ajThe language selected by the user (or the BBS) (0.86)" face:"Tim\
 es New Roman" >
<P "Normal" rightIndent:-500 >
<T "(line D)" italic face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "flags^aj^ajThe user's access flags" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "access_level^ajThe user's access level" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "timelimit^ajThe number of minutes the user gets per logon" face:"Times New \
 Roman" >
<P "Normal" rightIndent:-500 >
<T "timeused_last_call^ajThe number of minutes the user used last call" face:"T\
 imes New Roman" >
<P "Normal" rightIndent:-500 >
<T "anniversary_date^ajThe date of the first logon by the user" face:"Times New\
  Roman" >
<P "Normal" rightIndent:-500 >
<T "K_downloaded^ajThe amount of 1024 byte blocks the user downloaded last call\
 " face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "expiration_time^ajThe time the user last logged in within the timeout perio\
 d" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "chat_foreground^ajThe color chosen by the user for the display of their cha\
 t.  ">
<P "Normal" rightIndent:-500 >
<T "chat_background^ajThe background color chosen by the user for display of th\
 eir chat.">
<P "Normal" rightIndent:-500 >
<P "Normal" justifyCenter rightIndent:-500 >
<T "^ajSome notes:" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "The city field can be multiple words" face:"Times New Roman" >
<P "Normal" firstIndent:750 leftIndent:1250 rightIndent:-500 >
<T "The login name can be only two words.  The BBS warns users not to enter mor\
 e than two words, or enter an underscore between the last two words." face:"Ti\
 mes New Roman" >
<P "Normal" firstIndent:750 leftIndent:1250 rightIndent:-500 >
<T "timeused_last_call is cumulative over the time period defined by WAITTIME i\
 n the config file.  If the user logs in for 5 minutes at the top of each hour \
 for four hours, the timeused_last_call will be 20.  This is to make sure that \
 users don't get more time than they're supposed to get." face:"Times New Roman\
 " >
<P "Normal" firstIndent:750 leftIndent:1250 rightIndent:-500 >
<T "The credited time field is also cumulative over the WAITTIME period.  After\
  12 hours, that time is discarded." face:"Times New Roman" >
<P "Normal" firstIndent:750 leftIndent:1250 rightIndent:-500 >
<T "Access level, card color and flags are independent of one another.  (see ab\
 ove sections for description)" face:"Times New Roman" >
<P "Normal" firstIndent:750 leftIndent:1250 rightIndent:-500 >
<T "The language will be entered into the userlog field regardless of whether t\
 he BBS uses multiple languages." face:"Times New Roman" >
<P "Normal" firstIndent:750 leftIndent:1250 rightIndent:-500 >
<T "The expiration time is new to 0.90.  This is the time that the user last lo\
 gged in, if within the timeout period set in /bbs/config/bbsinfo file.  If the\
  user hasn't logged in within that time, the user time is reset to their defau\
 lt." face:"Times New Roman" >
<P "Normal" firstIndent:750 leftIndent:1250 rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "^ajThe other file format that hasn't been described is the files header fil\
 e.  A typical line from that file would be:" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "[A shaw 1 pb10.zoo]" face:"Courier" size:8 >
<P "Normal" rightIndent:-500  face:"Courier" size:8 >
<T "[B A GIF/JPEG viewer for VESA systems. ]" face:"Courier" size:8 >
<P "Normal" rightIndent:-500  face:"Courier" size:8 >
<T "[C DOS, VESA compatible driver ]" face:"Courier" size:8 >
<P "Normal" rightIndent:-500  face:"Courier" size:8 >
<T "[D This is a GIF/JPEG viewer for DOS.  It uses VESA compatible modes, so if\
  you]" face:"Courier" size:8 >
<P "Normal" rightIndent:-500  face:"Courier" size:8 >
<T "[E have a VESA compatible driver, get this program. ]" face:"Courier" size:\
 8 >
<P "Normal" rightIndent:-500  face:"Courier" size:8 >
<T "[F  ]" face:"Courier" size:8 >
<P "Normal" rightIndent:-500  face:"Courier" size:8 >
<P "Normal" rightIndent:-500 >
<T "^ajThe files header information is comprised of 6 lines, of the same format\
  as the Userlog information (square brackets and A-F labels).  The contents of\
  a record:" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "[A uploader number_of_downloads filename]" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "[B short description ]" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "[C hardware/software requirements]" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "[D line 1 of long description]" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "[E line 2 of long description]" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "[F line 3 of long description]" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "^ajMost of the above is self explanatory.  A few notes:" face:"Times New Ro\
 man" >
<P "Normal" rightIndent:-500 >
<T "^aj^aj^lh  The filename must not have spaces in it at this point.  I will b\
 e fixing this in the next release.  I will be adding quotes around the filenam\
 e." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^aj^lh  The short description should be less than 40 characters (so that\
  it will fit on the screen)" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^aj^lh  All fields from B onward are optional.  Nothing will be printed \
 if the field is empty." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "Linking External Programs to your BBS">
<P "heading 1" rightIndent:-500 >
<T "Useful programs" face:"Times New Roman" >
<P "heading 2" rightIndent:-500  face:"Times New Roman" >
<T "^aj">
<T "Some of the useful programs I have on my BBS available to BBS users are:" f\
 ace:"Times New Roman" >
<P "Normal" rightIndent:0 >
<T "^aj" face:"Times New Roman" >
<T "Program" underline face:"Times New Roman" >
<T "^aj^aj^aj" face:"Times New Roman" >
<T "Description" underline face:"Times New Roman" >
<P "Normal" rightIndent:0 >
<T "online games^ajOnline games are basically Unix style games run through the \
 BBS interface.  They work remarkably well." face:"Times New Roman" >
<P "Normal" firstIndent:500 leftIndent:2000 rightIndent:0 >
<T "additional editors^ajThe more editors on your system, the better chance a u\
 ser has to edit a message with something that he (or she) has used previously.\
 " face:"Times New Roman" >
<P "Normal" firstIndent:500 leftIndent:2000 rightIndent:0 >
<T "sendmail^ajI've got sendmail setup on my system.  I trust it more than smai\
 l, but that's personal preference.  You really " face:"Times New Roman" >
<T "need " bold face:"Times New Roman" >
<T "a working mail system for a BBS." face:"Times New Roman" >
<P "Normal" firstIndent:500 leftIndent:2000 rightIndent:0 >
<T "cnews^ajThe c-news package for handling the news system.  The news system i\
 s handled automatically in the background.  It requires little maintenance, an\
 d generally polices itself for errors." face:"Times New Roman" >
<P "Normal" firstIndent:500 leftIndent:2000 rightIndent:0 >
<T "tin^ajThe tin newsreader is the best newsreader I've found.  It is easy to \
 use, contains a lot of help, and is menu-driven.  Very handy.  See my notes fo\
 r limiting the security holes found within tin, however, prior to making it av\
 ailable to your users.  ">
<P "Normal" firstIndent:500 leftIndent:2000 rightIndent:0 >
<T "elm^ajAn easy to use mail program with great help (and " face:"Times New Ro\
 man" >
<T "excellent" bold face:"Times New Roman" >
<T " features)" face:"Times New Roman" >
<P "Normal" firstIndent:500 leftIndent:2000 rightIndent:0 >
<T "uqwk^ajAllows offline reading and responding to email and/or news." face:"T\
 imes New Roman" >
<P "Normal" firstIndent:500 leftIndent:2000 rightIndent:0 >
<T "^aj" face:"Times New Roman" >
<P "Normal" rightIndent:0 >
<T "^ajOf course, there are tons of other programs available for Linux (Unix). \
  Add them as you wish; many of them are indespensible for this reason or that \
 reason.  (again, this is a personal opinion)" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "Using UQWK for offline Mail and News">
<P "heading 2" rightIndent:-500 >
<T "^ajSince the last release of the BBS, I've installed UQWK, a QWK mail proce\
 ssor for Unix.  Since so many people use QWK in accessing their BBS, I've incl\
 uded the 1.8 release of UQWK with the BBS source.  The source is found in $BBS\
 DIR/src/utilities/uqwk-1.8.  Use the following to install:">
<P "Normal" rightIndent:-500 >
<T "^aj1.  cd to $BBSDIR/src/utilities/uqwk-1.8">
<P "Normal" rightIndent:-500 >
<T "^aj^ajcd $BBSDIR/src/utilities/uqwk-1.8">
<P "Normal" rightIndent:-500 >
<T "^aj2.  make the program">
<P "Normal" rightIndent:-500 >
<T "^aj^ajmake">
<P "Normal" rightIndent:-500 >
<T "^aj3.  copy the program to $BBSDIR/bin">
<P "Normal" rightIndent:-500 >
<T "^aj^ajcp uqwk $BBSDIR/bin">
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "^ajThere are a number of files included with the BBS that work to make the \
 QWK system work.  They are:">
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "^aj">
<T "Script" underline >
<T "^aj^aj">
<T "Description" underline >
<P "Normal" rightIndent:-500 >
<T "^ajnew_zip_qwk^ajBuilds a QWK packet with a PKZIP 2.04 compatible compresso\
 r ">
<P "Normal" rightIndent:-500 >
<T "^ajold_zip_qwk^ajBuilds a QWK packet in PKZIP 1.XX compatible formation (no\
  compression)">
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "^ajThe above scripts shouldn't need to be edited.">
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "^ajYou should now edit the menu found in $BBSDIR/menus/messages/qwk.  It ha\
 s some specific QWK options build into the menu for the building/processing of\
  QWK packets.  See the man page for uqwk for more information.  (It's located \
 in the source directory.  You may look at it by typing:  nroff -man uqwk.man |\
  more)">
<P "Normal" rightIndent:-500 >
<T "BBS Doors" face:"Times New Roman" >
<P "heading 2" rightIndent:-500  face:"Times New Roman" >
<T "^ajIncluded with the 1.0 release of rocat is the capability to call bbs ext\
 ernals (doors in DOS BBS speak) with the use of a DOS-style door.sys file.  ">
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "Installing the BattleField" face:"Times New Roman" >
<P "heading 3" rightIndent:-500  face:"Times New Roman" >
<T "^ajTo demonstrate the door capability, I've included an old game I wrote ba\
 ck in 1987 (when I was writing BBS externals for Macintosh BBS systems) called\
  BattleField.  To install BattleField, do the following:">
<P "Normal" rightIndent:-500 >
<T "^aj1.  cd to /bbs/src/bf.">
<P "Normal" rightIndent:-500 >
<T "^aj^ajcd /bbs/src/bf">
<P "Normal" rightIndent:-500 >
<T "^aj2.   Execute a make clean.">
<P "Normal" rightIndent:-500 >
<T "^aj^ajmake clean">
<P "Normal" rightIndent:-500 >
<T "^aj3.  Execute a make.">
<P "Normal" rightIndent:-500 >
<T "^aj^ajmake">
<P "Normal" rightIndent:-500 >
<T "^aj4.  Execute a make install to install the program and menus.">
<P "Normal" rightIndent:-500 >
<T "^aj^ajmake install">
<P "Normal" rightIndent:-500 >
<T "^aj5.  Add a command to a menu to execute the program (using command  22) t\
 o your games menu.">
<P "Normal" rightIndent:-500 >
<T "^aj^aj22|p|||||bf|   Play BattleField" face:"Courier" >
<P "Normal" rightIndent:-500  face:"Courier" >
<T "^aj6.  Enter the BBS and enter the game.">
<P "Normal" rightIndent:-500 >
<T "^aj7.  The game will then ask you the parameters to use: ">
<P "Normal">
<P "Normal">
<T "I am unable to find an options file." face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "Would you like to configure The BattleField? [Y/N] Y" face:"Courier" size:8\
  >
<P "Normal" face:"Courier" size:8 >
<P "Normal" rightIndent:-500 >
<T "What is the timelimit for the players to have for one" face:"Courier" size:\
 8 >
<P "Normal" face:"Courier" size:8 >
<T "session in BattleField? (in minutes) [20] " face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "How many times may the player enter the game per day? [2] " face:"Courier" \
 size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "How many days should unread (or not deleted) messages remain" face:"Courier\
 " size:8 >
<P "Normal" face:"Courier" size:8 >
<T "prior to automatic deletion? [7] " face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "How many days before the game automatically resets to clear the board? " fa\
 ce:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "(0 for no reset) [120] " face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "Should BattleField create a scores (rankings) file? [Y/N] y" face:"Courier"\
  size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "Please enter an absolute path for the scores file: " face:"Courier" size:8 \
 >
<P "Normal" face:"Courier" size:8 >
<T "[/bbs/admin/bfscores] " face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "Difficulty: 1 - Easy 10 - Very Hard" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "What difficulty should this game have?  [1] " face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "Please enter the minimum access level for a SysOp: " face:"Courier" size:8 \
 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "I can't find you in the playerfile. " face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" face:"Courier" size:8 >
<T "Would you like me to roll a character for you? [Y/N] n" face:"Courier" size\
 :8 >
<P "Normal" face:"Courier" size:8 >
<P "Normal" rightIndent:-500 >
<T "^ajAs you can see from the above, the options are pretty straightforward.  \
 They are:">
<P "Normal" rightIndent:-500 >
<T "^aj^aj">
<T "Option" underline >
<T "^aj^aj">
<T "Description" underline >
<P "Normal" rightIndent:-500 >
<T "^aj^ajtimelimit^ajThe amount of time the user gets in the game">
<P "Normal" rightIndent:-500 >
<T "^aj^ajentries^aj^ajThe number of entries per day.">
<P "Normal" rightIndent:-500 >
<T "^aj^ajmail_del^aj^ajThe number of days until public/unread mail is deleted"\
 >
<P "Normal" rightIndent:-500 >
<T "^aj^ajreset^aj^ajHow many days a tournament runs (make big for no tournamen\
 t)">
<P "Normal" rightIndent:-500 >
<T "^aj^ajscores^aj^ajThe path to the scores file (plain text).">
<P "Normal" rightIndent:-500 >
<T "^ajdifficulty^ajThe game difficulty.  Keep it easy until people get experie\
 nced.">
<P "Normal" firstIndent:0 leftIndent:2000 rightIndent:-500 localTabs lT:1000 >
<T "^ajaccess^ajThe minimum access level for the SysOp (used so that sysop can \
 enter without restriction)">
<P "Normal" leftIndent:2000 rightIndent:-500 localTabs lT:1000 >
<T "^ajNotes:">
<P "Normal" firstIndent:0 leftIndent:0 rightIndent:-500 localTabs >
<T "^aj^ajTo reset the game, go into the game and inside the sysop menu is a re\
 set option.">
<P "Normal" rightIndent:-500 localTabs >
<T "^aj^ajTo reconfigure the game, delete the file /bbs/config/bf/BattleField O\
 ptions.  At that point, you can">
<P "Normal" rightIndent:-500 localTabs >
<T "^aj^aj^aj re-enter the game and it will ask to be configured once again.">
<P "Normal" rightIndent:-500 localTabs >
<T "^aj^ajThe game is pretty solid.  However, I haven't tested it exhaustively.\
   It's large and very complex.">
<P "Normal" rightIndent:-500 localTabs >
<T "^aj^aj^ajThis makes testing rather difficult.">
<P "Normal" rightIndent:-500 localTabs >
<T "Other Information" face:"Times New Roman" >
<P "heading 1" rightIndent:-500  face:"Times New Roman" >
<T "How to connect to FIDONet" face:"Times New Roman" >
<P "heading 2" rightIndent:-500  face:"Times New Roman" >
<T "^aj">
<T "At this time, I do not have FIDONet installed on my BBS.  I hope to do this\
  in the future.  If you wish to do this, please look at the IFMail package (or\
  other packages) available on the Internet." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "UUCP, Mail and News" face:"Times New Roman" >
<P "heading 2" rightIndent:-500  face:"Times New Roman" >
<T "^aj">
<T "UUCP is the primary transfer medium for many e-mail and news sites.  It is \
 my primary medium.  Please read the Linux HOWTOs and the Linux FAQs for instru\
 ctions for installation and use of UUCP/News/Mail.  These are really complex s\
 ubjects." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "To Do" face:"Times New Roman" >
<P "heading 2" rightIndent:-500  face:"Times New Roman" >
<T "^ajThere are a number of things that I plan to do to continue developing th\
 e BBS interface.  When I initially designed the BBS, I wanted to have a BBS wi\
 th at least the capabilities of current BBS systems (within reason; I don't co\
 nsider a full graphical user interface reasonable at this point).  ">
<P "Normal" rightIndent:-500 >
<T "^ajI'd wanted to have a fully featured monitor system available for release\
  1.0.  However, it turns out that something in the compilation screws up when \
 the monitor is included.  Until I get this fixed, I'm releasing 1.0 wihtout th\
 e monitor.">
<P "Normal" rightIndent:-500 >
<T "^ajI hope to add a 'search all files sections' function to the BBS.  This h\
 as been reqested, but I haven't been able to get around to it yet.">
<P "Normal" rightIndent:-500 >
<T "^ajPerhaps one of these days I'll put a message system in the BBS.  Don't h\
 old your breath ... it's not a trivial operation.">
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "More than two serial lines" face:"Times New Roman" >
<P "heading 2" rightIndent:-500  face:"Times New Roman" >
<T "^ajThis BBS was meant to run with any number of lines/users (provided your \
 computer can handle the load).  However, I wanted to make sure that you unders\
 tand what is related to using more than one serial line.">
<P "Normal indent" rightIndent:-500 >
<T "^ajGenerally, running more than two serial lines requires the use of either\
  a Unix-specific card or a 'smart' card.  The Unix specific card is what I cur\
 rently use in The Roman Catacombs.  I like its capabilities, and especially th\
 e price.  These cards run about $100.00 (US dollars).  However, these cards ca\
 n influence the load on the system because of the number of interrupts generat\
 ed during high-speed file transfers.  ">
<P "Normal indent" rightIndent:-500 >
<T "^ajThis is why I recommend a 'smart' card for anything more than 4 lines.  \
 Cyclades currently offers 'smart' cards for Linux.  I do not know if they work\
  well, but I have heard good things about them.  Other vendors also have smart\
  cards available for Linux (Digiboard and Stallion come to mind).">
<P "Normal indent" rightIndent:-500 >
<T "^ajI know I have glossed over the above two items, but I don't want to re-i\
 terate information that is available in the Linux Frequently Asked Questions a\
 nd the Linux HOWTOs.  For more information, please see these documents.">
<P "Normal indent" rightIndent:-500 >
<T "Multiple Machines and Large Setups" face:"Times New Roman" >
<P "heading 2" rightIndent:-500  face:"Times New Roman" >
<T "Compiling the BBS for multiple machines" face:"Times New Roman" >
<P "heading 3" face:"Times New Roman" >
<T "^ajThe BBS currently supports the reporting of errors with the machine name\
 .  However, this option is turned off by default.  To turn this option on, edi\
 t the file '/bbs/src/bbshdr.h'.  In that file, you'll find a line:">
<P "Normal indent">
<T "^aj#undef^ajMULTIPLE_MACHINE_BBS">
<P "Normal indent">
<P "Normal indent">
<T "^ajChange the undef to a define.  Recompile.  At this point, your error mes\
 sages will look like the following:">
<P "Normal indent">
<P "Normal indent">
<T "10/17/94 02:40:21: (manwe S9) Logon for Loyd Craft" face:"Courier" size:8 >
<P "Normal indent" face:"Courier" size:8 >
<T "10/17/94 02:51:48: (manwe S9) Logoff for Loyd Craft" face:"Courier" size:8 \
 >
<P "Normal indent" face:"Courier" size:8 >
<T "10/17/94 07:27:08: (varda p4) Logon for BBS Administrator" face:"Courier" s\
 ize:8 >
<P "Normal indent" face:"Courier" size:8 >
<T "10/17/94 07:27:24: (varda p4) Unable to find macapps in bbs main files head\
 er." face:"Courier" size:8 >
<P "Normal indent" face:"Courier" size:8 >
<T "10/17/94 07:27:31: (varda p4) Logoff for BBS Administrator" face:"Courier" \
 size:8 >
<P "Normal indent" face:"Courier" size:8 >
<P "Normal indent">
<T "^ajThe changes are reflected in the machine name being placed in front of t\
 he tty.  This can be helpful when you've got a number of machines and errors a\
 re coming from one machine in particular.">
<P "Normal indent">
<P "Normal indent">
<T "Using a restricted shell" face:"Times New Roman" >
<P "heading 3" face:"Times New Roman" >
<T "^ajIn rocat-0.86, I added a '-r' flag to the part that starts external prog\
 rams.  This invoked the 'restricted' part of BASH.  However, I've found that B\
 ASH doesn't come with the restricted feature compiled in, by default.  So, I'v\
 e added another define for restricted BASH in /bbs/src/bbs.h:">
<P "Normal indent">
<T "^aj#undef HAVE_RESTRICTED_BASH">
<P "Normal indent">
<T "^ajIf you have a BASH that works with the '-r' option, change this to a 'de\
 fine' to give yourself a small amount of security.">
<P "Normal indent">
<P "Normal indent">
<T "Monitoring through IP sockets" face:"Times New Roman" >
<P "heading 3" rightIndent:-500  face:"Times New Roman" >
<T "^ajLet me explain a little bit more about how the BBS reports errors and do\
 es it's 'monitor' connections.  ">
<P "Normal indent" rightIndent:-500 >
<T "^ajCurrently, the BBS uses IP sockets as it's primary Inter-Process Communi\
 cations medium (IPC).  This allows you, the SysOp, to monitor the system from \
 another location on the network.  This is done by the changing two lines in th\
 e options (bbsinfo) file:">
<P "Normal indent" rightIndent:-500 >
<T "^aj">
<T "Option" underline >
<T "^aj^aj">
<T "Description" underline >
<P "Normal indent" rightIndent:-500 >
<T "^ajLOGHOST^ajthe hostname of the host that is running the errlog daemon">
<P "Normal indent" rightIndent:-500 >
<T "^ajWATCHHOST^ajthe hostname of the host that is running the monitor daemon"\
 >
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajIf you should have two machines, you can change the above options to poi\
 nt to your other machine, if necessary.  I wrote it this way for two reasons:"\
 >
<P "Normal indent" rightIndent:-500 >
<T "^aj1.  In my opinion (IMO), any BBS machine that runs this program (and doe\
 sn't have tons of horsepower) will be a dedicated machine.   ">
<P "Normal indent" rightIndent:-500 >
<T "^aj2.  Should you wish to run multiple BBS machines, you'd want all error m\
 essages to go to a single file.  I keep this in mind because I've seen quite a\
  few BBSs blossom into HUGE network based systems.  A BBS that focuses on sing\
 le-machine usage limits the growth of the BBS.">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajNow I may be wrong about number one above, but I like to plan for future\
  growth rather than limit myself to single machine designs.">
<P "Normal indent" rightIndent:-500 >
<T "^ajA few notes about running multiple machines:">
<P "Normal indent" firstIndent:500 leftIndent:500 rightIndent:-500 >
<T "^lh When running with multiple machines, you want your most reliable system\
  to run as the error logging system">
<P "Normal indent" firstIndent:500 leftIndent:500 rightIndent:-500 >
<T "^lh Should you run multiple BBS machines, running one pointing to itself an\
 d the other pointing to the first is the best option.">
<P "Normal indent" firstIndent:500 leftIndent:500 rightIndent:-500 >
<T "^lh If you have two linux boxes and want to run the BBS on one and the erro\
 r logging processes on the other, please remember that no error logging will b\
 e done should you, for instance, reboot to DOS to play a quick game of DOOM.  \
 In this case, you'll want error logging to stay on the BBS machine.">
<P "Normal indent" firstIndent:500 leftIndent:500 rightIndent:-500 >
<T "^lh If it wasn't clear before, running the error logging daemon is optional\
 , but generally useful.  It isn't necessary to run the logger, but if it is no\
 t running, it won't be able to tell you should an error occur.">
<P "Normal indent" firstIndent:500 leftIndent:500 rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "Terminal Servers" face:"Times New Roman" >
<P "heading 3" rightIndent:-500  face:"Times New Roman" >
<T "^ajAnother option that I didn't discuss was the use of terminal servers as \
 a front end to the BBS.  Terminal servers are dedicated computers that interfa\
 ce with modems and connect from the modem to the target computer upon connecti\
 on.  This allows the computer to off load communications interrupts from the m\
 achine.  All traffic comes (and goes) across the network.  ">
<P "Normal indent" rightIndent:-500 >
<T "^ajAt this point, I'd consider my dream BBS to be the following:">
<P "Normal indent" rightIndent:-500 >
<T "^ajA number of BBS machines (top of the line X86 or Alpha machines) with hi\
 gh-bandwidth busses.">
<P "Normal indent" rightIndent:-500 >
<T "^ajNetwork (ethernet, probably) to communicate between the boxes.">
<P "Normal indent" rightIndent:-500 >
<T "^ajA couple of terminal servers to handle the communications chores.">
<P "Normal indent" rightIndent:-500 >
<T "^ajA direct connect to the Internet through a dedicated 64Kbps line or an I\
 SDN line.">
<P "Normal indent" rightIndent:-500 >
<T "^ajTONS of disk space (of course)">
<P "Normal indent" rightIndent:-500 >
<T "^ajTONS of phone lines">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "^ajThis may not be especially practical, but I do like to dream!">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "The Roman Catacombs Setup" face:"Times New Roman" >
<P "heading 2" rightIndent:-500  face:"Times New Roman" >
<T "^ajIn this section, I'd like to describe exactly what my BBS looks like.  T\
 his is to allow you, the potential SysOp, to see what I've done with the BBS a\
 nd give you some ideas on how you'd like your BBS to look.">
<P "Normal indent" rightIndent:-500 >
<T "^ajBasically, I've created a BBS that runs in the directories described in \
 the previous sections.  However, I've done a few things that aren't obvious in\
  the previous discussions.  In particular, I've got a somewhat hierarchical me\
 nu system with respect to the Linux files areas.">
<P "Normal indent" rightIndent:-500 >
<T "^ajI currently support direct access to the Linux areas of the BBS without \
 authorization or pre-checking.  This allows someone to download the Linux disk\
 s that they require without running into upload/download limits and time const\
 raints (within reason; I don't want them to download the entire set at one tim\
 e, it would take too much time)  Basically, I've got a Linux user.  I've delet\
 ed his password so that no password is required.  He has his own 'card', which\
  allows 2500K of download per session, and unlimited download privileges.  The\
  Linux user can do only one thing.  That is, he can download Linux disks, and \
 that is it.  Here is the main menu:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "0||||||| Roman Catacombs                                                 En\
 try Vault" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0||||||| ------------------------------------------------------------------\
 ---------" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                                   Exit" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                                      <G>" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                        ----------------------------" face:"Courier\
 " size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                        H>elp" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                    <W> P>rivate Mail              <E>" face:"Couri\
 er" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||          Art Studio -- R>egistration Instructions -- Computer File\
 s" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                        U>tilities" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0||400|>||||                        S<Y>sop's Area" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                        C>hat with SysOp" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0||51|<||||                        L>inux Files Areas" face:"Courier" size:\
 8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                        ----------------------------" face:"Courier\
 " size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                                      <S>" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                               News and Games" face:"Courier" size:\
 8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0||||||| ------------------------------------------------------------------\
 ---------" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0||||||| <-> Previous Menu     <F> Feedback to SysOp   <G> Quick Logout" fa\
 ce:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "1|g||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "3|-||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "8|c||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "2|y|400|>|||sysop|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "2|e|||||computerfiles|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "2|w|||||art_studio|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "2|s|||||newsngames|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "2|u|||||utilities|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "2|l|50|<|||linuxtop|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "21|f|||||elm -s feedback shaw|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "2|p|||||mail|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "10|r|||||reg.instr|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "2|h|||||helptop|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500 >
<T "^ajThe Linux user's access level is set to be 50.  If you'll look at the li\
 ne containing 'linuxtop', you'll see that anybody with access below 51 (50 or \
 below) will see the 'Linux Files Areas' menu option.">
<P "Normal indent" rightIndent:-500 >
<T "^ajWhen the user selects the Linux Files Areas option, he is transferred to\
  the following menu:">
<P "Normal indent" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<T "0||||||| Roman Catacombs                                                   \
 Linux Top" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0||||||| ------------------------------------------------------------------\
 ---------" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                        ----------------------------" face:"Courier\
 " size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                        1. Slackware Distribution" face:"Courier" s\
 ize:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                        2. Linux Source" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                        3. Linux Utilities (source)" face:"Courier"\
  size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                        H. Help" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||                        ----------------------------" face:"Courier\
 " size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0|||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0||||||| ------------------------------------------------------------------\
 ---------" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "0||||||| <-> Previous Menu     <F> Feedback to SysOp   <G> Quick Logout" fa\
 ce:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "1|g||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "3|-||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "8|c||||||" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "2|1|||||linux/linuxslackware|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "2|2|||||linux/linuxsource|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "2|3|||||linux/linuxutilities|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "21|f|||||elm -s feedback shaw|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<T "2|h|||||helptop|" face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500  face:"Courier" size:8 >
<P "Normal indent" rightIndent:-500 >
<T "^ajThe operation that isn't obvious is the menu transfers at the bottom of \
 the menu.  Note how there is a slash in the menu title.  If the user selects '\
 1', he will be transferred to the menu named (with full path) /bbs/menus/linux\
 /linuxslackware.  This sort of operation allows you to nest menu directories b\
 ased on subject, type of operation, etc.  ">
<P "Normal indent" rightIndent:-500 >
<T "Updating from a previous release">
<P "heading 1" rightIndent:-500 >
<T "Updating from rocat 0.75" face:"Times New Roman" >
<P "heading 2" face:"Times New Roman" >
<T "^aj">
<T "There have been a number of changes since 0.75.  They are:" face:"Times New\
  Roman" >
<P "Normal">
<T "^aj^aj^lh Bug fixes (of course!)" face:"Times New Roman" >
<P "Normal">
<T "^aj^aj^lh Support for CD-ROM filesystems" face:"Times New Roman" >
<P "Normal">
<T "^aj^aj^lh A change in the configuration of the files header files to elimin\
 ate duplicated ^ajinformation." face:"Times New Roman" >
<P "Normal">
<T "^aj" face:"Times New Roman" >
<P "Normal">
<T "^ajSee the CD-ROM section for how to setup a CD-ROM section." face:"Times N\
 ew Roman" >
<P "Normal">
<P "Normal">
<T "^ajThe files section header used to contain both the size of the file and t\
 he date the file was uploaded.  I did this so that I wouldn't have to look up \
 the file on every access.  " face:"Times New Roman" >
<P "Normal">
<P "Normal">
<T "^ajWell, it turned out that I started doing that anyway so that I could ind\
 icate whether the file was available.  Combining the two operations resulted i\
 n the file information being read from the directory structure 'live'.  Note t\
 hat this could impact a large files section (~500 files or larger) on a slow d\
 rive (aka CD-ROM)." face:"Times New Roman" >
<P "Normal">
<P "Normal">
<T "^ajDue to the change in the files header, you *MUST* update your files sect\
 ion headers to the new format prior to installing the program.  I've furnished\
  a program, filesupdate, that will do this for you.  Simply run the program fo\
 r usage (and *SAVE* a copy of your old sections, just for security)." face:"Ti\
 mes New Roman" >
<P "Normal">
<P "Normal">
<T "Updating from rocat 0.80" face:"Times New Roman" >
<P "heading 2" face:"Times New Roman" >
<T "There have been a number of changes to rocat since 0.75:" face:"Times New R\
 oman" >
<P "Normal">
<T "^aj^lh  All text that the user can see has been extracted from the BBS and \
 placed into a single file in the /bbs/src/lang directory.  See the language se\
 ction for setup and use." face:"Times New Roman" >
<P "Normal">
<T "^aj^lh The BBS now operates differently when executing external application\
 s.  Prior to now, when the user executed the external, no time checking was do\
 ne.  This allowed the user to take as much time as (s)he wanted in the externa\
 l.  In this version, the BBS starts the external and watches the time.  (it sl\
 eeps for 10 seconds between waits)  When the user is down to 3 minutes, (s)he \
 is warned that their time is about to expire and to log out.  At 1 minute, the\
 y're given a similar warning.  When their time is up, the external is killed a\
 nd the BBS logs the user out." face:"Times New Roman" >
<P "Normal">
<T "^aj^lh With regard to the above option, I've added the FUDGETIMELIMIT optio\
 n in the bbsinfo.  This is used when the user has used all of their time downl\
 oading and is still in the process of downloading.  This option was added in h\
 opes of the user overestimating their download time being able to finish their\
  download.  Notes:" face:"Times New Roman" >
<P "Normal">
<T "^aj^aj1.  This is only available on download.  Other externals get the prev\
 ious option's treatment." face:"Times New Roman" >
<P "Normal">
<T "^aj^aj2.  The FUDGETIMLIMIT percentage is computed from the remaining time \
 that the user has.  In other words, if he has only 5 minutes left from an hour\
 , he only has 5% of the 5 minutes available.  (it uses minute granularity)" fa\
 ce:"Times New Roman" >
<P "Normal">
<T "^aj^lh When a user marks a file and continues to view the downloads area, i\
 t will now place a star to mark those files that the user has 'marked' for dow\
 nload." face:"Times New Roman" >
<P "Normal">
<T "^aj^lh There is a new option in the bbsinfo file that allows the sysop to t\
 urn off mail checking.  If you don't want the BBS to check for mail at any tim\
 e, set CHECKMAIL to 0 in bbsinfo." face:"Times New Roman" >
<P "Normal">
<T "^aj^lh The BBS now has a 'reset stack' menu command.  This works like a com\
 mand 2 (change menu), but rather than push the menu onto the stack, this menu \
 empties the stack.  This results in the new menu being the new 'root' menu.  T\
 his would be used (for example) if you had two sets of menus, one for ascii an\
 d one for ansi.  The main menu would have a question asking what type of menus\
  you want.  The command would be a command 9, and the new menus (ansi or ascii\
 ) would then be the new 'root' menu." face:"Times New Roman" >
<P "Normal">
<T "^aj^lh And, of course a few bug fixes here and there.  See the changelog fo\
 r more information." face:"Times New Roman" >
<P "Normal">
<P "Normal">
<T "^ajTo update from rocat 0.80, you need to update your bbsinfo file to refle\
 ct the new options found there (CHECKMAIL and FUDGETIMELIMIT).  Use the exampl\
 e found in the archive to make sure you've got everything.  Other than that, t\
 here isn't anything more to be updated." face:"Times New Roman" >
<P "Normal">
<P "Normal">
<T "Updating from rocat-0.85" face:"Times New Roman" >
<P "heading 2" face:"Times New Roman" >
<T "^ajThe major change of the BBS from 0.85 to 0.86 was the inclusion of a lan\
 guage object that interfaces with the BBS to show the user the language that h\
 e wishes to use.  Due to this, I needed to have the capability to select the l\
 anguage on a user-by-user basis.  I've added the name of the language file int\
 o the userlog database in line 3 (C).  If you're running 0.85, you'll need to \
 edit your userlog file to add this filename.  I've included a utility called "\
  face:"Times New Roman" >
<T "userupdate" italic face:"Times New Roman" >
<T " that will update your userlog file and save it in a file called " face:"Ti\
 mes New Roman" >
<T "userlog.new." underline face:"Times New Roman" >
<T "  It does not overwrite the userlog file.  You must manually move the userl\
 og.new file to userlog after checking to make sure things are OK.  (I don't fo\
 resee any problems)" face:"Times New Roman" >
<P "Normal">
<T "^ajI've added a feature that will ask users, upon logon, for their first an\
 d last names.  It has been reported that the BBS will incorrectly put users wi\
 th only one entry in the gecos (real name) field of the passwd file into the u\
 serlog with a bad first or last name.  If the BBS can't figure out the passwd \
 entry for these users, it will now ask them what their first name and last nam\
 e are.  Note that there is no 'badword' checking on these entries.  Note also \
 that the BBS does not update user's information after the initial log-on.  Thi\
 s means that users that already exhibit this problem will have to be corrected\
  manually by the SysOp." face:"Times New Roman" >
<P "Normal">
<T "^ajThere have been many small enhancements to the BBS.  I won't go into the\
 m here, but the BBS should simply work better than it has in the past." face:"\
 Times New Roman" >
<P "Normal">
<P "Normal">
<T "Updating from rocat-0.86" face:"Times New Roman" >
<P "heading 2" face:"Times New Roman" >
<T "^aj" face:"Times New Roman" size:12 >
<T "There were some very major changes in 0.90.  The menu system is now much ea\
 sier to setup, and, ANSI color support is now available.  The major change wit\
 h regard to upgrading was the userlog file.  At the end of line D, there is no\
 w an expiration date.  This is used when checking whether to reset the user's \
 time to default.  " face:"Times New Roman" >
<P "Normal">
<T "^ajThe userupdate function has changed to automatically update the userlog \
 file for you.  Enter the following (as the BBS administrator) to update your u\
 serlog:" face:"Times New Roman" >
<P "Normal">
<T "^ajuserupdate 0.86" face:"Times New Roman" >
<P "Normal">
<T "^ajThis will update the userlog file.  However, it will not replace your ex\
 isting userlog file with the updated version (for safety).  Copy the existing \
 userlog file to userlog.bak (or something similar) and then move userlog.new t\
 o userlog.  The 0.90 version of rocat will then function normally." face:"Time\
 s New Roman" >
<P "Normal">
<T "^ajOne other item must be updated.  The bbsinfo has changed to define defau\
 lt colors and attributes for the BBS.  I'd recommend saving your old bbsinfo c\
 onfiguration file and starting fresh with the one supplied with the BBS.  Of c\
 ourse, you can cut and paste if you feel confident you won't miss anything." f\
 ace:"Times New Roman" >
<P "Normal">
<T "Updating from 0.90-0.92" face:"Times New Roman" >
<P "heading 2" face:"Times New Roman" >
<T "^aj">
<T "Updates from 0.90 to the current revision basically entails replacing the b\
 bsinfo file with the new version.  Use the following to update:" face:"Times N\
 ew Roman" >
<P "Normal">
<T "^aj1.  Save a copy of your existing bbsinfo file." face:"Times New Roman" >
<P "Normal">
<T "^aj2.  Copy in the new bbsinfo file." face:"Times New Roman" >
<P "Normal">
<T "^aj3.  Edit the bbsinfo file to add your existing information." face:"Times\
  New Roman" >
<P "Normal">
<P "Normal">
<T "Updating from 0.92" face:"Times New Roman" >
<P "heading 2" face:"Times New Roman" >
<T "^ajIn general, the same process as above should be used to update from 0.92\
  to 0.95.  There are a number of files that you'll want to add:" face:"Times N\
 ew Roman" >
<P "Normal">
<T "^aj/bbs/config/roomnames" face:"Times New Roman" >
<P "Normal">
<T "^aj/bbs/admin/clubfile" face:"Times New Roman" >
<P "Normal">
<T "^ajNote that both are optional.  See the chat section for more information \
 about these files." face:"Times New Roman" >
<P "Normal">
<T "^ajIn the latest Slackware, the useradd and groupadd programs are no longer\
  avaailable.  Due to this, the way the BBS uses the 'new' user account and how\
  the BBS operates has been changed.  You'll want to update the following scrip\
 ts with those found in the distribution:">
<P "Normal">
<T "^aj/bbs/bbs">
<P "Normal">
<T "^aj/bbs/scripts/login.scr">
<P "Normal">
<T "^aj/bbs/scripts/addbbsuser">
<P "Normal">
<T "^ajIn addition, you'll want to reconfigure the 'new' user record.  See the \
 'new' user setup for more information.  Basically, the 'new' user is no longer\
  an alias for the 'root' user.  The 'new' user may be a normal (non root) user\
 .">
<P "Normal">
<T "^ajThere is now an additional program, anu, that is installed to replace th\
 e useradd function.  It must be installed by the root user for the BBS to func\
 tion correctly.  See the section on installation for more information.">
<P "Normal">
<T "Updating from 0.95/0.96">
<P "heading 2">
<T "^ajThe move from 0.95/0.96 to 1.0 isn't trivial.  I've added some very seri\
 ous features to the BBS that, if not done correctly, will make your BBS stop w\
 orking.  The pieces that have to be done are:">
<P "Normal">
<T "^aj1.  Install shadow passwords.">
<P "Normal">
<T "^aj2.  Convert your userlog using userupdate.">
<P "Normal">
<T "^aj3.  Installing a new /bbs/bbs script.">
<P "Normal">
<T "^aj4.  Installing the new programs (anu, rocat, etc).">
<P "Normal">
<T "^aj5.  Installing the new bbsinfo file.">
<P "Normal">
<T "^aj6.  Creating new directories.">
<P "Normal">
<T "^ajThe above steps, in detail:">
<P "Normal">
<P "Normal">
<T "^aj1.  Install shadow passwords.  See the section on shadow passwords for m\
 ore information.">
<P "Normal">
<T "^aj^ajNote:  the 'new' user record in /etc/shadow ">
<T "must " bold >
<T "be deleted.">
<P "Normal">
<T "^aj2.  Convert your userlog using userupdate.">
<P "Normal">
<T "^aj^aj1.  /bbs/bin/userupdate -v 0.89">
<P "Normal">
<T "^aj^aj2.  Follow the directions at the end of the update.">
<P "Normal">
<T "^aj3.  Install new /bbs/bbs script.">
<P "Normal">
<T "^aj4.  Install new programs.">
<P "Normal">
<T "^aj^aj1.  Kill all bbs daemons running.  (errlogd, rochatd, robcastd, ropch\
 atd)">
<P "Normal">
<T "^aj^aj2.  Delete the existing 'anu' program.  ">
<P "Normal">
<T "^aj^aj^ajsu ">
<P "Normal">
<T "^aj^aj^aj<root password>">
<P "Normal">
<T "^aj^aj^ajrm $BBSDIR/bin/anu">
<P "Normal">
<T "^aj^aj^ajexit">
<P "Normal">
<T "^aj^aj2.  'make install' from the bbs source directory (as shown in the dir\
 ections above).">
<P "Normal">
<T "^aj^aj3.  su to root">
<P "Normal">
<T "^aj^aj4.  'make anu-install'">
<P "Normal">
<T " ^aj^aj5.  Copy all new scripts to the /bbs/scripts directory.">
<P "Normal">
<T "^aj5.  Install new bbsinfo file.">
<P "Normal">
<T "^aj^aj1.  Save your existing bbsinfo file.">
<P "Normal">
<T "^aj^aj^ajcp /bbs/config/bbsinfo /bbs/config/bbsinfo.save">
<P "Normal">
<T "^aj^aj2.  Copy the new bbsinfo file to /bbs/config.">
<P "Normal">
<T "^aj^aj3.  Edit the new bbsinfo file to reflect your current BBS configurati\
 on.">
<P "Normal">
<T "^aj6.  Create new directories.">
<P "Normal">
<T "^aj^aj1.  mkdir /bbs/spool">
<P "Normal">
<T "^aj^aj2.  mkdir /bbs/spool/door">
<P "Normal">
<T "^aj^aj3.  chmod 1777 /bbs/spool/door">
<P "Normal">
<T "^aj">
<P "Normal">
<T "^ajIf you have problems, send me a message.  It's very difficult to test up\
 dating due to the amount of work to tear down and rebuild a BBS.">
<P "Normal">
<P "Normal">
<P "Normal">
<T "BBS revision history (and future)" face:"Times New Roman" >
<P "heading 1" face:"Times New Roman" >
<T "^aj">
<T "The following documents where the BBS has gone.  Please take future version\
  information with a grain of salt." face:"Times New Roman" >
<P "Normal">
<T "Version" underline face:"Times New Roman" >
<T "^aj^aj" face:"Times New Roman" >
<T "Notes" underline face:"Times New Roman" >
<P "Normal">
<T "0.70^aj^ajNot publically released" face:"Times New Roman" >
<P "Normal">
<T "0.75^aj^ajFirst publically released version" face:"Times New Roman" >
<P "Normal">
<T "0.80^aj^ajAdded CD-ROM file section support and removed some extraneous inf\
 ormation" face:"Times New Roman" >
<P "Normal">
<T "0.85^aj^ajSeparated the BBS strings to separate files for easier foreign la\
 nguage" face:"Times New Roman" >
<P "Normal">
<T "^aj^ajconfiguration" face:"Times New Roman" >
<P "Normal">
<T "0.86^aj^ajCreated language object to display the language that a user selec\
 ts upon initial" face:"Times New Roman" >
<P "Normal">
<T "^aj^ajlogon." face:"Times New Roman" >
<P "Normal">
<T "0.90^aj^ajRe-design of the menu system to allow the following capabilities:\
 " face:"Times New Roman" >
<P "Normal">
<T "^aj^aj^aj^lh  'Include' of menus.  This allows creation of menu templates" \
 face:"Times New Roman" >
<P "Normal">
<T "^aj^aj^aj^lh  Color changes" face:"Times New Roman" >
<P "Normal">
<T "^aj^aj^aj^lh  Macro definitions (for common strings)" face:"Times New Roman\
 " >
<P "Normal">
<T "0.91^aj^ajUpdate of color system" face:"Times New Roman" >
<P "Normal">
<T "0.92^aj^ajMore updates and bug fixes" face:"Times New Roman" >
<P "Normal">
<T "0.95^aj^ajIntroduction of the Chat subsystem." face:"Times New Roman" >
<P "Normal">
<T "Future" underline face:"Times New Roman" >
<T " (potential)" face:"Times New Roman" >
<P "Normal">
<T "1.00^aj^ajAccount expiration/validation/limitation, shadow passwords, bug f\
 ixes." face:"Times New Roman" >
<P "Normal">
<T "1.05^aj^ajIntroduction of a fully-featured BBS monitor">
<P "Normal">
<T "Conclusion" face:"Times New Roman" >
<P "heading 1" rightIndent:-500  face:"Times New Roman" >
<T "^aj">
<T "I really must apologize for the brevity of this document.  It's a rush job.\
   In the future, I want to put the following things into this document:" face:\
 "Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^aj^lh  A walk through for those who have never run a BBS before." face:\
 "Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^aj^lh  More pointers on how to setup the BBS for Linux" face:"Times New\
  Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^aj^lh  More examples" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "^ajWell, that's where it has to end.  This BBS isn't finished, but it works\
  " face:"Times New Roman" >
<T "really" bold face:"Times New Roman" >
<T " well.  I think the BBS has some of the most powerful capabilities I've eve\
 r seen.  This, coupled with the native programs and services available on Linu\
 x (Unix) make the BBS a " face:"Times New Roman" >
<T "very" bold face:"Times New Roman" >
<T " powerful system." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "To Contact Me" face:"Times New Roman" >
<P "heading 1" rightIndent:-500  face:"Times New Roman" >
<T "^aj">
<T "PLEASE" bold face:"Times New Roman" >
<T " don't expect me to walk you through your installation.  I've tried to expl\
 ain how to setup the BBS as completely as possible.  " face:"Times New Roman" \
 >
<P "Normal" rightIndent:-500 >
<T "^aj" face:"Times New Roman" >
<T "If you want support, I expect payment for services rendered.  I will offer \
 service contracts, should you wish it. (and want to pay for the BBS program) N\
 ote that paying for the BBS does not mean you are entitled to support.  A supp\
 ort contract involves costs beyond the price of the BBS.  (e.g. it's additiona\
 l)" bold italic face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajI expect you, the SysOp, to ask the Internet (through news) about proble\
 ms with configuration and/or bugs prior to contacting myself.  If I'm not very\
  wrong, there will be a LOT of SysOps running this software in a short amount \
 of time.  I am very very very busy, and expect to be so in the near future.  I\
 f a question is either obvious (RTFM) or not on the topic of the rocat BBS sys\
 tem, I will send it to /dev/null." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "^ajThere is now a rocat mailing list available.  To subscribe, send 'subscr\
 ibe' in the body of a message to:" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^ajrocat@manwe.fmsoft.com" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajThis will subscribe your email-address to the rocat mailing list.  The m\
 ailing list is used for up to date news, patches and utilities that other SysO\
 ps have come up with with respect to the rocat system.  I highly recommend sub\
 scribing to this list." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajIf you get the BBS up and running, please drop me a note.  I like to hea\
 r about success stories.  Also, if you have any (reasonable) ideas, please dro\
 p me a note." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajI wrote this BBS to be a " face:"Times New Roman" >
<T "free " bold face:"Times New Roman" >
<T "software package.  I don't expect payment.  However, should you find it in \
 your heart (and wallet) to send me $50.00 (or a case of good beer), send it to\
 :" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajfmSoft, Inc." face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj% Gregory Shaw" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj8060 Lowell Blvd" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^ajWesminster CO 80030" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "^ajI may always be contacted at my BBS:" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^ajThe Roman Catacombs" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^aj(303) 429-8914 (v.32bis)" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^aj(303) 429-6257 (v.34)">
<P "Normal" rightIndent:-500 >
<P "Normal" rightIndent:-500 >
<T "^ajAnd, of course, Internet mail:" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<T "^aj^ajshaw@fmsoft.com" face:"Times New Roman" >
<P "Normal" rightIndent:-500 >
<P "Normal indent" rightIndent:-500 >
<section  next_column pageWidth:8500 pageHeight:11000 leftMargin:1250 rightMarg\
 in:1250 topMargin:1000 bottomMargin:1000 bindingMargin:0 oddHeader:None firstH\
 eader:None oddFooter:Normal "_AX_HF_1" firstFooter:None sectNumFmt:-1 sectPage\
 Sep:"-" pageNumFmt:0 pageNumCtl:0>
<end_flow>
<start_hdrftr "_AX_HF_1">
<T "The rocat BBS System, copyright " face:"Arial" size:8 >
<T "^nd" face:"Symbol" >
<T " 1994-1995 by Gregory Shaw and fmSoft, Inc.  All Rights Reserved " face:"Ar\
 ial" size:8 >
<T "^aj">
<S_F>
<T "page_number ">
<FV>
<T "40">
<E_F>
<P "footer">
<end_hdrftr>
<start_vars>
<V "PathName$" "/home/shaw/bbsinstl.aw">
<V "DocName$" "bbsinstl.aw">
<V "Language@" 1>
<V "Creator$" "Applix Words">
<V "Created$" "Release 4.00 (build 1081643499) #-2061584302">
<V "AxCreationCodeVersion$" "Mon Apr 10 14:20:30 1995">
<V "CreationDate$" "Sun May 14 12:28:14 1995">
<V "CreationUser$" "shaw">
<V "Updated$" "Release 4.10 (build 1081791528) #-171798692">
<V "AxUpdateCodeVersion$" "Sat Jun  3 08:30:54 1995">
<V "UpdateDate$" "Mon Sep 25 14:54:16 1995">
<V "UpdateUser$" "shaw">
<V "DocWindowAttrType@" 1>
<V "DocWindowSize$" < 11121 8907>>
<V "ReadOnly@" 0>
<end_vars>
<end_document>
*END WORDS