GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  SP_KILL (3)

NAME

SP_kill - close a client side connection without notifying the daemon.

CONTENTS

Synopsis
Description
Bugs
Author

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)

Search for    or go to Top of page |  Section 3 |  Main Index


SPREAD SP_DISCONNECT (3) JULY 2005

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.