| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |
Arguments: &key wait server lisp-file lisp-port verbose error-p
This function ends a connection.
If lisp-port is non-nil
,
the lisp-file argument is ignored; the function
attempts to stop advertising at the given port. If
port is nil
but
lisp-file is non-nil
,
then the function attempts to stop advertising at the port specified
in the file. If the wait argument is nil
, the function returns before the attempts are
completed but the attempts continue.
If the wait argument is non-nil
(the default) or if the
lisp-port or lisp-file
arguments are omitted, then this function attempts to close down a
connection between Lisp and Java. If a graceful disconnect fails, the
connection is aborted unilaterally. If the wait
argument is nil
, return while attempted
disconnects are going on, otherwise return only when the connection is
shut down completely.
It is important to call jlinker-end before calling jlinker-init again even if the connection appears to be broken already.
The following keyword arguments alter the behavior jlinker-end:
verbose
: When t
, emit
status and warning messages. The default is the value of *jlinker-verbose*
.
error-p
: this argument determines the behavior of
jlinker-end
when an error occurs. If the value of this argument is true, an error
of type jlinker-error
is signaled. If the
value is nil
, no error is signaled. This
argument defaults to the value of *jlinker-error-p*
.
jlinker-end returns one of the following values:
:jlinker-end
: jlinker connection is properly shut
down in response to this call
:wait
: jlinker connection was shutdown in
another process; this call was waiting for it to finish because
wait is true
:busy
: jlinker shutdown is in progress already in
another process, return immediately because wait
is nil
nil
: immediate return because there is no
jlinker connection at all
nil
but wait is nil
nil
and error-p is nil
and an error occurred. The list contains
information about the error. The value of wait
does not affect this case.
jlinker-error
signaled so no
value returned]: lisp-file or
lisp-port arguments non-nil
and error-p is true and an
error occurred. The value of wait does not
affect this case.
See jlinker.htm for more information on the jLinker facility.
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 |