diff options
| author | Kim F. Storm | 2005-05-15 20:42:11 +0000 |
|---|---|---|
| committer | Kim F. Storm | 2005-05-15 20:42:11 +0000 |
| commit | 4b9f372b4e007cfcf87671e41986c04dfd471355 (patch) | |
| tree | 5a5f02eb856e1c4030a6232b8ee1112fe503e624 /lispref/processes.texi | |
| parent | 4214af69d70048e2b2f6be6e7aa23e8d621ce1c6 (diff) | |
| download | emacs-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.texi | 41 |
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. | |||
| 1559 | keyword/argument pairs, for example @code{:server t} to create a | 1559 | keyword/argument pairs, for example @code{:server t} to create a |
| 1560 | server process, or @code{:type 'datagram} to create a datagram | 1560 | server process, or @code{:type 'datagram} to create a datagram |
| 1561 | connection. @xref{Low-Level Network}, for details. You can also use | 1561 | connection. @xref{Low-Level Network}, for details. You can also use |
| 1562 | one of the @code{open-network-...} functions descibed below; | 1562 | the @code{open-network-stream} function descibed below. |
| 1563 | internally, they just call @code{make-network-process} with suitable | ||
| 1564 | arguments. | ||
| 1565 | 1563 | ||
| 1566 | You can distinguish process objects representing network connections | 1564 | You can distinguish process objects representing network connections |
| 1567 | and servers from those representing subprocesses with the | 1565 | and servers from those representing subprocesses with the |
| @@ -1601,25 +1599,6 @@ The arguments @var{host} and @var{service} specify where to connect to; | |||
| 1601 | a defined network service (a string) or a port number (an integer). | 1599 | a 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 | ||
| 1605 | This function opens a TCP connection, like @code{open-network-stream}, | ||
| 1606 | but it returns immediately without waiting for the request to be | ||
| 1607 | accepted or rejected by the remote server. When the request is | ||
| 1608 | subsequently accepted or rejected, the process's sentinel function | ||
| 1609 | will be called with a string that starts with @code{"open"} (on | ||
| 1610 | success) or @code{"failed"} (on error). | ||
| 1611 | |||
| 1612 | Some systems do not support non-blocking connections; on those | ||
| 1613 | systems, @code{open-network-stream-nowait} returns @code{nil} | ||
| 1614 | and does nothing. | ||
| 1615 | |||
| 1616 | The optional arguments @var{sentinel} and @var{filter} specify the | ||
| 1617 | sentinel and filter functions for this network connection. It is | ||
| 1618 | useful to specify them when opening the connection, because they will | ||
| 1619 | be 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 |
| 1624 | This function returns information about how a network process was set | 1603 | This function returns information about how a network process was set |
| 1625 | up. For a connection, when @var{key} is @code{nil}, it returns | 1604 | up. For a connection, when @var{key} is @code{nil}, it returns |
| @@ -1704,24 +1683,6 @@ number used for the connection. | |||
| 1704 | The client process' plist is initialized from the server's plist. | 1683 | The 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 | ||
| 1708 | Create a network server process for a TCP service. | ||
| 1709 | It returns @code{nil} if server processes are not supported; otherwise, | ||
| 1710 | it returns a subprocess-object to represent the server. | ||
| 1711 | |||
| 1712 | When a client connects to the specified service, Emacs creates a new | ||
| 1713 | subprocess to handle the new connection, and then calls its sentinel | ||
| 1714 | function (which it has inherited from the server). | ||
| 1715 | |||
| 1716 | The optional arguments @var{sentinel} and @var{filter} specify the | ||
| 1717 | sentinel and filter functions for the server. It is useful to specify | ||
| 1718 | them now, because they will be used later asynchronously when the | ||
| 1719 | server 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} | ||
| 1722 | meaning 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 |