FunctionPackage: net.rpcToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 8.2
Unrevised from 8.1 to 8.2.
8.1 version

client-exit

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

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.

The wait keyword argument

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 kill keyword argument

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-2012, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 8.2. This page was not revised from the 8.1 page.
Created 2010.1.21.

ToCDocOverviewCGDocRelNotesFAQIndexPermutedIndex
Allegro CL version 8.2
Unrevised from 8.1 to 8.2.
8.1 version