|
|
SP_DISCONNECT(3) User Manuals SP_DISCONNECT(3)
NAME
SP_kill - close a client side connection without notifying the daemon.
SYNOPSIS
#include <sp.h>
int SP_kill( mailbox mbox);
DESCRIPTION
SP_kill should be called when the application needs to close a connec‐
tion to the Spread daemon, but does not want to notify the daemon about
the close. The most common case of needing this is when a Spread client
application calls the unix function fork() and needs to close the con‐
nection in either the parent or child since the other will handle the
communcation.
Generally the SP_disconnect() function should be used to disconnect
from the daemon as it correctly and expediently notifies the daemon
about the disconnection. If a client calls SP_kill instead of SP_dis‐
connect when no other process has the client side mbox open (because of
fork) then the network connection to the daemon will be closed and the
daemon will detect the client as disconnected as soon as the network
layer (TCP) registers a closed socket on the daemon side. Thus it will
appear to the daemon as if a true network fault occurred or the client
crashed as opposed to cleanly disconnecting.
The mbox should be for the connection you wish to close the mbox on.
RETURN VALUES
Returns 0 on success or ILLEGAL_SESSION when the session mbox given is
not a valid connection.
BUGS
None.
AUTHOR
Yair Amir <yairamir@cnds.jhu.edu>
Jonathan Stanton <jonathan@cnds.jhu.edu>
SEE ALSO
libspread(3)
SPREAD JULY 2005 SP_DISCONNECT(3)
[top]
|
Vote for polarhome |
