home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 3 / Meeting_Pearls_III.iso / Pearls / tcp / Networking / TCP / Server / tnserv / doc / tnserv.doc
Text File  |  1993-12-12  |  6KB  |  139 lines
  1. /---------------------------------------------------------------\
  2.   ---------   -     -    /----\    ------   -----  --        --
  3.  |         | | \   | |  /      |  |      | |     \ \ \      / /
  4.   ---- ----  |  \  | | | /----\|  | |----  | ---\ | \ \    / /
  5.      | |     | \ \ | | | |        | |      | |  / / \ \    / /
  6.      | |     | | \ | | | \---\    | |---   | | / /   \ \  / /
  7.      | |     | |\ \| |  \____ \   | |---   | || |    \ \  / /
  8.      | |     | | \ | |       \ |  | |      | | \ \    \ \/ /
  9.      | |     | | \ | | |\----| |  | |----  | | \ \    \ \/ /
  10.      | |     | |  \  | |       |  |      | | |  \ \    \  /
  11.       -       -    --   \-----/    ------   -     -     --
  12. \---------------------------------------------------------------/
  13. tnserv is Copyright (C) 1993 Steve Holland sdh4@cornell.edu
  14. All Rights Reserved
  15. tnserv is FREEWARE. This means you can pass it on to others
  16. for FREE or for a nominal copying fee. Fred Fish is expressly
  17. invited to include this in his disk collection, and permission
  18. is hereby given for this program to be included on the 
  19. AmiNet CD-ROM. Furthermore, permission is hereby granted for
  20. tnserv to be included with the AmiTCP distribution, should
  21. the AmiTCP group in Finland choose to do so.
  22. This program is NOT distributed under the terms of the GNU
  23. general public license, at least not yet.
  24.  
  25. All the standard disclaimers apply. Use this program at your
  26. own risk.  
  27.  
  28.  
  29.  
  30. WHAT IS TNSERV?
  31.   Tnserv is a telnet daemon for AmiTCP version 2. It allows
  32. remote connections to your computer and allows remote shells, 
  33. multi-user BBSes, remote text editing, and much more.
  34.  
  35. SYSTEM REQUIREMENTS
  36.   Tnserv requires AmiTCP version 2 installed and running,
  37. and AmigaDOS 2.0 or better. It will generally  use less than
  38. 100k of memory, although it may use much more if there
  39. are many remote connections.
  40.  
  41. FEATURES
  42.   - Provides telnet daemon support for AmiTCP version 2
  43.   - Supports arbitrary number of simultaneous connections to 
  44.     a single login.
  45.   - Supports both pseudo-CON: and pseudo-serial.device connections,
  46.     allowing virtually any existing program which works either
  47.     in a Shell/CLI or over the serial port to be accessible
  48.     over the network.
  49.   - Compatible with MultiUser
  50.   - Converts network end of line sequencess to Amiga type 
  51.     end of line sequences.
  52.   - Supports telnet LINEMODE option which allows line editing
  53.     to be done on the client, therefore providing increased 
  54.     performance, and decreased network bandwidth usage.
  55.   - Provides password protection
  56.  
  57. INSTALLING TNSERV
  58. make a directory for tnserv and assign tnserv: to that
  59. directory. You will probably want to put that assign 
  60. in your user-startup file. The files in the s 
  61. directory are optional, but needed to  use the sample 
  62. password file entries. C/reqoff disables 
  63. system requesters for the current shell or cli. This 
  64. is needed to prevent processes under remote control
  65. from waiting for a user on the console to hit a "cancel"
  66. button. Devs/fakesr.device is what allows tnserv to 
  67. create pseudo-serial ports on the fly. It must be
  68. in your devs: assign path for tnserv to operate.
  69. The "telnetgetty" file must be in one of the following
  70. locations relative to the directory from which
  71. tnserv was run: 
  72.   tnserv:telnetgetty
  73.   telnetgetty/telnetgetty
  74.   telnetgetty
  75.   AmiTCP:bin/telnetgetty
  76. TNSERV WILL NOT WORK AT ALL UNLESS IT CAN FIND 
  77. TELNETGETTY IN ONE OF THESE LOCATIONS.
  78. Put an appropriate login banner in tnserv:banner and
  79. create the logins you want in the tnserv:passwd file.
  80. If you have MultiUser installed uncomment the line
  81. in s:remote-startup which calls logout.
  82. To run tnserv, simply type "run >nil: tnserv"
  83. from a shell, and tnserv will immediately
  84. begin waiting for connections. To stop tnserv 
  85. once it is started, you can use the break 
  86. shell command to send tnserv the Control-C signal.
  87.  
  88. PASSWD FILE FORMAT
  89. (see the example password file for documentation)
  90.  
  91. NOTES
  92. to use the supplied emacs script, you must first patch 
  93. your copy of emacs to use the fakesr.device instead of the
  94. serial.device. This is because of an emacs bug -- the command
  95. line option to tell it to use something other than serial.device
  96. unit 0 does not work.
  97. A '*' as a password indicates no password required for login.
  98. However, the current version of telnetgetty does require a 
  99. password anyway, although it does not care what is typed.
  100.  
  101. BUGS
  102. TelnetGetty should release the rights to fakesr.device unit immediately
  103. if the first open is not SERF_SHARED.
  104.  
  105. emacs seems to have some problems sometimes. Source unknown. Possibly
  106. emacs bug.
  107.  
  108. emacs does not accept cursor-key input. Source unknown. Probably termcap
  109. problems
  110.  
  111. If you telnet to the amiga, then use the amiga to telnet to a host,
  112. when you type characters they do not get displayed until you press
  113. return. Source unknown.
  114.  
  115. The Home-Dir option in the password file is currently ignored
  116.  
  117. TelnetGetty should not ask the user for a password for logins to accounts
  118. with no password.
  119.  
  120. The Ctrl-C, D, E, and F signals are not generated and sent to 
  121. the appropriate tasks/processes for the console mode.
  122. (this is currently considered a feature, since it makes
  123. it possible to run shell scrips securely without worrying
  124. about having someone Ctrl-D out of one.
  125.  
  126. TelnetGetty does not pay any attention to remote telnet requests/option
  127. negotiation, although it does correctly ignore them.
  128.  
  129. CONTACTING THE AUTHOR
  130.   Name: Steve Holland
  131.   E-Mail: sdh4@cornell.edu
  132.   Snail Mail:
  133.     22 Forty Acres Drive
  134.     Wayland, MA 01778
  135.     USA
  136.  
  137. Of course donations, while not required, would be
  138. graciously accepted.
  139.