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 "config.h"
#include "net.h"

#ifndef WITHOUT_ASYNC

typedef struct coap_async_state_t {
  unsigned char flags;  
  coap_tick_t created;
  
  void *appdata;
  
  unsigned short message_id;    
  coap_tid_t id;        
  struct coap_async_state_t *next; 
  coap_address_t peer;      
  size_t tokenlen;      
  unsigned char token[];    
} 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_OBSERVED  0x04 
#define COAP_ASYNC_RELEASE_DATA  0x08

coap_async_state_t *
coap_register_async(coap_context_t *context, coap_address_t *peer,
            coap_pdu_t *request, unsigned char flags, void *data);

int coap_remove_async(coap_context_t *context, coap_tid_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_tid_t id);

static inline void
coap_touch_async(coap_async_state_t *s) { coap_ticks(&s->created); }

#endif /*  WITHOUT_ASYNC */

#endif /* _COAP_ASYNC_H_ */