Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | BUGS | AUTHOR | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=SP_kill&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help