aboutsummaryrefslogtreecommitdiffstats
path: root/lispref/processes.texi
diff options
context:
space:
mode:
authorKim F. Storm2005-05-15 20:42:11 +0000
committerKim F. Storm2005-05-15 20:42:11 +0000
commit4b9f372b4e007cfcf87671e41986c04dfd471355 (patch)
tree5a5f02eb856e1c4030a6232b8ee1112fe503e624 /lispref/processes.texi
parent4214af69d70048e2b2f6be6e7aa23e8d621ce1c6 (diff)
downloademacs-4b9f372b4e007cfcf87671e41986c04dfd471355.tar.gz
emacs-4b9f372b4e007cfcf87671e41986c04dfd471355.zip
(Network): Remove open-network-stream-nowait.
(Network Servers): Remove open-network-stream-server.
Diffstat (limited to 'lispref/processes.texi')
-rw-r--r--lispref/processes.texi41
1 files changed, 1 insertions, 40 deletions
diff --git a/lispref/processes.texi b/lispref/processes.texi
index 6ffacebce8a..07a72886355 100644
--- a/lispref/processes.texi
+++ b/lispref/processes.texi
@@ -1559,9 +1559,7 @@ back to listening for more connection requests.
1559keyword/argument pairs, for example @code{:server t} to create a 1559keyword/argument pairs, for example @code{:server t} to create a
1560server process, or @code{:type 'datagram} to create a datagram 1560server process, or @code{:type 'datagram} to create a datagram
1561connection. @xref{Low-Level Network}, for details. You can also use 1561connection. @xref{Low-Level Network}, for details. You can also use
1562one of the @code{open-network-...} functions descibed below; 1562the @code{open-network-stream} function descibed below.
1563internally, they just call @code{make-network-process} with suitable
1564arguments.
1565 1563
1566 You can distinguish process objects representing network connections 1564 You can distinguish process objects representing network connections
1567and servers from those representing subprocesses with the 1565and servers from those representing subprocesses with the
@@ -1601,25 +1599,6 @@ The arguments @var{host} and @var{service} specify where to connect to;
1601a defined network service (a string) or a port number (an integer). 1599a defined network service (a string) or a port number (an integer).
1602@end defun 1600@end defun
1603 1601
1604@defun open-network-stream-nowait name buffer-or-name host service &optional sentinel filter
1605This function opens a TCP connection, like @code{open-network-stream},
1606but it returns immediately without waiting for the request to be
1607accepted or rejected by the remote server. When the request is
1608subsequently accepted or rejected, the process's sentinel function
1609will be called with a string that starts with @code{"open"} (on
1610success) or @code{"failed"} (on error).
1611
1612Some systems do not support non-blocking connections; on those
1613systems, @code{open-network-stream-nowait} returns @code{nil}
1614and does nothing.
1615
1616The optional arguments @var{sentinel} and @var{filter} specify the
1617sentinel and filter functions for this network connection. It is
1618useful to specify them when opening the connection, because they will
1619be used later asynchronously. The other arguments mean the same as in
1620@code{open-network-stream}.
1621@end defun
1622
1623@defun process-contact process &optional key 1602@defun process-contact process &optional key
1624This function returns information about how a network process was set 1603This function returns information about how a network process was set
1625up. For a connection, when @var{key} is @code{nil}, it returns 1604up. For a connection, when @var{key} is @code{nil}, it returns
@@ -1704,24 +1683,6 @@ number used for the connection.
1704The client process' plist is initialized from the server's plist. 1683The client process' plist is initialized from the server's plist.
1705@end itemize 1684@end itemize
1706 1685
1707@defun open-network-stream-server name buffer-or-name service &optional sentinel filter
1708Create a network server process for a TCP service.
1709It returns @code{nil} if server processes are not supported; otherwise,
1710it returns a subprocess-object to represent the server.
1711
1712When a client connects to the specified service, Emacs creates a new
1713subprocess to handle the new connection, and then calls its sentinel
1714function (which it has inherited from the server).
1715
1716The optional arguments @var{sentinel} and @var{filter} specify the
1717sentinel and filter functions for the server. It is useful to specify
1718them now, because they will be used later asynchronously when the
1719server receives a connection request. The three arguments @var{name},
1720@var{buffer-or-name} and @var{service} mean the same thing as in
1721@code{open-network-stream}, but @var{service} can be @code{t}
1722meaning ask the system to allocate an unused port to listen on.
1723@end defun
1724
1725@node Datagrams 1686@node Datagrams
1726@section Datagrams 1687@section Datagrams
1727@cindex datagrams 1688@cindex datagrams