home *** CD-ROM | disk | FTP | other *** search
/ Super Net 1 / SUPERNET_1.iso / PC / OTROS / MSDOS / PKTDRVR / TALK_12.ZIP / TALK.DOC < prev    next >
Encoding:
Text File  |  1994-01-11  |  11.4 KB  |  297 lines
  1. ------------------------------------------------------------------------
  2. Talk Version 1.2                                            11. Jan 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 Answer mode to reply to talk requests while you are absent.
  11. o Two display modes, single screen and split screen (like Unix talk)
  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. Comments, suggestions, improvements are welcome.
  26.  
  27.     Michael Ringe
  28.     Institut fuer Theoretische Physik
  29.     RWTH Aachen, Germany
  30.     michael@thphys.physik.rwth-aachen.de
  31.  
  32.  
  33. ------------------------------------------------------------------------
  34.             CHANGES FROM PREVIOUS VERSIONS
  35. ------------------------------------------------------------------------
  36.  
  37. Version 1.2
  38. -----------
  39. o Improved error and time out checks
  40. o Fixed debugging code
  41. o Allow environment variables in wattcp.cfg
  42. o Added auto answer mode
  43. o Added log file
  44.  
  45.  
  46. Version 1.1
  47. -----------
  48. o Added edit keys (erase char, erase word, kill line)
  49. o Added aliases
  50. o Added help screen
  51. o Display the current time in the status line
  52. o Allow different color sets in WATTCP.CFG for single window and
  53.   split screen mode
  54. o Alt-S toggles between single window and split screen mode
  55.  
  56.  
  57. Version 1.0
  58. -----------
  59. o Initial version
  60.  
  61.  
  62. ------------------------------------------------------------------------
  63.                   INSTALLATION
  64. ------------------------------------------------------------------------
  65.  
  66. To run talk you need two files:
  67.  
  68.     talk.exe   - The executable file
  69.     wattcp.cfg - The configuration file for the WATTCP library.
  70.  
  71. Wattcp.cfg may reside in the current directory, in the same directory as
  72. talk.exe, or in the directory specified by the environment variable
  73. WATTCP.CFG. If you don't use any other WATTCP applications, edit the
  74. wattcp.cfg which comes with talk and fill in the necessary information.
  75. If you already have a wattcp.cfg, you should use that. In this case you
  76. may want to add some entries.
  77.  
  78. Refer to the CONFIGURATION section below for more details about
  79. wattcp.cfg settings.
  80.  
  81.  
  82. ------------------------------------------------------------------------
  83.                  USAGE
  84. ------------------------------------------------------------------------
  85.  
  86. There are three ways of starting talk:
  87.  
  88. 1)  To begin a talk session with another user, enter
  89.  
  90.     talk [-l] <User>@<Host>
  91.     or
  92.     talk [-l] <Alias>
  93.  
  94.     where <Alias> is an alias name defined in wattcp.cfg (see
  95.     CONFIGURATION below). If the user is logged in, talk will print
  96.     a message and wait for the remote user to reply. <Host> may be a
  97.     domain name or an IP address.
  98.  
  99.     -l enables the log file (se below).
  100.  
  101. 2)  If invoked without arguments, talk waits for incoming talk requests.
  102.     Any invitation will be accepted regardless of user and terminal
  103.     name. Since there is not much you can do with your PC while talk is
  104.     waiting, this option is not very useful under MS-DOS.
  105.  
  106. 3)  Starting talk with
  107.  
  108.     talk -a
  109.  
  110.     makes talk operate as an answering machine. Talk will ask you for
  111.     a message which will be presented to any user who tries to talk
  112.     to your PC. The message can be up to 10 lines long. A line
  113.     containing a single dot in the first column ends the message.
  114.     To use the default message, just press enter on the first line.
  115.  
  116.     Otherwise, talk runs as under 2) with two differences:
  117.     - the log file (see below) is automatically enabled,
  118.     - talk does not exit after a connection is closed, but waits
  119.       for the next invitation.
  120.  
  121. During a talk session, you may press ESC to close the connection, or
  122. F1 to display a help screen.
  123.  
  124. Alt-S switches between the two display modes, single window and split
  125. screen. In split screen mode local and remote text is displayed in
  126. separate windows, as in the Unix talk. In single window mode all text
  127. is written into one window.
  128.  
  129. The talk protocol defines three edit keys which can be used during a
  130. talk session:
  131.  
  132.     Edit key  Corresponding PC key(s)    Meaning
  133.     --------  -------------------------  --------------------------
  134.     ERASE     Del, BS, Left              Delete the last character
  135.     WERASE    Ctrl-W, Ctrl-Left          Delete the last word
  136.     KILL      Ctrl-U                     Clear the current line
  137.  
  138. Note that these edit keys may have strange effects in single window
  139. mode, because they do not distinguish between local and remote text.
  140.  
  141. Pressing Alt-L toggles the log file. When the log file is enabled, an
  142. `L' appears in the status line and the text on the screen is logged into
  143. a file. The log file name is `talk.log' by default but may be changed to
  144. any name (see CONFIGURATION below).
  145.  
  146.  
  147. ------------------------------------------------------------------------
  148.                   CONFIGURATION
  149. ------------------------------------------------------------------------
  150.  
  151. Talk recognizes the following entries in wattcp.cfg:
  152.  
  153. talk_localuser="PC-User"
  154.     Sets your local username. If you talk to another user, he/she
  155.     will be notified with a message containig this name. This
  156.     setting has no effect if the talk was initiated by the remote
  157.     user, because talk will always assume the requested user id.
  158.  
  159. talk_screenmode="split"
  160.     Sets the initial display mode. "split" selects split screen
  161.     mode, any other value selects single window mode (default).
  162.  
  163. talk_colors=LLRRSSllrr[,LLRRSSllrr]
  164.     Screen colors. The value must consist of exactly 5 hex numbers
  165.     (2 digits each), specifying the screen attributes for local
  166.     window (LL), remote window (RR), status line (SS), local name
  167.     on status line (ll) and remote name on status line (rr).
  168.  
  169.     You may specify a second color set, which must be in the same
  170.     format and separated by exactly one character from the first
  171.     set. In this case, the first set applies to single window mode,
  172.     while the second set is used in split screen mode.
  173.  
  174. talk_alias="alias:user@host"
  175.     This defines an alias for user@host. With this definition,
  176.     `talk alias' becomes equivalent to `talk user@host'. You may
  177.     specify an arbitrary number of aliases.
  178.  
  179. talk_logfile="talk.log"
  180.     Specifies the name of the log file. Default is `talk.log'.
  181.  
  182. talk_message="%s is not here. Try again later, or leave a message."
  183.     Sets the default message for auto answer (-a) mode. This option
  184.     can be repeated to allow multiple line messages (up to 10
  185.     lines). `%s' may ocur once on each line and will be replaced by
  186.     the local user name.
  187.  
  188. Talk can read any of the above parameters from an environment variable.
  189. If the value specified in wattcp.cfg starts with a `$', the rest of the
  190. argument is interpreted as an environment variable name and the value is
  191. read from this variable. This may be useful when there is only one
  192. wattcp.cfg shared by many users. Note that the above mechanism applies
  193. ONLY to the settings listed above, not to the other definitions in
  194. wattcp.cfg. Note also that there is an include statement for wattcp.cfg
  195. which allows to include user-specific configuration files.
  196.  
  197.  
  198. ------------------------------------------------------------------------
  199.                 MESSAGES
  200. ------------------------------------------------------------------------
  201.  
  202. Here is a short explanation of some messages you may get from talk:
  203.  
  204. Your party is not logged on
  205.     The person you want to talk to is currently not logged on, or
  206.     does not exist on the specified machine. Check if you spelled
  207.     the user name correctly.
  208.  
  209. Your party is refusing messages
  210.     The person you want to talk to has disabled messages. To be able
  211.     to receive talk requests, messages must be enabled. On most Unix
  212.     systems this is done with the command `mesg y'.
  213.  
  214. Target machine does not recognize us
  215.     The talk daemon on the target machine was not able to map your
  216.     PC's IP address to a host name. Your PC is probably not
  217.     registered in the official nameserver for your domain.
  218.  
  219. Target machine is too confused to talk with us
  220.     The remote talk daemon failed to process our request for some
  221.     unspecified reason. This error may also occur if the network
  222.     connection is very bad.
  223.  
  224. ICMP: Port Unreachable
  225.     The target machine has disabled talk or it runs an old version
  226.     of the talk protocol.
  227.  
  228. No response from target host, giving up
  229.     The remote talk daemon does not respond to your request. This
  230.     may be caused by bad network connections.
  231.  
  232. Error: Cannot open connection.
  233.     This is a either a network problem (try to connect to the same
  234.     host via ftp or telnet), or your PC is incorrectly configured
  235.     (check your wattcp.cfg settings).
  236.  
  237.  
  238. ------------------------------------------------------------------------
  239.             KNOWN BUGS/RESTRICTIONS
  240. ------------------------------------------------------------------------
  241.  
  242. o Supports only the new version of the talk protocol, using port 518
  243.   (vs. 517 in old versions). You will not be able to talk to a machine
  244.   running an old implementation of talk (many SUNs still do).
  245.  
  246. o Talk is not a real talk daemon because it does not run in the
  247.   background. There should be a small TSR programm looking for
  248.   incoming invitations.
  249.  
  250. o The remote host, if it is a Unix machine, must know about your PC's
  251.   name. The remote talkd will try to map your IP address to a domain
  252.   name and refuse to process your request if this fails. If you get the
  253.   message "Target machine does not recognize us", contact your local
  254.   network administrator to have your PC registered on an official name
  255.   server.
  256.  
  257. o Only 80x25 video mode supported.
  258.  
  259. o Talk is a standalone application and does not coexist with most other
  260.   networking software. There is no support for other protocol stacks
  261.   like Winsock or PC/TCP.
  262.  
  263. o Talk should display the remote host name instead of its IP address.
  264.   Any volunteers for writing gethostbyaddr()?
  265.  
  266. o No possibility to talk to a specific tty if a user is logged in on
  267.   more than one terminal.
  268.  
  269. o Should ring again if the remote user does not respond.
  270.  
  271.  
  272. ------------------------------------------------------------------------
  273.                  COMPILING
  274. ------------------------------------------------------------------------
  275.  
  276. In order to build talk from the source code you need the WATTCP library,
  277. which is available via anonymous ftp from dorm.rutgers.edu. Place talk.c
  278. into the `apps' directory or into a separate directory so that
  279. #include "..\include\tcp.h" works.
  280.  
  281. The distributed executable was compiled with Borland C++ 3.1 and linked
  282. with the small model library (WATTCPSM.LIB).
  283.  
  284. *** IMPORTANT NOTE ***
  285. In order to compile correctly with BC 3.1, the file pctcp.c requires a
  286. patch. Change line 946 in function udp_handler() from
  287.  
  288.         s->myaddr = intel( ip->destination );
  289. to
  290.         s->myaddr = temp;
  291.  
  292. Otherwise, talk will not work! This note applies to the wattcp
  293. library which is currently available at dorm.rutgers.edu:
  294.  
  295.     135887  Sep 30  14:27  wattcp.zip
  296.  
  297.