mirror of
https://github.com/matrix-construct/construct
synced 2024-10-31 10:58:54 +01:00
202 lines
4.9 KiB
C++
202 lines
4.9 KiB
C++
// Matrix Construct
|
|
//
|
|
// Copyright (C) Matrix Construct Developers, Authors & Contributors
|
|
// Copyright (C) 2016-2018 Jason Volk <jason@zemos.net>
|
|
//
|
|
// Permission to use, copy, modify, and/or distribute this software for any
|
|
// purpose with or without fee is hereby granted, provided that the above
|
|
// copyright notice and this permission notice is present in all copies. The
|
|
// full license for this software is available in the LICENSE file.
|
|
|
|
#pragma once
|
|
#define HAVE_IRCD_NET_HOSTPORT_H
|
|
|
|
namespace ircd::net
|
|
{
|
|
struct hostport;
|
|
|
|
// abstraction bleed
|
|
extern const uint16_t canon_port;
|
|
extern const string_view canon_service;
|
|
|
|
const uint16_t &port(const hostport &);
|
|
const string_view &host(const hostport &);
|
|
const string_view &service(const hostport &);
|
|
|
|
uint16_t &port(hostport &);
|
|
string_view &host(hostport &);
|
|
string_view string(const mutable_buffer &out, const hostport &);
|
|
|
|
string_view canonize(const mutable_buffer &out, const hostport &, const uint16_t &port = canon_port);
|
|
std::string canonize(const hostport &, const uint16_t &port = canon_port);
|
|
|
|
std::ostream &operator<<(std::ostream &, const hostport &);
|
|
}
|
|
|
|
namespace ircd
|
|
{
|
|
using net::hostport;
|
|
using net::host;
|
|
}
|
|
|
|
/// This structure holds a hostname and service or port usually fresh from
|
|
/// user input intended for resolution.
|
|
///
|
|
/// The host can be passed to the constructor as a hostname or hostname:port
|
|
/// string.
|
|
///
|
|
/// The service field is a string which will trigger an SRV query during
|
|
/// resolution and/or be used to figure out the port number. If it is omitted
|
|
/// then the numerical port should be specified directly. If it exists then
|
|
/// the numerical port will only be used as a fallback, and an SRV response
|
|
/// with an alternative port may even override both the host and given
|
|
/// numerical port here.
|
|
///
|
|
struct ircd::net::hostport
|
|
{
|
|
IRCD_OVERLOAD(verbatim)
|
|
|
|
string_view host {"0.0.0.0"};
|
|
string_view service {canon_service};
|
|
uint16_t port {canon_port};
|
|
|
|
explicit operator bool() const;
|
|
bool operator!() const;
|
|
|
|
hostport(const string_view &host, const string_view &service, const uint16_t &port = canon_port);
|
|
hostport(const string_view &host, const uint16_t &port);
|
|
hostport(const string_view &amalgam);
|
|
hostport(const string_view &amalgam, verbatim_t);
|
|
hostport() = default;
|
|
};
|
|
|
|
/// Creates a host:service pair from a hostname and a service name string.
|
|
/// When passed to net::dns() this will indicate SRV resolution. If no
|
|
/// SRV record is found
|
|
/// TODO: todo: the servce is translated into its proper port.
|
|
/// TODO: now: the port 8448 is used with the hostname.
|
|
inline
|
|
ircd::net::hostport::hostport(const string_view &host,
|
|
const string_view &service,
|
|
const uint16_t &port)
|
|
:host{rfc3986::host(host)}
|
|
,service{service}
|
|
,port{port}
|
|
{}
|
|
|
|
/// Creates a host:port pair from a hostname and a port number. When
|
|
/// passed to net::dns() no SRV resolution will be done because no
|
|
/// service name has been given. (unless manually optioned when using
|
|
/// net::dns).
|
|
inline
|
|
ircd::net::hostport::hostport(const string_view &host,
|
|
const uint16_t &port)
|
|
:hostport
|
|
{
|
|
host, string_view{}, port
|
|
}
|
|
{}
|
|
|
|
/// Creates a host:service or host:port pair from the single string literally
|
|
/// containing the colon deliminated values. If the suffix is a port number
|
|
/// then the behavior for the port number constructor applies; if a service
|
|
/// string then the service constructor applies; if empty (just a hostname)
|
|
/// then service "matrix" is assumed with port 8448 fallback.
|
|
inline
|
|
ircd::net::hostport::hostport(const string_view &amalgam)
|
|
:host
|
|
{
|
|
rfc3986::host(amalgam)
|
|
}
|
|
,port
|
|
{
|
|
rfc3986::port(amalgam)
|
|
}
|
|
{
|
|
// When the amalgam has no port
|
|
if(amalgam == host)
|
|
{
|
|
// set the port to the canon_port; port=0 is bad
|
|
port = port?: canon_port;
|
|
return;
|
|
}
|
|
|
|
// or a valid integer port
|
|
if(port)
|
|
return;
|
|
|
|
// When the port is actually a service string
|
|
const auto service
|
|
{
|
|
rsplit(amalgam, ':').second
|
|
};
|
|
|
|
if(service)
|
|
this->service = service;
|
|
else
|
|
this->port = canon_port;
|
|
}
|
|
|
|
inline
|
|
ircd::net::hostport::hostport(const string_view &amalgam,
|
|
verbatim_t)
|
|
:host
|
|
{
|
|
rfc3986::host(amalgam)
|
|
}
|
|
,service
|
|
{
|
|
amalgam != host && !rfc3986::port(amalgam)?
|
|
rsplit(amalgam, ':').second:
|
|
string_view{}
|
|
}
|
|
,port
|
|
{
|
|
rfc3986::port(amalgam)
|
|
}
|
|
{}
|
|
|
|
inline
|
|
ircd::net::hostport::operator
|
|
bool()
|
|
const
|
|
{
|
|
return net::host(*this) != net::host(hostport{});
|
|
}
|
|
|
|
inline bool
|
|
ircd::net::hostport::operator!()
|
|
const
|
|
{
|
|
return !bool(*this);
|
|
}
|
|
|
|
inline ircd::string_view &
|
|
ircd::net::host(hostport &hp)
|
|
{
|
|
return hp.host;
|
|
}
|
|
|
|
inline uint16_t &
|
|
ircd::net::port(hostport &hp)
|
|
{
|
|
return hp.port;
|
|
}
|
|
|
|
inline const ircd::string_view &
|
|
ircd::net::service(const hostport &hp)
|
|
{
|
|
return hp.service;
|
|
}
|
|
|
|
inline const ircd::string_view &
|
|
ircd::net::host(const hostport &hp)
|
|
{
|
|
return hp.host;
|
|
}
|
|
|
|
inline const uint16_t &
|
|
ircd::net::port(const hostport &hp)
|
|
{
|
|
return hp.port;
|
|
}
|