| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |
Arguments: client &key wait kill
The kill argument was added in an update released in January, 2007.
This function causes a client image to exit. It returns one of the
keywords :terminating
,
:terminated
, :closing
, or
:closed
.
The client argument must be a client-lisp
instance. The wait
argument may be nil
, a positive integer, the
keyword :wait
, or any other non-nil
value.
If the client instance is already marked as terminated, the function
returns nil
immediately.
If the wait argument is nil
, the value returned is
:closing
. If the wait
argument is a positive integer, it is the number of seconds to wait.
If the wait argument is :wait
,
the wait interval is indefinite. If the wait argument is any other
non-nil
value, the wait interval is 30
seconds.
If at the end of the wait interval the connection to the client still
appears to be open, the value returned is :timeout
;
otherwise the value is :closed
.
The default behavior of client-exit (when kill
is nil
) is to call the client Lisp and
request that it terminate (if the keep flag, returned by client-lisp-keep, is nil
). When the kill argument is
non-nil
some more aggressive steps may be
taken, such as calling the Operating System kill command. The
table below lists the possible strategies.
Value of kill argument | Keep Flag Nil | Keep Flag T | ||
End with call | OS Kill | End with call | OS Kill | |
nil
|
yes | no | no | no |
:force
|
yes | no | yes | no |
:kill
|
no | yes | no | no |
:killall
|
no | yes | no | yes |
:all
|
yes | yes | yes | yes |
other non-nil
|
yes | yes | no | no |
See Running several communicating Allegro CL images in rpc.htm for information on running several Lisp images.
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 |