home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / bbs / secdos10.zip / SYSOP.DOC < prev   
Text File  |  1993-07-17  |  17KB  |  397 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.                          ---- SecureDOS ----
  9.  
  10.                              Version 1.00
  11.  
  12.                         Written By: Paul Taylor
  13.  
  14.                              17 July 1993
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.          Copyright (c) 1993, Paul Taylor.  All Rights Reserved
  23.  
  24. SecureDOS v1.00                                          Sysop Documentation
  25.  
  26.  
  27. Foreword
  28.  
  29.    I apologize in advance for this document.  I am writing it in a bit of
  30. a rush, because I have another project to begin on, but I do plan on fully
  31. supporting SecureDOS and making many future versions with the best features
  32. of the suggestions that I receive from my registered users.  If anything in
  33. this file that is unclear, feel free to contact me personally.  I can be
  34. reached at ShadowRift BBS (Number & other info at end of document). Thanks
  35. again and Please Register!
  36.  
  37.  
  38. Registration
  39.  
  40.    The software in this package is a fully functional version of the
  41. SecureDOS.  It is completely functional, but a few of the main features
  42. of SecureDOS are limited (or not included in the Unregistered version)
  43. Everyone is granted a limited 30 day license to use this program, but
  44. after that you must register.  Please remember, this is not freeware
  45. and is copyrighted.
  46.  
  47.    Registration is only $20 and it gets you the most up to date version,
  48. support and assistance (beyond basic installation help that is available
  49. for everyone).  You also receive the a registered copy which gives you many
  50. new commands plus you will be able to give your suggestions for new features
  51. for the future of SecureDOS.  You will also receive my undying gratitude!
  52.  
  53.    If this all sounds like a good deal, please fill out the registration
  54. form and make your check or money order payable to:
  55.  
  56.                     Paul Taylor
  57.                     P.O. Box 26190
  58.                     Jacksonville, Fl. 32226-6190
  59.  
  60.    If all goes well, within 3 weeks you should receive a disk in the mail.
  61. You can, however, download your registered version from ShadowRift BBS.  We
  62. recommend that you call and let us know your registration is on its way so
  63. that way we can post your registered version as soon as we receive the
  64. registration.  If you have a valid FIDO net address, please let us know and
  65. we can send it to you directly if you have no objections.  (Personal checks
  66. will require about a week to clear the bank)
  67.  
  68. Disclaimer
  69.  
  70.    SecureDOS is distributed as is.  There are no warranties, expressed
  71. or implied.  By setting up and running SecureDOSt, you are releasing
  72. Paul Taylor and ShadowRift BBS from any liability for any damage that
  73. may occur by the use or misuse of our programs.
  74.  
  75. Features
  76.  
  77.   SecureDOS is the first door utility to allow your Co-Sysop and other
  78. special users to Drop to DOS the SAFE way.  With any other program, your
  79. users were free to do whatever they like in your DOS if they could access
  80. your Drop to DOS command (Whether they were friend or foe).  SecureDOS is
  81. a DOS emulator.  It looks and acts like DOS in many ways, but it ISN'T DOS!
  82. SecureDOS doesn't just take your command and port it to DOS and then port the
  83. results back to the screen and the COMM port (as do some other programs) but
  84. SecureDOS actually executes it's own internal routines for all of it's
  85. commands, including Copying, Moving, Deleting, Renaming, etc. With SecureDOS
  86. your Co-Sysop (and anyone else with the access to get to SecureDOS) will only
  87. be able to do what you specifically allow him!  Delete, Rename, and movement
  88. of files can be totally disabled, if you like.  You can specify certain files
  89. that no one can access, either by attempting to delete them, rename them,
  90. type them, etc.  You can also specify certain directories of your hard drive
  91. that you do not want anyone messing with.  This has the same effect as if you
  92. entered in each filename individually in the File Protection list.  You also
  93. have the other options of Password protection and Aliasing.  With password
  94. protection an additional password that you can select via the SECDOS.CFG file
  95. is required before entering the door.  Aliasing means that YOU can define all
  96. of the commands themselves.  KILL can be the command word for DELETE if you
  97. want it to be.  (Caution : IF you change ANY commands, change the generic
  98. HELP command as well, but be sure to remember what you change it to!)
  99.  
  100.    Entering the SecureDOS
  101.  
  102.      Upon entering the door, the user will be displayed a message indicating
  103.  the name of the door, the current version number, and the version of DOS
  104.  the Sysop of the BBS is running.  The next series of messages you will see
  105.  let you know which of SecureDOS's security measures are in effect.  If the
  106.  password feature is in effect, the user will be asked now.
  107.  
  108.  
  109.    DOS prompt
  110.  
  111.      After sitting through the initial messages, the user will be droped to
  112.  a DOS prompt.  Remember, though, this isn't actually DOS, but only an
  113.  emulation.  From here, type HELP.  This will give you a full list of
  114.  commands that are available to you.  Most of the commands available are
  115.  standard DOS commands.
  116.  
  117.    Directory
  118.  
  119.    DIR (default) will give a complete listing of all files in the current
  120.  directory.  The only parameters that are available are a directory and a
  121.  file mask.
  122.  
  123.    Find File
  124.  
  125.    FF (Default) will search the entire drive for a file mask (as supplied
  126.  by the user.)  FF, on the test machines, had times that were slightly
  127.  better than Norton's FF (which it was modeled after).
  128.  
  129.    Archive Commands
  130.  
  131.    (ZIP,UNZIP,LHA,UNLHA,ARJ,UNARJ,VIEW)
  132.  
  133.    These commands are for archive manipulation.  In the registered version,
  134.  these commands will protect any files listed in your File Protection file
  135.  from being added to an archive.  They are inactive in the UNREGISTERED
  136.  version.
  137.  
  138.    Download a File
  139.  
  140.    The SEND (Default) command will accept a single filename as a parameter.
  141.  If that file exists, it will be uploaded to the user online.  This command
  142.  is inactive in the UNREGISTERED version (STILL UNDER DEVELOPMENT!)
  143.  
  144.    Edit a TextFile
  145.  
  146.    The EDIT (Default) command will allow a user to Edit a single TEXT file.
  147.  If the text file specified on the command line doesn't exist, it will create
  148.  it.  This editor allows the user online to toggle his Number Key pad between
  149.  Number mode and movement (edit) mode.  In edit mode, a user with ANSI can
  150.  PageUp, PageDown, move the the begining of a line (HOME) and move to the END
  151.  of a line (as well as move Up, Down, Left and Right).  The '.' command was
  152.  previously a Delete command, but was taken out due to the fact that a '.' is
  153.  a pretty common thing to type.  In the UNREGISTERED version, the Editor's
  154.  SAVE function doesn't work.  200 Lines is the limit in the UNREGISTERED
  155.  version's editor.
  156.  
  157.    Display a TextFile
  158.  
  159.    The TYPE (Default) command will allow a user to display the contents of
  160.  a text file.  Wildcards are accepted for this command.
  161.  
  162.    Move Files
  163.   
  164.    The MOVE (Default) command will allow a user to copy a file from one area
  165.  and then it will remove it from it's original location.
  166.  
  167.    Other Commands
  168.  
  169.    All other commands is SecureDOS are pretty much standard DOS commands, so
  170.  no explanation is given here.
  171.  
  172. Installation
  173.  
  174.    Unzip the SECDOS archive into the sub-directory that you plan to run
  175. SECDOS from.  Edit the SECDOS.CFG File.  NOTE : This file MUST be in the
  176. same directory that your SecureDOS .EXE file is in!  The SECDOS.CFG file
  177. is very self explanitory.  The DIRSEC.TXT File is the text file containing
  178. the list of Directories that are to be protected and the FILESEC.TXT file
  179. is the text file containing the list of files to be protected.  All of these
  180. files should be edited to your liking along with the ALIAS.TXT file, if you
  181. choose to use the ALIASing function.
  182.  
  183.  
  184.   Depending on which type of BBS software you are running, you should
  185. choose the appropriate command line parameters from the listing below:
  186.  
  187.          Parameter      Drop file      BBS Software - Notes
  188.          ---------     ------------  -----------------------------
  189.             /1         PCBOARD.SYS   PCBoard 12.x (See /P)
  190.             /2         JUMPER.DAT    2 A.M.
  191.             /3                       OPUS 1.12 (not available)
  192.             /4         CHAIN.TXT     WWIV, VBBS, TAG, Telegard
  193.             /5         CURRUSER.BBS  RyBBS
  194.             /6         SFDOORS.DAT   SpitFire
  195.             /7         AUNTIE.SYS    Auntie BBS (Same as /1)
  196.             /8                       Sapphire BBS (not available)
  197.             /9         cmdline       SearchLight,Remote Access, etc.
  198.             /D         DOOR.SYS      DoorWay to Unlimited Doors, GT (See /S)
  199.                                      NOTE : This is the 'Short' DOOR.SYS
  200.             /F         USERINFO.TXT  Forum
  201.             /G         CALLINFO.BBS  Genesis (Beta)
  202.             /H         INFO.TXT      Phoenix
  203.             /M         NUMBER.TXT    ModuleX
  204.             /O         LASTUSER.DAT  Opus 1.14
  205.             /Oxx       LASTUSxx.DAT  Opus 1.14 ('xx' is the task number in hex)
  206.             /P         PCBOARD.SYS   PCBoard 14.x (See /1)
  207.             /S         DOOR.SYS      GAP, Force, Wildcat 3.x,Telegard (See /D)
  208.                                      NOTE : This is the "Long" DOOR.SYS
  209.             /W         CALLINFO.BBS  Wildcat! 2.x, Telegard
  210.             /R         DOORINFO.DEF  Most widely used file
  211.             /R#        DORINFO#.DEF  "#" represents NODE number
  212.                                      EIS-PC, FoReM, OLEcom, QuickBBS, RBBS,
  213.                                      Remote Access, TAG, TPBoard, UBBS, VBBS.
  214.  
  215.     ****If this parameter is missing, UFRD will default to LOCAL mode.****
  216.  
  217.       Drop File Path
  218.  
  219.            If you do not run doors from your BBS's home directory (as
  220.            recommended) you will need to tell SECDOS where to find the
  221.            drop file.  You can either copy the file to the directory that
  222.            holds the SecureDOS files, or add the drop file's path to the
  223.            command line.  Here's an example of how to do that running
  224.            PCBoard 14.x, assuming the home directory is C:\PCB.
  225.  
  226.             SECDOS /P:C:\PCB\
  227.  
  228.            NOTE:  The '\' on the end of the path is required.
  229.  
  230.       Other Command Line Parameters:
  231.  
  232.         Local Mode Operation
  233.         --------------------
  234.            /L   Forces LOCAL mode.  Can NOT be overridden.  If
  235.                 either /C or /I are present REQUEST will exit.
  236.  
  237.         FOSSIL Drivers
  238.         --------------
  239.            F-   Do NOT use FOSSIL (/I gives same result)
  240.  
  241.            F+   Force FOSSIL use. (Ignored if /I is present)
  242.  
  243.            F@   Deinitialize FOSSIL when through.  By default, the
  244.                 Request door keeps the FOSSIL "HOT".  This can be
  245.                 combined with the above option (F+@).
  246.  
  247.            /C:n Comport to use (See /C:n below)
  248.  
  249.         Internal Comm Routines
  250.         ----------------------
  251.            /B   Locked Baud rate.  If you are running a Locked comm port
  252.                 you will need this command line switch if you aren't using
  253.                 a FOSSIL.
  254.  
  255.            /C:n Serial Port to use.  You can force the program to use a
  256.                 given serial port.  Valid values are from 1 to 8, but
  257.                 a FOSSIL must be used for serial ports above 4.
  258.  
  259.       /I:x:nnnn Non Standard IRQ specification.  If you are not using a
  260.                 FOSSIL, and you have a non standard serial port configuration
  261.                 you can use this option to specify your IRQ/port address info.
  262.                 The default settings are equivalent to:
  263.                      Com1 : /i:4:03f8
  264.                      Com2 : /i:3:02f8
  265.                      Com3 : /i:4:03e8
  266.                      Com4 : /i:3:02e8
  267.                 The 'x' is the IRQ number.  It is a HEX value from 0 to F.
  268.                 The 'nnnn' us the port address for communications.  If
  269.                 this is present, the FOSSIL routines will not be used.
  270.  
  271.         Other Misc. Cmd Line options
  272.         ----------------------------
  273.            /N   User Name (/N:Paul_Taylor)
  274.                 This option allows you to pass the door the users name
  275.                 through the command line.  This is useful for BBSes like
  276.                 Search Light, or if you are playing locally from DOS.
  277.                 (Underscores are converted to spaces)
  278.  
  279.            /Q   Quite Mode
  280.                 This prevents the Bells from sounding on the local console.
  281.  
  282.            /Z:x User time limit - X is an amount of time between 10 and 50.
  283.                 The users time in the door will be the lesser of this value
  284.                 and the amount shown in the BBS drop file.
  285.  
  286.  
  287.  
  288.  
  289.  To run any of the above BBS Types Follow this easy layout:
  290.  
  291.          SECDOS <BBS Type:Path To Drop file> <Optional Parameters>
  292.  
  293.       For Example:
  294.  
  295.       On a PCBoard (14.x) with the Home Directory located at C:\PCB\
  296.       the correct command line would be:
  297.  
  298.                       SECDOS /P:C:\PCB\
  299.  
  300.       If you were running a Telegard with a DOOR.SYS drop file, (current dir)
  301.       the correct command line would be:
  302.  
  303.                       SECDOS /S
  304.  
  305.       The following is a copy of the batch file ShadowRift uses to run
  306.       it's copy of the Request door:
  307.  
  308.       F:
  309.       CD\DOOR\SECDOS
  310.       BNU -L0=19200             Loads BNU - Locked port
  311.       SECDOS /P:F:\PCB\NODE1    Loads SecureDOS for PCBoard 14.5 (See Note)
  312.       BNU -U                    Unloads BNU
  313.       CD\PCB
  314.       BOARD
  315.  
  316.   Note: In /P:F:\PCB\NODE1 /P: is for PCB 14.x and F:\PCB\NODE1 is the
  317.         path to the PCBOARD.SYS file.
  318.  
  319. Sysop Function Keys
  320.  
  321.    The Sysop has the following Function keys during the programs execution.
  322.  
  323.           Key     Action
  324.          -----    ------------------------------------------------
  325.           F2      Toggle User Status Line.  This will toggle between
  326.                   the following Modes:
  327.                       Display Time Remaining (Default)
  328.                       Display Active Communications
  329.                       Display Remote Graphics
  330.           F7      Reduce users time remaining by 1 minute.
  331.           F8      Increase users time remaining by 1 minute.
  332.           F9      Drop carrier.  This disconnects the current user
  333.                   and simulates line noise.
  334.           F10     Forces the return to the BBS.  This gives the user
  335.                   a message informing them that the Sysop has terminated
  336.                   the session.  It then returns control to the BBS.
  337.  
  338.  
  339.  
  340.  
  341.  
  342. Known bugs and anomolies
  343.  
  344.    Currently, there are very few (known, that is. Heh).  One problem
  345. encountered has been with those using QEMM, occasionally.  Sometimes it
  346. does not like to load correctly with QEMM.  I have had users report that
  347. by removing the first colon from the command line, it seems to work
  348. correctly. Example:
  349.  
  350.                   Regular use:  SECDOS /P:F:\PCB\
  351.                     Modified :  SECDOS /PF:\PCB\
  352.  
  353.  
  354.    The only other known problem is the LOCAL mode detection routines.  If
  355. you encounter a problem with SecureDOS detecting local mode correctly, just
  356. make a separate command with the /L parameter in that commands batch file.
  357. Yes, that's not a very good fix, but at this time, it's all I can do.  I
  358. hope to have this problem fixed before too long.
  359.  
  360.  
  361.    If you find any problems with this software, it would be very much
  362. appreciated if you could report these.  You can report them directly to
  363. the author on ShadowRift BBS (Number at end of docs).  Just send private
  364. mail to Paul Taylor.
  365.  
  366.  
  367.  
  368.  
  369. Credits
  370.  
  371.    SecureDOS was written in Turbo Pascal 6.0 using Andy Mead's BOI
  372. 2.00 door writing routines. SecureDOS has been alpha and beta tested
  373. at ShadowRift BBS.  All requests for support and registration should be
  374. directed to:
  375.  
  376.                              Paul Taylor
  377.                            P.O. BOX 26190
  378.                       Jacksonville, FL. 32226-6190
  379.  
  380.   Electronic mail can be left on:
  381.  
  382.                 ShadowRift BBS   (HST) 904-696-9238
  383.              Fido net  (1:112/63)    (V32) 904-696-9322
  384.  
  385.  
  386. Closing Kudos
  387.  
  388. Thanks to Juan Gil for helping out in Beta testing.  Thanks to John Garrard
  389. for most of the beta testing and for several ideas, and thanks to Benjamin
  390. Adams for his suggestions for more features.
  391.  
  392.  
  393. Andrew Mead, for his great communications and door routines.
  394. (BBS Onliner Interface) He helped me out a lot while I was learning
  395. to use his routines.  I didn't know someone could have that many patience!
  396. Without his help, I would never have been able to write this!
  397.