include/tr_mq.h

   1 #ifndef _TR_MQ_H_
   2 #define _TR_MQ_H_
   3
   4 #include <talloc.h>
   5 #include <pthread.h>
   6
   7 /* msg for inter-thread messaging */
   8 typedef struct tr_mq_msg TR_MQ_MSG;
   9 struct tr_mq_msg {
  10   TR_MQ_MSG *next;
  11   char *message;
  12   void *p; /* payload */
  13   void (*p_free)(void *); /* function to free payload */
  14 };
  15
  16 /* message queue for inter-thread messaging */
  17
  18 typedef struct tr_mq TR_MQ;
  19 typedef void (*TR_MQ_NOTIFY_FN)(TR_MQ *, void *);
  20 struct tr_mq {
  21   pthread_mutex_t mutex;
  22   TR_MQ_MSG *head;
  23   TR_MQ_MSG *tail;
  24   TR_MQ_NOTIFY_FN notify_cb; /* callback when queue becomes non-empty */
  25   void *notify_cb_arg;
  26 };
  27
  28 /* message string for sending trpc messages */
  29 #define TR_MQMSG_TRPC_SEND "trpc send msg"
  30
  31 TR_MQ_MSG *tr_mq_msg_new(TALLOC_CTX *mem_ctx, const char *msg);
  32 void tr_mq_msg_free(TR_MQ_MSG *msg);
  33 const char *tr_mq_msg_get_message(TR_MQ_MSG *msg);
  34 void *tr_mq_msg_get_payload(TR_MQ_MSG *msg);
  35 void tr_mq_msg_set_payload(TR_MQ_MSG *msg, void *p, void (*p_free)(void *));
  36
  37
  38 TR_MQ *tr_mq_new(TALLOC_CTX *mem_ctx);
  39 void tr_mq_free(TR_MQ *mq);
  40 int tr_mq_lock(TR_MQ *mq);
  41 int tr_mq_unlock(TR_MQ *mq);
  42 void tr_mq_set_notify_cb(TR_MQ *mq, TR_MQ_NOTIFY_FN cb, void *arg);
  43 void tr_mq_append(TR_MQ *mq, TR_MQ_MSG *msg);
  44 TR_MQ_MSG *tr_mq_pop(TR_MQ *mq);
  45
  46 #endif /*_TR_MQ_H_ */