macro and text revision (-mdoc version 3)
[unix-history] / usr / src / libexec / talkd / talkd.8
CommitLineData
0fccfdb8 1.\" Copyright (c) 1983, 1991 The Regents of the University of California.
e1aed699 2.\" All rights reserved.
04426121 3.\"
121e56ee 4.\" %sccs.include.redist.man%
04426121 5.\"
0fccfdb8 6.\" @(#)talkd.8 6.5 (Berkeley) %G%
e1aed699 7.\"
0fccfdb8
CL
8.Dd
9.Dt TALKD 8
10.Os BSD 4.3
11.Sh NAME
12.Nm talkd
13.Nd remote user communication server
14.Sh SYNOPSIS
15.Nm talkd
16.Sh DESCRIPTION
17.Nm Talkd
18is the server that notifies a user that someone else wants to
04426121
KM
19initiate a conversation.
20It acts a repository of invitations, responding to requests
21by clients wishing to rendezvous to hold a conversation.
22In normal operation, a client, the caller,
0fccfdb8
CL
23initiates a rendezvous by sending a
24.Tn CTL_MSG
25to the server of
26type
27.Tn LOOK_UP
28(see
29.Aq Pa protocols/talkd.h ) .
04426121
KM
30This causes the server to search its invitation
31tables to check if an invitation currently exists for the caller
32(to speak to the callee specified in the message).
33If the lookup fails,
0fccfdb8
CL
34the caller then sends an
35.Tn ANNOUNCE
36message causing the server to
04426121
KM
37broadcast an announcement on the callee's login ports requesting contact.
38When the callee responds, the local server uses the
39recorded invitation to respond with the appropriate rendezvous
40address and the caller and callee client programs establish a
41stream connection through which the conversation takes place.
0fccfdb8
CL
42.Sh SEE ALSO
43.Xr talk 1 ,
44.Xr write 1
45.Sh HISTORY
46The
47.Nm
48command appeared in
49.Bx 4.3 .