xcm_addr.h

Go to the documentation of this file.

/*
 * SPDX-License-Identifier: BSD-3-Clause
 * Copyright(c) 2020 Ericsson AB
 */
 
#ifndef XCM_ADDR_H
#define XCM_ADDR_H
#ifdef __cplusplus
extern "C" {
#endif
 
#include <errno.h>
#include <inttypes.h>
#include <netinet/in.h>
#include <stdbool.h>
#include <sys/socket.h>
#include <sys/types.h>
 
#define XCM_UTLS_PROTO "utls"
#define XCM_TLS_PROTO "tls"
#define XCM_TCP_PROTO "tcp"
#define XCM_SCTP_PROTO "sctp"
#define XCM_UX_PROTO "ux"
#define XCM_UXF_PROTO "uxf"
 
#define XCM_BTLS_PROTO "btls"
#define XCM_BTCP_PROTO "btcp"
 
enum xcm_addr_type {
    xcm_addr_type_name,
    xcm_addr_type_ip
};
 
struct xcm_addr_ip
{
    sa_family_t family;
 
    union {
    in_addr_t ip4;
    uint8_t ip6[16];
    } addr;
};
 
struct xcm_addr_host
{
    enum xcm_addr_type type;
 
    union {
    struct xcm_addr_ip ip;
    /* Max DNS name length is 253 characters */
    char name[254];
    };
};
 
bool xcm_addr_is_valid(const char *xcm_addr_s);
 
bool xcm_addr_is_supported(const char *xcm_addr_s);
 
int xcm_addr_parse_proto(const char *addr_s, char *proto, size_t capacity);
 
int xcm_addr_parse_utls(const char *utls_addr_s, struct xcm_addr_host *host,
            uint16_t *port);
 
int xcm_addr_parse_tls(const char *tls_addr_s, struct xcm_addr_host *host,
               uint16_t *port);
 
int xcm_addr_parse_tcp(const char *tcp_addr_s, struct xcm_addr_host *host,
               uint16_t *port);
 
int xcm_addr_parse_sctp(const char *sctp_addr_s, struct xcm_addr_host *host,
            uint16_t *port);
 
int xcm_addr_parse_ux(const char *ux_addr_s, char *ux_path, size_t capacity);
 
int xcm_addr_parse_uxf(const char *uxf_addr_s, char *uxf_path,
               size_t capacity);
 
int xcm_addr_parse_btcp(const char *btcp_addr_s, struct xcm_addr_host *host,
            uint16_t *port);
 
int xcm_addr_parse_btls(const char *btls_addr_s, struct xcm_addr_host *host,
            uint16_t *port);
 
int xcm_addr_make_utls(const struct xcm_addr_host *host, unsigned short port,
               char *utls_addr_s, size_t capacity);
 
int xcm_addr_make_tls(const struct xcm_addr_host *host, unsigned short port,
              char *tls_addr_s, size_t capacity);
 
int xcm_addr_make_tcp(const struct xcm_addr_host *host, unsigned short port,
              char *tcp_addr_s, size_t capacity);
 
int xcm_addr_make_sctp(const struct xcm_addr_host *host, unsigned short port,
               char *sctp_addr_s, size_t capacity);
 
int xcm_addr_make_ux(const char *ux_name, char *ux_addr_s, size_t capacity);
 
int xcm_addr_make_uxf(const char *uxf_name, char *uxf_addr_s, size_t capacity);
 
int xcm_addr_make_btcp(const struct xcm_addr_host *host, unsigned short port,
               char *btcp_addr_s, size_t capacity);
 
int xcm_addr_make_btls(const struct xcm_addr_host *host, unsigned short port,
               char *btls_addr_s, size_t capacity);
 
#include <xcm_addr_compat.h>
 
#ifdef __cplusplus
}
#endif
#endif