home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / MISC / PPPBB301.ZIP / PPPBBS.DOC < prev    next >
Text File  |  1998-02-17  |  116KB  |  2,646 lines
  1.  
  2.                            PPPBBS Version 3.01
  3.                             (DOC Revision 27)
  4.                           ---------------------
  5.                     Copyright (C) Roland De Graaf 1998
  6.                            All Rights Reserved
  7.                              ---------------
  8.                        http://www.degraaf.net
  9.                        http://www.ameritech.net/users/pppbbs/index.htm
  10.                        http://pppbbs.dyndns.com
  11.                        ftp://pppbbs.dyndns.com
  12.                        telnet://pppbbs.dyndns.com
  13.  
  14.  
  15.      INTRODUCTION
  16.      ------------
  17.  
  18.         PPPBBS is the ultimate Internet-based BBS/TCPIP host
  19.      telecommunications software.  It is a multi-functional
  20.      program, focused toward TCP/IP connectivity with minimal
  21.      expense.  For a complete list of major features, please
  22.      see FEATURES.DOC.
  23.  
  24.         When you dial your internet service provider and connect
  25.      your computer to the internet, you are most likely using the
  26.      Point-to-Point-Protocol, also known as PPP.  Put in simple
  27.      terms, PPP is a way for two computers to communicate together
  28.      for networking purposes, such as running TCP/IP applications
  29.      like web browsers, ftp clients, and so on.   PPP does the work
  30.      necessary to dial/answer the modem, negotiate session options,
  31.      authenticate username/password, negotiate the IP address, and
  32.      allow TCP/IP and UDP/IP to communicate over the data link.
  33.  
  34.         PPPBBS is, at the core, a software-based multiuser Internet
  35.      Network Access Server that uses PPP over serial connections
  36.      (modems or direct connect).  PPPBBS dials-out and establishes a
  37.      PPP connection to your internet service provider, using your PPP
  38.      account.  Up to 8 callers can then call in on your other phone
  39.      lines with some type of PPP peer software (such as Windows 95
  40.      Dial-Up Networking) and use your Network Access Server and have
  41.      full access to the internet and/or your own intranet based
  42.      on the built-in server applications, such as the web server.
  43.      Non-PPP callers (ie using regular, old terminal software)
  44.      can login in text mode and use your PPPBBS mini-BBS.
  45.  
  46.         PPPBBS runs great all by itself, as a complete stand-alone
  47.      system.  If, however, you have an existing BBS software going
  48.      you don't want to give up, PPPBBS can also be optionally
  49.      configured to function in a front-end mode where it answers
  50.      all calls and transfers text-mode (ie non-PPP) callers to your
  51.      existing BBS software on an as-needed basis.  This means you can
  52.      add the capability of offering PPP Internet access to your
  53.      callers WITHOUT giving up your existing BBS.
  54.                     
  55.      Q: What type of internet account is needed?
  56.      A: Any PPP account should do nicely. Cheap is OK.
  57.         PPPBBS is designed to be compatible with a wide range of PPP
  58.         accounts for making that connection that connects your site
  59.         to the Internet.  It can be used with expensive, dedicated,
  60.         static IP address accounts, or considerably cheaper, non-dedicated,
  61.         dynamic IP address accounts.
  62.      
  63.      Q: Do I need to "own" a range of IP addresses for my callers to use?
  64.      A: No. PPPBBS cleverly makes use of one single IP address.
  65.  
  66.      Q: Do I need to have a fixed IP address?
  67.      A: No. PPPBBS works with either fixed or dynamic IP addressing.
  68.  
  69.      Q: Do I need to connect to my internet service provider 24 hours
  70.         a day?
  71.      A: Only if you want to. PPPBBS can be set to DEDICATED (24 hrs) or
  72.         DIAL-ON-DEMAND (only when an incoming caller is online).
  73.  
  74.      Q: How fast is PPPBBS?
  75.      A: Because PPPBBS does *not* require a multitasker, and uses
  76.         a FOSSIL-driver in block-mode, it is lightning fast.
  77.  
  78.      Q: What's a FOSSIL-driver?
  79.      A: See the end of this document file for FOSSIL specific information.
  80.  
  81.      Q: What type of hardware do I need?
  82.      A: If running DOS, the computer should be a 486/33 or better,
  83.         with at least 1 megabyte of RAM and at least 2 serial ports
  84.         with modems.  A hard drive is not required if you can fit
  85.         all of the necessary files on a floppy disk.  Multiport serial
  86.         cards will allow you to have more incoming lines.  An "older"
  87.         computer sitting in the corner can find new life as a router,
  88.         bbs, web server, and more.
  89.  
  90.         If running OS2 or Win95, a 486/66 or better is recommended,
  91.         with at least 8 megabytes of RAM.
  92.  
  93.      Q: How many phone lines will I need?
  94.      A: You need at least two: one for dialing out to your ISP,
  95.         and one for incoming callers.  The program supports
  96.         up to 8 incoming phone lines, assuming you have enough serial
  97.         ports and a modem for each phone line.  The minimum
  98.         recommended number of phone lines is 3: one for dialing out
  99.         (making the connection to the internet) and two for incoming
  100.         calls.
  101.  
  102.         NOTE: If number of phone lines is a problem, see the section
  103.         ADVANCED OPTIONS & TIPS.
  104.  
  105.      Q: How fast should my modem(s) be?
  106.      A: A 28.8k or 33.6k modem will work nicely for connecting to your
  107.         ISP; a 56k modem might be even better.  The modems on your
  108.         incoming lines could be a mixture of 14.4, 28.8, 33.6 or faster.
  109.  
  110.      Q: How does PPPBBS handle incoming calls?
  111.      A: PPPBBS automatically detects the difference between a PPP
  112.         caller and a text-mode caller, and then handles the call
  113.         accordingly.  PPP callers get the services of the TCP/IP
  114.         router, while text-mode callers get the PPPBBS and/or
  115.         your existing BBS.
  116.  
  117.      Q: Will callers need to use any "special" software to use
  118.         the Internet Network Access Server?
  119.      A: No.  They use standard PPP peer software (for example Windows 95
  120.         Dial-Up Networking), standard applications, and standard
  121.         web browsers.  There is no proprietary software required.
  122.         
  123.      
  124.      POSSIBLE APPLICATIONS
  125.      ---------------------
  126.  
  127.         How can you use PPPBBS?
  128.  
  129.      * As a way to gate your Internet PPP connection to your LAN (TCP/IP).
  130.  
  131.      * As a front-end that adds PPP access to an existing BBS.
  132.  
  133.      * As an inter-office PPP router and BBS for small businesses to give
  134.        branch offices or "road warriors" access to either the internet,
  135.        the company intranet, or both.
  136.  
  137.      * As an internet-sharing facility and BBS for your family, close
  138.        friends, associates, or community.
  139.  
  140.      * As a complete mini-ISP with all the software you need in
  141.        one easy to set-up and use package.
  142.  
  143.      * As a TCP/IP HTML-based BBS.  If you want a graphical BBS,
  144.        forget proprietary GUI's.  HTML and NetScape/Internet Explorer
  145.        are here to stay.  PPPBBS with its built-in web server makes
  146.        it possible, and easy.
  147.  
  148.      * As an ftp site and/or telnetable BBS.
  149.  
  150.  
  151.      SHAREWARE NOTICE & SOFTWARE LICENSE
  152.      -----------------------------------
  153.  
  154.      THIS SOFTWARE IS NOT FREE.  YOU MAY EVALUATE THE UNREGISTERED
  155.      VERSION FOR A MAXIMUM PERIOD OF UP TO 30 DAYS.  AFTER THAT
  156.      TIME YOU MUST EITHER REGISTER THE PROGRAM OR DISCONTINUE ITS USE.
  157.  
  158.      WHEN YOU REGISTER THE SOFTWARE PROGRAM (PPPBBS), YOU ARE THEREBY
  159.      GRANTED LICENSE TO USE THE SOFTWARE, DOCUMENTATION, AND REGISTRATION
  160.      KEYFILE ON ONE (1) COMPUTER SYSTEM (CPU).
  161.  
  162.      ALL TITLE AND OWNERSHIP OF THE SOFTWARE REMAINS WITH ROLAND DE GRAAF,
  163.      THE AUTHOR OF THE SOFTWARE.
  164.  
  165.      YOU AGREE THAT YOU MAY NOT:
  166.  
  167.      1. DISTRIBUTE REGISTERED VERSIONS OF THE SOFTWARE OR ITS KEYFILE.
  168.  
  169.      2. DECOMPILE, REVERSE-ENGINEER, DISASSEMBLE, OR MODIFY THE SOFTWARE.
  170.  
  171.      3. INSTALL THE SOFTWARE OR REGISTRATION KEYFILE ON MORE THAN ONE
  172.         COMPUTER, UNLESS A SEPARATE REGISTRATION IS PURCHASED FOR EACH
  173.         COMPUTER.
  174.         
  175.      4. TRANSFER OR RE-ASSIGN YOUR LICENSE TO USE THE SOFTWARE
  176.         OR ITS REGISTRATION KEYFILE.
  177.  
  178.  
  179.      THE SOFTWARE IS PROVIDED "AS-IS" WITH NO WARRANTIES OR GUARANTEES
  180.      OF ANY KIND.  FURTHERMORE, THE AUTHOR SHALL NOT BE HELD
  181.      RESPONSIBLE FOR ANY DAMAGES, MONETARY OR OTHERWISE, ASSOCIATED
  182.      WITH THE USE OF THIS SOFTWARE.
  183.  
  184.      THIS AGREEMENT MAY BE TERMINATED BY THE USER AT ANY TIME
  185.      BY DESTROYING ALL COPIES OF THE SOFTWARE AND ITS REGISTRATION
  186.      KEYFILE(S).  THIS AGREEMENT MAY BE TERMINATED BY THE AUTHOR
  187.      IF THE USER IS FOUND TO BE IN BREECH OF ANY PORTION OF THIS
  188.      AGREEMENT.
  189.  
  190.      THIS AGREEMENT MAY ONLY BE MODIFIED BY THE AUTHOR OF THE
  191.      SOFTWARE.
  192.           
  193.      BY INSTALLING THE SOFTWARE ON YOUR COMPUTER YOU GIVE YOUR
  194.      CONSENT TO BE BOUND BY THE TERMS OUTLINED IN THIS DOCUMENTATION.
  195.      THIS AGREEMENT SUPERCEDES ANY AND ALL PREVIOUS LICENSE
  196.      AGREEMENTS PERTAINING TO THIS SOFTWARE.
  197.           
  198.  
  199.      SET-UP & EXECUTION
  200.      ------------------
  201.  
  202.         Set-Up for PPPBBS is easy.  Run the SETUP.EXE that was
  203.      included with the archive.  SETUP.EXE will create a couple
  204.      of directories and copy a few files.  Set-up should not
  205.      take more than a few seconds.  If you encounter any diffculty
  206.      in getting set-up you may email Tech Support for help.
  207.  
  208.         PPPCFG.EXE and PPPBBS.EXE must always be executed from the
  209.      PPPBBS directory where the program has been set-up.
  210.       
  211.         Once SETUP.EXE is complete, change drive and/or directory to
  212.      make the newly created PPPBBS directory the current directory
  213.      and execute PPPCFG.EXE for the first time to set-up the operating
  214.      parameters for the software.  From then on, you may make changes
  215.      as necessary to these settings with PPPCFG.EXE.
  216.  
  217.         Don't forget to set-up your FOSSIL driver.
  218.      
  219.         Once the FOSSIL software is set-up, and PPPBBS has been
  220.      configured to use the correct FOSSIL ports, your site is ready
  221.      to start accepting calls.  You execute PPPBBS by running PPPBBS.EXE.
  222.      No command line options are required.
  223.  
  224.      NOTE: The files PPPCFG.PIF and PPPBBS.PIF are Windows 95 PIF
  225.      files, and are provided for your convenience.  But putting a copy
  226.      of these files on your desktop, you can execute these programs
  227.      without having to type at a DOS prompt.  You will need to modify
  228.      the "Properties" of these shortcuts if you instructed SETUP.EXE
  229.      to install PPPBBS in a directory other than C:\PPPBBS.
  230.      
  231.  
  232.      PPPCFG - SET-UP PARAMETERS EXPLANATION
  233.      --------------------------------------
  234.  
  235.         PPPCFG.EXE is both the set-up (configuration) program for PPPBBS,
  236.      and the USER EDITOR for creating and editing user accounts for your
  237.      incoming callers.  It is designed to be a user-friendly
  238.      utility that will allow you to make configuration changes quickly
  239.      and easily.  The first time you read this documentation, it will
  240.      be helpful for you to have PPPCFG running and in view.
  241.  
  242.         When editing PPPBBS settings, you can use the arrow keys
  243.      keys to select the field to edit.  Pressing [Enter], or typing
  244.      text or numbers initiates field input/editing.  Press [Enter],
  245.      [Esc], or up/down arrow keys to signal that you are done editing
  246.      that field.
  247.           
  248.         The main PPPCFG configuration screen is mainly devoted to
  249.      set-up of the PPP router.  The main PPPCFG configuration screen
  250.      is divided into six parts:
  251.      
  252.      Router Configuration
  253.      Internet Account
  254.      DialOut Configuration
  255.      Environment
  256.      Security Configuration
  257.      Host Ports Configuration
  258.  
  259.      Each of these sections will be described in detail in the sections
  260.      that follow.
  261.  
  262.  
  263.         Router Configuration
  264.         --------------------
  265.  
  266.         This region of the set-up screen is used to set some of the basic
  267.         IP addresses that PPPBBS needs to operate.  It should be noted
  268.         that some of these can sometimes be left at the default setting of
  269.         0.0.0.0 with the actual data automatically supplied by your
  270.         Internet Service Provider (ISP) when the router makes its initial
  271.         connection to the Internet.  The settings for this region are:
  272.  
  273.         Router IP:                             (default=0.0.0.0)
  274.  
  275.             This is the IP address assigned to you by your ISP.  It can
  276.             be a fixed (or static) address or a dynamically-assigned
  277.             address.  If you have a fixed address, it should go here.
  278.             If you know for certain that you have a dynamically-assigned
  279.             address, or don't know what your address is, you should
  280.             set this field to 0.0.0.0, and the router will attempt
  281.             to get the address automatically from your ISP.
  282.  
  283.         Primary DNS: & Secondary DNS:          (default=0.0.0.0)
  284.  
  285.             This setting is needed so that when you get incoming calls,
  286.             the router can attempt to automatically configure this
  287.             information for your PPP clients.  If you set these to
  288.             0.0.0.0 then PPPBBS will try to get this information
  289.             from your ISP at initial connection to the Internet.  It
  290.             should be noted, however, that not all ISPs support automatic
  291.             DNS assignment, and for those that do, it is possible that two
  292.             "hubs" operated by the same ISP may not both operate exactly
  293.             the same.  If you know the IP addresses of your ISP's primary
  294.             and secondary domain name servers (DNS), then you should enter
  295.             this information here.  If you do not know, then set it to
  296.             0.0.0.0 and PPPBBS will try to get the information
  297.             automatically.
  298.  
  299.         Primary WINS & Secondary WINS:         (default=0.0.0.0)
  300.  
  301.             Most PPPBBS operators will not need these settings.  In most
  302.             cases, these can be safely set to 0.0.0.0, and should not be
  303.             set to a value unless you know for sure that your PPP clients
  304.             will need this information.
  305.         
  306.  
  307.         Internet Account
  308.         ----------------
  309.  
  310.         This set of inputs allows you to configure the settings needed
  311.         for the router to log itself into the Internet, using your
  312.         standard ISP.  This also gives you control over how the router
  313.         connects to the Internet (ie dedicated or on-demand), and how it
  314.         identifies itself for login purposes.
  315.         
  316.         Username: & Password:
  317.  
  318.             These inputs are for your Internet account username and
  319.             password.  Note that this information is usually case-sensitive
  320.             and you must make sure to enter it exactly as it needs to
  321.             be used.
  322.  
  323.         Login Type:
  324.  
  325.             PPPBBS supports two different ways of logging into your
  326.             ISP.  The method preferred by most ISPs is PAP (Password
  327.             Authentication Protocol).  With PAP, your ISP automatically
  328.             detects the PPP framing, and login is completely automatic.
  329.  
  330.             The other method for logging in is a simple, old-fashioned,
  331.             text-based login.
  332.  
  333.             You should try PAP first, and if that does not work, then try
  334.             text-login.  If your ISP requires both, then set PPPBBS
  335.             to text-login.  PPPBBS is smart enough to use PAP if it is
  336.             requested during the LCP (Link Control Protocol) phase.
  337.  
  338.             This setting does not affect how your callers will login;
  339.             your PPP clients should always use PAP.  (This is automatic
  340.             for them if they call you using Windows 95's Dial-Up
  341.             Networking.)
  342.  
  343.         Dial-Up: & Inactivity Timer:
  344.  
  345.             This setting lets you specify how you want the PPPBBS router
  346.             to connect to the Internet.  The three choices are Dedicated,
  347.             On-demand, and Disabled.
  348.  
  349.             Dedicated means that PPPBBS will try to maintain the
  350.             connection to your ISP 24 hours a day, seven days a week.
  351.             Should the modem disconnect due to loss of carrier, PPPBBS
  352.             will immediately try to reestablish the connection.
  353.  
  354.             On-demand means that PPPBBS will not try to connect to the
  355.             Internet until there is an incoming call on one of your other
  356.             lines.  When there is activity on one or more of the incoming
  357.             caller phone lines, PPPBBS will immediately attempt to
  358.             establish a connection to the Internet.  When all of the
  359.             incoming callers have finished their work and logged off,
  360.             PPPBBS will wait until the Inactivity Timer expires before
  361.             disconnecting itself from the Internet.  This allows you to
  362.             tweak the response of the router so that an incoming caller
  363.             who loses carrier and calls right back can enjoy faster access
  364.             without having to wait for PPPBBS to re-dial your ISP.
  365.  
  366.             Disabled means that PPPBBS will not try to connect to
  367.             the Internet at all.  This setting is useful if you want
  368.             to use PPPBBS without necessarily connecting to the
  369.             Internet.  NOTE: In this mode, PPPBBS can still be used
  370.             as a "Intranet" TCP/IP router between the callers or computers
  371.             connected to it.  See the section in ADVANCED OPTIONS & TIPS
  372.             for more information.
  373.             
  374.             NOTE: When PPPBBS is set to On-demand, and the Router IP
  375.             is set to 0.0.0.0, PPPBBS will connect to your ISP right
  376.             away so that it can obtain a proper IP address from your ISP.
  377.             Once a valid address has been obtained, PPPBBS will begin
  378.             the Inactivity Countdown to disconnect -- unless of course
  379.             someone calls in on one of your incoming lines.
  380.  
  381.  
  382.         DialOut Configuration
  383.         ---------------------
  384.  
  385.         This section of the set-up screen lets you configure the
  386.         communications port that PPPBBS will use to dial out to your
  387.         Internet Service Provider.
  388.  
  389.         Port #:
  390.  
  391.             This specifies the FOSSIL port # to be used for dialing out.
  392.             FOSSIL port numbers usually start at 0 and go up from there:
  393.             0, 1, 2, 3, etc.  Generally, you will want to use your FASTEST
  394.             port and/or modem for dialing up your ISP.  If you own a
  395.             56k modem you may wish to see the section on 56k modems
  396.             at end of this documentation.
  397.  
  398.         Init:
  399.  
  400.             This input is for you to specify how you want the modem
  401.             initialized.  The initialization string you put here will
  402.             vary with the manufacturer and type of modem.  Note that
  403.             PPPBBS supports only modems capable of 9600 bps or FASTER.
  404.  
  405.             In principle, you want to configure your modem for:
  406.  
  407.                Description                      Modem Command
  408.                -----------------------------    -------------
  409.  
  410.                FIXED (or LOCKED) BAUD RATE         Varies
  411.                between the computer and modem
  412.  
  413.                HARDWARE HANDSHAKING                Varies
  414.  
  415.                CARRIER DETECTION                     &C1
  416.  
  417.                HANG-UP WHEN DTR IS LOWERED           &D2
  418.               
  419.             You absolutely do NOT want:
  420.  
  421.                SOFTWARE HANDSHAKING (also called XON/XOFF)
  422.  
  423.             Many of you may be able to use the default setting of ATZ.
  424.  
  425.             Users of US Robotics modems manufactured since 1994
  426.             can use the following init string for maximum performance:
  427.  
  428.                AT&F1E0
  429.  
  430.             Some users of modems based on the ROCKWELL chip manufactured
  431.             since 1995 can use:
  432.  
  433.                AT&F2E0
  434.  
  435.             If none of the examples listed here work for you, or
  436.             if you are unsure what to use, please consult the manual
  437.             that came with your modem.
  438.  
  439.         Dial:
  440.  
  441.             This input is for you to put the command needed to dial
  442.             the modem, INCLUDING the phone number that needs to be
  443.             dialed.  For example, to use touch-tone dialing of
  444.             the phone number 555-1234 you would enter:
  445.  
  446.                ATDT5551234
  447.  
  448.             To use pulse dialing of 555-4321 you would enter:
  449.  
  450.                ATDP5554321
  451.  
  452.         
  453.         Environment
  454.         -----------
  455.  
  456.         Currently there is only one setting under this section,
  457.         which pertains to general computer set-up.
  458.  
  459.         MultTask:
  460.  
  461.             If you run your computer system under a multitasker
  462.             (such as Desqview) or multitasking operating system
  463.             (such as Windows or OS/2), then this setting can optionally
  464.             be used to make PPPBBS allow OTHER programs on your
  465.             system run faster.
  466.  
  467.             NOTE that for maximum PPPBBS performance this setting
  468.             should be set to NONE.  ALSO NOTE that PPPBBS will
  469.             perform at its best if it is run under straight single-
  470.             tasking DOS.
  471.  
  472.             Since PPPBBS handles multiple ports WITHOUT multitasking,
  473.             it runs best without a multitasker and does NOT need one.
  474.  
  475.  
  476.         Security Configuration
  477.         ----------------------
  478.  
  479.         This section of the configuration screen is used to set general
  480.         security settings of your PPPBBS router, as they apply to
  481.         your incoming callers.
  482.  
  483.         Inac Timer:
  484.  
  485.             This setting allows you to control how long an incoming
  486.             caller can be idle before PPPBBS automatically logs them
  487.             off the system.  A setting of 0 disables this feature,
  488.             and is not recommended unless you really want to disable
  489.             this feature.  Some recommended example settings are:
  490.  
  491.             300 seconds (5 minutes)
  492.             600 seconds (10 minutes)
  493.             900 seconds (15 minutes)
  494.  
  495.             NOTE: This setting applies to callers using the PPP access
  496.             capability, and to text-mode callers using the PPPBBS mini-BBS.
  497.  
  498.         Anon PPP? & Anon Limit:
  499.  
  500.             These two settings control whether or not someone is allowed
  501.             to access your PPP router without having a valid user account.
  502.  
  503.             If set to NO, then incoming callers must have a valid
  504.             account set-up for them on the system.  When they access the
  505.             router, they must login (using PAP) with a valid username
  506.             and password.
  507.  
  508.             If set to YES, then any username/password can be used to
  509.             gain access to the system, however they will be limited
  510.             to the amount of time you specify in ANON LIMIT.
  511.  
  512.             NOTE that regardless of this setting, someone who logs
  513.             in with a valid user account will have a time limit as
  514.             configured for their valid user account.
  515.  
  516.         New User SL:
  517.  
  518.             This sets the security level which is assigned to new callers.
  519.  
  520.         New User TL:
  521.  
  522.             This sets the time limit which is assigned to new callers.
  523.  
  524.         New User PPP:
  525.  
  526.             This sets whether or not new callers can use PPP right away,
  527.             or if they must wait for the SysOp to validate them before
  528.             they can have PPP Internet access.
  529.  
  530.             NOTE: When you (the SysOp) validate (ie verify) your new
  531.             callers accounts, you should use the user editor (PPPCFG.EXE)
  532.             to upgrade the user's security level, time limits, and
  533.             access to PPP.
  534.                    
  535.         
  536.         Host Ports Configuration
  537.         ------------------------
  538.  
  539.         This part of the configuration screen defines how many ports
  540.         are to be used for incomnig calls, which port numbers are
  541.         to be used, and how you want the modems initialized.  Up to
  542.         eight ports can be configured here, and for purposes of
  543.         identification, PPPBBS calls them Channel 1, Channel 2,
  544.         and so on up to Channel 8.
  545.  
  546.         Port #
  547.  
  548.             These inputs specify the FOSSIL port number assigned
  549.             to each channel.  Note that each channel must be given
  550.             a unique FOSSIL port number, and that the FOSSIL port
  551.             number set-up for dialout (earlier section) cannot
  552.             be used here.  Setting the port number to - (the minus
  553.             sign or dash) disables that channel entirely.
  554.  
  555.         Initialization
  556.  
  557.             These inputs specify the modem initialization string.
  558.             See the "DialOut" section described earlier for information
  559.             on setting the init string.  The guidelines are the same.
  560.  
  561.         Answer
  562.  
  563.             These inputs allow you to set the modem command to make
  564.             the modem answer when an incoming call is received.  This
  565.             should ALWAYS be set to ATA (the default), unless you have
  566.             some type of very unusual modem or some type of special
  567.             need.
  568.             
  569.  
  570.      EMAIL & BUILT-IN TCP/IP CLIENTS SET-UP
  571.      --------------------------------------
  572.  
  573.         In addition to the main PPPCFG configuration screen, there
  574.      is also a screen devoted to email and the built-in TCP/IP clients
  575.      set-up.  Pressing [F1] (function key #1) when you are at the main
  576.      PPPCFG configuration screen brings you to the TCP/IP configuration
  577.      screen.
  578.      
  579.      The TCP/IP configuration screen is divided into 4 parts:
  580.  
  581.      Mail Configuration
  582.      Built-In SMTP Client
  583.      Built-In POP3 Client
  584.      Built-In DYNDNS.COM Client
  585.  
  586.      NOTE: You must have an account with DYNDNS.COM *before* you can
  587.      attempt to enable the built-in DYNDNS.COM client.  For more
  588.      information about DYNDNS.COM, look in ADVANCED TOPICS & TIPS.
  589.  
  590.      IMPORTANT: The Built-In SMTP Client, Built-In POP3 Client, and
  591.      Built-In DYNDNS.COM Client are DISABLED if your PPPBBS is
  592.      UNREGISTERED.
  593.  
  594.  
  595.         Mail Configuration
  596.         ------------------
  597.  
  598.            This section of the configuration provides PPPBBS with
  599.         specific information about YOUR site.
  600.  
  601.         Pri Hostname:
  602.         Sec Hostname:
  603.         Ter Hostname:
  604.  
  605.            These three settings specify your primary, secondary,
  606.            and tertiary hostnames, as they apply to networked email.
  607.            You can use one, two, or all three of these fields as
  608.            necessary, leaving unused fields blank.  The Primary
  609.            Hostname is the one that will appear on outgoing email,
  610.            and in other areas of the program.  The Secondary and
  611.            Tertiary Hostnames are provided for your convenience
  612.            in the event that you receive email at several different
  613.            site addresses (aliases).
  614.                                  
  615.            When incoming mail enters the system, the hostname that
  616.            the email is addressed to is compared to these three settings.
  617.            Mail that matches any one of these is considered MAIL FOR
  618.            YOUR SITE.  Mail that does NOT match ANY of these is
  619.            considered MAIL FOR OTHER SITES.
  620.  
  621.            If you have a registered domain name:
  622.  
  623.               Enter your primary registered domain name for Primary
  624.               Hostname.  Enter any additional registered domain names
  625.               for Secondary Hostname and Tertiary Hostname.
  626.               
  627.               If you also have a DYNDNS.COM hostname, enter that also
  628.               if you have room for it, in either the Secondary or
  629.               Tertiary positions.
  630.  
  631.            If you do NOT have a registered domain name:
  632.  
  633.               If you have a DYNDNS.COM hostname, enter that for
  634.               Primary Hostname, and enter your ISP's domain name
  635.               for Secondary Hostname.
  636.  
  637.               If you do NOT have a DYNDNS.COM hostname, enter your
  638.               ISP's domain name for Primary Hostname.
  639.  
  640.            It is very important that the hostname fields are configured
  641.            correctly for the SMTP, POP3, and Mail Processor to operate
  642.            smoothly.
  643.  
  644.            NOTE: The special hostname "bbs" is always recognized as
  645.            refering to your site.
  646.            
  647.  
  648.         Built-In SMTP Client
  649.         --------------------
  650.  
  651.            This section configures the built-in SMTP CLIENT.
  652.  
  653.         SMTP Host:
  654.  
  655.            The IP address of your ISP's SMTP SERVER should go here.
  656.            (This should be entered as an IP address, not a hostname.)
  657.            
  658.  
  659.         Built-In POP3 Client
  660.         --------------------
  661.  
  662.            This section configures the built-in POP3 CLIENT.
  663.  
  664.         POP3 Host:
  665.  
  666.            The IP address of your ISP's POP3 SERVER should go here.
  667.            This will usually be the same the "SMTP Host:" setting.
  668.            (This should be entered as an IP address, not a hostname.)
  669.  
  670.         POP3 Login:
  671.         POP3 Password:
  672.  
  673.            The POP3 Login (username) and POP3 Password necessary to
  674.            access your mailbox at your ISP or other email provider.
  675.            If this is a mailbox at your ISP, then usually the POP3
  676.            Login and POP3 Password will be the same as your PPP
  677.            Account Login and Password.  Note that upper/lower case
  678.            may be important!
  679.            
  680.         POP3 Schedule:
  681.  
  682.            This controls the automatic execution of the built-in
  683.            POP3 CLIENT.  A setting of zero disables automatic
  684.            execution.  A setting other than zero sets the time
  685.            between checking-for-new-mail, in minutes (minimum=5).
  686.                             
  687.  
  688.         Built-In DYNDNS.COM Client
  689.         --------------------------
  690.  
  691.            This section configures the built-in DYNDNS.COM CLIENT.
  692.  
  693.         Username:
  694.         Password:
  695.  
  696.            The username and password you used when you signed up for
  697.            DYNDNS.COM service. Note that these might be case-sensitive.
  698.  
  699.  
  700.      CREATING & EDITING USER ACCOUNTS
  701.      --------------------------------
  702.  
  703.         From the PPPCFG configuration screen, pressing [F5] (function
  704.      key #5) brings you to the PPPBBS USER EDITOR.  Once you are
  705.      in the USER EDITOR, you can edit user account information,
  706.      create new user accounts (Press [F1]), delete accounts (Press
  707.      [F10]), and go back to the configuration screen (Press [Esc]).
  708.  
  709.         When editing user account information, you can use the arrow
  710.      keys to select the field to edit.  Pressing [Enter], or typing
  711.      text or numbers initiates field input/editing.  Press [Enter],
  712.      [Esc], or up/down arrow keys to signal that you are done editing
  713.      that field.
  714.  
  715.         Note that fields listed in GREEN are REQUIRED inputs.  Fields
  716.      that are YELLOW are OPTIONAL.  GREY fields take no input at all
  717.      and are shown for your information.
  718.      
  719.         The fields on the user editor screen should be self-explanatory,
  720.      and if you are (or were) a BBS System Operator, they should be
  721.      immediately recognizable to you.
  722.  
  723.         A note about security level: Each user's account may be set to
  724.      a security level from 0 to 999.  While this allows you a lot of
  725.      flexibility, it is recommended that you set a "regular" user's
  726.      security level to a relatively low value in the 1 to 250 range.
  727.      The SysOp account (and other acccounts to be used by the System
  728.      Operator) should be set at a security level of 900 or higher.
  729.  
  730.      NOTE: Users logged in with a security level of 900 or higher are
  731.      immune to BLOCKED.CFG resrictions, and will not be disconnected due
  732.      to inactivity.
  733.      
  734.  
  735.      AUTOMATED NEW USER SIGN-UP
  736.      --------------------------
  737.  
  738.         On a BBS, new users typically  sign-up for an account by typing
  739.      NEW at the BBS's login prompt.  PPPBBS is no exception.  The 
  740.      built-in PPPBBS mini-BBS new user questionaire supports the
  741.      creation of new user accounts automatically, with all information
  742.      supplied by the user, and hopefully, validated (examined for
  743.      accuracy) by the PPPBBS system operator.  Once created, an account
  744.      (username and password) can be used to log into the PPP Internet
  745.      access or the text-based PPPBBS mini-BBS.
  746.  
  747.         Whether you offer PPP access for FREE, or for a FEE, is up
  748.      to you to decide.  You may decide to have two tiers of service;
  749.      FREE access limited to, for example, 30 minutes per day, and
  750.      PAID access where the user gets a larger time limit.  PPPBBS
  751.      allows you to configure time limits per day, per month, and per
  752.      call, so you have a lot of flexibility.  Whatever you decide,
  753.      make sure that your NEWUSER.BBS text file gives as much information
  754.      as possible up-front.  Also, give yourself room to make "changes
  755.      without prior notice" so you don't lock yourself in.
  756.  
  757.      NOTE: The security level, time limit, and PPP access control
  758.      assigned to new user's is configurable on the PPPCFG.EXE main
  759.      screen.
  760.             
  761.  
  762.      SETTING UP THE PPPBBS MINI-BBS
  763.      ------------------------------
  764.  
  765.         Customizing the PPPBBS built-in mini-BBS is not difficult.  It
  766.      consists mainly of editing the following text files with a text editor:
  767.      
  768.      WELCOME.BBS     Displayed to non-PPP callers before the "login" prompt
  769.      NEWUSER.BBS     Displayed to non-PPP callers who login as NEW
  770.      LOGGEDIN.BBS    Displayed to non-PPP callers after successful login
  771.      MAINMENU.BBS    The mini-BBS main menu
  772.      LOGOFF.BBS      Displayed to non-PPP callers when logging off
  773.  
  774.      You may edit these files to be plain ASCII text, or you may
  775.      wish to include ANSI color for a fancier design.
  776.  
  777.      NOTE: You should limit the size of each .BBS file to 2048 bytes
  778.      or less.
  779.  
  780.         There is also one CFG file that you can edit with a text editor:
  781.  
  782.      PPPTEXT.CFG     Text Strings (prompts, etc.) used by the mini-BBS
  783.  
  784.      As with the *.BBS files, you may edit PPPTEXT.CFG to be plain
  785.      ASCII text, or you may choose to include ANSI color.  Being able
  786.      to edit the text used by the mini-BBS, makes PPPBBS extremely
  787.      customizable.
  788.  
  789.      NOTE: For PPPTEXT.CFG, the | (pipe character) is used to mean
  790.      a carriage return/linefeed combination.  Hello|Roland|DeGraaf
  791.      would, for example, be displayed by the BBS as:
  792.      Hello
  793.      Roland
  794.      DeGraaf
  795.      
  796.         The purpose of the built-in mini-BBS is to provide necessary
  797.      support functions to the PPP Internet access server aspect of PPPBBS.
  798.      The functions provided by the mini-BBS are:
  799.  
  800.            Automated New User Sign-Up
  801.  
  802.              -New callers can create accounts that will
  803.               allow them to use the same account for both
  804.               PPP Internet access, and text-mode mini-BBS logins.
  805.            
  806.            Send Email, Read Email, & Feedback To SysOp
  807.  
  808.              -Callers who may need assistance setting up PPP,
  809.               or who have questions about their account can
  810.               login text-mode and leave email to the SysOp
  811.               or to other users.
  812.  
  813.            Account Settings
  814.  
  815.              -Allow users to change their password or other
  816.               user-changable parameters.
  817.  
  818.            Who's Online
  819.  
  820.              -See who else is online at the moment.
  821.  
  822.  
  823.      BUILT-IN TCP/IP SERVER SET-UP
  824.      -----------------------------
  825.  
  826.         By default, PPPBBS comes ready-configured for the following:
  827.  
  828.                        PPPBBS
  829.                        Server   TCP
  830.         Server         Type #   Port   Additional Parameters
  831.         -------------  ------   ----   ----------------------
  832.         Web Server         1      80   Root Directory = \PPPBBS\WWW
  833.         Telnet Server      2      23   (none)
  834.         Identification     3     113   (none)
  835.         SMTP Server        4      25   (none)
  836.         POP3 Server        5     110   (none)
  837.         FTP Server         6      21   Default Root Directory = \PPPBBS\FTP
  838.  
  839.      This is set-up for you in the file SERVERS.CFG.  The default
  840.      looks like this:
  841.  
  842.         1,80,\PPPBBS\WWW
  843.         2,23
  844.         3,113
  845.         4,25
  846.         5,110
  847.         6,21,\PPPBBS\FTP
  848.  
  849.      As you can see each line is in the format:
  850.  
  851.      <server type>,<TCP port>,<optional additional parameter>
  852.  
  853.      The default SERVERS.CFG file sets up the typical services on the
  854.      generally-accepted standard TCP ports.  You do not need to edit
  855.      the file if this is what you want.  If you have special needs,
  856.      you may reconfigure the SERVERS.CFG file by editing it with a
  857.      text editor, so long as you follow the format of the default file,
  858.      and limit the file to 16 entries maximum based on the 5 server types
  859.      currently supported:
  860.  
  861.      1 - Web Server (http)
  862.      2 - Telnet Server
  863.      3 - Identification Server
  864.      4 - SMTP Server
  865.      5 - POP3 Server
  866.      6 - FTP Server
  867.  
  868.      You may specify non-standard TCP ports if desired, so long as the
  869.      TCP port number is less than 256.  Here is an example:
  870.  
  871.         1,80,\PPPBBS\WWW
  872.         1,81,D:\WWW2
  873.         2,23
  874.         3,113
  875.         4,25
  876.         5,110
  877.         6,21,\PPPBBS\FTP
  878.  
  879.      The above example would give you a web server on TCP port 80
  880.      using root directory \PPPBBS\WWW, a web server on TCP port 81
  881.      using root directory D:\WWW2, a telnet server on TCP port 23,
  882.      an identification server on TCP port 113, a SMTP server on TCP
  883.      port 25, and a POP3 server on TCP port 110.
  884.  
  885.      NOTE: If you set the web server root directory to \PPPBBS\WWW,
  886.      then anyone can access files in directory \PPPBBS\WWW, and any
  887.      directory below that directory.  So, do not put anything
  888.      private or confidential in those directories!
  889.  
  890.      The above example also shows that you may set-up a server type
  891.      more than once, so long as each server is using a different
  892.      TCP port.  The example shows two web servers, each listening
  893.      on a different TCP ports, with different root directories.
  894.  
  895.      To illustrate how this might be useful, suppose you had a registered
  896.      domain name of "mypppbbs.com".  Someone wanting to surf your web site
  897.      might ask their web browser to open URL:
  898.  
  899.      http://mypppbbs.com/
  900.  
  901.      They would be accessing the web server on TCP port 80, where the
  902.      web server root directory is WWW.
  903.  
  904.      If they type:
  905.  
  906.      http://mypppbbs.com:81/
  907.  
  908.      They would be accessing the web server on TCP port 81, where the
  909.      web server root directory is WWW2.
  910.  
  911.      Thus, you can effectively have a number of individual web sites
  912.      on your system, each using a different TCP port, and each using
  913.      a separate root directory.  Because of the way PPPBBS is programmed,
  914.      and the high-level of integration between the TCP/IP stack and the
  915.      built-in TCP/IP applications, there is practically no performance
  916.      penalty for having multiple servers.  A PPPBBS built-in server
  917.      application that has nothing to do at the moment gets zero CPU time.
  918.        
  919.      NOTE: While you could also set-up the telnet, ident, smtp and pop3
  920.      servers multiply on alternate TCP ports also, like was shown for
  921.      the web server, there would be rarely an advantage to do so.
  922.  
  923.      A few things you can do with multiple web servers:
  924.  
  925.      -Keep the web server on standard TCP port 80 for your use as
  926.       System Operator, and set-up web servers on other TCP ports
  927.       for others (individuals, businesses, etc) in your area to put
  928.       up their own web sites, for free or possibly for a fee.
  929.       
  930.      -Use the additional entries to access other drives on your system,
  931.       and other directories on the current drive which are not already
  932.       accessible through the WWW root directory.
  933.            
  934.      IMPORTANT: Only the first line of SERVERS.CFG is recognized
  935.      if your PPPBBS is UNREGISTERED.
  936.      
  937.  
  938.      SETTING UP YOUR WEB SITE
  939.      ------------------------
  940.  
  941.         When you ran the SETUP.EXE program, it automatically created
  942.      the following directories for the web server defined in the
  943.      default SERVERS.CFG file:
  944.  
  945.      Your Web Server's Root   Directory: \PPPBBS\WWW
  946.      Your Web Server's CGI    Directory: \PPPBBS\WWW\CGI
  947.      Your Web Server's Images Directory: \PPPBBS\WWW\IMAGES
  948.  
  949.      The Root Directory:    \PPPBBS\WWW
  950.  
  951.         This is where you must place file INDEX.HTM, your HTML
  952.         "welcome" page.  You may place additional .HTM files
  953.         in this directory, and you may also create new directories
  954.         below \PPPBBS\WWW to hold whatever you want.
  955.  
  956.         SETUP.EXE copies an example INDEX.HTM to \PPPBBS\WWW
  957.         to get you started.
  958.  
  959.      The CGI Directory:     \PPPBBS\WWW\CGI
  960.  
  961.         Unused for now.  Leave empty.
  962.  
  963.      The Images Directory:  \PPPBBS\WWW\IMAGES
  964.  
  965.         This directory is for the .GIFs and .JPGs you'll be using.
  966.         You could put your GIFs and JPGs in the \PPPBBS\WWW Root
  967.         Directory, or other directory you create below \PPPBBS\WWW,
  968.         there is nothing to stop you from doing that, but you will
  969.         have a more organized and maintainable web site if you
  970.         keep your graphics in one place, separated from your HTMs.
  971.  
  972.         SETUP.EXE copies example PPPBBS1.GIF and PPPBBS2.GIF to
  973.         \PPPBBS\WWW\IMAGES to get you started.
  974.  
  975.         Naturally, the PPPBBS web server is capable of functioning like
  976.      a conventional web site.  You can make your web site look any way
  977.      that you want.  In addition, you can also make the web site your
  978.      "graphical BBS."  It has been said that telecommunications users
  979.      today want to have graphical interfaces, and they want them to be
  980.      based on open standards like http and HTML.  PPPBBS gives you the
  981.      opportunity to have exactly that -- a graphical BBS based on
  982.      HTML/GIF/JPG, utilizing industry-standard, off-the-shelf TCP/IP
  983.      web browsers like NetScape Navigator, NetScape Communicator,
  984.      Microsoft Internet Explorer, and so on.
  985.      
  986.         Web servers probabily spend most of their time transmitting
  987.      .HTMs (HTML files) and .GIFs and .JPGs.  It should be pointed out
  988.      that any type of file can be transmitted over http (web server).
  989.      Users can also download EXEs, ZIPs, ARJs, etc over their web browser.
  990.      You could, for example, create HTMs that give the appearance and
  991.      functionality of a BBS File Download area.
  992.      
  993.  
  994.      THE PPPBBS TELNET SERVER
  995.      ------------------------
  996.  
  997.         The built-in telnet server makes the text-mode mini-BBS
  998.      accessible over TCP/IP to both your local callers, and Internet
  999.      users all over the globe.  Why would someone want to use your
  1000.      text-based mini-BBS instead of accessing your web site?  The
  1001.      mini-BBS requires users to login with a valid username and
  1002.      password, so their identity is authenticated.  This means they
  1003.      can send/receive email using the mini-BBS, and change their
  1004.      account password if they want to.  It would also useful if
  1005.      someone has access to Internet telnet, but don't have a web
  1006.      browser, SMTP, or POP3 clients, on the machine they are
  1007.      currently using.
  1008.  
  1009.         There is nothing you need to set-up to make telnet work.
  1010.      It has been set-up for you in the default SERVERS.CFG.  Up to 4
  1011.      telnet logins may be active at a time, and you may be able to see
  1012.      telnet logins on the PPPBBS SysOp Screen, if there is room in the
  1013.      window.
  1014.  
  1015.  
  1016.      SETTING UP YOUR FTP SITE
  1017.      ------------------------
  1018.  
  1019.         The ftp server is an important part of your system.  Not only
  1020.      does it allow you put up an unlimited amount of shareware or
  1021.      freeware for download, but it is also the conduit which allows
  1022.      your user's to have personal web pages and ftp file space on
  1023.      your system.
  1024.  
  1025.         To access your software library, users should login to
  1026.      the ftp server ANONYMOUSLY.  (This is the default for ftp
  1027.      access through a web browser.)  The ftp server accepts "ftp",
  1028.      "anonymous", and "guest" as all meaning the same thing.
  1029.      
  1030.         To access their personal web/ftp sites, users should login
  1031.      to the ftp server using their system username and password.
  1032.  
  1033.      NOTE: Before ftp login, the text file WELCOME.FTP is displayed.
  1034.            You may customize WELCOME.FTP so long as you don't exceed
  1035.            10 lines and 512 bytes.
  1036.      
  1037.         FTPDIRS.CFG & YOUR SOFTWARE LIBRARY
  1038.         -----------------------------------
  1039.         
  1040.         When you ran the SETUP.EXE program, it automatically created
  1041.      some default directories for the ftp server, as defined in the
  1042.      default SERVERS.CFG and FTPDIRS.CFG file:
  1043.  
  1044.      Your FTP Server's Default Root Directory: \PPPBBS\FTP
  1045.      
  1046.      FTPDIRS.CFG is an ASCII file you edit with a text editor.
  1047.      FTPDIRS.CFG may contain up to 20 entries; the default
  1048.      FTPDIRS.CFG has only one entry to start you out and it
  1049.      looks like this:
  1050.  
  1051.      pub,\PPPBBS\FTP,0
  1052.  
  1053.      ---  ---------  -
  1054.       |      |       |
  1055.       |      |       --- 0 = Hard Drive, 1 = CDROM drive or changer
  1056.       |      ----------- Actual Disk Directory Path
  1057.       ------------------ Directory Name That Appears To Users
  1058.  
  1059.      Users accessing directory "pub" will actually be accessing 
  1060.      disk directory "\PPPBBS\FTP".  You could put files in
  1061.      \PPPBBS\FTP, and/or create new sub-directories below
  1062.      \PPPBBS\FTP (for example, \PPPBBS\FTP\GAMES, \PPPBBS\FTP\WIN95,
  1063.      and so on) and put files there.
  1064.  
  1065.      NOTE: Given this configuration, users will be able to access
  1066.            all files in \PPPBBS\FTP, and all subdirectories below
  1067.            \PPPBBS\FTP, so be careful not to put any private 
  1068.            information there.
  1069.  
  1070.      If you had files on another hard drive or in a different
  1071.      path, then you could add those to FTPDIRS.CFG also.  
  1072.      
  1073.      More Examples:
  1074.      
  1075.      pub2,C:\FILES,0
  1076.      shareware,D:\DLOADS,0
  1077.  
  1078.      If you had one or more shareware CDs in a normal CDROM drive
  1079.      or CDROM changer:
  1080.  
  1081.      cdrom1,D:\,1
  1082.      cdrom2,E:\,1
  1083.  
  1084.      Note:  The "1" on the end in the above examples would tell PPPBBS
  1085.             to "buffer" the file being downloaded.  In other words,  
  1086.             instead of having the user download the file directly 
  1087.             from the CDROM drive or CDROM changer, the file requested 
  1088.             is automatically copied to \PPPBBS\CDTEMP on your hard disk
  1089.             for the download.
  1090.  
  1091.             PPPBBS checks \PPPBBS\CDTEMP once every 10 minutes, and if
  1092.             there is no current download activity, the files there are 
  1093.             automatically deleted. \PPPBBS\CDTEMP is another directory
  1094.             that was automatically created when you ran the SETUP.EXE.
  1095.             
  1096.      If you want to be able to receive anonymous uploads, then
  1097.      create directory C:\UPLOAD and add the following line to
  1098.      FTPDIRS.CFG:
  1099.  
  1100.      incoming,C:\UPLOAD,0
  1101.  
  1102.      While FTPDIRS.CFG may limit you to 20 root directory entries, 
  1103.      there is NO LIMIT to the number of subdirectories which can 
  1104.      exist below those directories.  FTPDIRS.CFG allows the ftp 
  1105.      server to give the appearance of a single, unix-like, unified 
  1106.      file system to the outside world, while allowing you to span
  1107.      the actual sub-directories and files over several drives and/or 
  1108.      directories.
  1109.  
  1110.         USER'S WEB/FTP SITES
  1111.         --------------------
  1112.  
  1113.      SETUP.EXE also created a directory for your user's personal
  1114.      web and ftp sites:
  1115.  
  1116.      Your User's Directory: \PPPBBS\USERS
  1117.  
  1118.      (Additional directories will automatically be created under
  1119.      \PPPBBS\USERS as needed, the first time a user logs into the
  1120.      ftp server with a valid system username and handle.)
  1121.  
  1122.      To access a user's web site from the "outside world" with
  1123.      a web browser works like this: Suppose your site name is
  1124.      "mybbs.com" and the user's username is "joe" then the
  1125.      main URL for joe's home page would be:
  1126.  
  1127.      http://mybbs.com/~joe/index.htm
  1128.  
  1129.      To download filename.zip from joe's ftp site would take the URL:
  1130.      
  1131.      ftp://mybbs.com/users/joe/filename.zip
  1132.  
  1133.      NOTE: Anonymous users can download files from user's web/ftp
  1134.      sites *only* if they have the full URL.  They cannot, by default,
  1135.      "browse" the directories to see what files are there.
  1136.  
  1137.      You can open up the user's web and ftp directories for ftp
  1138.      directory browsing, if you want to, by adding the following line
  1139.      to FTPDIRS.CFG:
  1140.  
  1141.      users,\PPPBBS\USERS,0
  1142.      
  1143.  
  1144.      TCP/IP STACK
  1145.      ------------
  1146.  
  1147.         The TCP/IP stack is the heart of the built-in Internet server
  1148.      and client applications.  It performs the "grunge" work of
  1149.      establishing TCP "connections" with other computers, communicating
  1150.      data between the two computers, and closing the TCP "connection"
  1151.      when it is no longer needed.
  1152.  
  1153.         A TCP "connection" is a virtual or logical connection, not
  1154.      a physical one.  Your SMTP client, for example, makes a TCP
  1155.      connection to your ISP's SMTP server, sends mail, and then
  1156.      closes the TCP connection.  All TCP/IP applications work the
  1157.      same way:
  1158.  
  1159.        Establish TCP Connection
  1160.        Do The Work To Be Done
  1161.        Close TCP Connection
  1162.  
  1163.         The PPPBBS TCP/IP stack handles up to 32 TCP connections
  1164.      at a time.  By pressing the (T)oggle on the PPPBBS SysOp Screen
  1165.      you can see the TCP/IP Stack in motion.  Although PPPBBS
  1166.      supports up to 32 TCP connections at a time, you'll only
  1167.      be able to see the first 9, due to screen limitations.
  1168.  
  1169.         On the TCP/IP Stack window, you'll be able to see the IP
  1170.      address of the remote system and the local TCP port they are
  1171.      connected to.  If they are downloading a file from your web
  1172.      site, you'll also see the number of bytes sent so far, and
  1173.      periodically the filename they are downloading will be
  1174.      displayed where the IP address and local TCP port are usually
  1175.      displayed, so you can see what they are downloading.
  1176.  
  1177.  
  1178.      INTERNET/INTRANET EMAIL
  1179.      -----------------------
  1180.  
  1181.         PPPBBS is capable of both sending and receiving Internet
  1182.      email, and it does it in a manner just like an ISP.  Plus, there
  1183.      are some additional features and enhancements that make PPPBBS
  1184.      superior to conventional software in many ways.
  1185.  
  1186.         The two main upper-level protocols used to move email around
  1187.      on the Internet are:
  1188.  
  1189.      SMTP    Simple Mail Transfer Protocol
  1190.      POP3    Post Office Protocol 3
  1191.  
  1192.      SMTP and POP3 operate over TCP/IP (and of course PPP) links.
  1193.  
  1194.      
  1195.      HOW ISPs HANDLE INTERNET MAIL
  1196.      -----------------------------
  1197.      
  1198.         The following diagram shows the typical mail set-up
  1199.      as used by an Internet Service Provider:
  1200.  
  1201.        ------------------                   -------------------------
  1202.        |     User's     |                   | Other Internet Host's |
  1203.        |  SMTP CLIENT   |                   |      SMTP CLIENT      |
  1204.        ------------------                   -------------------------
  1205.                |                                        |
  1206.                ------------------       -----------------
  1207.  . . . . . . . . . . . . . . .  |  . .  |  . . . . . . . . . . . . . . . .
  1208.  .                             \|/     \|/                               .
  1209.  .                         -------------------                           .
  1210.  .       ISP               \                 /                           .
  1211.  .       Mail               \     SMTP      /                            .
  1212.  .       System              \   SERVER    /                             .
  1213.  .                            \           /                              .
  1214.  .   ----------------      -------------------      ------------------   .
  1215.  .   |              |      |                 |      |                |   .
  1216.  .   |  User        |<-----|      MAIL       |----->|  Outbound      |   .
  1217.  .   |  Mailboxes   |      |    PROCESSOR    |      |  Mail          |   .
  1218.  .   |              |      |                 |      |                |   .
  1219.  .   ----------------      -------------------      ------------------   .
  1220.  .          |                                               |            .
  1221.  .         \|/                                             \|/           .
  1222.  .   ----------------                               ------------------   .
  1223.  .   |              |                               |                |   .
  1224.  .   |     POP3     |                               |      SMTP      |   .
  1225.  .   |    SERVER    |                               |     CLIENT     |   .
  1226.  .   |              |                               |                |   .
  1227.  .   ----------------                               ------------------   .
  1228.  .          |                                               |            .
  1229.  . . . . .  |  . . . . . . . . . . . . . . . . . . . . . .  |  . . . . . .
  1230.             |                                               | 
  1231.            \|/                                             \|/ 
  1232.      -------------------                         -------------------------
  1233.      |     User's      |                         | Other Internet Host's |
  1234.      |  POP3 CLIENT    |                         |      SMTP SERVER      |
  1235.      -------------------                         -------------------------
  1236.  
  1237.      SMTP SERVER: A "universal" in-box that receives mail from
  1238.                   SMTP CLIENTs.  The server receives mail from
  1239.                   user's of the ISP and other ISPs (hosts) on
  1240.                   the Internet.  An SMTP SERVER runs continuously,
  1241.                   24 hours a day, and therefore, typically requires
  1242.                   a dedicated connection to the Internet.
  1243.  
  1244.      SMTP CLIENT: A client that sends email to an SMTP SERVER.
  1245.                   Unlike an SMTP SERVER, a SMTP CLIENT only runs
  1246.                   when there is something for it to do.
  1247.  
  1248.      MAIL PROCESSOR: A mail-sorting routine.  The MAIL PROCESSOR
  1249.                      examines each piece of email and routes it
  1250.                      accordingly.  Mail for user's of the ISP is placed
  1251.                      into their mailboxes on the ISP's system.  Mail
  1252.                      destined for other sites on the Internet is relayed
  1253.                      by the ISP's SMTP CLIENT.
  1254.  
  1255.      POP3 SERVER: A server that allows the user's of the ISP to retrieve
  1256.                   email from their mailboxes on the ISP's system.
  1257.  
  1258.  
  1259.      HOW PPPBBS HANDLES INTERNET MAIL
  1260.      --------------------------------
  1261.      
  1262.         The following diagram shows the typical mail set-up
  1263.      for PPPBBS.  You'll notice that it is identical to the
  1264.      previous diagram, with a couple of additions:
  1265.      
  1266.        ------------------                   -------------------------
  1267.        |  PPP Caller's  |                   | Other Internet Host's |
  1268.        |  SMTP CLIENT   |                   |      SMTP CLIENT      |
  1269.        ------------------                   -------------------------
  1270.                |                                        |
  1271.                ------------------       -----------------
  1272.  . . . . . . . . . . . . . . .  |  . .  |  . . . . . . . . . . . . . . . .
  1273.  .                             \|/     \|/                               .
  1274.  .                         -------------------                           .
  1275.  .       PPPBBS            \                 /                           .
  1276.  .       Mail               \     SMTP      /                            .
  1277.  .       System              \   SERVER    /                             .
  1278.  .                            \           /                              .
  1279.  .   ----------------      -------------------      ------------------   .
  1280.  .   |              |      |                 |      |                |   .
  1281.  .   |  User        |<-----|      MAIL       |----->|  Outbound      |   .
  1282.  .   |  Mailboxes   |      |    PROCESSOR    |      |  Mail          |   .
  1283.  .   |              |---   |                 |      |                |   .
  1284.  .   ----------------  |   -------------------      ------------------   .
  1285.  .          |          |     /|\         /|\                |            .
  1286.  .         \|/         |      |           |                \|/           .
  1287.  .   ----------------  |  ---------  ----------     ------------------   .
  1288.  .   |              |  |  |       |  |        |     |                |   .
  1289.  .   |     POP3     |  -->| Text  |  |  POP3  |     |      SMTP      |   .
  1290.  .   |    SERVER    |     | BBS   |  | CLIENT |     |     CLIENT     |   .
  1291.  .   |              |     |       |  |        |     |                |   .
  1292.  .   ----------------     ---------  ----------     ------------------   .
  1293.  .          |                            /|\                |            .
  1294.  . . . . .  |  . . . . . . . . . . . . .  |  . . . . . . .  |  . . . . . .
  1295.             |                             |                 | 
  1296.            \|/                            |                \|/ 
  1297.      -------------------   -------------------   -------------------------
  1298.      |  PPP Caller's   |   |   Your ISP's    |   |      Your ISP's       |
  1299.      |  POP3 CLIENT    |   |   POP3 SERVER   |   |      SMTP SERVER      |
  1300.      -------------------   -------------------   -------------------------
  1301.  
  1302.      SMTP SERVER: A "universal" in-box that receives mail from
  1303.                   SMTP CLIENTs.  The server can receive mail from
  1304.                   your PPP callers using your PPPBBS system, and
  1305.                   other hosts on the Internet.  The server is available
  1306.                   automatically when you start PPPBBS, unless it has
  1307.                   been disabled.
  1308.                   
  1309.             SMTP SERVER Notes:
  1310.                   
  1311.                   If you have a dedicated connection:
  1312.  
  1313.                     You may receive mail from your PPP callers,
  1314.                     and if it needs to be relayed to the Internet,
  1315.                     it will be relayed right away by the built-in
  1316.                     SMTP CLIENT.
  1317.  
  1318.                     If you have a static IP and registered domain
  1319.                     name, you may receive mail, directly, from
  1320.                     other Internet hosts.  You will have to ask your
  1321.                     ISP to set-up your mail exchange record to indicate
  1322.                     that you'll be receiving your email directly.
  1323.  
  1324.                     If you have a DYNDNS.COM static hostname, you may
  1325.                     receive mail, directly, from other Internet hosts.
  1326.                     All they have to do is email you at the address
  1327.                     <yourhandle>@<dyndnsname>.dyndns.com
  1328.                     such as:
  1329.                     sysop@pppbbs.dyndns.com
  1330.                     and your SMTP SERVER will be active soon!
  1331.  
  1332.                   If you dial-on-demand:
  1333.  
  1334.                     You may receive mail from your PPP callers,
  1335.                     and if it needs to be relayed to the Internet,
  1336.                     it will be relayed the next time PPPBBS connects
  1337.                     to the Internet as triggered by usage.
  1338.  
  1339.                   If you don't connect to the Internet at all:
  1340.  
  1341.                     You can still use the SMTP SERVER to receive
  1342.                     email from your PPP callers.  They will be able
  1343.                     to write email other users of your system.
  1344.                   
  1345.      SMTP CLIENT: A client that sends email to an SMTP SERVER.
  1346.                   Unlike an SMTP SERVER, a SMTP CLIENT only runs
  1347.                   when there is something for it to do.  PPPBBS
  1348.                   has a built-in SMTP CLIENT that is called upon
  1349.                   automatically as needed.
  1350.  
  1351.                   NOTE: If there is no mail to go out, you can "force"
  1352.                         the SMTP CLIENT to go through the paces by
  1353.                         pressing "S" at the PPPBBS Main Screen.  You
  1354.                         might find this useful during initial set-up.
  1355.  
  1356.      MAIL PROCESSOR: A mail-sorting routine.  The MAIL PROCESSOR
  1357.                      examines each piece of email and routes it
  1358.                      accordingly.  Mail for user's of your system
  1359.                      is placed into their mailboxes.  Mail destined
  1360.                      for other sites on the Internet is relayed
  1361.                      by the built-in SMTP CLIENT.  The MAIL PROCESSOR
  1362.                      also handles AutoResponder and MailList Hosting
  1363.                      functions.
  1364.  
  1365.      POP3 SERVER: A server that allows the user's of your system to
  1366.                   retrieve email from their mailboxes.  The POP3 login
  1367.                   and password they should use is the same one they use
  1368.                   for logging into the system.
  1369.  
  1370.                   NOTE: Login and Password are CASE-SENSITIVE!
  1371.  
  1372.      POP3 CLIENT: A client that retrieves email.  PPPBBS has a built-in
  1373.                   POP3 CLIENT, and therefore, it has two different ways
  1374.                   that you can get mail into your system: POP3 CLIENT
  1375.                   and SMTP SERVER.  The PPPBBS built-in POP3 CLIENT
  1376.                   will typically be used to get your email from a POP3
  1377.                   Mailbox on your ISP.  It's execution can be scheduled
  1378.                   for every few minutes or disabled.
  1379.  
  1380.                   NOTE: You can "force" the POP3 CLIENT to check for new
  1381.                         mail by pressing "P" at the PPPBBS Main Screen.
  1382.  
  1383.  
  1384.      SMTP SERVER vs POP3 CLIENT
  1385.      --------------------------
  1386.  
  1387.         At first glance, an SMTP SERVER and a POP3 CLIENT would seem
  1388.      to have the same function: receiving email.  But they are both
  1389.      very different; each with its own unique application.
  1390.  
  1391.      SMTP SERVER                          POP3 CLIENT
  1392.      -----------                          -----------
  1393.      Receives Email                       Receives Email
  1394.  
  1395.      Runs Continuously                    Runs Only When Needed
  1396.  
  1397.      Must Be Ready To Receive Mail        Picks Up The Mail At
  1398.      Anytime                              Its Own Leisure
  1399.  
  1400.      Gets Mail Directly                   Gets Mail From A Mailbox
  1401.  
  1402.      Knows "To:" and "From:"              Knows "To:" and "From:"
  1403.      Before Downloading Mail              After Downloading Mail
  1404.  
  1405.      Can Filter Before Download           Cannot Filter Before Download
  1406.           
  1407.      Requires Dedicated Connection        No Dedicated Connection Required
  1408.      To Receive Mail From Internet
  1409.      
  1410.         You can use either one, or both, to get your email from the
  1411.      Internet.  Which one you'll have to use will most likely be
  1412.      decided by your connection type.  The SMTP SERVER is better,
  1413.      because it allows for a greater degree of control over the
  1414.      mail you download, but it is also requires that you be connected
  1415.      continuously and ready to receive mail at anytime.  If you can
  1416.      get a dedicated connection, and either a registered domain name
  1417.      or a DYNDNS.COM static hostname, then you may wish to try getting
  1418.      your Internet mail via SMTP SERVER.
  1419.  
  1420.      If you have a registered domain name, then you may need to contact
  1421.      whoever provides DNS services for that domain name (typically
  1422.      your ISP) and let them know you wish to have mail routed to you
  1423.      directly via SMTP.
  1424.  
  1425.      If you have a DYNDNS.COM static hostname mapped to either a static
  1426.      or dynamic IP address, there doesn't appear to be any additional
  1427.      action needed for you to receive Internet mail addressed to your
  1428.      DYNDNS.COM static hostname with your SMTP SERVER.
  1429.      
  1430.      If you do not have a dedicated connection, then you will have
  1431.      to use the built-in POP3 CLIENT to retrieve the mail from your
  1432.      mailbox at your ISP.
  1433.         
  1434.      NOTE: Even if you don't have a dedicated connection, the SMTP SERVER
  1435.            is still worth running; it is always available for your PPP
  1436.            callers to use, no matter what type of connection you have
  1437.            to the Internet.
  1438.  
  1439.  
  1440.      SPECIAL NOTES ABOUT PPPBBS SMTP SERVER
  1441.      --------------------------------------
  1442.  
  1443.         SPAM-RELAY-PROTECTION
  1444.         ---------------------
  1445.  
  1446.         Email can be described one of four ways:
  1447.  
  1448.      1. Email from one of your users to another one of your users
  1449.      2. Email from one of your users to a user on the Internet
  1450.      3. Email from a user on the Internet to one of your users
  1451.      4. Email from a user on the Internet to another user on the Internet
  1452.  
  1453.      The PPPBBS SMTP SERVER will readily accept mail types 1, 2, and 3.
  1454.      It is by deliberate design, however, that the 4th type is NOT accepted.
  1455.      Users out on the Internet attempting to use your SMTP SERVER to relay
  1456.      messages back out to other users out on the Internet, will be thwarted
  1457.      with the message "No Relaying."
  1458.  
  1459.      The reason for this is simple:  Without this protection,
  1460.      bulk-emailers and SPAMMERs would be able to use your SMTP SERVER
  1461.      to send thousands or possibly millions of unwanted, bulk-emails
  1462.      through your system and your ISP's system.
  1463.  
  1464.      It is for your protection (and your good standing with your ISP)
  1465.      that this feature has been implemented.  It does NOT prevent
  1466.      your users from sending mail to whomever they choose.  It does
  1467.      NOT prevent your users from receiving mail from other sites.
  1468.      It merely prevents other outside Internet sites and outside,
  1469.      unauthorized users from using your SMTP SERVER as a free email
  1470.      relay.
  1471.  
  1472.         CLOAK DETECTION
  1473.         ---------------
  1474.  
  1475.         It is not unusual for SPAM (unwanted email, typically
  1476.      advertising or asking for money), to arrive "cloaked."
  1477.      A cloaked email typically has a bogus "From:" field, leaving
  1478.      you with no idea who really sent the message, and no way
  1479.      for you to tell them to stop SPAMMING you.  SPAMMERs
  1480.      cloak their email so that they don't get SPAMMED themselves.
  1481.  
  1482.      Here are two examples.  The first example cloaks only the
  1483.      sender's handle:
  1484.      
  1485.      From: 72462345@somewhere.com
  1486.  
  1487.      The second example cloaks both handle and hostname:
  1488.      
  1489.      From: 13456233@2783467.com
  1490.  
  1491.         The PPPBBS SMTP SERVER will not accept cloaked email.
  1492.      Since SMTP SERVERs know the To: and From: field before
  1493.      ever downloading the message, they are able to make a
  1494.      determination before any bandwidth is wasted.  Any mail sender,
  1495.      local or Internet, must provide a proper "From:" field.
  1496.      If a proper "From:" field is not present, the mail is
  1497.      rejected with the message "Mail Refused."
  1498.  
  1499.  
  1500.      AUTORESPONDER
  1501.      -------------
  1502.  
  1503.         An autoresponder automatically sends mail when "triggered"
  1504.      by a piece of incoming email addressed to it's name.
  1505.  
  1506.         The file for the AutoResponder's configuration is AUTORESP.CFG,
  1507.      and it is an ASCII text file you create with a text editor.  The
  1508.      general format is as follows:
  1509.  
  1510.      [<name of autoresponder #1>]
  1511.      <desired "From address" to be used for response>
  1512.      <desired "Subject" to be used for response>
  1513.      .
  1514.      .  Desired Text of Message
  1515.      .
  1516.      [<name of autoresponder #2>]
  1517.      <desired "From address" to be used for response>
  1518.      <desired "Subject" to be used for response>
  1519.      .
  1520.      .  Desired Text of Message
  1521.      .
  1522.  
  1523.      There is no hard-limit to the size of the response or
  1524.      the number of AutoResponders you can have, however a 
  1525.      larger AUTORESP.CFG will incur more processing time
  1526.      when an AutoResponse is needed.
  1527.  
  1528.      Additionally, all AutoResponder names must end in "-r".
  1529.      
  1530.  
  1531.      MAIL LIST HOSTING
  1532.      -----------------
  1533.  
  1534.         A mail-list is more than just a list of email addresses,
  1535.      that you can send email to by writing one piece of email.
  1536.      A mail-list is more like a private conference area.  Members 
  1537.      of the list who post to the list's address, will have their
  1538.      messages automatically distributed to everyone on the list.
  1539.  
  1540.         Mail-list configuration requires that you create ASCII file
  1541.      MAILLIST.CFG.  MAILLIST.CFG can hold the configuration for
  1542.      multiple mail-lists.  The general format is as follows:
  1543.      
  1544.      [<name of mail-list #1>]
  1545.      .
  1546.      .  Email Addresses of List Members, one per line
  1547.      .
  1548.      [<name of mail-list #2>]
  1549.      .
  1550.      .  Email Addresses of List Members, one per line
  1551.      .
  1552.      
  1553.         Suppose you wanted to start out with a list called "test-l"
  1554.      with just yourself and your cosysop as members, and your site's
  1555.      Internet address is "mybbs.com"; you would type into MAILLIST.CFG 
  1556.      something like this:
  1557.  
  1558.      [test-l]
  1559.      sysop@mybbs.com
  1560.      cosysop@mybbs.com
  1561.  
  1562.      If you also wanted another list "test2-l" with just yourself
  1563.      in it, you would put in:
  1564.  
  1565.      [test-l]
  1566.      sysop@mybbs.com
  1567.      cosysop@mybbs.com
  1568.      [test2-l]
  1569.      sysop@mybbs.com
  1570.  
  1571.      Notice that the list name always ends in "-l", and is put
  1572.      into the MAILLIST.CFG file surrounded by brackets.  There is
  1573.      no hard-limit to the number of mail-lists that can be
  1574.      supported, or the number of members that can be on each list.
  1575.      
  1576.      Users (Local or Internet) can add themselves to the list 
  1577.      automatically by sending mail to the list's address 
  1578.      (test-l@mybbs.com or test2-l@mybbs.com in the examples) 
  1579.      with the SUBJECT "add".  Users can remove themselves from 
  1580.      the list automatically by sending mail to the list's address 
  1581.      with the SUBJECT "remove".  In the case of automated ADD or 
  1582.      REMOVE, PPPBBS updates MAILLIST.CFG automatically for you, 
  1583.      however, you are always free to make edits manually if necessary.
  1584.      
  1585.      If you wanted to set-up the AutoResponder to deliver an 
  1586.      automated response to an ADD or REMOVE request to list
  1587.      "test-l", you would add something like the following to 
  1588.      AUTORESP.CFG:
  1589.  
  1590.      [test-l.add-r]
  1591.      ListServer
  1592.      ADD Request
  1593.      
  1594.      Thank you for joining "test-l"
  1595.      To remove yourself from this list, email test-l@mybbs.com,
  1596.      with the subject REMOVE.
  1597.  
  1598.      [test-l.remove-r]
  1599.      ListServer
  1600.      REMOVE Request
  1601.  
  1602.      You have been removed from "test-l"
  1603.      To re-join this list, email test-l@mybbs.com, 
  1604.      with the subject ADD.
  1605.  
  1606.      
  1607.      UNIVERSAL MAILBOX
  1608.      -----------------
  1609.  
  1610.         When a user signs up on your PPPBBS, they automatically
  1611.      get a mailbox for their personal use.  The mailbox can
  1612.      hold mail from other users of your system, and from users
  1613.      on the Internet.  The same mailbox is accessible for reading:
  1614.  
  1615.      1) If they call your PPPBBS with PPP and use POP3 to retrieve
  1616.         their email from your POP3 server, with software such as Microsoft
  1617.         Internet Mail, or most any standard TCP/IP mail software.
  1618.  
  1619.      2) If they call the PPPBBS mini-BBS and login via character-mode,
  1620.         and use the main menu Read Email function.
  1621.  
  1622.      3) If they are out-of-town and using another ISP, they can
  1623.         use POP3 to get their email from your POP3 server, presuming
  1624.         you are connected to the Internet at the time, and have static
  1625.         IP or DYNDNS static hostname.
  1626.  
  1627.  
  1628.      HOW YOUR USERS (PPP CALLERS) SHOULD CONFIGURE TCP/IP MAIL SOFTWARE
  1629.      ------------------------------------------------------------------
  1630.  
  1631.         There is very little that they will need to configure.
  1632.      Generally, TCP/IP mail software needs to know the address
  1633.      of your SMTP SERVER, address of your POP3 SERVER, their
  1634.      username and password (since that is needed for POP3
  1635.      login), and the your primary hostname you've configured
  1636.      with PPPCFG.EXE.
  1637.              
  1638.         If they will always be using your system directly, they
  1639.      can configure their mail software like this:
  1640.  
  1641.      SMTP Server:   bbs
  1642.      POP3 Server:   bbs
  1643.      POP3 Login:    <username>
  1644.      POP3 Password: <password>
  1645.      Email Address: <username>@<yourprimaryhostname>
  1646.  
  1647.      (The Transparent DNS Selective Interceptor makes the easy "bbs"
  1648.      entry possible.)
  1649.  
  1650.         If they will be accessing their mail from another ISP, they can
  1651.      configure their mail software like this:
  1652.  
  1653.      SMTP Server:   <otherispssmtpserver>
  1654.      POP3 Server:   <yourregistereddomainname-or-staticIP-or-dyndnsname>
  1655.      POP3 Login:    <username>
  1656.      POP3 Password: <password>
  1657.      Email Address: <username>@<yourprimaryhostname>
  1658.  
  1659.  
  1660.      HOW YOUR USERS (NON PPP CALLERS) USE THE BBS TO SEND MAIL
  1661.      ---------------------------------------------------------
  1662.  
  1663.         From the main menu, select (E) the normal email function.
  1664.      At the "Write Email To?" prompt, users can send mail to other
  1665.      users on the system by simply entering in the handle of the
  1666.      user they want to email.  An example:
  1667.  
  1668.      sysop
  1669.  
  1670.      To send mail to a user on the Internet, simply enter in that
  1671.      user's email address in the typical <username>@<hostname>
  1672.      format:
  1673.  
  1674.      roland@degraaf.net
  1675.  
  1676.  
  1677.      SETTING UP THE PPPBBS FRONT-END FEATURE
  1678.      ---------------------------------------
  1679.  
  1680.         Setting up the front-end feature involves creating/editing
  1681.      one batch file (.BAT), and optionally, one .BBS file.
  1682.  
  1683.         FRONTEND.BAT
  1684.         ------------
  1685.         
  1686.            The batch file needs to be called FRONTEND.BAT and should
  1687.         contain the necessary commands applicable to your BBS software.
  1688.         Obviously, FRONTEND.BAT will be different for each different type
  1689.         of BBS software.
  1690.  
  1691.            Example front-end set-up files for specific BBS softwares is
  1692.         available for download from the official PPPBBS web site and BBS.
  1693.         As of this writing, the following are available:
  1694.  
  1695.         EXAMPLE1.ZIP            Virtual Advanced BBS
  1696.  
  1697.         More examples will be added as they are submitted by sysops.
  1698.  
  1699.            When PPPBBS executes FRONTEND.BAT, it will pass the PPPBBS
  1700.         channel number that the caller is using.  If the caller is on
  1701.         channel 1, then PPPBBS will pass a "1", if the caller is on
  1702.         channel 2, then PPPBBS will pass a "2", and so on.
  1703.              
  1704.            For BBS softwares that are already channel-oriented, such as
  1705.         Virtual Advanced, this makes the batch file fairly straight-forward.
  1706.         (One would simply set-up the Channels on Virtual Advanced to use
  1707.         the same FOSSIL ports and baud rates as the Channels on PPPBBS.)
  1708.      
  1709.         As a working example, the FRONTEND.BAT for Virtual Advanced BBS
  1710.         looks like this:
  1711.  
  1712.         c:
  1713.         cd \vadv
  1714.         bbs.exe %1 /AC /H /B57600
  1715.         c:
  1716.         cd \pppbbs
  1717.         endrun.exe %1
  1718.         exit
  1719.  
  1720.         NOTE: ENDRUN.EXE is supplied with PPPBBS. Its function is to
  1721.         safely notify PPPBBS that the BAT file is done executing.
  1722.  
  1723.         FRONTEND.BBS
  1724.         ------------
  1725.  
  1726.            The one, optional .BBS file that you can create is called
  1727.         FRONTEND.BBS.  If this file is not created, then PPPBBS will
  1728.         execute FRONTEND.BAT as soon as PPPBBS detects that this is
  1729.         not an incoming PPP caller.  If FRONTEND.BBS does exist,
  1730.         then it is displayed to the caller, and they are prompted to
  1731.         press "1" to access your existing BBS (execute FRONTEND.BAT)
  1732.         or press "0" to access the PPPBBS mini-BBS.  FRONTEND.BBS
  1733.         can be as plain or as fancy as you like, so long as it is
  1734.         under 2048 bytes.
  1735.         
  1736.            Here is where you have some control over the perception
  1737.         of your BBS to the public.  Here are four separate options:
  1738.         
  1739.         1) If you want the PPPBBS mini-BBS to be disabled, then
  1740.            do not create FRONTEND.BBS.  This will also have the
  1741.            side-effect of preventing callers from being able to
  1742.            use the mini-BBS new user sign-up in order to gain a
  1743.            PPP access account, so you'll have to use the user editor
  1744.            to create accounts for them from their information
  1745.            in their user accounts on your existing BBS.
  1746.  
  1747.         2) If you want the PPPBBS mini-BBS to look like the main BBS,
  1748.            with your existing BBS as secondary BBS, then create
  1749.            FRONTEND.BBS to look something like:
  1750.  
  1751.            0 - Main BBS & PPP Sign-Up
  1752.            1 - Secondary BBS
  1753.  
  1754.         3) If you want the existing BBS to look like the main BBS,
  1755.            with your PPPBBS mini-BBS as secondary BBS, then create
  1756.            FRONTEND.BBS to look something like:
  1757.  
  1758.            1 - Main BBS
  1759.            0 - Secondary BBS & PPP Sign-Up
  1760.  
  1761.         4) If you want the existing BBS to be the only BBS, and have
  1762.            the PPPBBS mini-BBS be available for new user PPP sign-up,
  1763.            then create FRONTEND.BBS to look something like:
  1764.  
  1765.            1 - The BBS
  1766.            0 - Sign Up For PPP Access
  1767.  
  1768.            And edit PPPTEXT.CFG to make the Login: prompt look like:
  1769.  
  1770.            Enter NEW To Sign-Up For PPP Access:
  1771.      
  1772.  
  1773.      ORDERING PPPBBS & LIMITATIONS TO THE UNREGISTERED VERSION
  1774.      ---------------------------------------------------------
  1775.  
  1776.         Please see the accompanying text file ORDER.TXT for a mail-in
  1777.      order form and instructions for ordering via mail, email, BBS,
  1778.      or web site.  Orders placed by mail, email, or web site are
  1779.      shipped by FIRST CLASS MAIL.  Orders placed by BBS online
  1780.      ordering can be shipped by FIRST CLASS MAIL or DOWNLOADED
  1781.      FROM THE BBS.  UNDER NO CIRCUMSTANCES ARE ORDERS SENT VIA
  1782.      NETWORKED OR INTERNET EMAIL.
  1783.  
  1784.      PPPBBS REGISTRATION IS NON-TRANSFERRABLE, AND NON-REFUNDABLE.
  1785.  
  1786.         If the shareware copy of PPPBBS you downloaded does not contain
  1787.      ORDER.TXT, or if the ZIP does NOT say:
  1788.  
  1789.      Authentic Files Verified!   # ODO014
  1790.      ROLAND DE GRAAF
  1791.  
  1792.      You should access one of the official sites listed in this
  1793.      documentation to download an OFFICIAL copy of the software.
  1794.  
  1795.         When you register PPPBBS, you will receive a special file
  1796.      called a KEYFILE which, when placed in the directory where you
  1797.      run PPPBBS, will UNLOCK the program and provide you with its
  1798.      full capabilities.  The registration will also give you acess
  1799.      to technical support direct from the program author.
  1800.  
  1801.         In the UNREGISTERED state, the program will exhibit the
  1802.      following artificial limitations:
  1803.  
  1804.      Maximum Number Of Simultaneous Incoming Logins: 2
  1805.      Maximum Time Per Incoming Login: 10 minutes
  1806.  
  1807.         In addition, the UNREGISTERED version recognizes only the
  1808.      first line of SERVERS.CFG, limiting you to one built-in TCP/IP
  1809.      server application at a time, and the built-in TCP/IP client
  1810.      applications are completely disabled.
  1811.  
  1812.         The Ethernet support is also disabled in the UNREGISTERED 
  1813.      VERSION of PPPBBS.
  1814.      
  1815.      The above UNREGISTERED limitations will make the program usable
  1816.      enough for you to evaluate it, but not allow serious continued
  1817.      usage.  The maximum evaluation period is 30 days; after that time
  1818.      you must either register the software or discontinue using it.
  1819.           
  1820.  
  1821.      LOSS OF REGISTRATION
  1822.      --------------------
  1823.  
  1824.         Once received by the customer, the care and protection of
  1825.      the KEYFILE is the customer's responsibility.  THERE IS A
  1826.      $10 FEE TO REPLACE OR RE-SHIP LOST PPPBBS REGISTRATION
  1827.      KEYFILES.
  1828.                
  1829.  
  1830.      OBTAINING TECHNICAL SUPPORT
  1831.      ---------------------------
  1832.  
  1833.         Technical support is available to REGISTERED PPPBBS users.
  1834.      Technical support is also available to UNREGISTERED users during
  1835.      their 30-day evaluation period.  Registered users please include
  1836.      your registration number in your email for higher priority.
  1837.  
  1838.         EMAIL: roland@degraaf.net
  1839.         BBS: 616-399-4818 (or telnet://pppbbs.dyndns.com)
  1840.         http://www.degraaf.net 
  1841.         http://www.ameritech.net/users/pppbbs/index.htm
  1842.         http://pppbbs.dyndns.com
  1843.         ftp://pppbbs.dyndns.com
  1844.         
  1845.         The author will try to answer your email within 24 hours, but
  1846.      a response may take longer if the author is inundated with email,
  1847.      or is otherwise indisposed, or if your email requires an
  1848.      extensive response.
  1849.  
  1850.         The chance that you will need technical support is unlikely;
  1851.      PPPBBS has been carefully crafted according to InterNIC
  1852.      STDs (standards) and RFCs (request for comments) and in these
  1853.      cases what works, works.  There is not a whole lot of room
  1854.      for misinterpretation.
  1855.  
  1856.         The author has tested PPPBBS with numerous Internet Service
  1857.      Providers (for the dial out) and Windows 95 Dial-Up Networking
  1858.      (for the incoming PPP calls), and the program has passed all
  1859.      tests with flying colors.
  1860.  
  1861.  
  1862.      INTERNET TECHNICAL INFORMATION
  1863.      ------------------------------
  1864.  
  1865.         PPPBBS is a true IP (Internet Protocol) router, that just
  1866.      happens to have the PPP protocol, and some additional, unique
  1867.      features built right into it.  It is, essentially an
  1868.      intelligent router.  PPPBBS is NOT a proxy server, although
  1869.      it does do a bit of "magic" to allow multi-user Internet
  1870.      access without requiring a range of IP addresses.
  1871.      
  1872.         From a purely technical standpoint, these are the protocols
  1873.      supported, and how they are chained together:
  1874.  
  1875.                    PPP --- LCP  --- IP  --- TCP
  1876.                            PAP              UDP
  1877.                            IPCP
  1878.  
  1879.                    Ethernet -- IP  --- TCP
  1880.                                ARP     UDP
  1881.  
  1882.         Your callers will be able to use virtually all off-the-shelf
  1883.      Internet client applications.  This includes, but is not limited to,
  1884.      the following:
  1885.  
  1886.         Web Browsing (http) (ie NetScape, MS Internet Explorer, etc.)
  1887.         Telnet
  1888.         ftp
  1889.         Internet Relay Chat
  1890.         RealAudio
  1891.         Gopher
  1892.         SMTP/POP3
  1893.         NNTP      (Note 1)
  1894.  
  1895.         ...and many others.
  1896.  
  1897.      Notes:
  1898.  
  1899.      1. Your callers will need to have access to a public NNTP server.
  1900.         For a list of public NNTP servers, http://altavista.digital.com
  1901.         and search on "public NNTP server" (exactly as shown, including
  1902.         the quotes).
  1903.                    
  1904.  
  1905.      FOSSIL HELP
  1906.      -----------
  1907.  
  1908.         PPPBBS requires that you have a FOSSIL driver, or equivalent,
  1909.      installed on your computer before it will operate properly. A FOSSIL 
  1910.      driver is essentially a standardized set of routines for driving the 
  1911.      COM ports (serial ports) on your computer.  A FOSSIL is a serial
  1912.      port driver that can handle many ports.
  1913.  
  1914. DOS  For PPPBBS under DOS 5.00 or higher, the X00 FOSSIL driver
  1915. ONLY by Ray Gwinn is recommended.  X00150.ZIP is available from
  1916.      www.degraaf.net web site and BBS as well as many other places.  
  1917.      Specific X00 for DOS set-up help is in the next section of this 
  1918.      documentation.
  1919.      
  1920. OS2  For PPPBBS under OS/2, the Ray Gwinn SIO package is recommended,
  1921. ONLY and you'll want to have your CONFIG.SYS install the special SIO
  1922.      X00.SYS software interface that allows FOSSIL-programs to access
  1923.      the OS/2 serial ports without virtualization. (ie faster!)
  1924.      See the SIO documentation for more help setting up SIO and SIO's
  1925.      version of X00.SYS.
  1926.  
  1927. WIN  For PPPBBS under Windows95, you will probabily want to use
  1928. ONLY a very nice program called WinFossil.  It is a FOSSIL driver
  1929.      written specifically for Windows 95.  It has the advantage
  1930.      of making DOS communications programs which can do FOSSIL calls
  1931.      (such as PPPBBS and Virtual Advanced BBS for DOS) run almost as
  1932.      fast as native Windows applications.  This is possible because
  1933.      FOSSIL-based applications are given direct access to Windows
  1934.      COMM support, eliminating the need for the operating system
  1935.      to "virtualize" the COM port and thus eliminating a tremendous
  1936.      amount of processor overhead.  WinFossil has been tested by
  1937.      the PPPBBS author.
  1938.  
  1939.      
  1940.      SETTING UP X00 FOR DOS
  1941.      ----------------------
  1942.  
  1943.         Configuring the computer to install the X00.SYS FOSSIL driver
  1944.      at boot-up is done by editing the CONFIG.SYS file -- typically
  1945.      this means adding one line of text.
  1946.      
  1947.      A basic computer system with two COM ports at the standard COM1/COM2
  1948.      locations might use the line:
  1949.  
  1950.      DEVICE=C:\DOS\X00.SYS 0=3F8,4 1=2F8,3 B,0,57600 B,1,57600
  1951.  
  1952.      The above example configures the FOSSIL driver so that FOSSIL
  1953.      port 0 is at base address 3F8 and IRQ 4, and port 1 is at base
  1954.      address 2F8 IRQ 3.  The above example also shows using the B
  1955.      option to lock the baud rate of both COM ports to 57600.
  1956.  
  1957.      If the above example computer had two more ports at addresses
  1958.      3E8 IRQ 5 and 2E8 IRQ 2, the line would be:
  1959.  
  1960.   DEVICE=C:\DOS\X00.SYS 0=3F8,4 1=2F8,3 2=3E8,5 3=2E8,2 B,0,115200 B,1,57600 B,2,57600 B,3,57600
  1961.  
  1962.      The above example would give you four FOSSIL ports: Port 0,
  1963.      Port 1, Port 2, and Port 3.  Note that FOSSIL ports begin at 0
  1964.      (zero) not 1 (one).  Port 0 would be locked at 115200 baud, and
  1965.      Ports 1, 2, and 3 would be locked at 57600 baud.
  1966.  
  1967.         There are many more examples and a complete explanation
  1968.      in the docmentation that accompanies X00.  This text is merely
  1969.      intended to be a primer to help you get started quickly.
  1970.  
  1971.         The X00 FOSSIL driver is quite versatile; it can control
  1972.      standard and non-standard COM ports; it can also be used to
  1973.      control some non-intelligent multiport serial boards.
  1974.  
  1975.  
  1976.      SETTING UP DRIVERS THAT ACT LIKE FOSSILS
  1977.      ----------------------------------------
  1978.  
  1979.         There are some hardware-specific drivers that "look-like"
  1980.      FOSSIL drivers to application software.  A couple of examples
  1981.      are CFOS, a FOSSIL for driving older proprietary ISDN cards
  1982.      found all over Europe, and G00, a driver for GTEK's intelligent
  1983.      multiport serial boards, such as the SmartCard 8.
  1984.  
  1985.         These types of drivers should also work well with PPPBBS.
  1986.      Consult the manufacturers directions for driver installation.
  1987.  
  1988.  
  1989.      SETTING UP WINFOSSIL UNDER WIN95
  1990.      --------------------------------
  1991.  
  1992.         WinFossil practically sets itself up for you.  Once the
  1993.      files are installed, you merely go to the Control Panel,
  1994.      select the WinFossil icon, and use a nifty configuration
  1995.      program to enable the ports you want WinFossil to service.
  1996.  
  1997.         As a convenience, you may wish to put a Windows 95
  1998.      shortcut to the WinFossil configuration wizard on your desktop,
  1999.      should you need to make WinFossil configuration changes at
  2000.      some point in the future.
  2001.  
  2002.         After setting up WinFossil, don't forget to use the
  2003.      WinFossil cofiguration wizard to:
  2004.  
  2005.      1) Enable the COM ports to be serviced by WinFossil.
  2006.  
  2007.      2) Set the Locked Baud Rate of each port to 57600 or higher,
  2008.         depending on the type and age of the modem on each port.
  2009.  
  2010.      3) Set the Rx buffer to at least 8192 and the Tx buffer
  2011.         to at least 8192 for each port.  You may experiment
  2012.         with buffer settings for best program performance.
  2013.  
  2014.      NOTE: You may wish to give the COM port which is to be used by
  2015.      PPPBBS Channel 0 (the dial-out to your ISP) larger Rx and Tx
  2016.      buffers.
  2017.      
  2018.  
  2019.      USING 56K MODEMS
  2020.      ----------------
  2021.  
  2022.         PPPBBS fully supports ALL high-speed AT-command set modems -
  2023.      from 9600 to 56000 bps.
  2024.  
  2025.         It would seem that many ISPs support the use of 56k modems
  2026.      these days, and it would seem like a good idea to use a 56k
  2027.      modem on your PPPBBS dialout line.  Before you run out and get
  2028.      one, make sure you get a good modem; and make sure you have
  2029.      a clean phone line to use.
  2030.  
  2031.         It has been the author's experience that a poorly-made 56k
  2032.      modem and/or noisy phone line will actually give you less speed than
  2033.      a regular 33.6 modem connection.  If this happens, one of the
  2034.      best solutions is to connect to your ISPs regular 33.6 dial-up
  2035.      pool (many ISPs keep their 33.6 and 56k modems on separate
  2036.      hunt-groups) instead of trying to use their 56k facilities,
  2037.      OR, you can disable 56k by reconfiguring the modem itself.
  2038.      See your modem manual for the correct AT command.
  2039.  
  2040.  
  2041.      ADVANCED OPTIONS AND TIPS
  2042.      -------------------------
  2043.  
  2044.         This section describes advanced options; these options
  2045.      are not required -- they are available to allow you to configure
  2046.      PPPBBS to be as powerful as you need it to be.
  2047.  
  2048.         TRANSPARENT DNS SELECTIVE INTERCEPTOR
  2049.         -------------------------------------
  2050.  
  2051.            When your PPP callers use the Internet to surf the web or
  2052.         use other Internet services, such as FTP, telnet, SMTP, and so
  2053.         on, they are using your ISP's DNS (domain name server) to
  2054.         resolve hostnames to IP addresses.  But what if the server
  2055.         they want to access is running right on your PPPBBS itself?
  2056.         
  2057.         The "Transparent DNS Selective Interceptor" is a mechanism
  2058.         that gives each resolve request from your PPP callers a quick,
  2059.         cursory examination, and if the hostname they want resolved
  2060.         is "bbs" it intercepts the request and returns a reply giving
  2061.         your current IP address.  This permits SysOps using PPP accounts
  2062.         with dynamic IP addressing to be able to run the built-in server
  2063.         applications, and have them be easily accessible to PPP callers
  2064.         logged into your PPPBBS.
  2065.  
  2066.            To access your web server, for example, a PPP caller would
  2067.         start up their web browser and enter the URL:
  2068.  
  2069.         http://bbs/       (Some browsers may let them abbreviate to "bbs")
  2070.  
  2071.            To access the Text BBS via your telnet server, a PPP caller
  2072.         could type:
  2073.  
  2074.         telnet bbs
  2075.  
  2076.         This applies to any servers you have running on your PPPBBS site,
  2077.         and is not limited to the web and telnet servers.
  2078.                         
  2079.         If the hostname that needs to be resolved is not "bbs" then
  2080.         the resolve request is NOT intercepted and it is passed on
  2081.         normally, to your ISP's DNS server(s).
  2082.         
  2083.         There is nothing you need to set-up.  The interceptor works
  2084.         automatically, and transparently, and should not interfere
  2085.         with normal operation.
  2086.                 
  2087.         BLOCKED.CFG
  2088.         -----------
  2089.  
  2090.            BLOCKED.CFG is an ASCII file you create with a text editor.
  2091.         Its use is strictly optional.  BLOCKED.CFG allows you to
  2092.         block incoming-caller TCP/IP access to certain host TCP/IP
  2093.         address/port combinations.  Its possible applications include
  2094.         blocking SPAMMERs from using your ISPs SMTP server, or blocking
  2095.         under-age callers from accessing known adult web sites.
  2096.         
  2097.            For example, the author's ISP SMTP server is at IP address
  2098.         205.138.138.1, and all standard SMTP servers listen on port 25.
  2099.         So the author's BLOCKED.CFG looks like:
  2100.  
  2101.         205.138.138.1,25
  2102.  
  2103.         This simple example shows only one line of data in the file.
  2104.         BLOCKED.CFG may contain up to 100 lines (entries).
  2105.  
  2106.         NOTE: BLOCKED.CFG does not apply to users logged in with
  2107.         a security level of 900 or higher.
  2108.  
  2109.         RESERVED.CFG
  2110.         ------------
  2111.  
  2112.            RESERVED.CFG is an ASCII file you create with a text editor.
  2113.         What it does is fairly technical; its use is strictly optional.
  2114.         It allows you to "reserve" TCP or UDP ports to be automatically
  2115.         assigned to a particular PPP user when they are logged into the
  2116.         router.
  2117.  
  2118.         Up to 100 entries (one entry per line) may be entered into this
  2119.         file.  For more information and examples, see the section
  2120.         about running Internet Server Applications on Computers
  2121.         Routed Through PPPBBS.
  2122.  
  2123.         HOURLY.BAT & DAILY.BAT
  2124.         ----------------------
  2125.  
  2126.            If created, these files are executed either hourly or daily
  2127.         as applicable.  These files allow you to customize PPPBBS
  2128.         to automatically run external maintenance programs, such as
  2129.         mail tossers, daily-processing for door games, and so on.
  2130.         Especially useful for SysOps using the FRONTEND.BAT feature.
  2131.  
  2132.         IMPORTANT NOTE: If the FRONTEND.BAT option is being used,
  2133.         PPPBBS assumes you are running under Windows 95, and runs
  2134.         HOURLY.BAT and DAILY.BAT in the background.  This allows them
  2135.         to run without disturbing PPPBBS -- even if they take a few
  2136.         minutes to run.
  2137.         
  2138.         If, however, you are NOT using the FRONTEND.BAT feature, then
  2139.         PPPBBS assumes you are running under DOS or OS/2 and it must run
  2140.         HOURLY.BAT or DAILY.BAT the old-fashioned way.  Therefore,
  2141.         if you are not using the FRONTEND feature, it is advised that
  2142.         you not use the HOURLY.BAT or DAILY.BAT feature, unless you really
  2143.         need it.  If you do use it, you should limit HOURLY.BAT and/or
  2144.         DAILY.BAT to quick operations.
  2145.                         
  2146.         USING PPPBBS WHERE NUMBER OF PHONE LINES IS RESTRICTED
  2147.         ------------------------------------------------------
  2148.  
  2149.            Ideally, PPPBBS should be used with at least 3 phone
  2150.         lines available for its use:
  2151.  
  2152.         --------------------------
  2153.         | Dedicated or On-Demand |------phone line 1-------->
  2154.         | DialOut To ISP  (Ch 0) |
  2155.         --------------------------
  2156.         | Incoming Line   (Ch 1) |<-----phone line 2---------
  2157.         |                        |
  2158.         --------------------------
  2159.         | Incoming Line   (Ch 2) |<-----phone line 3---------
  2160.         |                        |
  2161.         --------------------------
  2162.                    .
  2163.                    .
  2164.                    .
  2165.  
  2166.  
  2167.          What if you have only ONE or TWO PHONE LINES available?
  2168.  
  2169.          Solution: If you don't get very many calls on your "voice"
  2170.          phone line, then hook it up to Ch 0, set PPPBBS to On-Demand,
  2171.          and use your voice line for the ISP dialout.  Your voice line
  2172.          will only be tied up while incoming callers are using PPP
  2173.          Internet access.  That leaves your ONE or TWO BBS PHONE
  2174.          LINES available to be connected to Ch 1 (ONE LINE)
  2175.          or connected to Ch 1 and Ch 2 (TWO LINES).
  2176.  
  2177.         CONTROLLING THE NEW USER QUESTIONAIRE
  2178.         -------------------------------------
  2179.  
  2180.            By default, PPPBBS new user sign up asks for the typical
  2181.         personal information: name, address, city, state, zip,
  2182.         phone number, and so on.  You can make PPPBBS skip certain
  2183.         fields by simply editing PPPTEXT.CFG.  If make the line blank
  2184.         where it reads "Address:" then PPPBBS will not ask for
  2185.         address.  Important! Do NOT delete the line entirely.
  2186.         The line should be blank (completely empty), but NOT deleted.
  2187.         Backup your PPPTEXT.CFG before attempting this edit.
  2188.  
  2189.         CHOOSING A MULTIPLE SERIAL CARD
  2190.         -------------------------------
  2191.  
  2192.            It is not the author's place or desire to suggest that you
  2193.         go out and buy any one particular multiple serial board.  There
  2194.         are no doubt many serial boards which will work with PPPBBS,
  2195.         so long as the FOSSIL driver has been set-up properly.
  2196.  
  2197.            In the hope of providing some information so that you can make
  2198.         your own decision, here is a list of multiple serial cards known to
  2199.         work with PPPBBS:
  2200.                                              
  2201.                                        Driver Support
  2202.  
  2203.       Serial Card                 DOS       OS2        Windows 95
  2204.       -------------------------   ---       ---        ----------
  2205.       GTEK Blackboard-4L          X00       SIO    GTEK Driver + WinFossil
  2206.       GTEK Blackboard-4           X00       SIO    GTEK Driver + WinFossil
  2207.  
  2208.       X00 = X00 FOSSIL DRIVER
  2209.       SIO = SIO DRIVERS FOR OS2
  2210.  
  2211.       The author welcomes user-submitted information to include in the
  2212.       above list.
  2213.  
  2214.       When purchasing a serial board you have to take into consideration
  2215.       the operating system you will be using.  If you are using DOS, then
  2216.       your choice is much less critical.  X00 can be made to function with
  2217.       just about any non-intelligent serial card.  If you will be using
  2218.       Windows 95, then you may want to make certain that the board
  2219.       comes with drivers for Windows 95 (or that the drivers can be
  2220.       downloaded from their web site).
  2221.  
  2222.         SETTING UP MULTIPLE SERIAL PORTS UNDER DOS
  2223.         ------------------------------------------
  2224.  
  2225.            Setting up multiple serial ports under DOS is pretty
  2226.         simple: configure the serial card so that it doesn't
  2227.         conflict with any other hardware, then configure X00
  2228.         to the port addresses and IRQ(s) you've set-up.
  2229.  
  2230.         NOTE: It is possible for X00 to support multiple COM
  2231.         ports using the same IRQ if certain conditions are met:
  2232.         (1) All ports sharing the IRQ must be on the same card
  2233.         (2) The card has been designed to allow ports to share
  2234.             a single IRQ
  2235.  
  2236.         Example:
  2237.  
  2238.            2 COM ports on Motherboard
  2239.              COM1 Base 3F8 IRQ 4
  2240.              COM2 Base 2F8 IRQ 3
  2241.  
  2242.            4 COM ports on GTEK BlackBoard-4
  2243.              COM3 Base 100 IRQ 12
  2244.              COM4 Base 108 IRQ 12
  2245.              COM5 Base 110 IRQ 12
  2246.              COM6 Base 118 IRQ 12
  2247.  
  2248.            6 COM ports total
  2249.  
  2250.         In CONFIG.SYS, the X00 line might look like:
  2251.  
  2252.   DEVICE=C:\DOS\X00.SYS 0=3F8,4 1=2F8,3 2=100,12 3=108,12 4=110,12 5=118,12
  2253.  
  2254.         SETTING UP MULTIPLE SERIAL PORTS UNDER WINDOWS 95
  2255.         -------------------------------------------------
  2256.  
  2257.            Setting up multiple serial port boards under Windows 95
  2258.         can be a little more tricky.  There is no one way to advise
  2259.         how to set-up a multiple serial board since each one is bound
  2260.         to be diffrerent.
  2261.         
  2262.            If your serial board comes with drivers, then you may be
  2263.         all set.  Typically, you will run a SETUP.EXE which will copy
  2264.         a few files, and update one or two .INF files, so that
  2265.         Windows 95 can then "Plug&Play" the new serial board
  2266.         ("New Hardware Found") the next time you restart Windows 95.
  2267.         There may or may not be more steps involved, depending on
  2268.         the serial board.
  2269.  
  2270.            If your serial board does not come with drivers, you may
  2271.         still be able to "install" the card into Windows 95 manually
  2272.         by using the "Add New Hardware" function from the "Control Panel."
  2273.         Be prepared to manually configre the base address and IRQ for
  2274.         each port, if that is what it takes.
  2275.  
  2276.         NOTE: Once your serial ports are recognized by Windows 95,
  2277.         don't forget to set-up WinFossil!
  2278.  
  2279.         IMPORTANT NOTE: When Windows 95 boots, it checks each known
  2280.         serial port on your system to see what is connected, mouse or
  2281.         modem.  If it finds a modem, it tries to figure out the type,
  2282.         manufacturer, and Windows 95 "plugs and plays" the modem.  If
  2283.         you have many serial ports, this process can take longer.
  2284.  
  2285.         If you have external modems with LED indicators, you can see
  2286.         the process happening (the DTR line will light momentarily
  2287.         and the Send Data and Receive Data lights will flash).
  2288.  
  2289.         If you have a lot of serial ports, the modem-detection
  2290.         process can still be in-progress even after the blue Windows 95
  2291.         boot-up screen disappears, and your desktop appears, giving
  2292.         the appearance that the computer is ready to use.
  2293.  
  2294.         It is not recommended that you start-up any communications
  2295.         software until Windows 95 has completely finished its
  2296.         modem-detection process.
  2297.  
  2298.         CONNECTING COMPUTERS VIA NULL MODEM
  2299.         -----------------------------------
  2300.  
  2301.            Suppose you have PPPBBS running on one computer, and you
  2302.         have one or more other computers in the same room or office
  2303.         that you want to connect to it directly.  The solution is to
  2304.         have enough serial ports on your PPPBBS computer, and to use
  2305.         an adapter or adapter-combination called a NULL MODEM.  The
  2306.         null modem will allow you to connect computers to your
  2307.         PPPBBS computer directly; you'll need one null modem
  2308.         for each computer you want to directly connect.
  2309.  
  2310.            When directly connected, you can typically use very high
  2311.         baud rates (57600 or higher).  Computers connected to PPPBBS
  2312.         via null modem can make either PPP logins (and access the
  2313.         Internet), or text-based BBS logins.
  2314.  
  2315.         Special Note When Using Over Null Modem
  2316.         ---------------------------------------
  2317.         Text-based BBS logins over the null modem should press ***
  2318.         to start the text-mode session.  This does NOT apply to PPP
  2319.         logins over the null modem, which are completely automatic.
  2320.  
  2321.            A null modem does not use a phone line; it is merely an
  2322.         "adapter" that should ideally make the following connections:
  2323.  
  2324.                        Pin                      Pin
  2325.             Chassis Gnd  1 --------------------   1       Chassis Gnd
  2326.             TX           2 --------------------   3       RX
  2327.             RX           3 --------------------   2       TX
  2328.             RTS          4 --------------------   5       CTS
  2329.             CTS          5 --------------------   4       RTS
  2330.             DSR & CD     6 & 8 ----------------  20       DTR
  2331.             Signal Gnd   7 --------------------   7       Signal Gnd
  2332.             DTR          20 -------------------   6 & 8   DSR & CD
  2333.  
  2334.        Radio Shack just happens to sell an ideally-wired null modem;
  2335.        you'll need cat. no. 26-1495 (F/F Gender Changer) and cat. no.
  2336.        26-1496 (Null Modem).  As of this writing, the price for each
  2337.        unit is $5.99 US.  You'll also need a standard PC modem/serial
  2338.        cable, so don't forget to buy one of those if you don't have a
  2339.        spare one already laying around.
  2340.        
  2341.           For purposes of this example, let's call the PPPBBS
  2342.        system the "host" computer, and the other computer(s)
  2343.        "guest" computers.  The following example shows a PPPBBS
  2344.        computer connected to 3 real modems, and connected to one
  2345.        computer directly through a null modem:
  2346.  
  2347.      -------------                                         -------------
  2348.      -   Host    -                                         -   Guest   -
  2349.      -           -                                         -           -
  2350.      - Ch0 COM1  - ---|modem|                              -           -
  2351.      -           -                                         -           -
  2352.      - Ch1 COM2  - ---|modem|                              -           -
  2353.      -           -                                         -           -
  2354.      - Ch2 COM3  - ---|modem|                              -           -
  2355.      -           -                                         -           -
  2356.      - Ch3 COM4  - -|F/F GC|-|MullModem|---serial-cable--- -           -
  2357.      -------------                                         -------------
  2358.  
  2359.           The above example could be easily expanded by having more
  2360.        COM ports available on the host computer.
  2361.  
  2362.        IMPORTANT NOTE: It is important that you lock the baud rate
  2363.        PPPBBS COM port (from within your FOSSIL driver) to a proper
  2364.        speed.  For ports connected via NULL MODEM, it is especially
  2365.        important to make sure both computers are using the SAME BAUD RATE.
  2366.        Also, When you set-up a channel connected a null modem in PPPCFG,
  2367.        you should set the Init: to the word NULL.  This lets PPPBBS know
  2368.        that this channel is not a real modem.
  2369.               
  2370.           If the guest computer is running Windows 95 and would like
  2371.        to use Windows 95 Dial-Up Networking to connect to the host
  2372.        computer, here are the set-up steps:
  2373.  
  2374.        FIRST SET-UP THE NULL MODEM IN WINDOWS 95
  2375.        
  2376.        1) Open "Control Panel"
  2377.        2) Open "Modems"
  2378.        3) Click "Add..."
  2379.        4) Click "Don't detect my modem..." (Check the Box)
  2380.        5) Click "Next"
  2381.        6) Click "Standard 28800 bps Modem"
  2382.        7) Click "Next"
  2383.        8) Select the Serial Port the null modem is connect to
  2384.        9) Click "Next"
  2385.  
  2386.        SECOND MAKE A NEW CONNECTION
  2387.  
  2388.        1) Open "My Computer"
  2389.        2) Open "Dial-Up Networking"
  2390.        3) Open "Make New Connection"
  2391.        4) Type a New Name for the Connection (example: NullModem)
  2392.        5) For Modem, select "Standard 28800 bps Modem"
  2393.        6) Click "Configure..."
  2394.        7) Make sure that the baud rate is correct (matches host computer)
  2395.        8) Click "OK"
  2396.        9) For telephone number, put in any number (your BBS number will do)
  2397.        10) Click "Next"
  2398.        11) Click "Finish" to save the new connection
  2399.  
  2400.        NOTE: It is possible to use the null modem concept to connect
  2401.        two serial ports on the same (PPPBBS) computer.  That way, if you
  2402.        run PPPBBS under Windows 95, you could also run Winsock-based
  2403.        Internet applications on your PPPBBS computer.
  2404.  
  2405.           The following example shows a host computer connected
  2406.        to itself:
  2407.  
  2408.      -------------
  2409.      -   Host    -
  2410.      -           -
  2411.      - Ch0 COM1  - ---|modem|
  2412.      -           -
  2413.      - Ch1 COM2  - ---|modem|
  2414.      -           -
  2415.      - Ch2 COM3  - ---|modem|
  2416.      -           -
  2417.      - Ch3 COM4  - -|F/F GC|-|MullModem|-|
  2418.      -           -                       |
  2419.      - Ch4 COM5  - ---serial-cable-------|
  2420.      -------------
  2421.  
  2422.        This computer is now both a host and guest.  Setting up the
  2423.        Windows 95 Dial-Up Networking is the same as previously
  2424.        described.  One could say that a computer set-up in this
  2425.        manner routes through itself.
  2426.  
  2427.        RUNNING INTERNET SERVER APPLICATIONS
  2428.        ON COMPUTERS ROUTING THROUGH PPPBBS
  2429.        ------------------------------------
  2430.  
  2431.           Naturally, PPPBBS connects your over-the-phone-line callers
  2432.        to the Internet; that is its main function.  And as shown in
  2433.        the previous section, it can also work over null modems.
  2434.  
  2435.           While using the PPPBBS Internet router, connected computers
  2436.        can use most any Internet client application (web browsing, telnet,
  2437.        ftp, and so on).  But what about server applications such as
  2438.        web servers, telnet servers and so on?
  2439.  
  2440.           It is possible, but because PPPBBS lets you run a multiuser
  2441.        Internet Access Server using just one IP address, there is a
  2442.        small amount of additional set-up required, mainly editing
  2443.        RESERVED.CFG.  Here are some examples:
  2444.  
  2445.        Example 1:
  2446.  
  2447.             A caller with an existing account with the username "Jim"
  2448.          wishes to run a telnet server when he is connected to PPPBBS.
  2449.          He wishes to use the standard telnet TCP port 23.
  2450.  
  2451.          Create or edit file RESERVED.CFG and put in the line:
  2452.  
  2453.          Jim=23
  2454.  
  2455.        Example 2:
  2456.  
  2457.             The SysOp wishes to connect a Windows 95-based computer
  2458.          directly to PPPBBS, and run a web server on the standard
  2459.          web server TCP port 80.
  2460.  
  2461.          Connect the Windows 95 computer to the PPPBBS computer via
  2462.          null modem as described in the previous section, and test
  2463.          the set-up with a web browser to make sure the "basics"
  2464.          are set-up correctly.
  2465.  
  2466.          On the PPPBBS computer, use the user editor to create an
  2467.          account for the other computer to use.  You might set the
  2468.          username to, for example, "webserve".  Set the security
  2469.          level for the account at 900.
  2470.        
  2471.          Create or edit file RESERVED.CFG and put in the line:
  2472.  
  2473.          webserve=80
  2474.  
  2475.        Example 3:
  2476.  
  2477.             PPPBBS is running under Windows 95.  The SysOp wishes to
  2478.          route the machine through itself, and run a web server on
  2479.          port 80 and a telnet server on port 23.
  2480.  
  2481.          Connect the machine to itself, as described in the previous
  2482.          section, and test the set-up with a web browser to make sure
  2483.          the "basics" are set-up correctly.
  2484.          
  2485.          Use the PPPBBS user editor to create an account.  You might
  2486.          set the username to, for example, "pppbbs".  Set the security
  2487.          level for the account at 900.
  2488.        
  2489.          Create or edit file RESERVED.CFG and put in the lines:
  2490.  
  2491.          pppbbs=23
  2492.          pppbbs=80
  2493.  
  2494.        While logged on, the specified user will be able to run
  2495.        Internet server applications on the TCP ports specified.
  2496.        The server application will be accessible by both users on
  2497.        the Internet, and users calling into PPPBBS.
  2498.  
  2499.        Once logged off, the reserved TCP ports are freed.
  2500.  
  2501.        It is possible to reserve the same TCP port for different
  2502.        users, such as if two callers both wanted to run telnet servers.
  2503.        This practice is NOT recommended, however; only one caller
  2504.        at a time can "own" a particular TCP port.
  2505.  
  2506.        IMPORTANT NOTE: TCP ports configured for use in SERVERS.CFG
  2507.        and TCP ports 256 to 512 cannot be reserved in RESERVED.CFG.
  2508.             
  2509.        USING PPPBBS WITHOUT CONNECTING TO THE INTERNET
  2510.        -----------------------------------------------
  2511.  
  2512.           Even if you've disabled dial-outs to the ISP, you can
  2513.        still use PPPBBS for its built-in BBS, and as an Intranet
  2514.        (or private network) router.  You could, for example, still
  2515.        run a private web server for use by the callers.
  2516.  
  2517.        To use the router without connecting to the Internet, you'll
  2518.        need to set the Router IP address to some "fake" fixed IP address.
  2519.        Since you won't be connecting to the Internet anyway, it doesn't
  2520.        matter what IP address you use.
  2521.  
  2522.        You will be able to run server applications using the same
  2523.        set-up method as if you were actually connecting to the
  2524.        Internet.  Server applications will be accessible at the
  2525.        "fake" IP address you set for Router IP.  Since this will
  2526.        be a fixed address, it will be easy for users to access server
  2527.        applications on your Intranet.
  2528.               
  2529.        NOTE: To prevent Channel 0 (the dial-out channel) from
  2530.        "taking up" a COM port, set the DialOut Configuration Port #
  2531.        to some non-existant FOSSIL port number, such as 9.
  2532.  
  2533.           Even if you are not connecting to the Internet, you can
  2534.        still make use of the built-in TCP/IP stack and built-in TCP/IP
  2535.        applications.  The web server, telnet server, smtp server and
  2536.        pop3 server are all still usable by callers logged in using
  2537.        PPP to your PPPBBS.  The web server let's you have your own
  2538.        private web site or bbs-on-a-web-site.  The telnet server
  2539.        lets them log into the BBS character-style.  The smtp server
  2540.        and pop3 server will still let them exchange mail with
  2541.        other users of your PPPBBS.
  2542.  
  2543.        NOTE: If you are not going to connect to the Internet, you
  2544.        should set the "Primary DNS" to be the same "fake" address
  2545.        you set-up for Router IP.  This will allow the transparent
  2546.        DNS selective interceptor to function, and callers will be
  2547.        able to access your server applications using the hostname
  2548.        "bbs".
  2549.                     
  2550.  
  2551.      ABOUT DYNDNS.COM
  2552.      ----------------
  2553.  
  2554.         DYNDNS.COM is a service that maps your dynamic IP address to
  2555.      a static Internet hostname.  You can look them up on the web at
  2556.      www.dyndns.com.  There is no affiliation between DYNDNS.COM and
  2557.      the author of PPPBBS.
  2558.      
  2559.         PPPBBS is designed to be compatible with a wide range of PPP
  2560.      accounts to connect your site to the Internet.  It can be used
  2561.      with expensive, dedicated, static IP address accounts, or 
  2562.      considerably cheaper, non-dedicated, dynamic IP address accounts.
  2563.  
  2564.         If having your TCP/IP server applications (web server, telnet
  2565.      server, and so on) conveniently accessible to Internet users
  2566.      all over the world is NOT important to you, then the type of
  2567.      account you use is irrelevant.  PPPBBS will still function as
  2568.      a network access server for your callers just the same no matter
  2569.      what type of PPP account you have.
  2570.  
  2571.         If, however, having your TCP/IP server applications accessible
  2572.      to Internet users all over the world IS important to you, then you
  2573.      need either a static IP (from your ISP), or a dynamic IP to static
  2574.      hostname mapping service like DYNDNS.COM.  This is so that
  2575.      Internet users all over the world will be able to "find" your
  2576.      site consistently.  If you consider that a dynamic IP address
  2577.      is like having a phone line where your phone number changes
  2578.      randomly, then you can see how hard it would be for your friends
  2579.      to call you!
  2580.           
  2581.         DYNDNS.COM allows you to use a cheap, dynamic IP Internet
  2582.      account to connect PPPBBS to the Internet, with most of the
  2583.      benefits of a static IP address.  Those benefits being namely
  2584.      the ability to make your server applications (web server, telnet
  2585.      server, and so on) available to Internet users all over the world
  2586.      at a hostname that is constant.
  2587.  
  2588.         Whenever your IP address changes, PPPBBS uses its built-in
  2589.      DYNDNS.COM client to notify the DYNDNS.COM server of your
  2590.      current IP address.
  2591.      
  2592.  
  2593.      POSSIBLE QUESTIONS AND ANSWERS
  2594.      ------------------------------
  2595.  
  2596.      NOTE: For more POSSIBLE QUESTIONS AND ANSWERS, see the introduction.
  2597.  
  2598.                                 ---- * ----
  2599.  
  2600.        Q: When I try to login text-mode via null modem, I get strange
  2601.           characters on the screen, and nothing looks right.
  2602.  
  2603.        A: The BAUD RATE between the two serial ports is mismatched.
  2604.  
  2605.           Lock the baud rate of the serial port controlled by PPPBBS
  2606.           by using the FOSSIL driver, to a value of 38400 or higher.
  2607.  
  2608.           Set the baud rate used by the "Standard 28800 bps Modem"
  2609.           to be the same baud rate as use by the PPPBBS serial port.
  2610.  
  2611.                                 ---- * ----
  2612.  
  2613.        Q: When I try to login PPP-mode via null modem, it doesn't work.
  2614.  
  2615.        A: Try it again.  If it still doesn't work, then likely the
  2616.           BAUD RATE between the two serial ports is mismatched.
  2617.  
  2618.           Lock the baud rate of the serial port controlled by PPPBBS
  2619.           by using the FOSSIL driver, to a value of 38400 or higher.
  2620.  
  2621.           Set the baud rate used by the "Standard 28800 bps Modem"
  2622.           to be the same baud rate as use by the PPPBBS serial port.
  2623.  
  2624.                                 ---- * ----
  2625.  
  2626.        Q: PPP and the PPPBBS mini-BBS are working correctly.
  2627.           But when callers try to access my other BBS through
  2628.           FRONTEND.BAT, they get strange characters. What causes
  2629.           this?
  2630.  
  2631.        A: Baud rate mismatch.
  2632.  
  2633.           Lock the baud rate of the serial port by using the FOSSIL
  2634.           driver, to a value of 38400 or higher.
  2635.  
  2636.           In the configuration for your other BBS software, configure
  2637.           it to lock the baud rate at the same rate.
  2638.  
  2639.                                 ---- * ----
  2640.  
  2641.        Q: Is PPPBBS year-2000 compatible?
  2642.  
  2643.        A: Yes.
  2644.  
  2645.                                 ---- * ----
  2646.