util.h

Go to the documentation of this file.

/*
 * Copyright (C) 2017 Kaspar Schleiser <kaspar@schleiser.de>
 *               2018 Freie Universität Berlin
 *
 * This file is subject to the terms and conditions of the GNU Lesser
 * General Public License v2.1. See the file LICENSE in the top level
 * directory for more details.
 */
 
#ifndef NET_SOCK_UTIL_H
#define NET_SOCK_UTIL_H
 
#include <stdbool.h>
#include <stdint.h>
 
#include "net/sock/udp.h"
#include "net/sock/tcp.h"
 
#ifdef MODULE_SOCK_DTLS
#include "net/credman.h"
#include "net/sock/dtls.h"
#endif
 
#ifdef __cplusplus
extern "C" {
#endif
 
int sock_tl_ep_fmt(const struct _sock_tl_ep *endpoint,
                   char *addr_str, uint16_t *port);
 
static inline int sock_tcp_ep_fmt(const sock_tcp_ep_t *endpoint,
                                  char *addr_str, uint16_t *port)
{
    return sock_tl_ep_fmt(endpoint, addr_str, port);
}
 
static inline int sock_udp_ep_fmt(const sock_udp_ep_t *endpoint,
                                  char *addr_str, uint16_t *port)
{
    return sock_tl_ep_fmt(endpoint, addr_str, port);
}
 
int sock_urlsplit(const char *url, char *hostport, char *urlpath);
 
const char *sock_urlpath(const char *url);
 
int sock_tl_str2ep(struct _sock_tl_ep *ep_out, const char *str);
 
int sock_tl_name2ep(struct _sock_tl_ep *ep_out, const char *str);
 
static inline int sock_tcp_str2ep(sock_tcp_ep_t *ep_out, const char *str)
{
    return sock_tl_str2ep(ep_out, str);
}
 
static inline int sock_tcp_name2ep(sock_tcp_ep_t *ep_out, const char *str)
{
    return sock_tl_name2ep(ep_out, str);
}
 
static inline int sock_udp_str2ep(sock_udp_ep_t *ep_out, const char *str)
{
    return sock_tl_str2ep(ep_out, str);
}
 
static inline int sock_udp_name2ep(sock_udp_ep_t *ep_out, const char *str)
{
    return sock_tl_name2ep(ep_out, str);
}
 
bool sock_tl_ep_equal(const struct _sock_tl_ep *a,
                      const struct _sock_tl_ep *b);
 
static inline bool sock_tcp_ep_equal(const sock_tcp_ep_t *a,
                                     const sock_tcp_ep_t *b)
{
    return sock_tl_ep_equal(a, b);
}
 
static inline bool sock_udp_ep_equal(const sock_udp_ep_t *a,
                                     const sock_udp_ep_t *b)
{
    return sock_tl_ep_equal(a, b);
}
 
#if defined(MODULE_SOCK_DTLS) || DOXYGEN
int sock_dtls_establish_session(sock_udp_t *sock_udp, sock_dtls_t *sock_dtls,
                                sock_dtls_session_t *session, credman_tag_t tag,
                                sock_udp_ep_t *local, const sock_udp_ep_t *remote,
                                void *work_buf, size_t work_buf_len);
#endif
 
#ifndef CONFIG_SOCK_SCHEME_MAXLEN
#define CONFIG_SOCK_SCHEME_MAXLEN      (16U)
#endif
 
#ifndef CONFIG_SOCK_HOSTPORT_MAXLEN
#define CONFIG_SOCK_HOSTPORT_MAXLEN    (64U)
#endif
 
#ifndef CONFIG_SOCK_URLPATH_MAXLEN
#define CONFIG_SOCK_URLPATH_MAXLEN     (64U)
#endif
#ifndef CONFIG_SOCK_DTLS_TIMEOUT_MS
#define CONFIG_SOCK_DTLS_TIMEOUT_MS    (1000U)
#endif
 
#ifndef CONFIG_SOCK_DTLS_RETRIES
#define CONFIG_SOCK_DTLS_RETRIES       (2)
#endif
 
#ifdef __cplusplus
}
#endif
 
#endif /* NET_SOCK_UTIL_H */