coap_uri.h

Go to the documentation of this file.

/*
 * coap_uri.h -- helper functions for URI treatment
 *
 * Copyright (C) 2010-2026 Olaf Bergmann <bergmann@tzi.org>
 *
 * SPDX-License-Identifier: BSD-2-Clause
 *
 * This file is part of the CoAP library libcoap. Please see README for terms
 * of use.
 */
 
#ifndef COAP_URI_H_
#define COAP_URI_H_
 
#include "coap_str.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
typedef enum coap_uri_scheme_t {
  COAP_URI_SCHEME_COAP = 0,
  COAP_URI_SCHEME_COAPS,     /* 1 */
  COAP_URI_SCHEME_COAP_TCP,  /* 2 */
  COAP_URI_SCHEME_COAPS_TCP, /* 3 */
  COAP_URI_SCHEME_HTTP,      /* 4 Proxy-Uri only */
  COAP_URI_SCHEME_HTTPS,     /* 5 Proxy-Uri only */
  COAP_URI_SCHEME_COAP_WS,   /* 6 */
  COAP_URI_SCHEME_COAPS_WS,  /* 7 */
  COAP_URI_SCHEME_LAST       /* 8 Size of scheme */
} coap_uri_scheme_t;
 
#define COAP_URI_SCHEME_SECURE_MASK 0x01
 
#define COAP_URI_SCHEME_COAP_BIT       (1 << COAP_URI_SCHEME_COAP)
#define COAP_URI_SCHEME_COAPS_BIT      (1 << COAP_URI_SCHEME_COAPS)
#define COAP_URI_SCHEME_COAP_TCP_BIT   (1 << COAP_URI_SCHEME_COAP_TCP)
#define COAP_URI_SCHEME_COAPS_TCP_BIT  (1 << COAP_URI_SCHEME_COAPS_TCP)
#define COAP_URI_SCHEME_HTTP_BIT       (1 << COAP_URI_SCHEME_HTTP)
#define COAP_URI_SCHEME_HTTPS_BIT      (1 << COAP_URI_SCHEME_HTTPS)
#define COAP_URI_SCHEME_COAP_WS_BIT    (1 << COAP_URI_SCHEME_COAP_WS)
#define COAP_URI_SCHEME_COAPS_WS_BIT   (1 << COAP_URI_SCHEME_COAPS_WS)
 
#define COAP_URI_SCHEME_ALL_COAP_BITS (COAP_URI_SCHEME_COAP_BIT | \
                                       COAP_URI_SCHEME_COAPS_BIT | \
                                       COAP_URI_SCHEME_COAP_TCP_BIT | \
                                       COAP_URI_SCHEME_COAPS_TCP_BIT | \
                                       COAP_URI_SCHEME_COAP_WS_BIT | \
                                       COAP_URI_SCHEME_COAPS_WS_BIT)
 
typedef struct {
  coap_str_const_t host;  
  uint16_t port;          
  coap_str_const_t path;  
  coap_str_const_t query; 
  enum coap_uri_scheme_t scheme;
} coap_uri_t;
 
typedef struct {
  uint32_t upa_value;     
  const char *upa_path;   
} coap_upa_abbrev_t;
 
static inline int
coap_uri_scheme_is_secure(const coap_uri_t *uri) {
  return uri && ((uri->scheme & COAP_URI_SCHEME_SECURE_MASK) != 0);
}
 
int coap_host_is_unix_domain(const coap_str_const_t *host);
 
int coap_host_is_llc(const coap_str_const_t *host);
 
coap_uri_t *coap_new_uri(const uint8_t *uri, unsigned int length);
 
coap_uri_t *coap_clone_uri(const coap_uri_t *uri);
 
void coap_delete_uri(coap_uri_t *uri);
 
int coap_split_uri(const uint8_t *str_var, size_t len, coap_uri_t *uri);
 
int coap_split_proxy_uri(const uint8_t *str_var, size_t len, coap_uri_t *uri);
 
int coap_uri_into_options(const coap_uri_t *uri, const coap_address_t *dst,
                          coap_optlist_t **optlist_chain,
                          int create_port_host_opt,
                          uint8_t *buf, size_t buflen);
 
int coap_uri_into_optlist(const coap_uri_t *uri, const coap_address_t *dst,
                          coap_optlist_t **optlist_chain,
                          int create_port_host_opt);
int coap_uri_into_optlist_abbrev(const coap_uri_t *uri, const coap_address_t *dst,
                                 coap_optlist_t **optlist_chain,
                                 int create_port_host_opt,
                                 coap_upa_abbrev_t *mapping, uint32_t count);
 
int coap_split_path(const uint8_t *path,
                    size_t length,
                    unsigned char *buf,
                    size_t *buflen);
 
int coap_path_into_optlist(const uint8_t *path, size_t length,
                           coap_option_num_t optnum,
                           coap_optlist_t **optlist_chain);
int coap_path_into_optlist_abbrev(const uint8_t *path, size_t length,
                                  coap_option_num_t optnum,
                                  coap_optlist_t **optlist_chain,
                                  coap_upa_abbrev_t *mapping, uint32_t count);
 
int coap_split_query(const uint8_t *query,
                     size_t length,
                     unsigned char *buf,
                     size_t *buflen);
 
int coap_query_into_optlist(const uint8_t *query, size_t length,
                            coap_option_num_t optnum,
                            coap_optlist_t **optlist_chain);
 
coap_string_t *coap_get_query(const coap_pdu_t *request);
 
coap_string_t *coap_get_uri_path(const coap_pdu_t *request);
 
void coap_upa_client_fallback(coap_upa_abbrev_t *mapping, uint32_t count);
 
void coap_upa_server_mapping(coap_upa_abbrev_t *mapping, uint32_t count);
 
#ifdef __cplusplus
}
#endif
 
#endif /* COAP_URI_H_ */