home *** CD-ROM | disk | FTP | other *** search
/ Super Net 1 / SUPERNET_1.iso / PC / OTROS / MSDOS / PKTDRVR / TALK_13.ZIP / TALK.DOC < prev    next >
Encoding:
Text File  |  1994-04-05  |  13.4 KB  |  349 lines
  1. ------------------------------------------------------------------------
  2. Talk Version 1.3                                          05. April 1994
  3. ------------------------------------------------------------------------
  4.  
  5. This is a simple talk client/server for MS-DOS. Talk's main features
  6. are:
  7.  
  8. o Talk from PC to Unix host or to another PC running talk
  9. o Wait for incoming invitations
  10. o Automatically reply to talk requests while you are absent
  11. o Two display modes, single screen and split screen
  12. o Define aliases for frequently used addresses
  13. o Log talk sessions to a file
  14.  
  15. Talk is built upon the WATTCP library and runs directly over a packet
  16. driver. It is a standalone application and does not run simultaneously
  17. with most other tcp/ip software like NCSA, CUTCP, and Trumpet WinSock.
  18. It runs, reportedly, together with IPX (using IPXPKT).
  19.  
  20. The program (executable and source code) is provided under the terms
  21. of the GNU General Public License. It may be used and distributed
  22. freely. There is absolutely NO WARRANTY. See the file COPYING for
  23. details.
  24.  
  25. Talk is user-supported software. If you have any comments or
  26. suggestions for further improvements, feel free to contact me. See
  27. the `ACKNOWLEDGEMENTS' section below for a list of contributors to
  28. this release.
  29.  
  30.     Michael Ringe
  31.     Institut fuer Theoretische Physik
  32.     RWTH Aachen, Germany
  33.     E-Mail: michael@thphys.physik.rwth-aachen.de
  34.  
  35.  
  36. ------------------------------------------------------------------------
  37.             CHANGES FROM PREVIOUS VERSIONS
  38. ------------------------------------------------------------------------
  39.  
  40. Version 1.3
  41. -----------
  42. o Fixed several minor Bugs
  43. o Support for 80x50 video mode
  44. o Added -q option
  45. o Allow terminal name on command line
  46. o Supports BSD-4.2 talk protocol
  47. o 'Upgrade' to BC 4.0
  48. o Added host name lookup
  49. o Added autocr mode
  50.  
  51. Version 1.2
  52. -----------
  53. o Improved error and time out checks
  54. o Fixed debugging code
  55. o Allow environment variables in wattcp.cfg
  56. o Added auto answer mode
  57. o Added log file
  58.  
  59. Version 1.1
  60. -----------
  61. o Added edit keys (erase char, erase word, kill line)
  62. o Added aliases
  63. o Added help screen
  64. o Display the current time in the status line
  65. o Allow different color sets in WATTCP.CFG for single window and
  66.   split screen mode
  67. o Alt-S toggles between single window and split screen mode
  68.  
  69. Version 1.0
  70. -----------
  71. o Initial version
  72.  
  73.  
  74. ------------------------------------------------------------------------
  75.                   INSTALLATION
  76. ------------------------------------------------------------------------
  77.  
  78. To run talk you need two files:
  79.  
  80.     talk.exe   - The executable file
  81.     wattcp.cfg - The configuration file for the WATTCP library.
  82.  
  83. Wattcp.cfg may reside in the current directory, in the same directory as
  84. talk.exe, or in the directory specified by the environment variable
  85. 'WATTCP.CFG'. If you don't use any other WATTCP applications, edit the
  86. wattcp.cfg which comes with talk and fill in the necessary information.
  87. If you already have a wattcp.cfg, you should use that. In this case you
  88. may want to add some entries.
  89.  
  90. Refer to the CONFIGURATION section below for more details about
  91. wattcp.cfg settings.
  92.  
  93.  
  94. ------------------------------------------------------------------------
  95.                USAGE (OVERVIEW)
  96. ------------------------------------------------------------------------
  97.  
  98. To talk to another user, enter
  99.  
  100.     talk [-lo] <user>@<host> [<term>]
  101.  
  102. <host> may be either a host name ('x.y.edu') or an Internet address
  103. ('111.222.333.444'). If the user is logged in more than once, you may
  104. connect to a specific terminal using the <term> argument. There are
  105. two options:
  106.  
  107.     -l    Switch on the log file
  108.     -o    Use the old (BSD 4.2) talk protocol
  109.  
  110.  
  111. To wait for incoming talk requests, invoke talk with
  112.  
  113.     talk [-alq]
  114.  
  115. Options:
  116.  
  117.     -l    Switch on the log file
  118.     -a    Automatic answer mode
  119.     -q    Be quiet in answer mode
  120.  
  121.  
  122. ------------------------------------------------------------------------
  123.                USAGE (MORE DETAILS)
  124. ------------------------------------------------------------------------
  125.  
  126. The log file
  127. ------------
  128. Talk can log the session to a log file. Logging is enabled by the -l
  129. option on the command line or by pressing Alt-L (the latter toggles the
  130. log file on and off). The default log file name is 'talk.log', but this
  131. may be changed in the configuration file (see CONFIGURATION below).
  132.  
  133.  
  134. Video and display modes
  135. -----------------------
  136. Talk supports 80x25, 80x43 EGA and 80x50 VGA video modes. In any of
  137. these video modes you may select between 'split screen' and 'single
  138. window' display. In split screen mode local and remote text is displayed
  139. in separate windows, as in the Unix talk. In single window mode all text
  140. is written into one window with different colors being used for local
  141. and remote text. During a talk session you may switch the display mode
  142. at any time by pressing Alt-S. The initial display mode can be selected
  143. in the configuration file (see below).
  144.  
  145. In single window mode, you have to press the enter key frequently to
  146. avoid mixing up your and your party's text. The 'autocr' feature, which
  147. is activated by Alt-R automates this procedure. When autocr is active
  148. (a 'R' appears in the status line) a new line is inserted automatically
  149. to keep your and your party's text on seperate lines.
  150.  
  151.  
  152. Special keys during a talk session
  153. ----------------------------------
  154. F1                   Display a help screen
  155. ESC                  Close the connection
  156. Alt-S                Switch between single window and split screen
  157. Alt-L                Toggle the log file
  158. Del, BS, Left        Delete the last character
  159. Ctrl-W, Ctrl-Left    Delete the last word
  160. Ctrl-U               Clear the current line
  161.  
  162. Note that the edit keys may have strange effects in single window mode,
  163. because they do not distinguish between local and remote text.
  164.  
  165.  
  166. New and old talk protocol
  167. -------------------------
  168. Besides the 'standard' talk protocol, which was released with BSD 4.3,
  169. there is an older protocol, which appeared in BSD 4.2. The old protocol
  170. is still in use on many machines (most of them SUN's) and incompatible
  171. with its successor. Even worse, the old protocol is machine dependent,
  172. i.e., two computers running the old protocol may or may not be able to
  173. talk to each other.
  174.  
  175. If you connect to another user, talk first tries to establish a
  176. connection using the standard protocol. If that fails, it tries the old
  177. protocol. On machines which only support the old protocol this will
  178. cause an error message ('Port unreachable') and a short delay. In such
  179. cases you may want to use the -o option. This option prevents talk from
  180. trying the standard protocol.
  181.  
  182.  
  183. Answer mode
  184. -----------
  185. Using the -a option makes talk operate as an answering machine. Talk
  186. will ask you for a message to present to any user who tries to talk to
  187. your PC. The message can be up to 10 lines long. A line containing a
  188. single dot in the first column ends the message. To use the default
  189. message, just press enter on the first line.
  190.  
  191. In answer mode, the log file is automatically enabled, and talk does
  192. not exit after a connection is closed. Also, there is a time-out of
  193. 2 minutes for inactive connections.
  194.  
  195. To suppress the beep and screen output, use the -q option ('quiet').
  196.  
  197.  
  198.  
  199. ------------------------------------------------------------------------
  200.                   CONFIGURATION
  201. ------------------------------------------------------------------------
  202.  
  203. Talk recognizes the following entries in wattcp.cfg:
  204.  
  205. talk_localuser="PC-User"
  206.     Sets your local username. If you talk to another user, he/she
  207.     will be notified with a message containig this name. This
  208.     setting has no effect if the talk was initiated by the remote
  209.     user, because talk will always assume the requested user id.
  210.  
  211. talk_screenmode="split[,autocr]"
  212.     Sets the initial display mode. "split" selects split screen
  213.     mode, any other value selects single window mode. "autocr"
  214.     is optional and turns on the autocr feature (see 'Screen modes'
  215.     above).
  216.  
  217. talk_colors=LLRRSSllrr[,LLRRSSllrr]
  218.     Screen colors. The value must consist of exactly 5 hex numbers
  219.     (2 digits each), specifying the screen attributes for local
  220.     window (LL), remote window (RR), status line (SS), local name
  221.     on status line (ll) and remote name on status line (rr).
  222.  
  223.     You may specify a second color set, which must be in the same
  224.     format and separated by exactly one character from the first
  225.     set. In this case, the first set applies to single window mode,
  226.     while the second set is used in split screen mode.
  227.  
  228. talk_alias="alias:user@host"
  229.     This defines an alias for user@host. With this definition,
  230.     'talk alias' becomes equivalent to 'talk user@host'. You may
  231.     specify an arbitrary number of aliases.
  232.  
  233. talk_logfile="talk.log"
  234.     Specifies the name of the log file. Default is `talk.log'.
  235.  
  236. talk_message="%s is not here. Try again later, or leave a message."
  237.     Sets the default message for auto answer (-a) mode. This option
  238.     can be repeated to allow multiple line messages (up to 10
  239.     lines). '%s' may ocur once on each line and will be replaced by
  240.     the local user name.
  241.  
  242. Talk can read any of the above parameters from an environment variable.
  243. If the value specified in wattcp.cfg starts with a '$', the rest of the
  244. argument is interpreted as an environment variable name and the value is
  245. read from this variable. This may be useful when there is only one
  246. wattcp.cfg shared by many users. Note that the above mechanism applies
  247. ONLY to the settings listed above, not to the other definitions in
  248. wattcp.cfg. Note also that there is an include statement for wattcp.cfg
  249. which allows to include user-specific configuration files.
  250.  
  251.  
  252. ------------------------------------------------------------------------
  253.                 MESSAGES
  254. ------------------------------------------------------------------------
  255.  
  256. Here is a short explanation of some messages you may get from talk:
  257.  
  258. Your party is not logged on
  259.     The person you want to talk to is currently not logged on, or
  260.     does not exist on the specified machine. Check if you spelled
  261.     the user name correctly.
  262.  
  263. Your party is refusing messages
  264.     The person you want to talk to has disabled messages. To be able
  265.     to receive talk requests, messages must be enabled. On most Unix
  266.     systems this is done with the command 'mesg y'.
  267.  
  268. Target machine does not recognize us
  269.     The talk daemon on the target machine was not able to map your
  270.     PC's IP address to a host name. Your PC is probably not
  271.     registered in the official nameserver for your domain.
  272.  
  273. Target machine is too confused to talk with us
  274.     The remote talk daemon failed to process our request for some
  275.     unspecified reason. This error may also occur if the network
  276.     connection is very bad.
  277.  
  278. ICMP: Port Unreachable
  279.     The target machine has disabled talk or it runs an old version
  280.     of the talk protocol. Use -o to avoid this message.
  281.  
  282. No response from target host, giving up
  283.     The remote talk daemon does not respond to your request. This
  284.     may be caused by bad network connections.
  285.  
  286. Error: Cannot open connection.
  287.     This is a either a network problem (try to connect to the same
  288.     host via ftp or telnet), or your PC is incorrectly configured
  289.     (check your wattcp.cfg settings).
  290.  
  291.  
  292. ------------------------------------------------------------------------
  293.             KNOWN BUGS/RESTRICTIONS
  294. ------------------------------------------------------------------------
  295.  
  296. o Since the old talk protocol is hardware dependent, talk will not work
  297.   with some machines. I would like to fix this `bug', but there seems
  298.   no documentation available for the old protocol. If anybody has a
  299.   specification or something similar, I would like to receive a copy!
  300.  
  301. o Talk is not a real talk daemon because it does not run in the
  302.   background. There should be a small TSR programm looking for
  303.   incoming invitations.
  304.  
  305. o The remote host, if it is a Unix machine, must know about your PC's
  306.   name. The remote talkd will try to map your IP address to a domain
  307.   name and refuse to process your request if this fails. If you get the
  308.   message "Target machine does not recognize us", contact your local
  309.   network administrator to have your PC registered on an official name
  310.   server.
  311.  
  312. o Talk is a standalone application and does not coexist with most other
  313.   networking software. There is no support for other protocol stacks
  314.   like Winsock or PC/TCP.
  315.  
  316. o Should ring again if the remote user does not respond.
  317.  
  318. o Invitations are not deleted.
  319.  
  320.  
  321. ------------------------------------------------------------------------
  322.                  COMPILING
  323. ------------------------------------------------------------------------
  324.  
  325. In order to build talk from the source code you need the WATTCP library,
  326. which is available via anonymous ftp from dorm.rutgers.edu. Place talk.c
  327. into the 'apps' directory or into a separate directory so that
  328. #include "..\include\tcp.h" works.
  329.  
  330. The distributed executable was compiled with Borland C++ 4.0 using the
  331. small memory model and a modified startup code. You can generate the
  332. modified startup code by removing the __ExceptInit call from c0.asm and
  333. building c0s.obj. With BC 4.0, this reduces the executable size by about
  334. 20K.
  335.  
  336.  
  337. ------------------------------------------------------------------------
  338.                 ACKNOWLEDEGMENTS
  339. ------------------------------------------------------------------------
  340.  
  341. Many of the improvements and additions in this release have been
  342. contributed or inspired by users of talk. I would like to thank all
  343. persons who sent me comments and suggestions:
  344.  
  345.     Ross B. Inman
  346.     William L. Menninger
  347.     Pete Wood
  348.  
  349.