FAME DoorHeader Creator by SieGeL (tRSi/F-iNNOVATiON) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ INTRODUCTION: ~~~~~~~~~~~~~ If you are a doorprogrammer for the FAME system, you know the following problem: You have finished your new FAME Door and want to release it now. As a good programmer, you have of course written an Installerscript for your new door. The normal installation should be no problem, but what about the Datafile for your Door that FAME requires to let users start your door from FAME ? You have normally two choices: 1. You let the user start the Systemeditor and he has to enter all the datas your door requires by hand. 2. You supply a ready-made datafile for the door and copy it to FAME's Doorsettings drawer. Anyway, the user must check out if everything is set correct, i.e. the path, name of door etc. As you may noticed, it is a problem for a coder to let his door install automatically. Because of this I have written this little tiny utility, which should help you out of this situation. DoorHeader is able to create a complete doordefinition just by simply given some arguments via the commandline, that's it. USAGE OF DOORHEADER: ~~~~~~~~~~~~~~~~~~~~ DoorHeader has the following Argumentline: NAME/K/A,PATH/K/A,TYPE/K/A,STACK/K/N,LEVEL/K/N/A,PRI/K/N,PASSWORD/K, SERVERNAME/K,NR/S,NC/S,AR/S,AC/S,SR/S,SC/S,CF/S,RD/S,UNUSED/S,MULTINODE/S, INTERFACE/K/A As you may see, ALL datas which are important for the doordefinition could be set via the arguments. Here's a more detailed information about these arguments: NAME = Door call name PATH = Path to the executable TYPE = DoorType: B = BBSCMD, S = SYSCMD or any number from 1-x for the according CONFCMD command. STACK = Size in bytes for the stack used by the door. Defaults to 4096 LEVEL = Accesslevel for the door PRI = Priority for the door, defaults to 0 PASSWORD = Password to use for the door SERVERNAME = Name to show inside the server for this door NR = Set NR Command Gadget NC = Set NC Command Gadget AR = Set AR Command Gadget AC = Set AC Command Gadget SR = Set SR Command Gadget SC = Set SC Command Gadget CF = Set CF Command Gadget RD = Set RD Command Gadget UNUSED = Set UNUSED Command Gadget MULTINODE = If set, Door is Multinode capable, otherwise only single node INTERFACE = Defines the Door Interface Type, valid are: FIM, XIM, TIM, AIM, CIM, RIM, SIM, TXT, SND, SPK, GFM If you are not familar with AmigaDOS Argument-Templates, please take a look to your AmigaDOS Manual for further informations. The following Arguments *MUST* be given in order to let the door work: NAME, PATH, TYPE, LEVEL, INTERFACE All other arguments are switches or defines other optional fields, which are not neccessary to let the door work. Of course you must also set which doorcommandtypes your door uses, i.e. the NR_, CF_ and SR_ commands are used by your door, you have to supply the following arguments: NR CF SR Here's an example how you may use DoorHeader: DoorHeader NAME=DD PATH=DOORS:DD TYPE=B LEVEL=50 NR SR MULTINODE INTERFACE=FIM This will create a doordefinition called 'DD' in the path 'FAME:SETTINGS/DOORS/BBSCMD/DD' with Accesslevel set to '50', Commands 'NR' and 'SR' activated, DoorInterface set to 'FIM' and also 'MULTINODE' capable. I think the usage should be clear, if not, write a mail to me and I will help you with your problems. Contact adresses could be found at the end of this document. NOTES AND RESTRICTIONS: ~~~~~~~~~~~~~~~~~~~~~~~ The following things should be clear in order to use DoorHeader correctly: - FAME: assign won't be checked!! This is up to you to check out if FAME: is correctly assigned. - Any existing command will be overwritten by DoorHeader without any check, so if you want to store the old command, make a backup of it before using DoorHeader! - If a wrong Interface type is supplied, DoorHeader set it to 'FIM' as default interface type. - No check for the correct doorpath is made, you are responsible to pass the correct path to DoorHeader! - If you pass the wrong TYPE (BBSCMD,SYSCMD, CONFCMD), DoorHeader will fallback to the Default type, which is BBSCMD. - DoorHeader will create the Doordefinition in FAME:SETTINGS/DOORS/, the rest of the path is determined by the TYPE of the door. - Always pass the arguments with their according keywords or DoorHeader will fail! I.e. only writing DoorHeader DD ... instead of writing DoorHeader NAME=DD will fail. - DoorHeader requires Kickstart V37 or higher. Lower Kickstarts are useless as FAME also requires Kickstart V37. LAST WORDS: ~~~~~~~~~~~ I hope that this little tool will help all the fine doorprogrammers in the whole world :) Keep on programming and help to make FAME the best BBS system ever written on AMIGA! Sorry that this door has no AmigaGuide document, but I think a good coder doesn't need an AmigaGuide doc, this piece of text should be enough! HOW TO CONTACT ME: ~~~~~~~~~~~~~~~~~~ If you have any questions about this or other tools written by me, feel free to contact me via the following adresses: E-Mail: siegel@deadline.snafu.de BBS: pUNISHMENT iNC. BBS - FAME Register & Beta Site. Node0: +49(0) 30 694 84 70 - Node1: +49(0) 30 694 85 70 FIDO: 171:600/100.0@aganet - User: Sascha Pfalz Or try to catch me in the IRC, channel #amielite or #FAME ---------------------------------------------------------------------[EOF]---