uri.h

Go to the documentation of this file.

/*
 * uri.h -- helper functions for URI treatment
 *
 * Copyright (C) 2010-2020 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 <stdint.h>
 
#include "coap_str.h"
 
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_t;
 
#define COAP_URI_SCHEME_SECURE_MASK 0x01
 
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;
 
static inline int
coap_uri_scheme_is_secure(const coap_uri_t *uri) {
  return uri && ((uri->scheme & COAP_URI_SCHEME_SECURE_MASK) != 0);
}
 
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(coap_uri_t *uri, coap_optlist_t **optlist_chain,
                          int create_port_opt, uint8_t *buf, size_t buflen);
 
int coap_split_path(const uint8_t *s,
                    size_t length,
                    unsigned char *buf,
                    size_t *buflen);
 
int coap_split_query(const uint8_t *s,
                     size_t length,
                     unsigned char *buf,
                     size_t *buflen);
 
coap_string_t *coap_get_query(const coap_pdu_t *request);
 
coap_string_t *coap_get_uri_path(const coap_pdu_t *request);
 
#endif /* COAP_URI_H_ */