KMSXPR 1.02 -*- KMS File Transfer Server ©1993 Thomas Schwarz ============================================================= Documentation ============= Description: ------------ KMSXPR is responsible for all Xpr-Library filetransfers done by KMS, my famous "Karfunkel Mailbox System". It is designed especially for use with KMS and is not intended to be used by anything or anybody else. (But surely I'm not able to stop you from abusing it anyway :-) Input and output is completely handled through the standard io-channels, so these have to be properly redirected for working on a serial line. But this is very well handled by KMS, so you don't have to bother about it. (You really don't have to bother about anything referring to KMSXPR if you don't misuse it as already mentioned before :-) (So why do you read this documentation at all? :-) Call Syntax: ------------ KMSXPR LIBRARY/A,OPTIONS/K,RECEIVE/S,SEND/S,LOGDIR/K,DEFDIR/K,LIST/K,FILES/M Parameters: +++++++++++ LIBRARY/A Required: name of xpr-library to use for the file transfer (e.g. "xprzmodem.library") OPTIONS/K Optional: xpr-library options (see docs for used library) (e.g. OPTIONS="TN ON B16 F0 E10 AN DN KY SN RN PT:") RECEIVE/S Optional: start transfer in receive mode (default) SEND/S Optional: start transfer in send mode LOGDIR/K Optional: directory for transfer logging (defaults to "T:") (e.g. LOGDIR = DH0:Logs) The format of an entry in the logfile is as follows: "Filename Filesize Characters-per-Second Sent/Rcvd Libraryname" DEFDIR/K Optional: directory for received files (default is current dir) (e.g. DEFDIR = Downloads:) LIST/K Optional: file which contains, line by line, the names of the files to be transfered including full path FILES/M Optional for receiving, required for sending, if no LIST given: Receiving: name of the file to be received. If none is given, the name is tried to be taken from the sending side Sending : name(s) of the file(s) to be sent Distribution: ------------- The "Karfunkel Mailbox System" and "KMSXPR" are Copyright ©1993/94 by Thomas Schwarz. All Rights Reserved. "KMSXPR" is only to be distributed as part of the KMS package. Really ONLY. Please refer to the KMS documentation for further distribution information. Author information: ------------------- It's me :-) Thomas Schwarz Gieshügeler Straße 26 97218 Gerbrunn Germany Email: kmshq@bmagic.mayn.sub.de kmshq@bmagic.incubus.sub.org Thomas_Schwarz@wue.maus.de Acknowledgements: ----------------- This program is heavily based on "XPR" from the AXsh-Package by the well known genius Pasi 'Albert' Ojala (Internet: albert@cs.tut.fi OR albert@cc.tut.fi). If you don't already know about AXsh, please read this excerpt from the original AXsh documentation (you'll like it! :-) --------------------------------------------------------------------------- AXsh is a shell based local communication software, which allows remote users to connect to your machine. AXsh can also be run under UUCP, but you need to do some changes to some of the configuration files. AXsh consists of three main parts: the AXsh shell software, AX-sysghost, which holds information about users and AX-server, which takes incoming calls, starts AXsh etc. AXsh supports multiple users, multiple lines and different user levels. You can define allowed commands and directories for each user level. Command arguments can also be restricted to home directory or to allowed directories. AXsh is a SHAREWARE product and the REGISTRATION fee is about US$ 30, 150 FIM. We'll accept any other currency too, because that is more convinient for everybody, but US$ and FIM are preferred. The cheapest way to send the money is in cash in a letter. If you don't plan to register, but have an Internet mail address, you should still send some mail so I can keep you upto date about updates to the demo distribution. We are developing the system constantly and all comments and bug reports are welcomed. (See the addresses in the end of this document.) --------------------------------------------------------------------------- Copyright notices: ------------------ Unix is a registered trademark of AT&T Amiga is a registered trademark of Commodore Business Machines, Inc. AmigaOS is a registered trademark of Commodore Business Machines, Inc. AXsh, KMS and KMSXPR are not registered trademarks, but using them without permission is bad for your teeth. Disclaimer: ----------- *** STANDARD DISCLAIMER *** This product is meant for educational purposes only. Any resemblance to real persons, living or dead is purely coincidental. Void where prohibited. Some assembly required. List each check separately by bank number. Batteries not included. Contents may settle during shipment. Use only as directed. No other warranty expressed or implied. Do not use while operating a motor vehicle or heavy equipment. Postage will be paid by addressee. Subject to CAB approval. This is not an offer to sell securities. Apply only to affected area. May be too intense for some viewers. Do not stamp. Use other side for additional listings. For recreational use only. Do not disturb. All models over 18 years of age. If condition persists, consult your physician. No user-serviceable parts inside. Freshest if eaten before date on carton. Subject to change without notice. Times approximate. Simulated picture. No postage necessary if mailed in the United States. Breaking seal constitutes acceptance of agreement. For off-road use only. As seen on TV. One size fits all. Many suitcases look alike. Contains a substantial amount of non-tobacco ingredients. Colors may, in time, fade. We have sent the forms which seem to be right for you. Slippery when wet. For office use only. Not affiliated with the American Red Cross. Drop in any mailbox. Edited for television. Keep cool; process promptly. Post office will not deliver without postage. List was current at time of printing. Return to sender, no forwarding order on file, unable to forward. Not responsible for direct, indirect, incidental or consequential damages resulting from any defect, error or failure to perform. At participating locations only. Not the Beatles. Penalty for private use. See label for sequence. Substantial penalty for early withdrawal. Do not write below this line. Falling rock. Lost ticket pays maximum rate. Your cancelled check is your receipt. Add toner. Place stamp here. Avoid contact with skin. Sanitized for your protection. Be sure each item is properly endorsed. Sign here without admitting guilt. Slightly higher west of the Mississippi. Employees and their families are not eligible. Beware of dog. Contestants have been briefed on some questions before the show. Limited time offer, call now to insure prompt delivery. You must be present to win. No passes accepted for this engagement. No purchase necessary. Processed at location stamped in code at top of carton. Shading within a garment may occur. Use only in well-ventilated area. Keep away from fire or flame. Replace with same type. Approved for veterans. Booths for two or more. Check here if tax deductible. Some equipment shown is optional. Price does not include taxes. No Canadian coins. Not recommended for children. Prerecorded for this time zone. Reproduction strictly prohibited. No solicitors. No alcohol, dogs, or horses. No anchovies unless otherwise specified. Restaurant package, not for resale. List at least two alternate dates. First pull up, then pull down. Call toll free before digging. Driver does not carry cash. Some of the trademarks mentioned in this product appear for identification purposes only. Record additional transactions on back of previous stub. Decision of judges is final. This supersedes all previous notices. Conclusion: ----------- ...and always remember: The answer still is 42. Quote of the day: ----------------- "You mean mysterious ancient races of Amazonian princesses who subject all male prisoners to strange and exhausting progenitative rites?" said Eric, his glasses beginning to fog. -- (Terry Pratchett, Eric) Last words: ----------- Perhaps you wonder why this documentation is written in English while KMS in general is a German system? Well, I'm practising my English :-)