home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / SH100.ZIP / SBBSHEAD.DOC next >
Encoding:
Text File  |  1992-01-14  |  6.3 KB  |  137 lines
  1.     
  2.     92-01-13                                               Claes Boström. 
  3.     ---------------------------------------------------------------------
  4.     SBBSHead 1.00 (C)1992 Claes Boström.
  5.     ---------------------------------------------------------------------
  6.     ▄███▄ ████▄ ████▄ ▄███▄ ██▐█▌▐███▌▐████▌ ████▄     ██     ▄███▄ ▄███▄
  7.     ███ █ ██▐██ ██▐██ ███ █ ██▐█▌▐█▌  ▐██▐█▌ ██▐██    ███     ██▐██ ██▐██
  8.     ▐██▌  ████▀ ████▀ ▐██▌  ████▌▐██▌ ▐████▌ ██▐██     ██     ██▐██ ██▐██
  9.      ▐██▌ ████▄ ████▄  ▐██▌ ████▌▐██▌ ▐████▌ ██▐██     ██     ██▐██ ██▐██
  10.     █ ███ ██▐██ ██▐██ █ ███ ██▐█▌▐█▌  ▐██▐█▌ ██▐██     ██     ██▐██ ██▐██
  11.     ▀███▀ ████▀ ████▀ ▀███▀ ██▐█▌▐███▌▐██▐█▌ ████▀    ▄██▄ ██ ▀███▀ ▀███▀
  12.     ---------------------------------------------------------------------
  13.     SBBSHead 1.00 (C)1992 Claes Boström.
  14.     ---------------------------------------------------------------------
  15.  
  16.  
  17.  
  18.     SBBSHEAD is a small utility that's makes a small 'head' in 
  19.     your FILES.BBS. This head holds valuable information about 
  20.     your fileareas and presents this information to your users.
  21.  
  22.     
  23.  
  24.     The program SBBSHEAD.EXE and this documentation is copyright 
  25.     by Claes Boström. Both are released as public domain. Any one 
  26.     may use it, copy it, spread it and so on.... but no one may 
  27.     change the program or this documentation in any way.
  28.     Claes Boström still ownes the copyright to the program and 
  29.     the documentation.
  30.  
  31.     Permission granted to copy for non-commercial uses only.
  32.     All other rights retained.
  33.  
  34.     Claes Boström specifically disclaims all warranties, expressed 
  35.     or implied, including but not limited to, implied warranties of 
  36.     merchantability and fitness for any particular purpose. In no 
  37.     event shall Claes Boström be liable for any loss of profit or 
  38.     any other commercial damage, including but not limited to 
  39.     special, incidental, consequential or other damages.
  40.  
  41.     If you find this software useful, send me a postcard to the
  42.     following adress:
  43.     Claes Boström, Lövåsvägen 11, 440 42 Alafors, Sweden.
  44.     In this way, i can see how the program is spread across
  45.     the world....   :-)  
  46.  
  47.     
  48.     
  49.     IMPORTANT NOTICE !
  50.     As always, take a backup before testing new software on your 
  51.     computer. In this case it is rather simple. Since the program 
  52.     only operates on the files called FILES.BBS in your directories 
  53.     for the file-base, use PKZIP or another packer to make an backup. 
  54.     Example here is for PKZIP. Make the root the current directory
  55.     and zip all FILES.BBS into a single file.
  56.     Example: PKZIP -r -p YOURNAME FILES.BBS
  57.     This searches all directories on the disk for your FILES.BBS and
  58.     pack's them into one file. Now you have a backup-file in the root.
  59.     To unpack it: PKUNZIP -d YOURNAME and you have your original 
  60.     files back.
  61.  
  62.     
  63.     
  64.     This is the basic layout of SBBShead. It holds and displays the 
  65.     current information.
  66.  
  67.     * Name of file-area.
  68.     * Securitylevel of that area.
  69.     * How many files (excluding FILES.BBS and FILES.OLD) and how
  70.       many bytes they are.
  71.     * If they can DownLoad from this area.
  72.     * It they have your permission to UpLoad to this area.
  73.     * And, what age that are required to DownLoad from this area.
  74.  
  75.     Here are a the layout as it looks like in FILES.BBS.
  76.  ╔═(SBBSHead 1.00 )══════════════════════════════════════════════════════════╗
  77.  ║ SuperBBS Support-files, (C) THE BBS                          Seclvl: 1000 ║
  78.  ╟────────────┬─────────────────┬─────────────────┬───────────────┬──────────╢
  79.  ║    3 files │     18148 bytes │ DownLoad is ON  │ UpLoad is OFF │ Age:Free ║
  80.  ╚════════════╧═════════════════╧═════════════════╧═══════════════╧══════════╝
  81.  
  82.  
  83.  
  84.     Just put the program in any directory you want to. 
  85.     The program tries to find the needing files from the
  86.     environment variable 'SBBS'. If you don't use it (required
  87.     if you run SuperBBS Ver 1.12 or above) put the following
  88.     statement in your AUTOEXEC.BAT-file.
  89.     SET SBBS=<PATH to there you have the SuperBBS system-files>.
  90.     Example is: SET SBBS=C:\BBS;
  91.  
  92.     If you are afraid of testing it, simply run the program
  93.     with the following parameter, -1. (SBBSHEAD -1 ). The 
  94.     program only runs for the first area in your system 
  95.     (area number 1 from FLSEARCH.BBS) and creates the head 
  96.     in your FILES.BBS for that area. This is a simple way 
  97.     of testing that the software is able to run on your machine 
  98.     and that it does not destroys anything for you.
  99.  
  100.     The program works in this way. First it opens up the file
  101.     FLSEARCH.BBS there the information about all file areas
  102.     and their directories are located.
  103.     For every file-area it finds it reads the FILES.BBS 
  104.     from that directory and copies it to memory. Then it
  105.     makes a backup of that file in the same directory, this
  106.     backup-file is named FILES.OLD. (So if anything goes wrong
  107.     you should at least have a backup of your FILES.BBS).
  108.     After that it retrieves information about the directory 
  109.     (Number of files and their filesizes).
  110.     Then it creates the new FILES.BBS in the same directory. 
  111.     Then it writes the SBBSHead at top of that file. After that 
  112.     it reads information from the FILES.BBS in memory and puts t
  113.     hat information into FILES.BBS at the disk. 
  114.     Under this part of the job it makes _ONE_ very 
  115.     important thing. In the first 800 bytes from the file
  116.     in memory (the 10 first rows from FILES.BBS) it tries 
  117.     to find the ascii-chars 188, 189, 190 and 217 (╝,╜,╛,┘).
  118.     If it finds any of theese it assumes that this is the
  119.     end of the OLD SBBShead. From that point on it copies from 
  120.     memory to the FILES.BBS. So if you have been running 
  121.     other software that has an other layot of the 'head', 
  122.     you might need to edit the file afterwards.
  123.  
  124.  
  125.  
  126.     91-11-23  1.00α  Created first time.
  127.     91-12-23  1.00ß  Removed 350-line limit and fixed some text.
  128.     91-11-25  1.00Γ  Fixed a bug concerning other XXXXHEAD.
  129.     92-01-13  1.00   Official release. Completely rewrote the program
  130.                      to be more safe then handling the backup-files.
  131.                      Thank's Mikael Hugo, DataPhone BBS +46 8 269840,HST DS
  132.                      for testing this release.
  133.     
  134.     92-01-13  Claes Boström. THE BBS, +46 303 42364, 1200-HST+, 24 H
  135.  
  136.  
  137.