The CIA World Factbook 1992

home *** CD-ROM | disk | FTP | other *** search

/ The CIA World Factbook 1992 / k3bimage.iso / sel / 02 / 0031 / gt_cbv.doc < prev next >

Wrap

Text File | 1991-12-02 | 14.5 KB | 396 lines

GT_CBV Version 1.4a Call Back Validation Door for GT Power Comm 14 and 15 ===================================================== Purpose ------- The name says it all. With this you can offer a door for your users to Validate themselves. It will call them back to confirm that the phone number given is correct. It however has no way of confirming the name. Functional Overview ------------------- - GT_CBV was intended to be as simple as possible to implement (for the Sysop) and to use (for the user). It gets all the information required from the GT control files, including Modem Settings, Result codes, Passwords, Phone numbers etc. Thus it is almost pre-setup by setting up GT for Host mode. There are many command line parameters available to deal with special situations but in most cases their use is not required. - It will not allow long distance call back (different area code or starting with 1) and will block numbers starting with 911, 411 or 611. - It keeps a file of validated numbers with the users name and checks new numbers against this file to avoid multiple alias's. This will pose a problem for members living in the same household but I saw no way to solve that problem. You can edit this file manually to add numbers you wish to be blocked or remove previously entered numbers. Do Not use a word processor or other program that inserts special characters in the file. - Messages to the user are in separate text files to allow the sysop to customize his door. - A Call back that could not be completed the first time will not be attempted again, in case of a prank. The reasons for not being able to complete the call are: NO CARRIER, BUSY, VOICE and NO ANSWER. These will use the equivalent strings or numbers as entered in the GT configuration result-code area. RINGING will be handled properly and any other result (other than the various connect messages) will cause it to try again, most commonly ERROR and NO DIALTONE. A caller connecting while the system is trying to call out will be hung up on. There is no easy way of trapping this to give them a message. - Access level increases are based on a table provided by the sysop. - The user has a five minute time limit in the door program to prevent unusually long connect times, while sitting in it. When the time expires he is merely sent back to the GT main menu. Page 1 File Explanations ----------------- You Should have received these files: GT_CBV.EXE The actual Program. GT_CBV.DOC This Document. GT_CBV.PHN Phone number cross reference file. GT_CBV.VAL Access level table for upgrades. GT_CBV.MB1 Text - Welcome to door message. GT_CBV.MB2 Text - Ready to Go... What to do. GT_CBV.MB3 Text - Completed and Upgraded GT_CBV.MB4 Text - Your level doesn't have an upgrade. GT_CBV.MB5 Text - Your phone number already in file. GTCBCVT2.ZIP Mark Street's utility to help setup a file based on the users you have validated by hand. The program will create these files as needed: GT_CBV.LOG Log of door use. GT_CBV.FLG Data for Call Back (Will be deleted after call). Setup ----- GT_CBV.* files should all be in the directory defined by your GTPATH= command. GT_CBV.VAL - This is the access level table file. It must have two characters per line. The first one is the access level that is allowed to use the door and the next is the level to raise to after successful completion of the Call Back. e.g. Ef A1 cS This table would allow access levels E, A and c to use the door and raise them to the level in the second column. The access levels should exist in the GTPASSWD.BBS file! AUTOEXEC.BAT - You have to add one line to this file BEFORE the Bulletin Board is started up. The line should be: GT_CBV /CHECK This will check to see if a "call back" is required every time the computer resets. Page 2 GTDOORn.BAT - This file (n = door number) should look like this ECHO OFF GT_CBV Do NOT redirect output via the CTTY, GATEWAY or DOORWAY or any other driver or programs designed to redirect video output or watch the carrier. The door program will NOT WORK PROPERLY. It takes care of local echoing etc. by itself. Do Not use any carrier loss detection programs with this door. Since it is the purpose of this door to drop the carrier it will interfere with its normal operation. GT_CBV will watch for abnormal carrier loss and reset accordingly. (version 1.1 and up does, anyway) GT_CBV.MSn - These are the message text files. They are provided with vanilla messages and therefore don't have to be modified unless desired. GT_CBV.PHN - This file contains the phone numbers not to be allowed for call back. You should add into this file your own phone number and any other numbers you wish to be blocked. The program will add the phone numbers of users that have successfully completed the door procedure. If at anytime you upgrade a user by hand for any reason you should add his phone number to the list manually to prevent re-use. That's it! Additional Command Line Parameters ---------------------------------- All parameters must begin with a / and should be separated by spaces. If you enter the same parameter more than once on the command line, only the last one will be used. /ANY - This is for our international friends. It will not enforce the seven digit scheme of phone numbers. It will still block 911 611 411 and numbers starting with 0 or 1. I do not wish to release a program that can call 911 in any way shape or form. /BASE - Use this parameter to force it to use a different base address for the serial port. The default is the standard address for the port defined in GT config. The address defined must be the decimal value (Not HEX). BASE:1016 (Standard Com1 hex 03f8) BASE:760 (Standard Com2 hex 02f8) BASE:744 (normal Com3 hex 02e8) BASE:736 (normal Com4 hex 02e0) Page 3 /BOOT - This allows you to change the method the program re-boots. The default is a Cold Boot. Valid parameters are: BOOT=WARM Do a warm boot whenever required. BOOT=COLD Do a cold boot when req. BOOT=NONE Do NOT re-boot. Returns control to batch file. See Warning below. /DELAY - This will delay the startup of the program for X number of seconds. The format is: DELAY=x Where x is the number of seconds, from 1 to 300 (five minutes). It would only be necessary to add it to the Autoexec portion of GT_cbv but it will work on both. /DTR - Tells the program to ignore GT's hang-up string and simply lower the DTR signal in order to hang- up on the caller. Use this if you prefer it or if it is having trouble hanging up. This is also a little faster if it works with your modem. /INT - Use this to over-ride the standard interrupt. The default is the standard interrupt for the port defined in GT config. INT:4 (Standard Interrupt for Com1) INT:3 (Standard Interrupt for Com2) INT:4 (normal Interrupt for Com3) INT:3 (normal Interrupt for Com4) WARNING: GT_CBV will not work properly with BOOT=NONE unless the batch files involved are setup to handle it. Also if the door is not overlaid GT Power will reset anyway when it sees the carrier drop. Its really only intended for people who are running some kind of multi-tasking software. They should try something like this in the Gtdoorn.bat: ECHO OFF GT_CBV /BOOT=NONE IF ERRORLEVEL=0 CONTINUE GOTO ABORT :CONTINUE GT_CBV /CHECK /BOOT=NONE IF ERRORLEVEL=0 GOOD :ABORT [ re-load GT. The caller is still connected. He either quit the door or something was wrong. ] :GOOD [ re-load GT for incoming calls. The caller is upgraded and gone. ] I can't really try this myself and so would appreciate feed- back about this. GT Power WILL NOT handle a user upgrade properly if the door program returns to GT without disconnecting the user! Allowing this to occur could cause irreparable damage to GT data files! Page 4 Some Considerations ------------------- There are some valid reasons that someone would not be able to use this door successfully. Including... two family members or roommates wanting to use your system, Someone who has a switchboard or other service that prevents them from getting a direct call etc. If you modify the rejection message file please keep this in mind. There are also still ways to get a multiple membership. Anyone who has more than one line in the household or work, someone who has a portable computer and others. This program will merely make this sort of thing harder. It was not intended as a security program as much as a convenient method for legitimate new users to gain access quickly. The BBS that I run is a lot of fun but it was taking me far too long to attend to the needs of a new user. Any Suggestions as to how to solve some of these problems or others not yet conceived are welcome for future versions. Long-Distance Call backs are not supported. I can't figure out a good way of controlling these so that Ma-Bell doesn't make huge profits from you. Any ideas with this aspect are greatly welcome. Keep in mind that it has to work in different locations. Some Notes on Compatibility --------------------------- GT_CBV is written and compiled using TurboC 2.0. As well as others it uses the include files CONIO, BIOS and DOS. This makes it somewhat dependent on the compatibility of your computer. It also makes use of some pretty specific code for the 8250 serial chip. I can't guaranty that I can solve all compatibility problems but I would like to try. Me! --- If you wish to contact me for support there are three ways: at the address below via Post, Net/Node 053/004 on the GT Network or directly at "The Hotel Essentia BBS" (416) 785-9376 (Toronto, Canada). Cheers Max Schwade P.S. About registration... It will get you a notice of new versions and a entry on a list of registered BBS users on The Hotel Essentia BBS. I won't bore you with all the other reasons. Please send $ 5.00 to: Max Schwade 458 Cranbrooke Ave Toronto, Ontario Canada M5M 1N7 Page 5 Version History --------------- v1.4a - Opps! I screwed up the BackSpace logic for entering a new phone number. Fixed it, sorry 'bout that one. v1.4 - Bryan Pike discovered a BUG! GT_CBV would abort if the user logged on with ANSI graphics mode and there is no GTWELCOME.CBS file. It also wouldn't report this properly in the log. It will now simply load GTWELCOME.BBS as it should have in this case. - The parameter /BOOT has been added for people who want to modify the way your system is rebooted. See the command line parameters section for details. - Mark Street's Utility to aid the setup of the initial phone file is included with his permission. - The /ANY parameter has been added to allow this utility to work in countries which do not use the seven digit phone number scheme. It will still block 911 611 411 and numbers starting with 0 or 1. - The /DELAY parameter has been added if your (high speed "do-it-all-in-a-sec" computer phones the user back too quickly - The /BASE:xxxx has been added if you are using a non-standard serial port base address - The /INT:x has been added if you are using a non- standard interrupt. v1.3a - My attempts to make DTR or the hang-up string detection automatic have been fruitless. The choice is now on the command line. The parameter /dtr will tell the system to ignore the hang-up String in GT and drop DTR only. Default is "use hang-up". v1.3 - 12/04/89 Added options to quit at all relevant prompts. - Program will try to hang up only three times now, and then assume it has hung up. This is for people who are not making use of the GT hang-up string. - The DTR lowering problem has been straightened out. This problem was only apparent on certain modems (mostly 1200 baud) - A Five minute time limit has been added to the door. Although this is relatively short. Its not so bad because it merely kicks them back to GT and the user is able to reopen the door. v1.2 - <Full Release version 11/21/89> Added code for GT15. Program will assume version 15 based on presence of USER.CTL file automatically. - Added date and time to log file. v1.1 - Corrected (ahem) a little oversight that caused the program to hang when the phone number was rejected and then the carrier was lost. v1.0 - This is the initial BETA release for GT Power Comm v14.03 only. Page 6