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

  
 
  

home | help
CMAP_DISPATCH(3)   Corosync Cluster Engine Programmer's Manual	CMAP_DISPATCH(3)

NAME
     cmap_dispatch - Dispatches callbacks from the CMAP service

SYNOPSIS
     #include <corosync/cmap.h>

     cs_error_t  cmap_dispatch	(cmap_handle_t	handle, cs_dispatch_flags_t dis-
     patch_types);

DESCRIPTION
     The cmap_dispatch function is used to dispatch configuration changes.

     Each application may have several connections to the CMAP API.  Each appli-
     cation uses the handle argument to uniquely identify the connection.

     The dispatch_types argument is used to identify the type of dispatch to ex-
     ecute.  The possible types are CS_DISPATCH_ONE, CS_DISPATCH_ALL and CS_DIS-
     PATCH_BLOCKING.

     The dispatch values have the following meanings:

     CS_DISPATCH_ONE
	    Dispatch at least one callback, blocking until the callback is  dis-
	    patched.

     CS_DISPATCH_ALL
	    Dispatch  all  waiting  callbacks  without	blocking to wait for any
	    callbacks.

     CS_DISPATCH_BLOCKING
	    Dispatch all callbacks blocking indefinitely.  This  is  used  in  a
	    threaded  program  where a thread is created, and then cs_dispatch()
	    is called immediately from the created thread to execute callbacks.

     CS_DISPATCH_ONE_NONBLOCKING
	    Dispatch at most one callback. If  there  is  no  pending  callback,
	    CS_ERR_TRY_AGAIN is returned.

     It's  needed  to  call  cmap_track_add(3)	to add tracked items and receive
     callbacks.

RETURN VALUE
     This call returns the CS_OK value if successful, otherwise an error is  re-
     turned.

SEE ALSO
     cmap_track_add(3), cmap_track_delete(3), cmap_overview(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 interrupted by a signal

     CS_ERR_NOT_SUPPORTED The requested protocol/functionality not supported

     CS_ERR_MESSAGE_ERROR Incorrect auth message received

     CS_ERR_NO_MEMORY Not enough memory to complete the requested task

corosync Man Page		   23/01/2012			CMAP_DISPATCH(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=cmap_dispatch&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help