DragonFly On-Line Manual Pages

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
       connection 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 connection 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_disconnect 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)