cpg_zcb_mcast_joined(3) [centos man page]

CPG_ZCB_MCAST_JOINED(3) 			    Corosync Cluster Engine Programmer's Manual 			   CPG_ZCB_MCAST_JOINED(3)

NAME

       cpg_mcast_joined - Multicasts a zero copy buffer to all groups joined to a handle

SYNOPSIS

       #include <sys/uio.h> #include <corosync/cpg.h>

       int cpg_zcb_mcast_joined(cpg_handle_t handle, cpg_guarantee_t guarantee, const void *buffer,int msg_len );

DESCRIPTION

       The cpg_zcb_mcast_joined function will multicast a zero copy buffer message to all the processes that have been joined with the cpg_join(3)
       funtion for the same group name.  Messages that are sent to any of the groups joined to the parameter handle will be delivered to all  sub-
       scribed processes in the system.

       The argument guarantee requests a delivery guarantee for the message to be sent.  The cpg_guarantee_t type is defined by:

	      typedef enum {
		      CPG_TYPE_UNORDERED,     /* not implemented */
		      CPG_TYPE_FIFO,	      /* same as agreed */
		      CPG_TYPE_AGREED,	      /* implemented */
		      CPG_TYPE_SAFE	      /* not implemented */
	      } cpg_guarantee_t;

       The meanings of the cpg_guarantee_t typedef are:

       CPG_TYPE_UNORDERED
	      Messages are guaranteed to be delivered, but with no particular order.  This mode is unimplemented in the CPG library.

       CPG_TYPE_FIFO
	      Messages	are  guaranteed  to  be  delivered  in	first  sent  first  delivery  order.  In fact, this guarantee is equivalent to the
	      CPG_TYPE_AGREED guarantee.

       CPG_TYPE_AGREED
	      All processors must agree on the order of delivery.  If a message is sent from two or more processes at about  the  same	time,  the
	      delivery will occur in the same order to all processes.

       CPG_TYPE_SAFE
	      All  processes must agree on the order of delivery.  Further all processes must have a copy of the message before any delivery takes
	      place.  This mode is unimplemented in the CPG library.

       The msg argument describes the zero copy buffer which is used to transmit a message.  this buffer must be allocated by cpg_zcb_alloc(3).

       The msg_len argument describes the number of bytes to be transmitted in the zero copy buffer.

RETURN VALUE

       This call returns the CS_OK value if successful, otherwise an error is returned.

ERRORS

       The errors are undocumented.

SEE ALSO

       cpg_overview(8),  cpg_initialize(3),  cpg_finalize(3),  cpg_fd_get(3),  cpg_dispatch(3),  cpg_join(3),  cpg_leave(3),  cpg_mcast_joined(3),
       cpg_membership_get(3) cpg_zcb_alloc(3) cpg_zcb_free(3) cpg_zcb_mcast_joined(3) cpg_context_get(3) cpg_context_set(3) cpg_local_get(3)

       CS_ERR_TRY_AGAIN Resource temporarily unavailable

       CS_ERR_INVALID_PARAM Invalid argument

       CS_ERR_ACCESS Permission denied

       CS_ERR_LIBRARY The connection failed

       CS_ERR_INTERRUPT System call inturrupted by a signal

       CS_ERR_NOT_SUPPORTED The requested protocol/functuality not supported

       CS_ERR_MESSAGE_ERROR Incorrect auth message received

       CS_ERR_NO_MEMORY Not enough memory to completed the requested task

corosync Man Page						    3004-08-31						   CPG_ZCB_MCAST_JOINED(3)

Check Out this Related Man Page

EVS_MCAST_GROUPS(3)				    Corosync Cluster Engine Programmer's Manual 			       EVS_MCAST_GROUPS(3)

NAME

       evs_join - Multicast a message to selected groups

SYNOPSIS

       #include <sys/uio.h> #include <corosync/evs.h>

       int  evs_mcast_groups(evs_handle_t  handle,  evs_guraantee_t  guarantee,  evs_group_t  *groups, int group_entries, struct iovec *iovec, int
       iov_len);

DESCRIPTION

       The evs_mcast_groups(3) function multicasts a message to all the groups specified in the arguemnt groups.  Messages are	delivered  to  all
       processors in the system that are described by the current configuration.

       The argument handle describes a handle created with evs_initialize(3).

       The argument guarantee requests a delivery guarantee for the message to be sent.  The evs_guarantee_t type is defined by:

	      typedef enum {
		  EVS_TYPE_UNORDERED,	    /* not implemented */
		  EVS_TYPE_FIFO,	  /* same as agreed */
		  EVS_TYPE_AGREED,	    /* implemented */
		  EVS_TYPE_SAFE 	  /* not implemented */
	      } evs_guarantee_t;

       The meanings of the evs_guarantee_t typedef are:

       EVS_GUARANTEE_UNORDERED
	      Messages are guaranteed to be delivered, but with no particular order.  This mode is unimplemented in the EVS library.

       EVS_GUARANTEE_FIFO
	      Messages	are  guaranteed  to be delivered in first sent first delivery order from one one.  In fact, this guarantee is actually the
	      AGREED guarantee.

       EVS_GUARANTEE_AGREED
	      All processors must agree on the order of delivery.  If a message is sent from two or more processors at about the  same	time,  the
	      delivery will occur in the same order to all processors.

       EVS_GUARANTEE_SAFE
	      All  processors  must  agree  on	the order of delivery.	Further all processors must have a copy of the message before any delivery
	      takes place.  This mode is unimplemented in the EVS library.

       The groups argument is of the type evs_group_t which is defined by the structure:

	      typedef struct {
		  char key[32];
	      } evs_groups_t;

       The group_entries argument describes the number of entries in the group argument.

       The iovec argument describes the scatter/gather list which is used to transmit a message.  This is a standard  socket  structure  described
       by:

	      struct iovec
	      {
		  void *iov_base;     /* Pointer to data.  */
		  unsigned int iov_len;     /* Length of data.	*/
	      };

       The iovlen argument describes the number of entires in the iovec argument.

RETURN VALUE

       This call returns the EVS_OK value if successful, otherwise an error is returned.

ERRORS

       The errors are undocumented.

SEE ALSO

       evs_overview(8),  evs_initialize(3),  evs_finalize(3),  evs_fd_get(3),  evs_dispatch(3),  evs_leave(3),	evs_join(3),  evs_mcast_joined(3),
       evs_mmembership_get(3) evs_context_get(3) evs_context_set(3)

corosync Man Page						    2004-08-31						       EVS_MCAST_GROUPS(3)

Linux and UNIX Man Pages

cpg_zcb_mcast_joined(3) [centos man page]

Check Out this Related Man Page