[Spread-cvs] commit: r262 - trunk/docs

jonathan at spread.org jonathan at spread.org
Mon Aug 8 00:53:24 EDT 2005


Author: jonathan
Date: 2005-08-08 00:53:24 -0400 (Mon, 08 Aug 2005)
New Revision: 262

Added:
   trunk/docs/SP_get_first_vs_set_offset_memb_mess.3
   trunk/docs/SP_get_gid_offset_memb_mess.3
   trunk/docs/SP_get_local_vs_set_offset_memb_mess.3
   trunk/docs/SP_get_local_vs_set_offset_memb_scat.3
   trunk/docs/SP_get_num_vs_sets_offset_memb_mess.3
   trunk/docs/SP_get_vs_set_members_offset_vs_set.3
   trunk/docs/SP_get_vs_set_size_offset_vs_set.3
   trunk/docs/SP_kill.3
   trunk/docs/SP_version.3
Modified:
   trunk/docs/SP_disconnect.3
Log:
Update man pages for SP_ functions and add new pages for SP_get_* 
functions that query the location of fields in the body of
membership messages.


Modified: trunk/docs/SP_disconnect.3
===================================================================
--- trunk/docs/SP_disconnect.3	2005-08-08 04:13:53 UTC (rev 261)
+++ trunk/docs/SP_disconnect.3	2005-08-08 04:53:24 UTC (rev 262)
@@ -15,6 +15,15 @@
 other connections still open to the daemon and may open a new
 connection after disconnecting.
 
+If any SP_ function returns a 
+.B CONNECTION_CLOSED
+or 
+.B NET_ERRROR_ON_SESSION
+error on any call, then the mailbox cannot be used anymore
+until it is disconnected with a call to this function and then
+reconnected by calling SP_connect(). Any other SP_ calls
+will only immediately return the same error value. 
+ 
 The 
 .I mbox 
 should be for the connection you wish to disconnect from.

Added: trunk/docs/SP_get_first_vs_set_offset_memb_mess.3
===================================================================
--- trunk/docs/SP_get_first_vs_set_offset_memb_mess.3	2005-08-08 04:13:53 UTC (rev 261)
+++ trunk/docs/SP_get_first_vs_set_offset_memb_mess.3	2005-08-08 04:53:24 UTC (rev 262)
@@ -0,0 +1,26 @@
+.\" Process this file with
+.\" groff -man -Tascii foo.1
+.\"
+.TH SP_ERROR 3 "JULY 2005" SPREAD "User Manuals"
+.SH NAME
+SP_get_first_vs_set_offset_memb_mess \- Offset to first VS Set in Membership message
+.SH SYNOPSIS
+.B #include <sp.h>
+.br
+.BI "int SP_get_first_vs_set_offset_memb_mess( void );"
+.SH DESCRIPTION
+.B SP_get_first_vs_set_offset_memb_mess
+returns the byte offset of the beginning of the first VS set stored in the membership mesage.
+.SH "RETURN VALUES"
+Returns value.
+.SH BUGS
+None.
+.SH AUTHOR
+Yair Amir <yairamir at cnds.jhu.edu>
+.br
+Jonathan Stanton <jonathan at cnds.jhu.edu>
+.br
+Commedia Project <commedia at cnds.jhu.edu>
+.SH "SEE ALSO"
+.BR libsp(3)
+

Added: trunk/docs/SP_get_gid_offset_memb_mess.3
===================================================================
--- trunk/docs/SP_get_gid_offset_memb_mess.3	2005-08-08 04:13:53 UTC (rev 261)
+++ trunk/docs/SP_get_gid_offset_memb_mess.3	2005-08-08 04:53:24 UTC (rev 262)
@@ -0,0 +1,26 @@
+.\" Process this file with
+.\" groff -man -Tascii foo.1
+.\"
+.TH SP_ERROR 3 "JULY 2005" SPREAD "User Manuals"
+.SH NAME
+SP_get_gid_offset_memb_mess \- Group ID offset in Membership message
+.SH SYNOPSIS
+.B #include <sp.h>
+.br
+.BI "int SP_get_gid_offset_memb_mess( void );"
+.SH DESCRIPTION
+.B SP_get_gid_offset_memb_mess
+returns the byte offset of the group ID field in the body of a membership message.
+.SH "RETURN VALUES"
+Returns value.
+.SH BUGS
+None.
+.SH AUTHOR
+Yair Amir <yairamir at cnds.jhu.edu>
+.br
+Jonathan Stanton <jonathan at cnds.jhu.edu>
+.br
+Commedia Project <commedia at cnds.jhu.edu>
+.SH "SEE ALSO"
+.BR libsp(3)
+

Added: trunk/docs/SP_get_local_vs_set_offset_memb_mess.3
===================================================================
--- trunk/docs/SP_get_local_vs_set_offset_memb_mess.3	2005-08-08 04:13:53 UTC (rev 261)
+++ trunk/docs/SP_get_local_vs_set_offset_memb_mess.3	2005-08-08 04:53:24 UTC (rev 262)
@@ -0,0 +1,30 @@
+.\" Process this file with
+.\" groff -man -Tascii foo.1
+.\"
+.TH SP_ERROR 3 "JULY 2005" SPREAD "User Manuals"
+.SH NAME
+SP_get_local_vs_set_offset_memb_mess \- Offset to beginning of local VS Set in Membership message
+.SH SYNOPSIS
+.B #include <sp.h>
+.br
+.BI "int SP_get_local_vs_set_offset_memb_mess( char *" reg_memb_mess );
+.SH DESCRIPTION
+.B SP_get_local_vs_set_offset_memb_mess
+returns the byte offset of the beginning of the local client's VS Set in the body of a membership message.
+Unlike other SP_get_* functions, the value returned can be different for every receiver. 
+The 
+.I reg_memb_mess 
+should be the body of a received membership message. 
+.SH "RETURN VALUES"
+Returns value.
+.SH BUGS
+None.
+.SH AUTHOR
+Yair Amir <yairamir at cnds.jhu.edu>
+.br
+Jonathan Stanton <jonathan at cnds.jhu.edu>
+.br
+Commedia Project <commedia at cnds.jhu.edu>
+.SH "SEE ALSO"
+.BR libsp(3)
+

Added: trunk/docs/SP_get_local_vs_set_offset_memb_scat.3
===================================================================
--- trunk/docs/SP_get_local_vs_set_offset_memb_scat.3	2005-08-08 04:13:53 UTC (rev 261)
+++ trunk/docs/SP_get_local_vs_set_offset_memb_scat.3	2005-08-08 04:53:24 UTC (rev 262)
@@ -0,0 +1,30 @@
+.\" Process this file with
+.\" groff -man -Tascii foo.1
+.\"
+.TH SP_ERROR 3 "JULY 2005" SPREAD "User Manuals"
+.SH NAME
+SP_get_local_vs_set_offset_memb_mess \- Offset to beginning of local VS Set in Membership message
+.SH SYNOPSIS
+.B #include <sp.h>
+.br
+.BI "int SP_get_local_vs_set_offset_memb_scat( const scatter *" reg_memb_scat );
+.SH DESCRIPTION
+.B SP_get_local_vs_set_offset_memb_scat
+returns the byte offset of the beginning of the local client's VS Set in the body of a membership message.
+Unlike other SP_get_* functions, the value returned can be different for every receiver. 
+The 
+.I reg_memb_scat
+should be the scatter storing the body of a received membership message. 
+.SH "RETURN VALUES"
+Returns value.
+.SH BUGS
+None.
+.SH AUTHOR
+Yair Amir <yairamir at cnds.jhu.edu>
+.br
+Jonathan Stanton <jonathan at cnds.jhu.edu>
+.br
+Commedia Project <commedia at cnds.jhu.edu>
+.SH "SEE ALSO"
+.BR libsp(3)
+

Added: trunk/docs/SP_get_num_vs_sets_offset_memb_mess.3
===================================================================
--- trunk/docs/SP_get_num_vs_sets_offset_memb_mess.3	2005-08-08 04:13:53 UTC (rev 261)
+++ trunk/docs/SP_get_num_vs_sets_offset_memb_mess.3	2005-08-08 04:53:24 UTC (rev 262)
@@ -0,0 +1,27 @@
+.\" Process this file with
+.\" groff -man -Tascii foo.1
+.\"
+.TH SP_ERROR 3 "JULY 2005" SPREAD "User Manuals"
+.SH NAME
+SP_get_offset_to_local_vs_set_offset \- Offset to integer storing the offset to the local VS Set in Membership message
+.SH SYNOPSIS
+.B #include <sp.h>
+.br
+.BI "int SP_get_offset_to_local_vs_set_offset( void );"
+.SH DESCRIPTION
+.B SP_get_offset_to_local_vs_set_offset
+returns the byte offset of the integer storing the offset that locates the local VS Set belonging to the client who 
+received the membership message. This value could be different for each receiver. 
+.SH "RETURN VALUES"
+Returns value.
+.SH BUGS
+None.
+.SH AUTHOR
+Yair Amir <yairamir at cnds.jhu.edu>
+.br
+Jonathan Stanton <jonathan at cnds.jhu.edu>
+.br
+Commedia Project <commedia at cnds.jhu.edu>
+.SH "SEE ALSO"
+.BR libsp(3)
+

Added: trunk/docs/SP_get_vs_set_members_offset_vs_set.3
===================================================================
--- trunk/docs/SP_get_vs_set_members_offset_vs_set.3	2005-08-08 04:13:53 UTC (rev 261)
+++ trunk/docs/SP_get_vs_set_members_offset_vs_set.3	2005-08-08 04:53:24 UTC (rev 262)
@@ -0,0 +1,27 @@
+.\" Process this file with
+.\" groff -man -Tascii foo.1
+.\"
+.TH SP_ERROR 3 "JULY 2005" SPREAD "User Manuals"
+.SH NAME
+SP_get_vs_set_members_offset_vs_set \- Offset to member list of current VS Set in Membership message
+.SH SYNOPSIS
+.B #include <sp.h>
+.br
+.BI "int SP_get_vs_set_members_offset_vs_set( void );"
+.SH DESCRIPTION
+.B SP_get_vs_set_members_offset_vs_set
+returns the byte offset to the member list of a VS set stored in the membership mesage. The
+offset is relative to the beginning of the specific VS set entry. 
+.SH "RETURN VALUES"
+Returns value.
+.SH BUGS
+None.
+.SH AUTHOR
+Yair Amir <yairamir at cnds.jhu.edu>
+.br
+Jonathan Stanton <jonathan at cnds.jhu.edu>
+.br
+Commedia Project <commedia at cnds.jhu.edu>
+.SH "SEE ALSO"
+.BR libsp(3)
+

Added: trunk/docs/SP_get_vs_set_size_offset_vs_set.3
===================================================================
--- trunk/docs/SP_get_vs_set_size_offset_vs_set.3	2005-08-08 04:13:53 UTC (rev 261)
+++ trunk/docs/SP_get_vs_set_size_offset_vs_set.3	2005-08-08 04:53:24 UTC (rev 262)
@@ -0,0 +1,27 @@
+.\" Process this file with
+.\" groff -man -Tascii foo.1
+.\"
+.TH SP_ERROR 3 "JULY 2005" SPREAD "User Manuals"
+.SH NAME
+SP_get_vs_set_size_offset_vs_set \- Offset to size of current VS Set in Membership message
+.SH SYNOPSIS
+.B #include <sp.h>
+.br
+.BI "int SP_get_vs_set_size_offset_vs_set( void );"
+.SH DESCRIPTION
+.B SP_get_vs_set_size_offset_vs_set
+returns the byte offset to the size field of a VS set stored in the membership mesage. The
+offset is relative to the beginning of the specific VS set entry. 
+.SH "RETURN VALUES"
+Returns value.
+.SH BUGS
+None.
+.SH AUTHOR
+Yair Amir <yairamir at cnds.jhu.edu>
+.br
+Jonathan Stanton <jonathan at cnds.jhu.edu>
+.br
+Commedia Project <commedia at cnds.jhu.edu>
+.SH "SEE ALSO"
+.BR libsp(3)
+

Added: trunk/docs/SP_kill.3
===================================================================
--- trunk/docs/SP_kill.3	2005-08-08 04:13:53 UTC (rev 261)
+++ trunk/docs/SP_kill.3	2005-08-08 04:53:24 UTC (rev 262)
@@ -0,0 +1,51 @@
+.\" Process this file with
+.\" groff -man -Tascii foo.1
+.\"
+.TH SP_DISCONNECT 3 "JULY 2005" SPREAD "User Manuals"
+.SH NAME
+SP_kill \- close a client side connection without notifying the daemon. 
+.SH SYNOPSIS
+.B #include <sp.h>
+.br
+.BI "int SP_kill( mailbox " mbox );
+.SH DESCRIPTION
+.B 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 clienta application calls the unix function 
+.B fork()
+and needs to close the connection in either the parent or child since the other
+will handle the communcation. 
+
+Generally the 
+.B 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 
+.B 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 
+.I mbox 
+should be for the connection you wish to close the mbox on.
+.SH "RETURN VALUES"
+Returns 0 on success or 
+.B ILLEGAL_SESSION
+when the session 
+.I mbox
+given is not a valid connection.
+.SH BUGS
+None.
+.SH AUTHOR
+Yair Amir <yairamir at cnds.jhu.edu>
+.br
+Jonathan Stanton <jonathan at cnds.jhu.edu>
+.br
+Commedia Project <commedia at cnds.jhu.edu>
+.SH "SEE ALSO"
+.BR libsp (3)
+

Added: trunk/docs/SP_version.3
===================================================================
--- trunk/docs/SP_version.3	2005-08-08 04:13:53 UTC (rev 261)
+++ trunk/docs/SP_version.3	2005-08-08 04:53:24 UTC (rev 262)
@@ -0,0 +1,28 @@
+.\" Process this file with
+.\" groff -man -Tascii foo.1
+.\"
+.TH SP_POLL 3 "JULY 2005" SPREAD "User Manuals"
+.SH NAME
+SP_version \- returns the three component version number of the Spread library
+.SH SYNOPSIS
+.B #include <sp.h>
+.br
+.BI "int SP_version( int *" major_version, "int *" minor_version, "int *" patch_version );
+.SH DESCRIPTION
+.B SP_version
+is a way to retrieve the current version of the Spread library that is linked with the client
+application. This may not be the same version number as the daemon that the client connects
+to. This function does not require any network communication. 
+.SH "RETURN VALUES"
+Returns 0 if the parameters are invalid pointers, or returns one and sets the parameters to appropriate version numbers if they are valid.
+.SH BUGS
+None.
+.SH AUTHOR
+Yair Amir <yairamir at cnds.jhu.edu>
+.br
+Jonathan Stanton <jonathan at cnds.jhu.edu>
+.br
+Commedia Project <commedia at cnds.jhu.edu>
+.SH "SEE ALSO"
+.BR libsp (3)
+




More information about the Spread-cvs mailing list