| Allegro CL version 7.0 Unrevised from 6.2 to 7.0. | |||||||||
Arguments: &key process-function end-function init-args max-servers total-timeout stop
This function starts a process that continuously restarts the Lisp jLinker server so that one is (almost) always available for a Java connection.
The returned value depends on the arguments. When a new listener is
started, then the returned value is the name of the listening process
in Lisp. When the stop argument is passed, the
returned value is the stop argument. A returned
value of nil indicates that no listeners were
active, so the call was ignored. A returned value of
:stopping indicates that a previous
:stop request is not yet completed; in some cases,
it may be necessary to manually kill the remaining jlinker processes.
Normally, the returned value is the stop
argument.
When the stop argument is the keyword
:abort, any attempt to stop the listeners is
terminated. This option is very likely to leave processes that must
be killed manually.
The process-function argument is a function of
one argument. It is called when jlinker-init returns after a new
server creation. The argument is the value returned by jlinker-init. If this
function returns nil, the jlinker-listen process exits and
no more servers will be created.
The stop argument is t to stop advertising after the next connection is made. A value of :stop stops advertising immediately but leaves active connections running. A value of :all stops advertising immediately and forces all the active connections to be killed.
The end-function is called with two arguments when the listener process exits for any reason. The first argument is a reason keyword and the second is a list of currently active connections.
The init-args argument is a list of keyword-value
pairs passed in a call to (jlinker-init :lisp-advertises
...).
The max-servers argument is the maximum number of simultaneous active server connections. When this number is reached, the advertised socket is disabled until one or more servers terminate.
The total-timeout argument may be a number of seconds for how long the advertised connection is made available.
See jlinker.htm for more information on the jLinker facility.
Copyright (c) 1998-2006, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 7.0. This page was not revised from the 6.2 page.
Created 2004.8.21.
| Allegro CL version 7.0 Unrevised from 6.2 to 7.0. | |||||||||