home *** CD-ROM | disk | FTP | other *** search
/ C!T ROM 5 / ctrom5b.zip / ctrom5b / OS2 / BBS / TELDR003 / TELDOR.DOC < prev    next >
Text File  |  1994-10-30  |  8KB  |  155 lines
  1. Documentation for Telnet Door version 0.02, the universal interface between an
  2. OS/2 BBS and the Internet.
  3.  
  4.   Telnet Door is a program that I initially wrote because I wanted to connect
  5. my BBS to the Internet via a UNIX system.  I wrote this door to enable users
  6. of my system to login to my UNIX system via OS/2s TCP/IP networking, and from
  7. access the Internet from there (once I get a connection).  I soon realised that
  8. many other sysops want to do the same thing, so I decided to release this as
  9. shareware.
  10.  
  11.  
  12. +++Shareware legal statement:
  13.  
  14.    This program is not guaranteed to do anything apart from consume space on
  15. your hard drive.  If you wish to use this for more than 90 days from the date
  16. you received it you must pay me $25 Australian, for each line of your BBS that
  17. will be running this program (see below).
  18.  
  19. +++System requirements:
  20.  
  21.    This program requires at least OS/2 version 2.0 running IBM's TCP/IP
  22. networking software version 2.0 (I believe that my program is compatible with
  23. FTP software's TCP/IP for OS/2, but I haven't been able to test it).
  24. Requirements for RAM and hard drive space are so small that it won't make an
  25. impact on the typical BBS system.
  26.  
  27. +++Test system:
  28.  
  29.    This program has been extensively tested on an OS/2 system running OS/2
  30. version 2.11 and the "Warp" beta with IBM's TCP/IP version 2.00 on a 486.  The
  31. target system of the TELNET was a 386 running Linux (kernel versions 1.1.19 to
  32. 1.1.51 and utilities from the Slackware 1.2.0.3 distribution) and was on an
  33. ethernet segment.  Although I haven't tested them, other types of TCP/IP
  34. networks (SLIP, Token Ring, etc) should all work.  TCP/IP hides the network
  35. hardware from my application so the actual hardware interface being used
  36. shouldn't matter.
  37.  
  38. +++Compiler used:
  39.  
  40.    This program was compiled with IBM's Cset++ version 2.1.
  41.  
  42. +++Usage of the program:
  43.  
  44.    Here's the help screen which is displayed when you give it incorrect command
  45. line parameters, no command line arguements or run it with the "-?" parameter:
  46.  
  47. Usage: telnetdr [ OPTIONS ] hostname
  48.  
  49. hostname is in dotted decimal or *domain name* convention
  50.  
  51. Options: c=com handle        file handle for serial port if any
  52.          fd=door config file full file and path name for DORINFO1.DEF file
  53.          t=mins              time in minutes that the user may be logged in
  54.          d=filename          debugging file name
  55.          l=filename          logging file name
  56.          p=port              TCP port to login to on remote machine
  57.          o=options           misc on/off options, see manual
  58. Telnet Door V003, copyright 1994 Russell Coker.
  59.  
  60.  
  61.    Basic usage is the same as any other Telnet program, just
  62. "teldor 202.12.87.129" or "teldor snoopy.apana.org.au" or whatever the
  63. destination address is using either the dotted decimal address or the domain
  64. name system address.
  65.  
  66.   For basic BBS operation it is: "teldor fd=c:\path\dorinfo1.def 202.12.87.129"
  67.  
  68. The 'fd' parameter specifies the fully qualified path name of the DORINFO1.DEF
  69. file which contains all necessary information on the user.  The 'f' stands for
  70. the file name of a settings file, and the 'd' stands for DORINFO1.DEF format.
  71. In future I will support other formats as well.  NB  The "COMx" line in the
  72. door file is taken to contain the number of the open OS/2 file handle for the
  73. serial port.  So "COM3" does not mean serial port 3 it means file handle 3
  74. which points to a serial port.  If you don't understand this then read the
  75. documentation for Maximus or BinkleyTerm.  I don't agree with that feature
  76. being used in that way, but I know 99% of you have BBSs set up like that.  The
  77. preferred way of passing an open serial port handle is via the "C=x" command
  78. line parameter which overrides the parameter in the door file (all command
  79. line parameters take precedence over door file parameters).
  80.    This program will exit if a user tries to stay online longer than they are
  81. allowed.  It does not hang up on them, it merely tells them that their time
  82. is up and exits.  This allows the BBS software to decide exactly what to do
  83. when someone stays online too long.  The amount of time that they are allowed
  84. is taken from the command line via the "t=x" parameter, or from the door file
  85. if it's not specified on the command line (NB the doorfile is strictly
  86. optional, if you don't specify a time limit on the command line and the
  87. doorfile isn't being used then they are allowed to stay online forever).  The
  88. user is given a warning 5 minutes before their time is due to expire to give
  89. them time to save files etc.
  90.     The "p=x" command line parameter is used to specify the TCP port to login
  91. to on the remote machine.  The default is 23 (the RLOGIN port).  You can also
  92. use a service name with the "p=" parameter.  EG  "p=nntp" would connect you to
  93. the Net News Transfer Protocol port and allow you to read Net News (if you're
  94. masochistic).
  95.     The parameters "d=" and "l=" are for specifying the debugging and logging
  96. file names respectively.  The logging file will store all data sent to the
  97. user on disk and may be useful to a sysop.  The debugging file will only store
  98. information on the state of my program.  The intended usage of the debugging
  99. file is for you to send it to me if you encounter a bug in my program, however
  100. if you feel curious then feel free to try and decipher it.
  101.    The "O=" command line parameter can be used in the following ways:
  102.     "O=C" will turn the local console off.  This is useful for BBS sysops who
  103. don't want to see what the user is doing.  It turns off all local display and
  104. keyboard input.  This can make TELDOR run considerably faster in some
  105. situations due to the output speed slowing the system down, a future version
  106. will display output much faster and this won't be needed for speed.
  107.     "O=7" will turn off binary mode.  This is necessary if you wish to login to
  108. an OS/2 system and not have the screen garbled.
  109.     "O=8" will force my program to pass binary data in both directions when not
  110. in binary mode!  It should never be necessary to use this feature, but I expect
  111. that there are some telnet servers out there that are buggy and require this.
  112.     If you wish to have all data displayed locally except for BEL characters
  113. then the setting O=Q (for quiet) will cause all beeps to be filtered out from
  114. local display (they will still be sent to the remote user however).
  115.     You use multiple options in the following way "O=7C" to turn console output
  116. off and to use non-binary mode, or "O=8Q" to force binary transmission and
  117. filter out beeps from local display.
  118.  
  119.  
  120.  To register post a cheque or International bank draft for $25 Australian per
  121. line of your BBS which will be running my program to:
  122.  
  123.  
  124. Russell Coker,
  125. PO Box 584,
  126. Lilydale, 3140,
  127. Victoria Australia.
  128.  
  129.    Note the new PO box address!
  130.  
  131.    To get the latest version and for technical support you can send EMAIL to
  132. your choice of the following addresses:
  133. rjc@snoopy.apana.org.au.
  134. Russell Coker @ 3:633/363.0 @ fidonet
  135.  
  136.     Or call my BBS directly on +61-3-739-7145.
  137.  
  138.   To get the absolutely latest version FREQ "TELDOR" from 3:633/363@fidonet,
  139. download it from files area OBBS in my BBS as the latest file that matches
  140. "TELDR" (do a locate to find it), or do an anonymous FTP from my Internet
  141. system (snoopy.apana.org.au).  Also many other sites have copies of my program,
  142. the systems hobbes.nmsu.edu and ftp-os2.cdrom.com get copies soon after release
  143. and they both have Internet links that are thousands of times faster than mine
  144. so you may prefer to FTP from them instead of from me.  But if you are paranoid
  145. about corrupt files or something then feel free to download it from
  146. snoopy.apana.org.au.  Snoopy is an Internet host that is totally administered
  147. by myself.
  148.  
  149.    I am currently running a mailing list for UUencoded copies of this program.
  150. This means that people who have Internet EMAIL addresses don't have to do
  151. anything to keep up to date with the very latest versions of my program, they
  152. can just automatically receive copies in their mail account without having to
  153. do anything.  If you are interested in this idea then just send me an EMAIL
  154. message to my Internet address and I'll put you on the list.
  155.