async.h

Go to the documentation of this file.

/*
 * async.h -- state management for asynchronous messages
 *
 * Copyright (C) 2010-2011 Olaf Bergmann <bergmann@tzi.org>
 *
 * This file is part of the CoAP library libcoap. Please see README for terms
 * of use.
 */
 
#ifndef COAP_ASYNC_H_
#define COAP_ASYNC_H_
 
#include "coap2/net.h"
 
#ifndef WITHOUT_ASYNC
 
typedef struct coap_async_state_t {
  unsigned char flags;  
  coap_tick_t created;
 
  void *appdata;
  coap_session_t *session;         
  coap_mid_t id;                   
  struct coap_async_state_t *next; 
  size_t tokenlen;                 
  uint8_t token[8];                
} coap_async_state_t;
 
/* Definitions for Async Status Flags These flags can be used to control the
 * behaviour of asynchronous response generation.
 */
#define COAP_ASYNC_CONFIRM   0x01  
#define COAP_ASYNC_SEPARATE  0x02  
#define COAP_ASYNC_RELEASE_DATA  0x08
 
coap_async_state_t *
coap_register_async(coap_context_t *context,
                    coap_session_t *session,
                    coap_pdu_t *request,
                    unsigned char flags,
                    void *data);
 
int coap_remove_async(coap_context_t *context,
                      coap_session_t *session,
                      coap_mid_t id,
                      coap_async_state_t **s);
 
void
coap_free_async(coap_async_state_t *state);
 
coap_async_state_t *coap_find_async(coap_context_t *context, coap_session_t *session, coap_mid_t id);
 
COAP_STATIC_INLINE void
coap_touch_async(coap_async_state_t *s) { coap_ticks(&s->created); }
 
void
coap_delete_all_async(coap_context_t *context);
 
#endif /*  WITHOUT_ASYNC */
 
#endif /* COAP_ASYNC_H_ */