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 "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_ */