option.h

Go to the documentation of this file.

/*
 * option.h -- helpers for handling options in CoAP PDUs
 *
 * Copyright (C) 2010-2013 Olaf Bergmann <bergmann@tzi.org>
 *
 * This file is part of the CoAP library libcoap. Please see README for terms
 * of use.
 */

#ifndef COAP_OPTION_H_
#define COAP_OPTION_H_

#include "bits.h"
#include "pdu.h"

typedef uint8_t coap_opt_t;
#define PCHAR(p) ((coap_opt_t *)(p))

typedef struct {
  uint16_t delta;
  size_t length;
  const uint8_t *value;
} coap_option_t;

size_t coap_opt_parse(const coap_opt_t *opt,
                      size_t length,
                      coap_option_t *result);

size_t coap_opt_size(const coap_opt_t *opt);

#define COAP_OPT_FILTER_SHORT 6

#define COAP_OPT_FILTER_LONG  2

/* Ensure that COAP_OPT_FILTER_SHORT and COAP_OPT_FILTER_LONG are set
 * correctly. */
#if (COAP_OPT_FILTER_SHORT + COAP_OPT_FILTER_LONG > 16)
#error COAP_OPT_FILTER_SHORT + COAP_OPT_FILTER_LONG must be less or equal 16
#endif /* (COAP_OPT_FILTER_SHORT + COAP_OPT_FILTER_LONG > 16) */

#define COAP_OPT_FILTER_SIZE                                        \
  (((COAP_OPT_FILTER_SHORT + 1) >> 1) + COAP_OPT_FILTER_LONG) +1

typedef uint16_t coap_opt_filter_t[COAP_OPT_FILTER_SIZE];

#define COAP_OPT_ALL NULL

COAP_STATIC_INLINE void
coap_option_filter_clear(coap_opt_filter_t f) {
  memset(f, 0, sizeof(coap_opt_filter_t));
}

int coap_option_filter_set(coap_opt_filter_t filter, uint16_t type);

int coap_option_filter_unset(coap_opt_filter_t filter, uint16_t type);

int coap_option_filter_get(coap_opt_filter_t filter, uint16_t type);

COAP_STATIC_INLINE int
coap_option_setb(coap_opt_filter_t filter, uint16_t type) {
  return coap_option_filter_set(filter, type) ? 1 : -1;
}

COAP_STATIC_INLINE int
coap_option_clrb(coap_opt_filter_t filter, uint16_t type) {
  return coap_option_filter_unset(filter, type) ? 1 : -1;
}

COAP_STATIC_INLINE int
coap_option_getb(coap_opt_filter_t filter, uint16_t type) {
  return coap_option_filter_get(filter, type);
}

typedef struct {
  size_t length;                
  uint16_t type;                
  unsigned int bad:1;           
  unsigned int filtered:1;      
  coap_opt_t *next_option;      
  coap_opt_filter_t filter;     
} coap_opt_iterator_t;

coap_opt_iterator_t *coap_option_iterator_init(const coap_pdu_t *pdu,
                                               coap_opt_iterator_t *oi,
                                               const coap_opt_filter_t filter);

coap_opt_t *coap_option_next(coap_opt_iterator_t *oi);

coap_opt_t *coap_check_option(coap_pdu_t *pdu,
                              uint16_t type,
                              coap_opt_iterator_t *oi);

size_t coap_opt_setheader(coap_opt_t *opt,
                          size_t maxlen,
                          uint16_t delta,
                          size_t length);

size_t coap_opt_encode_size(uint16_t delta, size_t length);

size_t coap_opt_encode(coap_opt_t *opt,
                       size_t n,
                       uint16_t delta,
                       const uint8_t *val,
                       size_t length);

uint16_t coap_opt_delta(const coap_opt_t *opt);

uint16_t coap_opt_length(const coap_opt_t *opt);

const uint8_t *coap_opt_value(const coap_opt_t *opt);

typedef struct coap_optlist_t {
  struct coap_optlist_t *next;  
  uint16_t number;              
  size_t length;                
  uint8_t *data;                
} coap_optlist_t;

coap_optlist_t *coap_new_optlist(uint16_t number,
                                 size_t length,
                                 const uint8_t *data);

int coap_add_optlist_pdu(coap_pdu_t *pdu, coap_optlist_t** optlist_chain);

int coap_insert_optlist(coap_optlist_t **optlist_chain,
                        coap_optlist_t *optlist);

void coap_delete_optlist(coap_optlist_t *optlist_chain);

#endif /* COAP_OPTION_H_ */