| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |
Arguments: (server rpc-socket-server) &key confirm
Arguments: (server rpc-datagram-server) &key confirm
This function accepts one connection from a remote client. In a typical situation, a server would loop on a call to this function. The function rpc-open-listener implements such a loop. This function is useful if an application needs behavior that is not provided by rpc-open-listener.
When server is a subclass of rpc-socket-server
, this method
waits for a connection and returns the resulting port object.
When server is a subclass of rpc-datagram-server
, the effect of this
method is to wait for one datagram message to arrive. The message
could be a new RPC call, the result of some previous RPC call, or an
RPC request. Unless this method is called repeatedly in some loop, the
Lisp host will be very unreceptive to remote calls and requests.
The keyword arguments are the same as make-rpc-server, and are used to update the settings in the server instance.
A passive socket is opened if necessary, and closed if appropriate. If
begin is t, start receiver and sender processes
for the port. The begin argument always defaults
to t, unless it is explicitly passed as nil
in each call.
If connect-action is :return
, the port object is
simply returned as the value of the call.
If connect-action is :call
,
then two values are returned:
If connect-action is :process
,
then two values are returned:
:call
case.
The confirm keyword argument: when this argument
is non-nil
, the Lisp RPC protocol includes
additional confirmation messages that track the progress of a remote
call in more detail (see rpc-query for more details). The default
value is nil
.
A non-nil
value may be applicable when using
a very slow network connection. In such cases more detailed progress
information could be useful.
This argument was not available in releases prior to 6.2, where this
function worked as if this argument was specified non-nil
.
See also rpc.htm for general information on the Remote Procedure Call utility in Allegro CL.
Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.
| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |