29#ifdef HAVE_SYS_UNISTD_H 
   30#include <sys/unistd.h> 
   33#ifdef HAVE_SYS_TYPES_H 
   36#ifdef HAVE_SYS_SOCKET_H 
   37#include <sys/socket.h> 
   39#ifdef HAVE_SYS_IOCTL_H 
   42#ifdef HAVE_NETINET_IN_H 
   43#include <netinet/in.h> 
   45#ifdef HAVE_ARPA_INET_H 
   51#ifdef COAP_EPOLL_SUPPORT 
   53#include <sys/timerfd.h> 
   67#include <lwip/timeouts.h> 
   68#include <lwip/tcpip.h> 
   71#ifndef INET6_ADDRSTRLEN 
   72#define INET6_ADDRSTRLEN 40 
   76#define min(a,b) ((a) < (b) ? (a) : (b)) 
   92#error FRAC_BITS must be less or equal 8 
   96#define Q(frac,fval) ((uint16_t)(((1 << (frac)) * fval.integer_part) + \ 
   97                                 ((1 << (frac)) * fval.fractional_part + 500)/1000)) 
 
  100#define ACK_RANDOM_FACTOR                                        \ 
  101  Q(FRAC_BITS, session->ack_random_factor) 
 
  104#define ACK_TIMEOUT Q(FRAC_BITS, session->ack_timeout) 
  118  unsigned int result = 0;
 
 
  167  if (node->
t < q->
t) {
 
  179  } 
while (q && q->
t <= node->
t);
 
 
  252  memset(node, 0, 
sizeof(*node));
 
 
  280#if COAP_CLIENT_SUPPORT 
  308#if COAP_SERVER_SUPPORT 
  356  memset(&setup_data, 0, 
sizeof(setup_data));
 
  362  if (key && key_len > 0) {
 
  412    coap_log_err(
"coap_context_set_pki: Wrong version of setup_data\n");
 
  425                              const char *ca_dir) {
 
 
  437                                  const char *ca_dir) {
 
 
  470#if COAP_CLIENT_SUPPORT 
 
  481                                size_t max_token_size) {
 
 
  489                                   unsigned int max_idle_sessions) {
 
 
  500                                        unsigned int max_handshake_sessions) {
 
 
  513                             unsigned int csm_timeout) {
 
 
  526                                unsigned int csm_timeout_ms) {
 
  527  if (csm_timeout_ms < 10)
 
  529  if (csm_timeout_ms > 10000)
 
  530    csm_timeout_ms = 10000;
 
 
  541                                      uint32_t csm_max_message_size) {
 
  542  assert(csm_max_message_size >= 64);
 
  543  if (csm_max_message_size > COAP_DEFAULT_MAX_PDU_RX_SIZE) {
 
  544    csm_max_message_size = COAP_DEFAULT_MAX_PDU_RX_SIZE;
 
  546                   csm_max_message_size);
 
 
  559                                 unsigned int session_timeout) {
 
 
  565                                        unsigned int reconnect_time) {
 
  566#if COAP_CLIENT_SUPPORT 
  570  (void)reconnect_time;
 
 
  581#if COAP_SERVER_SUPPORT 
 
  590#if COAP_EPOLL_SUPPORT 
  591  return context->epfd;
 
 
  600#if COAP_EPOLL_SUPPORT 
 
  636#if COAP_CLIENT_SUPPORT 
 
  645#if COAP_SERVER_SUPPORT 
 
  654#if COAP_AF_UNIX_SUPPORT 
 
  692  context->
app_cb = app_data ? callback : NULL;
 
 
  700#if ! COAP_SERVER_SUPPORT 
  706    coap_log_warn(
"coap_startup() should be called before any other " 
  707                  "coap_*() functions are called\n");
 
  718#ifdef COAP_EPOLL_SUPPORT 
  719  c->epfd = epoll_create1(0);
 
  721    coap_log_err(
"coap_new_context: Unable to epoll_create: %s (%d)\n",
 
  727    c->eptimerfd = timerfd_create(CLOCK_REALTIME, TFD_NONBLOCK);
 
  728    if (c->eptimerfd == -1) {
 
  729      coap_log_err(
"coap_new_context: Unable to timerfd_create: %s (%d)\n",
 
  735      struct epoll_event event;
 
  738      memset(&event, 0, 
sizeof(event));
 
  739      event.events = EPOLLIN;
 
  741      event.data.ptr = NULL;
 
  743      ret = epoll_ctl(c->epfd, EPOLL_CTL_ADD, c->eptimerfd, &event);
 
  767#if COAP_SERVER_SUPPORT 
  770    if (endpoint == NULL) {
 
  781#if defined(COAP_EPOLL_SUPPORT) || COAP_SERVER_SUPPORT 
 
  817#if COAP_SERVER_SUPPORT 
  828  if (context->timer_configured) {
 
  830    sys_untimeout(coap_io_process_timeout, (
void *)context);
 
  832    context->timer_configured = 0;
 
  836#if COAP_ASYNC_SUPPORT 
  837  coap_delete_all_async(context);
 
  840#if COAP_OSCORE_SUPPORT 
  844#if COAP_SERVER_SUPPORT 
  848  HASH_ITER(hh, context->
cache, cp, ctmp) {
 
  855  LL_FOREACH_SAFE(context->
endpoint, ep, tmp) {
 
  860#if COAP_CLIENT_SUPPORT 
  870#ifdef COAP_EPOLL_SUPPORT 
  871  if (context->eptimerfd != -1) {
 
  873    struct epoll_event event;
 
  876    ret = epoll_ctl(context->epfd, EPOLL_CTL_DEL, context->eptimerfd, &event);
 
  882    close(context->eptimerfd);
 
  883    context->eptimerfd = -1;
 
  885  if (context->epfd != -1) {
 
  886    close(context->epfd);
 
  890#if COAP_SERVER_SUPPORT 
  891#if COAP_WITH_OBSERVE_PERSIST 
  895#if COAP_PROXY_SUPPORT 
  896  coap_proxy_cleanup(context);
 
 
  920    switch (opt_iter.
number) {
 
  941    if (opt_iter.
number & 0x01) {
 
  943      switch (opt_iter.
number) {
 
  944#if COAP_Q_BLOCK_SUPPORT 
  974#if COAP_OSCORE_SUPPORT 
  981#if COAP_SERVER_SUPPORT 
  982          if ((opt_iter.
number & 0x02) == 0) {
 
 1013    if (last_number == opt_iter.
number) {
 
 1031          unsigned char buf[4];
 
 1033          coap_log_debug(
"Option Block2 has invalid set M bit - cleared\n");
 
 1050    last_number = opt_iter.
number;
 
 
 1098  ssize_t bytes_written = -1;
 
 1106  return bytes_written;
 
 
 1111  ssize_t bytes_written;
 
 1114#if ! COAP_CLIENT_SUPPORT 
 1126    coap_log_err(
"Multicast requests cannot be Confirmable (RFC7252 8.1)\n");
 
 1145  return bytes_written;
 
 
 1220  unsigned int result;
 
 1223#define FP1 Q(FRAC_BITS, ((coap_fixed_point_t){1,0})) 
 1226#define SHR_FP(val,frac) (((val) + (1 << ((frac) - 1))) >> (frac)) 
 
 1272  coap_log_debug(
"** %s: mid=0x%04x: added to retransmit queue (%ums)\n",
 
 
 1282#if COAP_CLIENT_SUPPORT 
 1303  if (token == NULL) {
 
 1308    token->
s[i] = (uint8_t)(i + 1);
 
 1324    LL_PREPEND(session->
lg_crcv, lg_crcv);
 
 1336#if COAP_CLIENT_SUPPORT 
 1338    int timeout_ms = 5000;
 
 1370      if (result < timeout_ms) {
 
 1371        timeout_ms -= result;
 
 
 1425#if COAP_CLIENT_SUPPORT 
 1440#
if COAP_OSCORE_SUPPORT
 
 1441      session->oscore_encryption ||
 
 1446#
if COAP_Q_BLOCK_SUPPORT
 
 1469#if COAP_CLIENT_SUPPORT 
 1473  int observe_action = -1;
 
 1474  int have_block1 = 0;
 
 1484    coap_log_err(
"coap_send: Invalid PDU code (%d.%02d)\n",
 
 1490#if COAP_CLIENT_SUPPORT 
 1543#if COAP_OSCORE_SUPPORT 
 1544  if (session->oscore_encryption) {
 
 1545    if (session->recipient_ctx->initial_state == 1) {
 
 1575        (block.
m == 1 || block.
bert == 1)) {
 
 1578#if COAP_Q_BLOCK_SUPPORT 
 1580        (block.
m == 1 || block.
bert == 1)) {
 
 1582        coap_log_warn(
"Block1 and Q-Block1 cannot be in the same request\n");
 
 1597          scratch[0] = 
'\000';
 
 1599            size = strlen(scratch);
 
 1600            snprintf(&scratch[size], 
sizeof(scratch)-size,
 
 1603          coap_log_debug(
"Token {%s} reused - see https://rfc-editor.org/rfc/rfc9175.html#section-4.2\n",
 
 1615      coap_log_debug(
"coap_send: Using coap_cancel_observe() to do OBSERVE cancellation\n");
 
 1636    memset(&block, 0, 
sizeof(block));
 
 1639#if COAP_Q_BLOCK_SUPPORT 
 1656#if COAP_Q_BLOCK_SUPPORT 
 1657  if (!(session->
block_mode & COAP_BLOCK_HAS_Q_BLOCK))
 
 1667                                              (block.
num << 4) | (0 << 3) | block.
szx),
 
 1673      LL_FOREACH(session->
lg_xmit, lg_xmit) {
 
 1681                                                  (block.
num << 4) | (0 << 3) | block.
szx),
 
 1691                                              (block.
num << 4) | (block.
m << 3) | block.
szx),
 
 1697      LL_FOREACH(session->
lg_xmit, lg_xmit) {
 
 1717#if COAP_Q_BLOCK_SUPPORT 
 1720    if (block.
num == 0 && block.
m == 0) {
 
 1726                                              (0 << 4) | (1 << 3) | block.
szx),
 
 1738  if (coap_check_send_need_lg_crcv(session, pdu)) {
 
 1741    if (!session->
lg_xmit && have_block1) {
 
 1746    LL_FOREACH(session->
lg_crcv, lg_crcv) {
 
 1749        LL_DELETE(session->
lg_crcv, lg_crcv);
 
 1755    if (have_block1 && session->
lg_xmit) {
 
 1756      LL_FOREACH(session->
lg_xmit, lg_xmit) {
 
 1765    if (lg_crcv == NULL) {
 
 1776#if COAP_Q_BLOCK_SUPPORT 
 1779    mid = coap_send_q_block1(session, block, pdu, COAP_SEND_INC_PDU);
 
 1786#if COAP_CLIENT_SUPPORT 
 1789      LL_PREPEND(session->
lg_crcv, lg_crcv);
 
 
 1802#if COAP_SERVER_SUPPORT 
 1807  if (!digest_ctx || !pdu) {
 
 1838  ssize_t bytes_written;
 
 1841#if ! COAP_SERVER_SUPPORT 
 1845#if COAP_CLIENT_SUPPORT 
 1852#if COAP_PROXY_SUPPORT 
 1853  if (session->server_list) {
 
 1855    return coap_proxy_local_write(session, pdu);
 
 1867    addr_str[
sizeof(addr_str)-1] = 
'\000';
 
 1869                        sizeof(addr_str) - 1)) {
 
 1873      if (addr_str[0] == 
'[') {
 
 1874        cp = strchr(addr_str, 
']');
 
 1877        if (memcmp(&addr_str[1], 
"::ffff:", 7) == 0) {
 
 1884        cp = strchr(addr_str, 
':');
 
 1898        if (hop_limit == 1) {
 
 1903        } 
else if (hop_limit < 1 || hop_limit > 255) {
 
 1905          coap_log_warn(
"Proxy return has bad hop limit count '%zu'\n",
 
 1917      if (pdu->
data && opt == NULL) {
 
 1932        pdu->
data[data_len] = 
'\000';
 
 1933        a_match = strstr((
char *)pdu->
data, cp);
 
 1934        if (a_match && (a_match == (
char *)pdu->
data || a_match[-1] == 
' ') &&
 
 1935            ((
size_t)(a_match - (
char *)pdu->
data + len) == data_len ||
 
 1936             a_match[len] == 
' ')) {
 
 1946          if (pdu->
data == NULL) {
 
 1954                               (uint8_t *)&hop_limit);
 
 1958            memmove(pdu->
data + len + 1, pdu->
data,
 
 1960            memcpy(pdu->
data, cp, len);
 
 1961            pdu->
data[len] = 
' ';
 
 1969  if (session->
echo) {
 
 1974    session->
echo = NULL;
 
 1976#if COAP_OSCORE_SUPPORT 
 1977  if (session->oscore_encryption) {
 
 1988#if !COAP_DISABLE_TCP 
 1999        coap_log_debug(
"Remote end did not indicate CSM support for Block1 enabled\n");
 
 2002        coap_log_debug(
"Remote end did not indicate CSM support for Block2 enabled\n");
 
 2009        coap_log_debug(
"Remote end did not indicate CSM support for BERT Block1\n");
 
 2013        coap_log_debug(
"Remote end did not indicate CSM support for BERT Block2\n");
 
 2019#if COAP_OSCORE_SUPPORT 
 2020  if (session->oscore_encryption &&
 
 2027    if (osc_pdu == NULL) {
 
 2040#if COAP_SERVER_SUPPORT 
 2057  if (bytes_written < 0) {
 
 2062#if !COAP_DISABLE_TCP 
 2064      (
size_t)bytes_written < pdu->used_size + pdu->
hdr_size) {
 
 2088  node->
id = pdu->
mid;
 
 
 2108               coap_pdu_t **response_pdu, uint32_t timeout_ms) {
 
 
 2129                   coap_pdu_t **response_pdu, uint32_t timeout_ms) {
 
 2130#if COAP_CLIENT_SUPPORT 
 2132  uint32_t rem_timeout = timeout_ms;
 
 2138  uint32_t time_so_far_ms;
 
 2141  assert(request_pdu);
 
 2189    if (time_so_far_ms >= timeout_ms) {
 
 2192      rem_timeout = timeout_ms - time_so_far_ms;
 
 2197      ticks_so_far = now - start;
 
 2199      if (time_so_far_ms >= timeout_ms) {
 
 2202        rem_timeout = timeout_ms - time_so_far_ms;
 
 2209    ticks_so_far = now - start;
 
 2211    ret = time_so_far_ms;
 
 2215    if (*response_pdu == NULL) {
 
 2238  coap_log_warn(
"coap_send_recv: Client mode not supported\n");
 
 2239  *response_pdu =  NULL;
 
 
 2247  if (!context || !node || !node->
session)
 
 2252    ssize_t bytes_written;
 
 2272      node->
t = next_delay;
 
 2283      coap_log_debug(
"** %s: mid=0x%04x: mcast delayed transmission\n",
 
 2286      coap_log_debug(
"** %s: mid=0x%04x: retransmission #%d (next %ums)\n",
 
 2309    if (bytes_written < 0)
 
 2310      return (
int)bytes_written;
 
 2316  coap_log_warn(
"** %s: mid=0x%04x: give up after %d attempts\n",
 
 2319#if COAP_SERVER_SUPPORT 
 2331#if COAP_PROXY_SUPPORT 
 2335                                     0, COAP_PROXY_SUBS_TOKEN);
 
 2359#if COAP_CLIENT_SUPPORT 
 
 2375#if COAP_SERVER_SUPPORT 
 
 2388#if COAP_CLIENT_SUPPORT 
 2414    ssize_t bytes_written;
 
 2418    coap_log_debug(
"** %s: mid=0x%04x: transmitted after delay (1)\n",
 
 2424    if (bytes_written > 0)
 
 2426    if (bytes_written <= 0 ||
 
 2428      if (bytes_written > 0)
 
 
 2440#if COAP_CONSTRAINED_STACK 
 2452  packet->
length = 
sizeof(payload);
 
 2463    if (bytes_read < 0) {
 
 2464      if (bytes_read == -2) {
 
 2469    } 
else if (bytes_read > 0) {
 
 2471#if COAP_CLIENT_SUPPORT 
 2480#if !COAP_DISABLE_TCP 
 2483    ssize_t bytes_read = 0;
 
 2489    if (bytes_read < 0) {
 
 2491    } 
else if (bytes_read > 2) {
 
 2513    ssize_t bytes_read = 0;
 
 2521      if (bytes_read > 0) {
 
 2525      retry = bytes_read == (ssize_t)packet->
length;
 
 2526      while (bytes_read > 0) {
 
 2531          size_t n = 
min(len, (
size_t)bytes_read);
 
 2547            } 
else if (error_opts.
mask) {
 
 2552                coap_log_warn(
"coap_read_session: cannot create error response\n");
 
 2555                  coap_log_warn(
"coap_read_session: error sending response\n");
 
 2568          size_t len = hdr_size + tok_ext_bytes - session->
partial_read;
 
 2569          size_t n = 
min(len, (
size_t)bytes_read);
 
 2576                                              hdr_size + tok_ext_bytes);
 
 2577            if (size > COAP_DEFAULT_MAX_PDU_RX_SIZE) {
 
 2578              coap_log_warn(
"** %s: incoming PDU length too large (%zu > %lu)\n",
 
 2580                            size, COAP_DEFAULT_MAX_PDU_RX_SIZE);
 
 2625    } 
while (bytes_read == 0 && retry);
 
 
 2632#if COAP_SERVER_SUPPORT 
 2635  ssize_t bytes_read = -1;
 
 2637#if COAP_CONSTRAINED_STACK 
 2652  packet->
length = 
sizeof(payload);
 
 2658  if (bytes_read < 0) {
 
 2659    if (errno != EAGAIN) {
 
 2662  } 
else if (bytes_read > 0) {
 
 2685#if !COAP_DISABLE_TCP 
 2692  return session != NULL;
 
 2706#ifdef COAP_EPOLL_SUPPORT 
 2709  coap_log_emerg(
"coap_io_do_io() requires libcoap not compiled for using epoll\n");
 
 2714#if COAP_SERVER_SUPPORT 
 2716  LL_FOREACH_SAFE(ctx->
endpoint, ep, tmp) {
 
 2718      coap_read_endpoint(ctx, ep, now);
 
 2720      coap_write_endpoint(ctx, ep, now);
 
 2721#if !COAP_DISABLE_TCP 
 2723      coap_accept_endpoint(ctx, ep, now, NULL);
 
 2739#if COAP_CLIENT_SUPPORT 
 
 2771#ifndef COAP_EPOLL_SUPPORT 
 2775  coap_log_emerg(
"coap_io_do_epoll() requires libcoap compiled for using epoll\n");
 
 2782  for (j = 0; j < nevents; j++) {
 
 2787#if COAP_SERVER_SUPPORT 
 2791            (events[j].events & EPOLLIN)) {
 
 2793          coap_read_endpoint(endpoint->
context, endpoint, now);
 
 2797            (events[j].events & EPOLLOUT)) {
 
 2804          coap_write_endpoint(endpoint->
context, endpoint, now);
 
 2807#if !COAP_DISABLE_TCP 
 2809            (events[j].events & EPOLLIN)) {
 
 2811          coap_accept_endpoint(endpoint->
context, endpoint, now, NULL);
 
 2823#if COAP_CLIENT_SUPPORT 
 2825              (events[j].events & (EPOLLOUT|EPOLLERR|EPOLLHUP|EPOLLRDHUP))) {
 
 2836              (events[j].events & (EPOLLIN|EPOLLERR|EPOLLHUP|EPOLLRDHUP))) {
 
 2842              (events[j].events & (EPOLLOUT|EPOLLERR|EPOLLHUP|EPOLLRDHUP))) {
 
 2854    } 
else if (ctx->eptimerfd != -1) {
 
 2863      if (read(ctx->eptimerfd, &count, 
sizeof(count)) == -1) {
 
 
 2876                  uint8_t *msg, 
size_t msg_len) {
 
 2891    coap_log_debug(
"coap_handle_dgram: UDP version not supported\n");
 
 2909        coap_log_warn(
"coap_handle_dgram: cannot create error response\n");
 
 2912          coap_log_warn(
"coap_handle_dgram: error sending response\n");
 
 
 2940  if (!queue || !*queue)
 
 2945  if (session == (*queue)->session && 
id == (*queue)->id) { 
 
 2947    *queue = (*queue)->
next;
 
 2949      (*queue)->
t += (*node)->t;
 
 2951    (*node)->next = NULL;
 
 2962  } 
while (q && (session != q->
session || 
id != q->
id));
 
 
 2985  if (!queue || !*queue)
 
 2990  if (session == (*queue)->session &&
 
 2993    *queue = (*queue)->
next;
 
 2995      (*queue)->
t += (*node)->t;
 
 2997    (*node)->next = NULL;
 
 3014  } 
while (q && (session != q->
session ||
 
 
 3118#if COAP_ERROR_PHRASE_LENGTH > 0 
 3149#if COAP_ERROR_PHRASE_LENGTH > 0 
 3150      snprintf(buf, 
sizeof(buf), 
"%s", phrase ? phrase : 
"");
 
 3157        size_t len = strlen(buf);
 
 3159        snprintf(&buf[len], 
sizeof(buf) - len, 
"%s%d", first ? 
" " : 
",", opt_iter.
number);
 
 3162      coap_add_data(response, (
size_t)strlen(buf), (
const uint8_t *)buf);
 
 3163    } 
else if (opts && opts->
mask) {
 
 3173#if COAP_ERROR_PHRASE_LENGTH > 0 
 3175        coap_add_data(response, (
size_t)strlen(phrase), (
const uint8_t *)phrase);
 
 3179        coap_add_data(response, (
size_t)strlen(phrase), (
const uint8_t *)phrase);
 
 
 3187#if COAP_SERVER_SUPPORT 
 3188#define SZX_TO_BYTES(SZX) ((size_t)(1 << ((SZX) + 4))) 
 3217    coap_log_warn(
"cannot determine length of /.well-known/core\n");
 
 3232    assert(len <= (
size_t)wkc_len);
 
 3233    data_string->
length = len;
 
 3246        coap_log_debug(
".well-known/core: truncating data length to %zu from %zu\n",
 
 3253      free_wellknown_response(session, data_string);
 
 3257                                                 -1, 0, data_string->
length,
 
 3259                                                 free_wellknown_response,
 
 3261      goto error_released;
 
 3274  free_wellknown_response(session, data_string);
 
 3276  if (response->
code == 0) {
 
 3280    response->
data = NULL;
 
 3297  int num_cancelled = 0;    
 
 3299#ifndef COAP_SERVER_SUPPORT 
 3304#if COAP_SERVER_SUPPORT 
 3314  return num_cancelled;
 
 
 3317#if COAP_SERVER_SUPPORT 
 3322enum respond_t { RESPONSE_DEFAULT, RESPONSE_DROP, RESPONSE_SEND };
 
 3369static enum respond_t
 
 3374  unsigned int val = 0;
 
 3400          response->
data = NULL;
 
 3401          return RESPONSE_SEND;
 
 3403          return RESPONSE_DROP;
 
 3407        return RESPONSE_SEND;
 
 3412      if ((resource->
flags &
 
 3415        return RESPONSE_DROP;
 
 3416      } 
else if ((resource->
flags &
 
 3419        if (response->
data == NULL)
 
 3420          return RESPONSE_DROP;
 
 3421      } 
else if ((resource->
flags &
 
 3424        return RESPONSE_DROP;
 
 3425      } 
else if ((resource->
flags &
 
 3428        return RESPONSE_DROP;
 
 3435    return RESPONSE_DROP;
 
 3446      return RESPONSE_DROP;
 
 3450      return RESPONSE_DROP;
 
 3456  return RESPONSE_DEFAULT;
 
 3478  enum respond_t respond = RESPONSE_DEFAULT;
 
 3481  int is_proxy_uri = 0;
 
 3482  int is_proxy_scheme = 0;
 
 3483  int skip_hop_limit_check = 0;
 
 3485  int send_early_empty_ack = 0;
 
 3491  int added_block = 0;
 
 3493#if COAP_Q_BLOCK_SUPPORT 
 3494  int lg_xmit_ctrl = 0;
 
 3496#if COAP_ASYNC_SUPPORT 
 3502      coap_log_info(
"Invalid multicast packet received RFC7252 8.1\n");
 
 3506#if COAP_ASYNC_SUPPORT 
 3507  async = coap_find_async_lkd(session, pdu->
actual_token);
 
 3512    if (async->delay == 0 || async->delay > now) {
 
 3532      is_proxy_scheme = 1;
 
 3540  if (is_proxy_scheme || is_proxy_uri) {
 
 3546                     is_proxy_scheme ? 
"Scheme" : 
"Uri");
 
 3550    if (((
size_t)pdu->
code - 1 <
 
 3555                     is_proxy_scheme ? 
"Scheme" : 
"Uri",
 
 3556                     pdu->code/100,  pdu->code%100);
 
 3571      memset(&uri, 0, 
sizeof(uri));
 
 3606        is_proxy_scheme = 0;
 
 3607        skip_hop_limit_check = 1;
 
 3612  assert(resource == NULL);
 
 3614  if (!skip_hop_limit_check) {
 
 3622      if (hop_limit == 1) {
 
 3626      } 
else if (hop_limit < 1 || hop_limit > 255) {
 
 3643  if (!is_proxy_uri && !is_proxy_scheme) {
 
 3649  if ((resource == NULL) || (resource->
is_unknown == 1) ||
 
 3654    if (resource != NULL)
 
 3680    if (is_proxy_uri || is_proxy_scheme) {
 
 3684               ((
size_t)pdu->
code - 1 <
 
 3690      resource = &resource_uri_wellknown;
 
 3692               ((
size_t)pdu->
code - 1 <
 
 3729#if COAP_WITH_OBSERVE_PERSIST 
 3731        context->unknown_pdu = pdu;
 
 3732        context->unknown_session = session;
 
 3735#if COAP_WITH_OBSERVE_PERSIST 
 3737        context->unknown_pdu = NULL;
 
 3738        context->unknown_session = NULL;
 
 3749      coap_log_debug(
"request for unknown resource '%*.*s', return 4.04\n",
 
 3759#if COAP_OSCORE_SUPPORT 
 3761    coap_log_debug(
"request for OSCORE only resource '%*.*s', return 4.04\n",
 
 3777  if ((
size_t)pdu->
code - 1 <
 
 3809#if COAP_ASYNC_SUPPORT 
 3844                                      resource, uri_path, observe,
 
 3845                                      &added_block, &free_lg_srcv)) {
 
 3853#if COAP_Q_BLOCK_SUPPORT 
 3869        if (block.
num != 0) {
 
 3873#if COAP_Q_BLOCK_SUPPORT 
 3876        if (block.
num != 0) {
 
 3896      coap_log_info(
"observe: unexpected action %d\n", observe_action);
 
 3907    send_early_empty_ack = 1;
 
 3909  if (send_early_empty_ack) {
 
 3913      coap_log_debug(
"Duplicate request with mid=0x%04x - not processed\n",
 
 3915      goto drop_it_no_debug;
 
 3919#if COAP_WITH_OBSERVE_PERSIST 
 3922    context->unknown_pdu = pdu;
 
 3923    context->unknown_session = session;
 
 3925    context->unknown_pdu = NULL;
 
 3931  if (resource == &resource_uri_wellknown) {
 
 3936    h(resource, session, pdu, query, response);
 
 3948    coap_log_warn(
"handle_request: Invalid PDU response code (%d.%02d)\n",
 
 3950                  response->
code & 0x1f);
 
 3951    goto drop_it_no_debug;
 
 3963      LL_DELETE(session->
lg_srcv, free_lg_srcv);
 
 3973  if (send_early_empty_ack &&
 
 3978    if (response->
code == 0) {
 
 3979      goto drop_it_no_debug;
 
 3982  respond = no_response(pdu, response, session, resource);
 
 3983  if (respond != RESPONSE_DROP) {
 
 3984#if (COAP_MAX_LOGGING_LEVEL >= _COAP_LOG_DEBUG) 
 4004        && (response->
code == 0)) {
 
 4009      response->
data = NULL;
 
 4017#if COAP_Q_BLOCK_SUPPORT 
 4022        if (coap_send_q_block2(session, resource, query, pdu->
code, block,
 
 4046        goto drop_it_no_debug;
 
 4050        goto drop_it_no_debug;
 
 4053      node->
id = response->
mid;
 
 4054      node->
pdu = response;
 
 4058      coap_log_debug(
"   %s: mid=0x%04x: mcast response delayed for %u.%03u secs\n",
 
 4064      node->
timeout = (
unsigned int)delay;
 
 4078#if COAP_Q_BLOCK_SUPPORT 
 4113#if COAP_CLIENT_SUPPORT 
 4122#if COAP_PROXY_SUPPORT 
 4123  if (context->proxy_response_handler) {
 
 4125    coap_proxy_req_t *proxy_req = coap_proxy_map_outgoing_request(session,
 
 4129    if (proxy_req && proxy_req->incoming && !proxy_req->incoming->server_list) {
 
 4130      coap_proxy_process_incoming(session, rcvd, body_data, proxy_req,
 
 4203      coap_log_debug(
"Extended Token requested size support not available\n");
 
 4212      LL_DELETE(session->
lg_crcv, lg_crcv);
 
 4219#if COAP_Q_BLOCK_SUPPORT 
 4221  if (session->
block_mode & COAP_BLOCK_PROBE_Q_BLOCK) {
 
 4266#if !COAP_DISABLE_TCP 
 4284      coap_log_warn(
"***%s: Increase timeout in coap_context_set_csm_timeout_ms() to > %d\n",
 
 4295        if (max_recv > COAP_DEFAULT_MAX_PDU_RX_SIZE) {
 
 4296          max_recv = COAP_DEFAULT_MAX_PDU_RX_SIZE;
 
 4297          coap_log_debug(
"*  %s: Restricting CSM Max-Message-Size size to %u\n",
 
 
 4359        coap_log_warn(
"coap_dispatch: cannot create error response\n");
 
 
 4385  int packet_is_bad = 0;
 
 4386#if COAP_OSCORE_SUPPORT 
 4390  int is_ext_token_rst;
 
 4391  int oscore_invalid = 0;
 
 4398    coap_log_info(
"coap_dispatch: Received invalid PDU code (%d.%02d)\n",
 
 4412#if COAP_SERVER_SUPPORT 
 4418    coap_pdu_cksum(pdu, &digest);
 
 4420#if COAP_OSCORE_SUPPORT 
 4421      uint8_t oscore_encryption = session->oscore_encryption;
 
 4423      session->oscore_encryption = 0;
 
 4430#if COAP_OSCORE_SUPPORT 
 4431        session->oscore_encryption = oscore_encryption;
 
 4435#if COAP_OSCORE_SUPPORT 
 4436      session->oscore_encryption = oscore_encryption;
 
 4446#if COAP_OSCORE_SUPPORT 
 4458          coap_log_warn(
"coap_dispatch: cannot create error response\n");
 
 4472#if COAP_SERVER_SUPPORT 
 4481#if COAP_SERVER_SUPPORT 
 4487      memset(&uri, 0, 
sizeof(uri));
 
 4513        if (session->recipient_ctx == NULL ||
 
 4514            session->recipient_ctx->initial_state == 0) {
 
 4521        session->oscore_encryption = 1;
 
 4528             session->oscore_encryption &&
 
 4532      coap_log_err(
"received an invalid response to the OSCORE request\n");
 
 4538  switch (pdu->
type) {
 
 4554#if COAP_SERVER_SUPPORT 
 4563#if COAP_Q_BLOCK_SUPPORT 
 4565      int doing_q_block = 0;
 
 4568      LL_FOREACH(session->
lg_xmit, lg_xmit) {
 
 4575      if (doing_q_block && lg_xmit) {
 
 4578        memset(&block, 0, 
sizeof(block));
 
 4590        coap_send_q_blocks(session, lg_xmit, block,
 
 4591                           lg_xmit->
sent_pdu, COAP_SEND_SKIP_PDU);
 
 4595    if (pdu->
code == 0) {
 
 4596#if COAP_CLIENT_SUPPORT 
 4610          !coap_check_send_need_lg_crcv(session, sent->
pdu) &&
 
 4618        uint64_t token_match =
 
 4622        LL_FOREACH(session->
lg_crcv, lg_crcv) {
 
 4635            LL_PREPEND(session->
lg_crcv, lg_crcv);
 
 4662#if COAP_Q_BLOCK_SUPPORT 
 4664    if (session->
block_mode & COAP_BLOCK_PROBE_Q_BLOCK &&
 
 4672    is_ext_token_rst = 0;
 
 4679      is_ext_token_rst = 1;
 
 4682    if (!is_ping_rst && !is_ext_token_rst)
 
 4699      if (!is_ping_rst && !is_ext_token_rst) {
 
 4703      } 
else if (is_ping_rst) {
 
 4711#if COAP_SERVER_SUPPORT 
 4715        LL_FOREACH_SAFE(r->subscribers, obs, tmp) {
 
 4729#if COAP_PROXY_SUPPORT 
 4732      coap_delete_proxy_subscriber(session, NULL, pdu->
mid, COAP_PROXY_SUBS_MID);
 
 4755    if (oscore_invalid ||
 
 4763          coap_log_warn(
"coap_dispatch: cannot create error response\n");
 
 4780#if !COAP_DISABLE_TCP 
 4785#if COAP_SERVER_SUPPORT 
 4787      handle_request(context, session, pdu, orig_pdu);
 
 4790#if COAP_CLIENT_SUPPORT 
 4792        handle_response(context, session, sent ? sent->
pdu : NULL, pdu);
 
 4825  if (packet_is_bad) {
 
 4834#if COAP_OSCORE_SUPPORT 
 
 4839#if COAP_MAX_LOGGING_LEVEL >= _COAP_LOG_DEBUG 
 4844    return "COAP_EVENT_DTLS_CLOSED";
 
 4846    return "COAP_EVENT_DTLS_CONNECTED";
 
 4848    return "COAP_EVENT_DTLS_RENEGOTIATE";
 
 4850    return "COAP_EVENT_DTLS_ERROR";
 
 4852    return "COAP_EVENT_TCP_CONNECTED";
 
 4854    return "COAP_EVENT_TCP_CLOSED";
 
 4856    return "COAP_EVENT_TCP_FAILED";
 
 4858    return "COAP_EVENT_SESSION_CONNECTED";
 
 4860    return "COAP_EVENT_SESSION_CLOSED";
 
 4862    return "COAP_EVENT_SESSION_FAILED";
 
 4864    return "COAP_EVENT_PARTIAL_BLOCK";
 
 4866    return "COAP_EVENT_XMIT_BLOCK_FAIL";
 
 4868    return "COAP_EVENT_SERVER_SESSION_NEW";
 
 4870    return "COAP_EVENT_SERVER_SESSION_DEL";
 
 4872    return "COAP_EVENT_SERVER_SESSION_CONNECTED";
 
 4874    return "COAP_EVENT_BAD_PACKET";
 
 4876    return "COAP_EVENT_MSG_RETRANSMITTED";
 
 4878    return "COAP_EVENT_OSCORE_DECRYPTION_FAILURE";
 
 4880    return "COAP_EVENT_OSCORE_NOT_ENABLED";
 
 4882    return "COAP_EVENT_OSCORE_NO_PROTECTED_PAYLOAD";
 
 4884    return "COAP_EVENT_OSCORE_NO_SECURITY";
 
 4886    return "COAP_EVENT_OSCORE_INTERNAL_ERROR";
 
 4888    return "COAP_EVENT_OSCORE_DECODE_ERROR";
 
 4890    return "COAP_EVENT_WS_PACKET_SIZE";
 
 4892    return "COAP_EVENT_WS_CONNECTED";
 
 4894    return "COAP_EVENT_WS_CLOSED";
 
 4896    return "COAP_EVENT_KEEPALIVE_FAILURE";
 
 
 4923#if COAP_PROXY_SUPPORT 
 4925      coap_proxy_remove_association(session, 0);
 
 4927#if COAP_CLIENT_SUPPORT 
 
 5006#if COAP_SERVER_SUPPORT 
 5009  LL_FOREACH(context->
endpoint, ep) {
 
 5018#if COAP_CLIENT_SUPPORT 
 
 5028#if COAP_SERVER_SUPPORT 
 5029#if COAP_ASYNC_SUPPORT 
 5040  if (context->async_state_traversing)
 
 5042  context->async_state_traversing = 1;
 
 5043  LL_FOREACH_SAFE(context->async_state, async, tmp) {
 
 5044    if (async->delay != 0) {
 
 5045      if (async->delay <= now) {
 
 5049        handle_request(context, async->session, async->pdu, NULL);
 
 5052        coap_free_async_lkd(async->session, async);
 
 5054        next_due = async->delay - now;
 
 5060    *tim_rem = next_due;
 
 5061  context->async_state_traversing = 0;
 
 5100#if defined(HAVE_WINSOCK2_H) 
 5101  WORD wVersionRequested = MAKEWORD(2, 2);
 
 5103  WSAStartup(wVersionRequested, &wsaData);
 
 5112  coap_start_io_process();
 
 5117  coap_io_lwip_init();
 
 5119#if COAP_SERVER_SUPPORT 
 5121                                         (
const uint8_t *)
".well-known/core" 
 5123  memset(&resource_uri_wellknown, 0, 
sizeof(resource_uri_wellknown));
 
 5124  resource_uri_wellknown.
ref = 1;
 
 5127  resource_uri_wellknown.
uri_path = &well_known;
 
 
 5137#if defined(HAVE_WINSOCK2_H) 
 5139#elif defined(WITH_CONTIKI) 
 5140  coap_stop_io_process();
 
 5143  coap_io_lwip_cleanup();
 
 
 5159#if COAP_CLIENT_SUPPORT 
 
 5170#if COAP_PROXY_SUPPORT 
 5171  context->proxy_response_handler = handler;
 
 
 5199                                       uint32_t dynamic_max) {
 
 
 5217#if ! defined WITH_CONTIKI && ! defined WITH_LWIP && ! defined RIOT_VERSION && !defined(__ZEPHYR__) 
 5218#if COAP_SERVER_SUPPORT 
 5221                           const char *ifname) {
 
 5232                               const char *ifname) {
 
 5233#if COAP_IPV4_SUPPORT 
 5234  struct ip_mreq mreq4;
 
 5236#if COAP_IPV6_SUPPORT 
 5237  struct ipv6_mreq mreq6;
 
 5239  struct addrinfo *resmulti = NULL, hints, *ainfo;
 
 5242  int mgroup_setup = 0;
 
 5250#if COAP_IPV6_SUPPORT 
 5251  mreq6.ipv6mr_interface = 0;
 
 5253#if COAP_IPV4_SUPPORT 
 5254  mreq4.imr_interface.s_addr = INADDR_ANY;
 
 5257  memset(&hints, 0, 
sizeof(hints));
 
 5258  hints.ai_socktype = SOCK_DGRAM;
 
 5261  result = getaddrinfo(group_name, NULL, &hints, &resmulti);
 
 5265                 "Cannot resolve multicast address: %s\n",
 
 5266                 group_name, gai_strerror(result));
 
 5276#if defined(ESPIDF_VERSION) 
 5277    struct netif *netif;
 
 5279#if COAP_IPV4_SUPPORT 
 5286    for (ainfo = resmulti; ainfo != NULL && !(done_ip4 == 1 && done_ip6 == 1);
 
 5287         ainfo = ainfo->ai_next) {
 
 5288      switch (ainfo->ai_family) {
 
 5289#if COAP_IPV6_SUPPORT 
 5294#if defined(ESPIDF_VERSION) 
 5295        netif = netif_find(ifname);
 
 5297          mreq6.ipv6mr_interface = netif_get_index(netif);
 
 5300                       "Cannot get IPv4 address: %s\n",
 
 5303        memset(&ifr, 0, 
sizeof(ifr));
 
 5304        strncpy(ifr.ifr_name, ifname, IFNAMSIZ - 1);
 
 5305        ifr.ifr_name[IFNAMSIZ - 1] = 
'\000';
 
 5307#ifdef HAVE_IF_NAMETOINDEX 
 5308        mreq6.ipv6mr_interface = if_nametoindex(ifr.ifr_name);
 
 5309        if (mreq6.ipv6mr_interface == 0) {
 
 5311                        "cannot get interface index for '%s'\n",
 
 5314#elif defined(__QNXNTO__) 
 5319                        "cannot get interface index for '%s': %s\n",
 
 5323          mreq6.ipv6mr_interface = ifr.ifr_ifindex;
 
 5329#if COAP_IPV4_SUPPORT 
 5334#if defined(ESPIDF_VERSION) 
 5335        netif = netif_find(ifname);
 
 5337          mreq4.imr_interface.s_addr = netif_ip4_addr(netif)->addr;
 
 5340                       "Cannot get IPv4 address: %s\n",
 
 5347        ip4fd = socket(AF_INET, SOCK_DGRAM, 0);
 
 5349          coap_log_err(
"coap_join_mcast_group_intf: %s: socket: %s\n",
 
 5353        memset(&ifr, 0, 
sizeof(ifr));
 
 5354        strncpy(ifr.ifr_name, ifname, IFNAMSIZ - 1);
 
 5355        ifr.ifr_name[IFNAMSIZ - 1] = 
'\000';
 
 5356        result = ioctl(ip4fd, SIOCGIFADDR, &ifr);
 
 5359                       "Cannot get IPv4 address: %s\n",
 
 5363          mreq4.imr_interface = ((
struct sockaddr_in *)&ifr.ifr_addr)->sin_addr;
 
 5384  for (ainfo = resmulti; ainfo != NULL; ainfo = ainfo->ai_next) {
 
 5385    LL_FOREACH(ctx->
endpoint, endpoint) {
 
 5391#if COAP_IPV6_SUPPORT 
 5392        if (ainfo->ai_family == AF_INET6) {
 
 5399              mreq6.ipv6mr_interface =
 
 5402              mreq6.ipv6mr_interface = 0;
 
 5405          gaddr.
addr.
sin6.sin6_family = AF_INET6;
 
 5407          gaddr.
addr.
sin6.sin6_addr = mreq6.ipv6mr_multiaddr =
 
 5408                                          ((
struct sockaddr_in6 *)ainfo->ai_addr)->sin6_addr;
 
 5409          result = setsockopt(endpoint->
sock.
fd, IPPROTO_IPV6, IPV6_JOIN_GROUP,
 
 5410                              (
char *)&mreq6, 
sizeof(mreq6));
 
 5413#if COAP_IPV4_SUPPORT && COAP_IPV6_SUPPORT 
 5416#if COAP_IPV4_SUPPORT 
 5417          if (ainfo->ai_family == AF_INET) {
 
 5426                mreq4.imr_interface.s_addr = INADDR_ANY;
 
 5429            gaddr.
addr.
sin.sin_family = AF_INET;
 
 5431            gaddr.
addr.
sin.sin_addr.s_addr = mreq4.imr_multiaddr.s_addr =
 
 5432                                                 ((
struct sockaddr_in *)ainfo->ai_addr)->sin_addr.s_addr;
 
 5433            result = setsockopt(endpoint->
sock.
fd, IPPROTO_IP, IP_ADD_MEMBERSHIP,
 
 5434                                (
char *)&mreq4, 
sizeof(mreq4));
 
 5442          coap_log_err(
"coap_join_mcast_group_intf: %s: setsockopt: %s\n",
 
 5447          addr_str[
sizeof(addr_str)-1] = 
'\000';
 
 5449                              sizeof(addr_str) - 1)) {
 
 5461  if (!mgroup_setup) {
 
 5466  freeaddrinfo(resmulti);
 
 5478#if COAP_CLIENT_SUPPORT 
 5483#if COAP_IPV4_SUPPORT 
 5485      if (setsockopt(session->
sock.
fd, IPPROTO_IP, IP_MULTICAST_TTL,
 
 5486                     (
const char *)&hops, 
sizeof(hops)) < 0) {
 
 5493#if COAP_IPV6_SUPPORT 
 5495      if (setsockopt(session->
sock.
fd, IPPROTO_IPV6, IPV6_MULTICAST_HOPS,
 
 5496                     (
const char *)&hops, 
sizeof(hops)) < 0) {
 
void coap_address_init(coap_address_t *addr)
Resets the given coap_address_t object addr to its default values.
 
int coap_is_mcast(const coap_address_t *a)
Checks if given address a denotes a multicast address.
 
void coap_address_copy(coap_address_t *dst, const coap_address_t *src)
 
void coap_debug_reset(void)
Reset all the defined logging parameters.
 
struct coap_proxy_list_t coap_proxy_list_t
Proxy information.
 
struct coap_async_t coap_async_t
Async Entry information.
 
const char * coap_socket_strerror(void)
 
void coap_packet_get_memmapped(coap_packet_t *packet, unsigned char **address, size_t *length)
Given a packet, set msg and msg_len to an address and length of the packet's data in memory.
 
void coap_update_io_timer(coap_context_t *context, coap_tick_t delay)
Update when to continue with I/O processing, unless packets come in in the meantime.
 
#define COAP_RXBUFFER_SIZE
 
#define COAP_SOCKET_ERROR
 
@ COAP_NACK_NOT_DELIVERABLE
 
@ COAP_NACK_TOO_MANY_RETRIES
 
#define COAP_SOCKET_MULTICAST
socket is used for multicast communication
 
#define COAP_SOCKET_WANT_ACCEPT
non blocking server socket is waiting for accept
 
#define COAP_SOCKET_NOT_EMPTY
the socket is not empty
 
#define COAP_SOCKET_CAN_WRITE
non blocking socket can now write without blocking
 
#define COAP_SOCKET_BOUND
the socket is bound
 
#define COAP_SOCKET_WANT_READ
non blocking socket is waiting for reading
 
#define COAP_SOCKET_CAN_ACCEPT
non blocking server socket can now accept without blocking
 
#define COAP_SOCKET_WANT_WRITE
non blocking socket is waiting for writing
 
#define COAP_SOCKET_CAN_CONNECT
non blocking client socket can now connect without blocking
 
void coap_epoll_ctl_mod(coap_socket_t *sock, uint32_t events, const char *func)
Epoll specific function to modify the state of events that epoll is tracking on the appropriate file ...
 
#define COAP_SOCKET_WANT_CONNECT
non blocking client socket is waiting for connect
 
#define COAP_SOCKET_CAN_READ
non blocking socket can now read without blocking
 
#define COAP_SOCKET_CONNECTED
the socket is connected
 
Library specific build wrapper for coap_internal.h.
 
void coap_dump_memory_type_counts(coap_log_t level)
Dumps the current usage of malloc'd memory types.
 
void coap_memory_init(void)
Initializes libcoap's memory management.
 
void * coap_malloc_type(coap_memory_tag_t type, size_t size)
Allocates a chunk of size bytes and returns a pointer to the newly allocated memory.
 
void coap_free_type(coap_memory_tag_t type, void *p)
Releases the memory that was allocated by coap_malloc_type().
 
CoAP mutex mechanism wrapper.
 
#define coap_mutex_init(a)
 
#define coap_mutex_destroy(a)
 
#define FRAC_BITS
The number of bits for the fractional part of ACK_TIMEOUT and ACK_RANDOM_FACTOR.
 
static ssize_t coap_send_pdu(coap_session_t *session, coap_pdu_t *pdu, coap_queue_t *node)
 
static int send_recv_terminate
 
static int coap_remove_from_queue_token(coap_queue_t **queue, coap_session_t *session, coap_bin_const_t *token, coap_queue_t **node)
 
#define MAX_BITS
The maximum number of bits for fixed point integers that are used for retransmission time calculation...
 
#define ACK_TIMEOUT
creates a Qx.FRAC_BITS from session's 'ack_timeout'
 
static const char * coap_event_name(coap_event_t event)
 
static int coap_cancel(coap_context_t *context, const coap_queue_t *sent)
This function cancels outstanding messages for the session and token specified in sent.
 
static int coap_handle_dgram_for_proto(coap_context_t *ctx, coap_session_t *session, coap_packet_t *packet)
 
static void coap_write_session(coap_context_t *ctx, coap_session_t *session, coap_tick_t now)
 
COAP_STATIC_INLINE void coap_free_node(coap_queue_t *node)
 
#define SHR_FP(val, frac)
 
static void handle_signaling(coap_context_t *context, coap_session_t *session, coap_pdu_t *pdu)
 
static int check_token_size(coap_session_t *session, const coap_pdu_t *pdu)
 
static unsigned int s_csm_timeout
 
COAP_STATIC_INLINE coap_queue_t * coap_malloc_node(void)
 
#define ACK_RANDOM_FACTOR
creates a Qx.FRAC_BITS from session's 'ack_random_factor'
 
int coap_dtls_context_set_pki(coap_context_t *ctx COAP_UNUSED, const coap_dtls_pki_t *setup_data COAP_UNUSED, const coap_dtls_role_t role COAP_UNUSED)
 
int coap_dtls_receive(coap_session_t *session COAP_UNUSED, const uint8_t *data COAP_UNUSED, size_t data_len COAP_UNUSED)
 
int coap_dtls_context_load_pki_trust_store(coap_context_t *ctx COAP_UNUSED)
 
int coap_dtls_context_set_pki_root_cas(coap_context_t *ctx COAP_UNUSED, const char *ca_file COAP_UNUSED, const char *ca_path COAP_UNUSED)
 
void coap_dtls_free_context(void *handle COAP_UNUSED)
 
void * coap_dtls_new_context(coap_context_t *coap_context COAP_UNUSED)
 
uint16_t coap_option_num_t
 
uint8_t coap_opt_t
Use byte-oriented access methods here because sliding a complex struct coap_opt_t over the data buffe...
 
#define SESSIONS_ITER_SAFE(e, el, rtmp)
 
#define SESSIONS_ITER(e, el, rtmp)
 
void coap_io_do_epoll_lkd(coap_context_t *ctx, struct epoll_event *events, size_t nevents)
Process all the epoll events.
 
coap_mid_t coap_send_rst_lkd(coap_session_t *session, const coap_pdu_t *request)
Sends an RST message with code 0 for the specified request to dst.
 
coap_mid_t coap_send_message_type_lkd(coap_session_t *session, const coap_pdu_t *request, coap_pdu_type_t type)
Helper function to create and send a message with type (usually ACK or RST).
 
coap_mid_t coap_send_error_lkd(coap_session_t *session, const coap_pdu_t *request, coap_pdu_code_t code, coap_opt_filter_t *opts)
Sends an error response with code code for request request to dst.
 
void coap_io_do_io_lkd(coap_context_t *ctx, coap_tick_t now)
Processes any outstanding read, write, accept or connect I/O as indicated in the coap_socket_t struct...
 
int coap_send_recv_lkd(coap_session_t *session, coap_pdu_t *request_pdu, coap_pdu_t **response_pdu, uint32_t timeout_ms)
 
int coap_io_process_lkd(coap_context_t *ctx, uint32_t timeout_ms)
The main I/O processing function.
 
void coap_call_response_handler(coap_session_t *session, coap_pdu_t *sent, coap_pdu_t *rcvd, void *body_free)
 
unsigned int coap_io_prepare_epoll_lkd(coap_context_t *ctx, coap_tick_t now)
Any now timed out delayed packet is transmitted, along with any packets associated with requested obs...
 
coap_mid_t coap_send_lkd(coap_session_t *session, coap_pdu_t *pdu)
Sends a CoAP message to given peer.
 
coap_mid_t coap_send_ack_lkd(coap_session_t *session, const coap_pdu_t *request)
Sends an ACK message with code 0 for the specified request to dst.
 
COAP_API void coap_io_do_epoll(coap_context_t *ctx, struct epoll_event *events, size_t nevents)
Process all the epoll events.
 
COAP_API void coap_io_do_io(coap_context_t *ctx, coap_tick_t now)
Processes any outstanding read, write, accept or connect I/O as indicated in the coap_socket_t struct...
 
int coap_add_data_large_response_lkd(coap_resource_t *resource, coap_session_t *session, const coap_pdu_t *request, coap_pdu_t *response, const coap_string_t *query, uint16_t media_type, int maxage, uint64_t etag, size_t length, const uint8_t *data, coap_release_large_data_t release_func, void *app_ptr)
Associates given data with the response pdu that is passed as fourth parameter.
 
void coap_block_delete_lg_srcv(coap_session_t *session, coap_lg_srcv_t *lg_srcv)
 
void coap_block_delete_lg_crcv(coap_session_t *session, coap_lg_crcv_t *lg_crcv)
 
int coap_handle_response_get_block(coap_context_t *context, coap_session_t *session, coap_pdu_t *sent, coap_pdu_t *rcvd, coap_recurse_t recursive)
 
void coap_check_code_lg_xmit(const coap_session_t *session, const coap_pdu_t *request, coap_pdu_t *response, const coap_resource_t *resource, const coap_string_t *query)
The function checks that the code in a newly formed lg_xmit created by coap_add_data_large_response_l...
 
int coap_handle_response_send_block(coap_session_t *session, coap_pdu_t *sent, coap_pdu_t *rcvd)
 
coap_lg_crcv_t * coap_find_lg_crcv(coap_session_t *session, coap_pdu_t *pdu)
Find the current lg_crcv for the session that matches the pdu.
 
int coap_handle_request_put_block(coap_context_t *context, coap_session_t *session, coap_pdu_t *pdu, coap_pdu_t *response, coap_resource_t *resource, coap_string_t *uri_path, coap_opt_t *observe, int *added_block, coap_lg_srcv_t **free_lg_srcv)
 
#define STATE_TOKEN_BASE(t)
 
coap_lg_crcv_t * coap_block_new_lg_crcv(coap_session_t *session, coap_pdu_t *pdu, coap_lg_xmit_t *lg_xmit)
 
int coap_handle_request_send_block(coap_session_t *session, coap_pdu_t *pdu, coap_pdu_t *response, coap_resource_t *resource, coap_string_t *query)
 
#define COAP_OPT_BLOCK_SZX(opt)
Returns the value of the SZX-field of a Block option opt.
 
#define COAP_BLOCK_TRY_Q_BLOCK
 
#define COAP_BLOCK_SINGLE_BODY
 
int coap_get_block_b(const coap_session_t *session, const coap_pdu_t *pdu, coap_option_num_t number, coap_block_b_t *block)
Initializes block from pdu.
 
#define COAP_BLOCK_NO_PREEMPTIVE_RTAG
 
#define COAP_BLOCK_CACHE_RESPONSE
 
#define COAP_BLOCK_USE_LIBCOAP
 
void coap_digest_free(coap_digest_ctx_t *digest_ctx)
Free off coap_digest_ctx_t.
 
int coap_digest_final(coap_digest_ctx_t *digest_ctx, coap_digest_t *digest_buffer)
Finalize the coap_digest information into the provided digest_buffer.
 
int coap_digest_update(coap_digest_ctx_t *digest_ctx, const uint8_t *data, size_t data_len)
Update the coap_digest information with the next chunk of data.
 
coap_digest_ctx_t * coap_digest_setup(void)
Initialize a coap_digest.
 
void coap_delete_cache_entry(coap_context_t *context, coap_cache_entry_t *cache_entry)
Remove a cache-entry from the hash list and free off all the appropriate contents apart from app_data...
 
int64_t coap_tick_diff_t
This data type is used to represent the difference between two clock_tick_t values.
 
void coap_clock_init(void)
Initializes the internal clock.
 
uint64_t coap_tick_t
This data type represents internal timer ticks with COAP_TICKS_PER_SECOND resolution.
 
#define COAP_TICKS_PER_SECOND
Use ms resolution on POSIX systems.
 
#define COAP_MAX_DELAY_TICKS
 
uint64_t coap_ticks_to_rt_us(coap_tick_t t)
Helper function that converts coap ticks to POSIX wallclock time in us.
 
void coap_prng_init_lkd(unsigned int seed)
Seeds the default random number generation function with the given seed.
 
int coap_prng_lkd(void *buf, size_t len)
Fills buf with len random bytes using the default pseudo random number generator.
 
void coap_delete_all_resources(coap_context_t *context)
Deletes all resources from given context and frees their storage.
 
void coap_resource_release_lkd(coap_resource_t *resource)
Decrement reference counter on a resource.
 
coap_print_status_t coap_print_wellknown_lkd(coap_context_t *context, unsigned char *buf, size_t *buflen, size_t offset, const coap_string_t *query_filter)
Prints the names of all known resources for context to buf.
 
coap_resource_t * coap_get_resource_from_uri_path_lkd(coap_context_t *context, coap_str_const_t *uri_path)
Returns the resource identified by the unique string uri_path.
 
void coap_resource_reference_lkd(coap_resource_t *resource)
Increment reference counter on a resource.
 
#define RESOURCES_ITER(r, tmp)
 
#define COAP_RESOURCE_HANDLE_WELLKNOWN_CORE
Define this when invoking coap_resource_unknown_init2() if .well-known/core is to be passed to the un...
 
#define COAP_RESOURCE_FLAGS_HAS_MCAST_SUPPORT
This resource has support for multicast requests.
 
#define COAP_RESOURCE_FLAGS_LIB_DIS_MCAST_SUPPRESS_4_XX
Disable libcoap library suppressing 4.xx multicast responses (overridden by RFC7969 No-Response optio...
 
#define COAP_RESOURCE_FLAGS_LIB_DIS_MCAST_DELAYS
Disable libcoap library from adding in delays to multicast requests before releasing the response bac...
 
void(* coap_method_handler_t)(coap_resource_t *resource, coap_session_t *session, const coap_pdu_t *request, const coap_string_t *query, coap_pdu_t *response)
Definition of message handler function.
 
#define COAP_RESOURCE_FLAGS_OSCORE_ONLY
Define this resource as an OSCORE enabled access only.
 
#define COAP_RESOURCE_FLAGS_LIB_DIS_MCAST_SUPPRESS_5_XX
Disable libcoap library suppressing 5.xx multicast responses (overridden by RFC7969 No-Response optio...
 
uint32_t coap_print_status_t
Status word to encode the result of conditional print or copy operations such as coap_print_link().
 
#define COAP_PRINT_STATUS_ERROR
 
#define COAP_RESOURCE_FLAGS_FORCE_SINGLE_BODY
Force all large traffic to this resource to be presented as a single body to the request handler.
 
#define COAP_RESOURCE_FLAGS_LIB_ENA_MCAST_SUPPRESS_2_05
Enable libcoap library suppression of 205 multicast responses that are empty (overridden by RFC7969 N...
 
#define COAP_RESOURCE_FLAGS_LIB_ENA_MCAST_SUPPRESS_2_XX
Enable libcoap library suppressing 2.xx multicast responses (overridden by RFC7969 No-Response option...
 
int coap_handle_event_lkd(coap_context_t *context, coap_event_t event, coap_session_t *session)
Invokes the event handler of context for the given event and data.
 
uint16_t coap_new_message_id_lkd(coap_session_t *session)
Returns a new message id and updates session->tx_mid accordingly.
 
unsigned int coap_adjust_basetime(coap_context_t *ctx, coap_tick_t now)
Set sendqueue_basetime in the given context object ctx to now.
 
int coap_delete_node_lkd(coap_queue_t *node)
Destroys specified node.
 
void coap_delete_all(coap_queue_t *queue)
Removes all items from given queue and frees the allocated storage.
 
int coap_context_set_psk2_lkd(coap_context_t *context, coap_dtls_spsk_t *setup_data)
Set the context's default PSK hint and/or key for a server.
 
void coap_register_option_lkd(coap_context_t *ctx, uint16_t type)
Registers the option number number with the given context object context.
 
int coap_remove_from_queue(coap_queue_t **queue, coap_session_t *session, coap_mid_t id, coap_queue_t **node)
This function removes the element with given id from the list given list.
 
coap_queue_t * coap_peek_next(coap_context_t *context)
Returns the next pdu to send without removing from sendqeue.
 
COAP_API int coap_delete_node(coap_queue_t *node)
Destroys specified node.
 
int coap_client_delay_first(coap_session_t *session)
Delay the sending of the first client request until some other negotiation has completed.
 
int coap_context_set_psk_lkd(coap_context_t *context, const char *hint, const uint8_t *key, size_t key_len)
Set the context's default PSK hint and/or key for a server.
 
coap_queue_t * coap_pop_next(coap_context_t *context)
Returns the next pdu to send and removes it from the sendqeue.
 
void coap_dispatch(coap_context_t *context, coap_session_t *session, coap_pdu_t *pdu)
Dispatches the PDUs from the receive queue in given context.
 
int coap_insert_node(coap_queue_t **queue, coap_queue_t *node)
Adds node to given queue, ordered by variable t in node.
 
unsigned int coap_calc_timeout(coap_session_t *session, unsigned char r)
Calculates the initial timeout based on the session CoAP transmission parameters 'ack_timeout',...
 
int coap_join_mcast_group_intf_lkd(coap_context_t *ctx, const char *groupname, const char *ifname)
Function interface for joining a multicast group for listening for the currently defined endpoints th...
 
void coap_free_context_lkd(coap_context_t *context)
CoAP stack context must be released with coap_free_context_lkd().
 
int coap_context_load_pki_trust_store_lkd(coap_context_t *ctx)
Load the context's default trusted CAs for a client or server.
 
coap_mid_t coap_send_internal(coap_session_t *session, coap_pdu_t *pdu, coap_pdu_t *request_pdu)
Sends a CoAP message to given peer.
 
void * coap_context_set_app_data2_lkd(coap_context_t *context, void *app_data, coap_app_data_free_callback_t callback)
Stores data with the given context, returning the previously stored value or NULL.
 
int coap_can_exit_lkd(coap_context_t *context)
Returns 1 if there are no messages to send or to dispatch in the context's queues.
 
coap_mid_t coap_retransmit(coap_context_t *context, coap_queue_t *node)
Handles retransmissions of confirmable messages.
 
int coap_check_code_class(coap_session_t *session, coap_pdu_t *pdu)
Check whether the pdu contains a valid code class.
 
int coap_context_set_pki_root_cas_lkd(coap_context_t *ctx, const char *ca_file, const char *ca_dir)
Set the context's default Root CA information for a client or server.
 
int coap_option_check_critical(coap_session_t *session, coap_pdu_t *pdu, coap_opt_filter_t *unknown)
Verifies that pdu contains no unknown critical options, duplicate options or the options defined as R...
 
coap_mid_t coap_wait_ack(coap_context_t *context, coap_session_t *session, coap_queue_t *node)
 
coap_queue_t * coap_new_node(void)
Creates a new node suitable for adding to the CoAP sendqueue.
 
void coap_cancel_session_messages(coap_context_t *context, coap_session_t *session, coap_nack_reason_t reason)
Cancels all outstanding messages for session session.
 
int coap_context_set_pki_lkd(coap_context_t *context, const coap_dtls_pki_t *setup_data)
Set the context's default PKI information for a server.
 
int coap_handle_dgram(coap_context_t *ctx, coap_session_t *session, uint8_t *msg, size_t msg_len)
Parses and interprets a CoAP datagram with context ctx.
 
void coap_cancel_all_messages(coap_context_t *context, coap_session_t *session, coap_bin_const_t *token)
Cancels all outstanding messages for session session that have the specified token.
 
void coap_context_set_session_timeout(coap_context_t *context, unsigned int session_timeout)
Set the session timeout value.
 
unsigned int coap_context_get_max_handshake_sessions(const coap_context_t *context)
Get the session timeout value.
 
COAP_API int coap_join_mcast_group_intf(coap_context_t *ctx, const char *groupname, const char *ifname)
Function interface for joining a multicast group for listening for the currently defined endpoints th...
 
void(* coap_pong_handler_t)(coap_session_t *session, const coap_pdu_t *received, const coap_mid_t mid)
Received Pong handler that is used as callback in coap_context_t.
 
unsigned int coap_context_get_max_idle_sessions(const coap_context_t *context)
Get the maximum idle sessions count.
 
COAP_API int coap_send_recv(coap_session_t *session, coap_pdu_t *request_pdu, coap_pdu_t **response_pdu, uint32_t timeout_ms)
 
coap_context_t * coap_new_context(const coap_address_t *listen_addr)
Creates a new coap_context_t object that will hold the CoAP stack status.
 
COAP_API coap_mid_t coap_send(coap_session_t *session, coap_pdu_t *pdu)
Sends a CoAP message to given peer.
 
COAP_API int coap_context_set_pki(coap_context_t *context, const coap_dtls_pki_t *setup_data)
Set the context's default PKI information for a server.
 
void coap_mcast_per_resource(coap_context_t *context)
Function interface to enable processing mcast requests on a per resource basis.
 
coap_response_t(* coap_response_handler_t)(coap_session_t *session, const coap_pdu_t *sent, const coap_pdu_t *received, const coap_mid_t mid)
Response handler that is used as callback in coap_context_t.
 
COAP_API coap_mid_t coap_send_error(coap_session_t *session, const coap_pdu_t *request, coap_pdu_code_t code, coap_opt_filter_t *opts)
Sends an error response with code code for request request to dst.
 
void coap_context_set_csm_max_message_size(coap_context_t *context, uint32_t csm_max_message_size)
Set the CSM max session size value.
 
void coap_context_set_csm_timeout(coap_context_t *context, unsigned int csm_timeout)
Set the CSM timeout value.
 
void coap_send_recv_terminate(void)
Terminate any active coap_send_recv() sessions.
 
coap_resource_t *(* coap_resource_dynamic_create_t)(coap_session_t *session, const coap_pdu_t *request)
Definition of resource dynamic creation handler function.
 
void coap_register_response_handler(coap_context_t *context, coap_response_handler_t handler)
Registers a new message handler that is called whenever a response is received.
 
COAP_API void * coap_context_set_app_data2(coap_context_t *context, void *app_data, coap_app_data_free_callback_t callback)
Stores data with the given context, returning the previously stored value or NULL.
 
coap_pdu_t * coap_new_error_response(const coap_pdu_t *request, coap_pdu_code_t code, coap_opt_filter_t *opts)
Creates a new ACK PDU with specified error code.
 
void coap_context_set_max_handshake_sessions(coap_context_t *context, unsigned int max_handshake_sessions)
Set the maximum number of sessions in (D)TLS handshake value.
 
int coap_context_get_coap_fd(const coap_context_t *context)
Get the libcoap internal file descriptor for using in an application's select() or returned as an eve...
 
void coap_register_dynamic_resource_handler(coap_context_t *context, coap_resource_dynamic_create_t dyn_create_handler, uint32_t dynamic_max)
Sets up a handler for calling when an unknown resource is requested.
 
COAP_API void coap_set_app_data(coap_context_t *context, void *app_data)
 
int coap_mcast_set_hops(coap_session_t *session, size_t hops)
Function interface for defining the hop count (ttl) for sending multicast traffic.
 
void(* coap_ping_handler_t)(coap_session_t *session, const coap_pdu_t *received, const coap_mid_t mid)
Received Ping handler that is used as callback in coap_context_t.
 
void coap_ticks(coap_tick_t *t)
Returns the current value of an internal tick counter.
 
COAP_API void coap_free_context(coap_context_t *context)
CoAP stack context must be released with coap_free_context().
 
void(* coap_nack_handler_t)(coap_session_t *session, const coap_pdu_t *sent, const coap_nack_reason_t reason, const coap_mid_t mid)
Negative Acknowedge handler that is used as callback in coap_context_t.
 
void coap_context_set_shutdown_no_observe(coap_context_t *context)
 
void * coap_context_get_app_data(const coap_context_t *context)
Returns any application-specific data that has been stored with context using the function coap_conte...
 
COAP_API int coap_context_set_pki_root_cas(coap_context_t *ctx, const char *ca_file, const char *ca_dir)
Set the context's default Root CA information for a client or server.
 
COAP_API void coap_context_set_app_data(coap_context_t *context, void *app_data)
Stores data with the given context.
 
uint32_t coap_context_get_csm_max_message_size(const coap_context_t *context)
Get the CSM max session size value.
 
unsigned int coap_context_get_session_timeout(const coap_context_t *context)
Get the session timeout value.
 
COAP_API int coap_context_set_psk(coap_context_t *context, const char *hint, const uint8_t *key, size_t key_len)
Set the context's default PSK hint and/or key for a server.
 
COAP_API coap_mid_t coap_send_ack(coap_session_t *session, const coap_pdu_t *request)
Sends an ACK message with code 0 for the specified request to dst.
 
unsigned int coap_context_get_csm_timeout_ms(const coap_context_t *context)
Get the CSM timeout value.
 
void coap_register_ping_handler(coap_context_t *context, coap_ping_handler_t handler)
Registers a new message handler that is called whenever a CoAP Ping message is received.
 
COAP_API int coap_context_set_psk2(coap_context_t *context, coap_dtls_spsk_t *setup_data)
Set the context's default PSK hint and/or key for a server.
 
void * coap_get_app_data(const coap_context_t *ctx)
 
int coap_context_set_cid_tuple_change(coap_context_t *context, uint8_t every)
Set the Connection ID client tuple frequency change for testing CIDs.
 
void coap_context_set_max_idle_sessions(coap_context_t *context, unsigned int max_idle_sessions)
Set the maximum idle sessions count.
 
COAP_API coap_mid_t coap_send_message_type(coap_session_t *session, const coap_pdu_t *request, coap_pdu_type_t type)
Helper function to create and send a message with type (usually ACK or RST).
 
COAP_API coap_mid_t coap_send_rst(coap_session_t *session, const coap_pdu_t *request)
Sends an RST message with code 0 for the specified request to dst.
 
void coap_context_set_keepalive(coap_context_t *context, unsigned int seconds)
Set the context keepalive timer for sessions.
 
COAP_API int coap_can_exit(coap_context_t *context)
Returns 1 if there are no messages to send or to dispatch in the context's queues.
 
COAP_API void coap_register_option(coap_context_t *ctx, uint16_t type)
Registers the option number number with the given context object context.
 
unsigned int coap_context_get_csm_timeout(const coap_context_t *context)
Get the CSM timeout value.
 
COAP_API int coap_context_load_pki_trust_store(coap_context_t *ctx)
Load the hosts's default trusted CAs for a client or server.
 
void coap_context_set_session_reconnect_time(coap_context_t *context, unsigned int reconnect_time)
Set the session reconnect delay time after a working client session has failed.
 
void coap_register_pong_handler(coap_context_t *context, coap_pong_handler_t handler)
Registers a new message handler that is called whenever a CoAP Pong message is received.
 
void coap_context_set_max_token_size(coap_context_t *context, size_t max_token_size)
Set the maximum token size (RFC8974).
 
COAP_API int coap_handle_event(coap_context_t *context, coap_event_t event, coap_session_t *session)
Invokes the event handler of context for the given event and data.
 
void coap_register_nack_handler(coap_context_t *context, coap_nack_handler_t handler)
Registers a new message handler that is called whenever a confirmable message (request or response) i...
 
void coap_context_set_csm_timeout_ms(coap_context_t *context, unsigned int csm_timeout_ms)
Set the CSM timeout value.
 
@ COAP_RESPONSE_FAIL
Response not liked - send CoAP RST packet.
 
@ COAP_RESPONSE_OK
Response is fine.
 
const coap_bin_const_t * coap_get_session_client_psk_identity(const coap_session_t *coap_session)
Get the current client's PSK identity.
 
void coap_dtls_startup(void)
Initialize the underlying (D)TLS Library layer.
 
coap_session_t * coap_session_new_dtls_session(coap_session_t *session, coap_tick_t now)
Create a new DTLS session for the session.
 
int coap_dtls_hello(coap_session_t *coap_session, const uint8_t *data, size_t data_len)
Handling client HELLO messages from a new candiate peer.
 
int coap_dtls_set_cid_tuple_change(coap_context_t *context, uint8_t every)
Set the Connection ID client tuple frequency change for testing CIDs.
 
int coap_dtls_context_set_spsk(coap_context_t *coap_context, coap_dtls_spsk_t *setup_data)
Set the DTLS context's default server PSK information.
 
void coap_dtls_shutdown(void)
Close down the underlying (D)TLS Library layer.
 
const coap_bin_const_t * coap_get_session_client_psk_key(const coap_session_t *coap_session)
Get the current client's PSK key.
 
const coap_bin_const_t * coap_get_session_server_psk_key(const coap_session_t *coap_session)
Get the current server's PSK key.
 
const coap_bin_const_t * coap_get_session_server_psk_hint(const coap_session_t *coap_session)
Get the current server's PSK identity hint.
 
#define COAP_DTLS_PKI_SETUP_VERSION
Latest PKI setup version.
 
@ COAP_DTLS_ROLE_SERVER
Internal function invoked for server.
 
unsigned int coap_encode_var_safe(uint8_t *buf, size_t length, unsigned int val)
Encodes multiple-length byte sequences.
 
unsigned int coap_decode_var_bytes(const uint8_t *buf, size_t len)
Decodes multiple-length byte sequences.
 
uint64_t coap_decode_var_bytes8(const uint8_t *buf, size_t len)
Decodes multiple-length byte sequences.
 
unsigned int coap_encode_var_safe8(uint8_t *buf, size_t length, uint64_t val)
Encodes multiple-length byte sequences.
 
coap_event_t
Scalar type to represent different events, e.g.
 
@ COAP_EVENT_OSCORE_DECODE_ERROR
Triggered when there is an OSCORE decode of OSCORE option failure.
 
@ COAP_EVENT_SESSION_CONNECTED
Triggered when TCP layer completes exchange of CSM information.
 
@ COAP_EVENT_OSCORE_INTERNAL_ERROR
Triggered when there is an OSCORE internal error i.e malloc failed.
 
@ COAP_EVENT_DTLS_CLOSED
Triggerred when (D)TLS session closed.
 
@ COAP_EVENT_TCP_FAILED
Triggered when TCP layer fails for some reason.
 
@ COAP_EVENT_WS_CONNECTED
Triggered when the WebSockets layer is up.
 
@ COAP_EVENT_DTLS_CONNECTED
Triggered when (D)TLS session connected.
 
@ COAP_EVENT_SESSION_FAILED
Triggered when TCP layer fails following exchange of CSM information.
 
@ COAP_EVENT_PARTIAL_BLOCK
Triggered when not all of a large body has been received.
 
@ COAP_EVENT_XMIT_BLOCK_FAIL
Triggered when not all of a large body has been transmitted.
 
@ COAP_EVENT_SERVER_SESSION_NEW
Called in the CoAP IO loop if a new server-side session is created due to an incoming connection.
 
@ COAP_EVENT_OSCORE_NOT_ENABLED
Triggered when trying to use OSCORE to decrypt, but it is not enabled.
 
@ COAP_EVENT_WS_CLOSED
Triggered when the WebSockets layer is closed.
 
@ COAP_EVENT_SESSION_CLOSED
Triggered when TCP layer closes following exchange of CSM information.
 
@ COAP_EVENT_SERVER_SESSION_DEL
Called in the CoAP IO loop if a server session is deleted (e.g., due to inactivity or because the max...
 
@ COAP_EVENT_OSCORE_NO_SECURITY
Triggered when there is no OSCORE security definition found.
 
@ COAP_EVENT_DTLS_RENEGOTIATE
Triggered when (D)TLS session renegotiated.
 
@ COAP_EVENT_BAD_PACKET
Triggered when badly formatted packet received.
 
@ COAP_EVENT_SERVER_SESSION_CONNECTED
Called in the CoAP IO loop once a server session is active and (D)TLS (if any) is established.
 
@ COAP_EVENT_MSG_RETRANSMITTED
Triggered when a message is retransmitted.
 
@ COAP_EVENT_OSCORE_NO_PROTECTED_PAYLOAD
Triggered when there is no OSCORE encrypted payload provided.
 
@ COAP_EVENT_TCP_CLOSED
Triggered when TCP layer is closed.
 
@ COAP_EVENT_WS_PACKET_SIZE
Triggered when there is an oversize WebSockets packet.
 
@ COAP_EVENT_TCP_CONNECTED
Triggered when TCP layer connects.
 
@ COAP_EVENT_OSCORE_DECRYPTION_FAILURE
Triggered when there is an OSCORE decryption failure.
 
@ COAP_EVENT_KEEPALIVE_FAILURE
Triggered when no response to a keep alive (ping) packet.
 
@ COAP_EVENT_DTLS_ERROR
Triggered when (D)TLS error occurs.
 
#define coap_lock_callback(func)
Dummy for no thread-safe code.
 
#define coap_lock_callback_ret(r, func)
Dummy for no thread-safe code.
 
#define coap_lock_callback_ret_release(r, func, failed)
Dummy for no thread-safe code.
 
#define coap_lock_unlock()
Dummy for no thread-safe code.
 
#define coap_lock_check_locked()
Dummy for no thread-safe code.
 
#define coap_lock_callback_release(func, failed)
Dummy for no thread-safe code.
 
#define coap_lock_lock(failed)
Dummy for no thread-safe code.
 
#define coap_lock_init()
Dummy for no thread-safe code.
 
#define coap_log_debug(...)
 
coap_log_t coap_get_log_level(void)
Get the current logging level.
 
#define coap_log_alert(...)
 
void coap_show_pdu(coap_log_t level, const coap_pdu_t *pdu)
Display the contents of the specified pdu.
 
#define coap_log_emerg(...)
 
size_t coap_print_addr(const coap_address_t *addr, unsigned char *buf, size_t len)
Print the address into the defined buffer.
 
const char * coap_endpoint_str(const coap_endpoint_t *endpoint)
Get endpoint description.
 
const char * coap_session_str(const coap_session_t *session)
Get session description.
 
#define coap_log_info(...)
 
#define coap_log_warn(...)
 
#define coap_log_err(...)
 
int coap_netif_strm_connect2(coap_session_t *session)
Layer function interface for Netif stream connect (tcp).
 
ssize_t coap_netif_dgrm_read(coap_session_t *session, coap_packet_t *packet)
Function interface for layer data datagram receiving for sessions.
 
ssize_t coap_netif_dgrm_read_ep(coap_endpoint_t *endpoint, coap_packet_t *packet)
Function interface for layer data datagram receiving for endpoints.
 
int coap_netif_available(coap_session_t *session)
Function interface to check whether netif for session is still available.
 
#define COAP_OBSERVE_CANCEL
The value COAP_OBSERVE_CANCEL in a GET/FETCH request option COAP_OPTION_OBSERVE indicates that the ob...
 
#define COAP_OBSERVE_ESTABLISH
The value COAP_OBSERVE_ESTABLISH in a GET/FETCH request option COAP_OPTION_OBSERVE indicates a new ob...
 
coap_opt_t * coap_option_next(coap_opt_iterator_t *oi)
Updates the iterator oi to point to the next option.
 
uint32_t coap_opt_length(const coap_opt_t *opt)
Returns the length of the given option.
 
coap_opt_iterator_t * coap_option_iterator_init(const coap_pdu_t *pdu, coap_opt_iterator_t *oi, const coap_opt_filter_t *filter)
Initializes the given option iterator oi to point to the beginning of the pdu's option list.
 
#define COAP_OPT_ALL
Pre-defined filter that includes all options.
 
void coap_option_filter_clear(coap_opt_filter_t *filter)
Clears filter filter.
 
coap_opt_t * coap_check_option(const coap_pdu_t *pdu, coap_option_num_t number, coap_opt_iterator_t *oi)
Retrieves the first option of number number from pdu.
 
const uint8_t * coap_opt_value(const coap_opt_t *opt)
Returns a pointer to the value of the given option.
 
int coap_option_filter_get(coap_opt_filter_t *filter, coap_option_num_t option)
Checks if number is contained in filter.
 
int coap_option_filter_set(coap_opt_filter_t *filter, coap_option_num_t option)
Sets the corresponding entry for number in filter.
 
coap_pdu_t * coap_oscore_new_pdu_encrypted_lkd(coap_session_t *session, coap_pdu_t *pdu, coap_bin_const_t *kid_context, oscore_partial_iv_t send_partial_iv)
Encrypts the specified pdu when OSCORE encryption is required on session.
 
struct coap_pdu_t * coap_oscore_decrypt_pdu(coap_session_t *session, coap_pdu_t *pdu)
Decrypts the OSCORE-encrypted parts of pdu when OSCORE is used.
 
int coap_rebuild_pdu_for_proxy(coap_pdu_t *pdu)
Convert PDU to use Proxy-Scheme option if Proxy-Uri option is present.
 
void coap_delete_all_oscore(coap_context_t *context)
Cleanup all allocated OSCORE information.
 
#define COAP_PDU_IS_RESPONSE(pdu)
 
coap_pdu_t * coap_pdu_reference_lkd(coap_pdu_t *pdu)
Increment reference counter on a pdu to stop it prematurely getting freed off when coap_delete_pdu() ...
 
void coap_delete_pdu_lkd(coap_pdu_t *pdu)
Dispose of an CoAP PDU and free off associated storage.
 
#define COAP_TOKEN_EXT_2B_TKL
 
size_t coap_insert_option(coap_pdu_t *pdu, coap_option_num_t number, size_t len, const uint8_t *data)
Inserts option of given number in the pdu with the appropriate data.
 
int coap_remove_option(coap_pdu_t *pdu, coap_option_num_t number)
Removes (first) option of given number from the pdu.
 
int coap_pdu_parse_opt(coap_pdu_t *pdu, coap_opt_filter_t *error_opts)
Verify consistency in the given CoAP PDU structure and locate the data.
 
#define COAP_DROPPED_RESPONSE
Indicates that a response is suppressed.
 
int coap_pdu_parse_header(coap_pdu_t *pdu, coap_proto_t proto)
Decode the protocol specific header for the specified PDU.
 
size_t coap_pdu_parse_header_size(coap_proto_t proto, const uint8_t *data)
Interprets data to determine the number of bytes in the header.
 
#define COAP_PDU_IS_EMPTY(pdu)
 
#define COAP_PDU_IS_SIGNALING(pdu)
 
int coap_option_check_repeatable(coap_option_num_t number)
Check whether the option is allowed to be repeated or not.
 
size_t coap_update_option(coap_pdu_t *pdu, coap_option_num_t number, size_t len, const uint8_t *data)
Updates existing first option of given number in the pdu with the new data.
 
#define COAP_TOKEN_EXT_1B_TKL
 
size_t coap_pdu_encode_header(coap_pdu_t *pdu, coap_proto_t proto)
Compose the protocol specific header for the specified PDU.
 
#define COAP_DEFAULT_VERSION
 
int coap_pdu_parse2(coap_proto_t proto, const uint8_t *data, size_t length, coap_pdu_t *pdu, coap_opt_filter_t *error_opts)
Parses data into the CoAP PDU structure given in result.
 
size_t coap_pdu_parse_size(coap_proto_t proto, const uint8_t *data, size_t length)
Parses data to extract the message size.
 
int coap_pdu_resize(coap_pdu_t *pdu, size_t new_size)
Dynamically grows the size of pdu to new_size.
 
#define COAP_PDU_IS_REQUEST(pdu)
 
size_t coap_add_option_internal(coap_pdu_t *pdu, coap_option_num_t number, size_t len, const uint8_t *data)
Adds option of given number to pdu that is passed as first parameter.
 
#define COAP_OPTION_HOP_LIMIT
 
#define COAP_OPTION_NORESPONSE
 
#define COAP_OPTION_URI_HOST
 
#define COAP_OPTION_IF_MATCH
 
#define COAP_OPTION_BLOCK2
 
const char * coap_response_phrase(unsigned char code)
Returns a human-readable response phrase for the specified CoAP response code.
 
#define COAP_OPTION_CONTENT_FORMAT
 
#define COAP_OPTION_BLOCK1
 
#define COAP_OPTION_Q_BLOCK1
 
#define COAP_OPTION_PROXY_SCHEME
 
#define COAP_OPTION_URI_QUERY
 
int coap_mid_t
coap_mid_t is used to store the CoAP Message ID of a CoAP PDU.
 
#define COAP_TOKEN_DEFAULT_MAX
 
#define COAP_OPTION_IF_NONE_MATCH
 
#define COAP_TOKEN_EXT_MAX
 
#define COAP_OPTION_URI_PATH
 
#define COAP_SIGNALING_OPTION_EXTENDED_TOKEN_LENGTH
 
#define COAP_RESPONSE_CODE(N)
 
#define COAP_RESPONSE_CLASS(C)
 
coap_pdu_code_t
Set of codes available for a PDU.
 
#define COAP_OPTION_OSCORE
 
coap_pdu_type_t
CoAP PDU message type definitions.
 
#define COAP_SIGNALING_OPTION_BLOCK_WISE_TRANSFER
 
int coap_add_token(coap_pdu_t *pdu, size_t len, const uint8_t *data)
Adds token of length len to pdu.
 
#define COAP_OPTION_Q_BLOCK2
 
#define COAP_SIGNALING_OPTION_CUSTODY
 
int coap_pdu_parse(coap_proto_t proto, const uint8_t *data, size_t length, coap_pdu_t *pdu)
Parses data into the CoAP PDU structure given in result.
 
#define COAP_OPTION_URI_PORT
 
coap_pdu_t * coap_pdu_init(coap_pdu_type_t type, coap_pdu_code_t code, coap_mid_t mid, size_t size)
Creates a new CoAP PDU with at least enough storage space for the given size maximum message size.
 
#define COAP_OPTION_ACCEPT
 
#define COAP_INVALID_MID
Indicates an invalid message id.
 
#define COAP_OPTION_PROXY_URI
 
#define COAP_OPTION_OBSERVE
 
#define COAP_DEFAULT_URI_WELLKNOWN
well-known resources URI
 
#define COAP_MEDIATYPE_APPLICATION_LINK_FORMAT
 
#define COAP_SIGNALING_OPTION_MAX_MESSAGE_SIZE
 
int coap_add_data(coap_pdu_t *pdu, size_t len, const uint8_t *data)
Adds given data to the pdu that is passed as first parameter.
 
@ COAP_SIGNALING_CODE_ABORT
 
@ COAP_SIGNALING_CODE_CSM
 
@ COAP_SIGNALING_CODE_PING
 
@ COAP_REQUEST_CODE_DELETE
 
@ COAP_SIGNALING_CODE_PONG
 
@ COAP_SIGNALING_CODE_RELEASE
 
@ COAP_REQUEST_CODE_FETCH
 
void coap_register_proxy_response_handler(coap_context_t *context, coap_proxy_response_handler_t handler)
Registers a new message handler that is called whenever a response is received by the proxy logic.
 
coap_pdu_t *(* coap_proxy_response_handler_t)(coap_session_t *session, const coap_pdu_t *sent, coap_pdu_t *received, coap_cache_key_t *cache_key)
Proxy response handler that is used as callback held in coap_context_t.
 
void coap_connect_session(coap_session_t *session, coap_tick_t now)
 
ssize_t coap_session_delay_pdu(coap_session_t *session, coap_pdu_t *pdu, coap_queue_t *node)
 
#define COAP_DEFAULT_LEISURE_TICKS(s)
The DEFAULT_LEISURE definition for the session (s).
 
void coap_handle_nack(coap_session_t *session, coap_pdu_t *sent, const coap_nack_reason_t reason, const coap_mid_t mid)
 
size_t coap_session_max_pdu_rcv_size(const coap_session_t *session)
Get maximum acceptable receive PDU size.
 
coap_session_t * coap_endpoint_get_session(coap_endpoint_t *endpoint, const coap_packet_t *packet, coap_tick_t now)
Lookup the server session for the packet received on an endpoint, or create a new one.
 
void coap_free_endpoint_lkd(coap_endpoint_t *endpoint)
Release an endpoint and all the structures associated with it.
 
void coap_read_session(coap_context_t *ctx, coap_session_t *session, coap_tick_t now)
 
int coap_session_reconnect(coap_session_t *session)
Close the current session (if not already closed) and reconnect to server (client session only).
 
void coap_session_server_keepalive_failed(coap_session_t *session)
Clear down a session following a keepalive failure.
 
#define COAP_MAX_PAYLOADS(s)
 
void coap_session_connected(coap_session_t *session)
Notify session that it has just connected or reconnected.
 
ssize_t coap_session_send_pdu(coap_session_t *session, coap_pdu_t *pdu)
Send a pdu according to the session's protocol.
 
size_t coap_session_max_pdu_size_lkd(const coap_session_t *session)
Get maximum acceptable PDU size.
 
void coap_session_release_lkd(coap_session_t *session)
Decrement reference counter on a session.
 
coap_session_t * coap_session_reference_lkd(coap_session_t *session)
Increment reference counter on a session.
 
void coap_session_disconnected_lkd(coap_session_t *session, coap_nack_reason_t reason)
Notify session that it has failed.
 
coap_endpoint_t * coap_new_endpoint_lkd(coap_context_t *context, const coap_address_t *listen_addr, coap_proto_t proto)
Create a new endpoint for communicating with peers.
 
coap_session_t * coap_new_server_session(coap_context_t *ctx, coap_endpoint_t *ep, void *extra)
Creates a new server session for the specified endpoint.
 
@ COAP_EXT_T_NOT_CHECKED
Not checked.
 
@ COAP_EXT_T_CHECKING
Token size check request sent.
 
@ COAP_EXT_T_CHECKED
Token size valid.
 
void coap_session_set_mtu(coap_session_t *session, unsigned mtu)
Set the session MTU.
 
coap_session_state_t
coap_session_state_t values
 
#define COAP_PROTO_NOT_RELIABLE(p)
 
#define COAP_PROTO_RELIABLE(p)
 
void(* coap_app_data_free_callback_t)(void *data)
Callback to free off the app data when the entry is being deleted / freed off.
 
@ COAP_SESSION_TYPE_HELLO
server-side ephemeral session for responding to a client hello
 
@ COAP_SESSION_TYPE_SERVER
server-side
 
@ COAP_SESSION_TYPE_CLIENT
client-side
 
@ COAP_SESSION_STATE_ESTABLISHED
 
@ COAP_SESSION_STATE_NONE
 
void coap_delete_bin_const(coap_bin_const_t *s)
Deletes the given const binary data and releases any memory allocated.
 
coap_binary_t * coap_new_binary(size_t size)
Returns a new binary object with at least size bytes storage allocated.
 
coap_bin_const_t * coap_new_bin_const(const uint8_t *data, size_t size)
Take the specified byte array (text) and create a coap_bin_const_t * Returns a new const binary objec...
 
void coap_delete_binary(coap_binary_t *s)
Deletes the given coap_binary_t object and releases any memory allocated.
 
#define coap_binary_equal(binary1, binary2)
Compares the two binary data for equality.
 
#define coap_string_equal(string1, string2)
Compares the two strings for equality.
 
coap_string_t * coap_new_string(size_t size)
Returns a new string object with at least size+1 bytes storage allocated.
 
void coap_delete_string(coap_string_t *s)
Deletes the given string and releases any memory allocated.
 
int coap_delete_observer_request(coap_resource_t *resource, coap_session_t *session, const coap_bin_const_t *token, coap_pdu_t *request)
Removes any subscription for session observer from resource and releases the allocated storage.
 
void coap_persist_cleanup(coap_context_t *context)
Close down persist tracking, releasing any memory used.
 
int coap_delete_observer(coap_resource_t *resource, coap_session_t *session, const coap_bin_const_t *token)
Removes any subscription for session observer from resource and releases the allocated storage.
 
int coap_cancel_observe_lkd(coap_session_t *session, coap_binary_t *token, coap_pdu_type_t message_type)
Cancel an observe that is being tracked by the client large receive logic.
 
void coap_handle_failed_notify(coap_context_t *context, coap_session_t *session, const coap_bin_const_t *token)
Handles a failed observe notify.
 
coap_subscription_t * coap_add_observer(coap_resource_t *resource, coap_session_t *session, const coap_bin_const_t *token, const coap_pdu_t *pdu)
Adds the specified peer as observer for resource.
 
void coap_touch_observer(coap_context_t *context, coap_session_t *session, const coap_bin_const_t *token)
Flags that data is ready to be sent to observers.
 
int coap_epoll_is_supported(void)
Determine whether epoll is supported or not.
 
int coap_tls_is_supported(void)
Check whether TLS is available.
 
int coap_af_unix_is_supported(void)
Check whether socket type AF_UNIX is available.
 
int coap_ipv6_is_supported(void)
Check whether IPv6 is available.
 
int coap_threadsafe_is_supported(void)
Determine whether libcoap is threadsafe or not.
 
int coap_dtls_is_supported(void)
Check whether DTLS is available.
 
int coap_server_is_supported(void)
Check whether Server code is available.
 
int coap_client_is_supported(void)
Check whether Client code is available.
 
int coap_ipv4_is_supported(void)
Check whether IPv4 is available.
 
coap_string_t * coap_get_uri_path(const coap_pdu_t *request)
Extract uri_path string from request PDU.
 
int coap_split_proxy_uri(const uint8_t *str_var, size_t len, coap_uri_t *uri)
Parses a given string into URI components.
 
coap_string_t * coap_get_query(const coap_pdu_t *request)
Extract query string from request PDU according to escape rules in 6.5.8.
 
#define COAP_STATIC_INLINE
 
coap_address_t remote
remote address and port
 
coap_address_t local
local address and port
 
Multi-purpose address abstraction.
 
union coap_address_t::@0 addr
 
CoAP binary data definition with const data.
 
size_t length
length of binary data
 
const uint8_t * s
read-only binary data
 
CoAP binary data definition.
 
size_t length
length of binary data
 
Structure of Block options with BERT support.
 
unsigned int num
block number
 
uint32_t chunk_size
1024 if BERT
 
unsigned int bert
Operating as BERT.
 
unsigned int aszx
block size (0-7 including BERT
 
unsigned int defined
Set if block found.
 
unsigned int m
1 if more blocks follow, 0 otherwise
 
unsigned int szx
block size (0-6)
 
The CoAP stack's global state is stored in a coap_context_t object.
 
coap_tick_t sendqueue_basetime
The time stamp in the first element of the sendqeue is relative to sendqueue_basetime.
 
coap_pong_handler_t pong_handler
Called when a ping response is received.
 
coap_app_data_free_callback_t app_cb
call-back to release app_data
 
unsigned int reconnect_time
Time to wait before reconnecting a failed client session.
 
uint8_t shutdown_no_send_observe
Do not send out unsolicited observe when coap_free_context() is called.
 
coap_resource_dynamic_create_t dyn_create_handler
Dynamc resource create handler.
 
coap_session_t * sessions
client sessions
 
coap_nack_handler_t nack_handler
Called when a response issue has occurred.
 
void * app_data
application-specific data
 
unsigned int ping_timeout
Minimum inactivity time before sending a ping message.
 
coap_resource_t * resources
hash table or list of known resources
 
uint16_t * cache_ignore_options
CoAP options to ignore when creating a cache-key.
 
coap_opt_filter_t known_options
 
coap_ping_handler_t ping_handler
Called when a CoAP ping is received.
 
uint32_t csm_max_message_size
Value for CSM Max-Message-Size.
 
size_t cache_ignore_count
The number of CoAP options to ignore when creating a cache-key.
 
unsigned int max_handshake_sessions
Maximum number of simultaneous negotating sessions per endpoint.
 
uint32_t max_token_size
Largest token size supported RFC8974.
 
coap_response_handler_t response_handler
Called when a response is received.
 
coap_cache_entry_t * cache
CoAP cache-entry cache.
 
uint8_t mcast_per_resource
Mcast controlled on a per resource basis.
 
coap_endpoint_t * endpoint
the endpoints used for listening
 
uint32_t csm_timeout_ms
Timeout for waiting for a CSM from the remote side.
 
coap_event_handler_t handle_event
Callback function that is used to signal events to the application.
 
unsigned int session_timeout
Number of seconds of inactivity after which an unused session will be closed.
 
uint8_t observe_no_clear
Observe 4.04 not to be sent on deleting resource.
 
uint32_t block_mode
Zero or more COAP_BLOCK_ or'd options.
 
coap_resource_t * proxy_uri_resource
can be used for handling proxy URI resources
 
coap_dtls_spsk_t spsk_setup_data
Contains the initial PSK server setup data.
 
coap_resource_t * unknown_resource
can be used for handling unknown resources
 
unsigned int max_idle_sessions
Maximum number of simultaneous unused sessions per endpoint.
 
coap_bin_const_t identity
 
coap_dtls_cpsk_info_t psk_info
Client PSK definition.
 
The structure used for defining the PKI setup data to be used.
 
The structure used for defining the Server PSK setup data to be used.
 
coap_dtls_spsk_info_t psk_info
Server PSK definition.
 
Abstraction of virtual endpoint that can be attached to coap_context_t.
 
coap_context_t * context
endpoint's context
 
coap_session_t * sessions
hash table or list of active sessions
 
coap_address_t bind_addr
local interface address
 
coap_socket_t sock
socket object for the interface, if any
 
coap_proto_t proto
protocol used on this interface
 
uint64_t state_token
state token
 
uint32_t count
the number of packets sent for payload
 
coap_binary_t * app_token
original PDU token
 
coap_layer_write_t l_write
 
coap_layer_establish_t l_establish
 
Structure to hold large body (many blocks) client receive information.
 
uint64_t state_token
state token
 
coap_binary_t * app_token
app requesting PDU token
 
Structure to hold large body (many blocks) server receive information.
 
Structure to hold large body (many blocks) transmission information.
 
coap_tick_t last_all_sent
Last time all data sent or 0.
 
uint8_t blk_size
large block transmission size
 
union coap_lg_xmit_t::@1 b
 
int last_block
last acknowledged block number Block1 last transmitted Q-Block2
 
coap_pdu_t * sent_pdu
The sent pdu with all the data.
 
uint16_t option
large block transmisson CoAP option
 
Iterator to run through PDU options.
 
coap_option_num_t number
decoded option number
 
size_t length
length of payload
 
coap_addr_tuple_t addr_info
local and remote addresses
 
unsigned char * payload
payload
 
uint8_t * token
first byte of token (or extended length bytes prefix), if any, or options
 
size_t max_size
maximum size for token, options and payload, or zero for variable size pdu
 
coap_pdu_code_t code
request method (value 1–31) or response code (value 64-255)
 
uint8_t hdr_size
actual size used for protocol-specific header (0 until header is encoded)
 
coap_bin_const_t actual_token
Actual token in pdu.
 
uint8_t * data
first byte of payload, if any
 
coap_mid_t mid
message id, if any, in regular host byte order
 
uint32_t e_token_length
length of Token space (includes leading extended bytes
 
size_t used_size
used bytes of storage for token, options and payload
 
uint8_t crit_opt
Set if unknown critical option for proxy.
 
coap_binary_t * data_free
Data to be freed off by coap_delete_pdu()
 
size_t alloc_size
allocated storage for token, options and payload
 
coap_session_t * session
Session responsible for PDU or NULL.
 
coap_pdu_type_t type
message type
 
coap_address_t remote
For re-transmission - where the node is going.
 
coap_session_t * session
the CoAP session
 
coap_pdu_t * pdu
the CoAP PDU to send
 
unsigned int timeout
the randomized timeout value
 
uint8_t is_mcast
Set if this is a queued mcast response.
 
struct coap_queue_t * next
 
coap_mid_t id
CoAP message id.
 
coap_tick_t t
when to send PDU for the next time
 
unsigned char retransmit_cnt
retransmission counter, will be removed when zero
 
Abstraction of resource that can be attached to coap_context_t.
 
coap_str_const_t ** proxy_name_list
Array valid names this host is known by (proxy support)
 
coap_str_const_t * uri_path
Request URI Path for this resource.
 
unsigned int observe
The next value for the Observe option.
 
coap_method_handler_t handler[7]
Used to store handlers for the seven coap methods GET, POST, PUT, DELETE, FETCH, PATCH and IPATCH.
 
uint32_t ref
Resource reference count.
 
unsigned int is_proxy_uri
resource created for proxy URI handler
 
unsigned int is_dynamic
create unknown resource dynamically
 
unsigned int is_unknown
resource created for unknown handler
 
unsigned int is_reverse_proxy
resource created for reverse proxy URI handler
 
unsigned int observable
can be observed
 
size_t proxy_name_count
Count of valid names this host is known by (proxy support)
 
int flags
zero or more COAP_RESOURCE_FLAGS_* or'd together
 
Abstraction of virtual session that can be attached to coap_context_t (client) or coap_endpoint_t (se...
 
coap_lg_xmit_t * lg_xmit
list of large transmissions
 
volatile uint8_t max_token_checked
Check for max token size coap_ext_token_check_t.
 
uint8_t csm_not_seen
Set if timeout waiting for CSM.
 
unsigned ref_subscriptions
reference count of current subscriptions
 
coap_bin_const_t * psk_key
If client, this field contains the current pre-shared key for server; When this field is NULL,...
 
uint32_t block_mode
Zero or more COAP_BLOCK_ or'd options.
 
uint8_t doing_first
Set if doing client's first request.
 
uint8_t delay_recursive
Set if in coap_client_delay_first()
 
coap_socket_t sock
socket object for the session, if any
 
coap_pdu_t * partial_pdu
incomplete incoming pdu
 
uint32_t max_token_size
Largest token size supported RFC8974.
 
coap_bin_const_t * psk_identity
If client, this field contains the current identity for server; When this field is NULL,...
 
coap_session_state_t state
current state of relationship with peer
 
uint8_t csm_bert_rem_support
CSM TCP BERT blocks supported (remote)
 
coap_digest_t cached_pdu_cksum
Checksum of last CON request PDU.
 
coap_mid_t remote_test_mid
mid used for checking remote support
 
uint8_t read_header[8]
storage space for header of incoming message header
 
unsigned ref_proxy_subs
reference count of current proxy subscriptions
 
coap_addr_tuple_t addr_info
remote/local address info
 
coap_proto_t proto
protocol used
 
unsigned ref
reference count from queues
 
coap_response_t last_con_handler_res
The result of calling the response handler of the last CON.
 
coap_bin_const_t * psk_hint
If client, this field contains the server provided identity hint.
 
coap_bin_const_t * last_token
 
uint8_t doing_send_recv
Set if coap_send_recv() active.
 
coap_dtls_cpsk_t cpsk_setup_data
client provided PSK initial setup data
 
size_t mtu
path or CSM mtu (xmt)
 
size_t partial_read
if > 0 indicates number of bytes already read for an incoming message
 
void * tls
security parameters
 
uint16_t max_retransmit
maximum re-transmit count (default 4)
 
uint8_t csm_block_supported
CSM TCP blocks supported.
 
uint8_t proxy_session
Set if this is an ongoing proxy session.
 
uint8_t con_active
Active CON request sent.
 
coap_queue_t * delayqueue
list of delayed messages waiting to be sent
 
uint32_t tx_rtag
Next Request-Tag number to use.
 
coap_mid_t last_ping_mid
the last keepalive message id that was used in this session
 
coap_lg_srcv_t * lg_srcv
Server list of expected large receives.
 
coap_bin_const_t * req_token
Token in request pdu of coap_send_recv()
 
coap_pdu_t * resp_pdu
PDU returned in coap_send_recv() call.
 
coap_lg_crcv_t * lg_crcv
Client list of expected large receives.
 
coap_mid_t last_con_mid
The last CON mid that has been been processed.
 
coap_session_type_t type
client or server side socket
 
coap_mid_t last_ack_mid
The last ACK mid that has been been processed.
 
coap_context_t * context
session's context
 
uint8_t session_failed
Set if session failed and can try re-connect.
 
size_t partial_write
if > 0 indicates number of bytes already written from the pdu at the head of sendqueue
 
coap_pdu_t * cached_pdu
Cached copy of last ACK response PDU.
 
coap_bin_const_t * echo
last token used to make a request
 
coap_layer_func_t lfunc[COAP_LAYER_LAST]
Layer functions to use.
 
coap_session_t * session
Used to determine session owner.
 
coap_endpoint_t * endpoint
Used by the epoll logic for a listening endpoint.
 
coap_address_t mcast_addr
remote address and port (multicast track)
 
coap_socket_flags_t flags
1 or more of COAP_SOCKET* flag values
 
CoAP string data definition with const data.
 
const uint8_t * s
read-only string data
 
size_t length
length of string
 
CoAP string data definition.
 
size_t length
length of string
 
Number of notifications that may be sent non-confirmable before a confirmable message is sent to dete...
 
struct coap_session_t * session
subscriber session
 
coap_pdu_t * pdu
cache_key to identify requester
 
Representation of parsed URI.
 
coap_str_const_t host
The host part of the URI.