home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / CLIPPER / MISC / XBBS7200.ZIP / XBBS7200.TAR / extra_info < prev    next >
Encoding:
Text File  |  1987-01-29  |  7.5 KB  |  170 lines
  1.                Extra Information On How the BBS Operates
  2.  
  3. 1) All errors that are detected that would normally go to stderr are sent,
  4.    instead to a file called /tmp/errors_out. Under normal conditions, this
  5.    file should always have a 0 length.
  6.  
  7. 2) The file, callers.bbs, contains a time log of all of your bbs callers.
  8.    In addition to the name and time, all uploads and downloads are logged
  9.    into this file. If a file is uploaded as "SYSOP ONLY", the description of
  10.    the file is also added to callers.bbs instead of files.bbs. This way, you
  11.    can still get the description.
  12.  
  13. 3) A file, /tmp/files, is generated for each and every L(ist) command that is
  14.    requested. This is a temporary file which is sent to the user.
  15.  
  16. 4) The file, users.bbs, contains the list of all of your users, with their
  17.    passwords, first time called, last time called, and their address in the
  18.    form of city and state.
  19.  
  20. 5) The file, messages.bbs, contain all of the messages. There are three codes
  21.    used within this file : 0 - The message is active and not confidential
  22.                            5 - The message is active and is confidential
  23.                            9 - The message was deleted 
  24.    ( Note: if you wish to reactivate a deleted message, just change the "9"
  25.            to either a "0" or "5" ).
  26.    ( A program will be available soon to "squeeze" the message file and
  27.      remove deleted messages )
  28.  
  29. 6) The file, crossref.bbs, contains the cross reference table between the
  30.    message number and file record number. This way, RAPID message access
  31.    is achieved. Presently, you can have up to 1000 messages within the system.
  32.    ( active and deleted )
  33.  
  34. 7) The file, bulletin.bbs, contains your bulletin which is printed out
  35.    whenever a user logs into the bbs or with the B command from the main
  36.    menu.
  37.  
  38. 8) The file, header.bbs, contains the information to add the NEXT message
  39.    into the message file. This way, a search is not required to find the
  40.    proper entry point.
  41.  
  42. 9) The file, files.bbs, contains the download file information
  43.  
  44. A) The file, help.bbs, contains the HELP information for your users.
  45.  
  46. B) The file, humor.bbs, contains the humor file for your users!
  47.  
  48. C) The file, lastcall.bbs, contains the information about your last user
  49.    on the system.
  50.  
  51. D) The file, newuser.bbs, contains the message you output to new users.
  52.  
  53. E) The file, system.bbs, contains the terminate message you output to the
  54.    user when he "logs off".
  55.  
  56. F) The file, welcome.bbs, contains the "welcome" message you output when
  57.    the user logs in. Please note that this is sent prior to the bulletin
  58.    and may be your message of the day.
  59.  
  60.  
  61.  
  62.  
  63. A quick note on how files are handled when they are uploaded. 
  64.  
  65. Files are sent, depending on the protocol used, either to your FILES 
  66. directory or to your /usr/bbs directory. In the case of the files
  67. being sent to /usr/bbs ( KERMIT UPLOAD ), they will be moved to FILES
  68. after the transfer is completed. If the file(s) is/are marked as
  69. SYSOP ONLY, they will be moved to your BBS directory to insure complete
  70. privacy. Therefore, even if your user knows the name of the file, he
  71. can not get to it!
  72.  
  73.  
  74. Warning! DO NOT try to modify the following files with an editor like
  75. vi: users.bbs, header.bbs, crossref.bbs, messages.bbs since they are
  76. NOT truely ASCII files and the files WILL BE damaged. In the case of
  77. crossref.bbs, no ASCII information is even stored in it ( binary file ).
  78.  
  79. ************************************************************************
  80. USER SIGNALS that are used:
  81.  
  82. 1) SIGUSR1 Toggles the local monitoring of the BBS. An example of the SHELL
  83.    Script that can be used is "toggle". This file can be found in the
  84.    download section.
  85.  
  86. 2) SIGUSR2 Toggles the privileges and time of the present user on the system.
  87.    The time and privilege level is set to maximum so CARE should be used
  88.    with this option since the user can now enter into Unix/Xenix with the
  89.    U option in the main menu. An example of a SHELL SCRIPT that can be used
  90.    is "systoggle". This file can be found in the download section.
  91. *************************************************************************
  92.  
  93. New features added on October 12, 1986:
  94.  
  95. Three new .bbs files have been added: filepriv.bbs, mainpriv.bbs, and
  96. userpriv.bbs.
  97.  
  98. 1) filepriv.bbs contains the privileges assigned to the file menu options.
  99.    The file simply contains the letter and privilege assigned to the letter.
  100.    The range of privileges can vary between 0 and 32767. The privileges are
  101.    all relative so you may want to limit the range from 1 to 9. Warning,
  102.    be sure that the G option is ALWAYS lower than the lowest individual
  103.    privilege so you user can log off! An example of the file can be found
  104.    in this download section called filepriv.bbs.
  105.  
  106. 2) mainpriv.bbs contains the privileges assigned to the main menu options.
  107.    It is in the same form as filepriv.bbs. An example of the file can be
  108.    downloaded and is called mainpriv.bbs.
  109.  
  110. 3) userpriv.bbs is a dynamically created/appended file which contains the
  111.    individual user privileges along with their "delta time" allocation.
  112.    The file contains entries for each of your users in the form of:
  113.  
  114.     FIRSTNAME LASTNAME PRIVILEGE_LEVEL DELTA_TIME EXTRA_KBYTES
  115.  
  116.     An example of a particular user maybe as follows:
  117.  
  118.     John Smith 5 600 5
  119.  
  120.     Basically, the above user has a privilege level of 5 and has 10 additional
  121.     minutes allowed over the default time (RUNTIME in bbscdef.h). Also, he has
  122.     an extra 5 kilobytes of downloading allowed ( added to MAXKBYTES in
  123.     bbscdef.h ).
  124.  
  125.     An entry may also look like this:
  126.  
  127.     Joe Blow 2 -2400 -50
  128.  
  129.     This means that the above user has a privilege level of 2 and has
  130.     been disallowed 40 minutes from the default time. If the default
  131.     time is set at 60 minutes, his total usage time is only 20 minutes.
  132.     His maximum allowable download in bytes has also been reduced by
  133.     50K!
  134.  
  135.     The default privilege level can be found in bbscdef.h and is called
  136.     NEWPRIV.
  137.  
  138. ***************************************************************************
  139. New features added on October 14, 1986
  140.  
  141.     The sysop, by using SIGUSR2, can now give the present user temporary
  142.     maximum privileges and time on the system. Since this is a "toggle",
  143.     by issuing this signal again, the user will be returned back to the
  144.     logon time limits and privileges. An example of a SHELL SCRIPT that can
  145.     be used is systoggle.
  146.  
  147.     You can now allow users to enter into Xenix/Unix! Care should be given
  148.     when allocating the user such high privileges. This is the U option
  149.     in the main menu. A suggestion would be to give this privilege the
  150.     maximum allowed in this BBS, 32767. Remember, when SIGUSR2 is issued,
  151.     that user WILL HAVE that privilege!
  152.  
  153. ***************************************************************************
  154.                        New Nov 9th, 1986
  155.  
  156. You must now have multiple versions of files.bbs. One, each, for EVERY
  157. download directory and it must be in that directory. The files.bbs file
  158. must only contain the file listing for that particular directory!
  159. ***************************************************************************
  160.                        New Nov 12, 1986
  161.  
  162. Now, there are multiple message bases. The three files, crossref.bbs,
  163. header.bbs, and messages.bbs are stored in each different message base.
  164. ***************************************************************************
  165.                        New Dec 8, 1986
  166.  
  167. A response time variable has been added to the bbs software. This variable
  168. is defined in bbscdef.h as WAITTIME. On this system, it is set to 300
  169. seconds or 5 minutes. 
  170.