2018-12-16 12:57:44 -05:00
|
|
|
// Copyright (c) 2018, The Monero Project
|
|
|
|
//
|
|
|
|
// All rights reserved.
|
|
|
|
//
|
|
|
|
// Redistribution and use in source and binary forms, with or without modification, are
|
|
|
|
// permitted provided that the following conditions are met:
|
|
|
|
//
|
|
|
|
// 1. Redistributions of source code must retain the above copyright notice, this list of
|
|
|
|
// conditions and the following disclaimer.
|
|
|
|
//
|
|
|
|
// 2. Redistributions in binary form must reproduce the above copyright notice, this list
|
|
|
|
// of conditions and the following disclaimer in the documentation and/or other
|
|
|
|
// materials provided with the distribution.
|
|
|
|
//
|
|
|
|
// 3. Neither the name of the copyright holder nor the names of its contributors may be
|
|
|
|
// used to endorse or promote products derived from this software without specific
|
|
|
|
// prior written permission.
|
|
|
|
//
|
|
|
|
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY
|
|
|
|
// EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
|
|
|
// MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
|
|
|
|
// THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
|
|
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
|
|
|
// PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
|
|
|
|
// INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
|
|
|
// STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
|
|
|
|
// THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
|
|
|
|
|
|
#pragma once
|
|
|
|
|
|
|
|
#include <boost/utility/string_ref.hpp>
|
|
|
|
#include <cstdint>
|
|
|
|
|
|
|
|
#include "common/expect.h"
|
|
|
|
#include "net/net_utils_base.h"
|
|
|
|
|
|
|
|
namespace net
|
|
|
|
{
|
2019-04-10 18:34:30 -04:00
|
|
|
void get_network_address_host_and_port(const std::string& address, std::string& host, std::string& port);
|
|
|
|
|
2018-12-16 12:57:44 -05:00
|
|
|
/*!
|
2019-01-21 11:50:03 -05:00
|
|
|
Identifies onion, i2p and IPv4 addresses and returns them as a generic
|
2018-12-16 12:57:44 -05:00
|
|
|
`network_address`. If the type is unsupported, it might be a hostname,
|
|
|
|
and `error() == net::error::kUnsupportedAddress` is returned.
|
|
|
|
|
2019-01-21 11:50:03 -05:00
|
|
|
\param address An onion address, i2p address, ipv4 address or hostname. Hostname
|
2018-12-16 12:57:44 -05:00
|
|
|
will return an error.
|
|
|
|
\param default_port If `address` does not specify a port, this value
|
|
|
|
will be used.
|
|
|
|
|
|
|
|
\return A tor or IPv4 address, else error.
|
|
|
|
*/
|
|
|
|
expect<epee::net_utils::network_address>
|
|
|
|
get_network_address(boost::string_ref address, std::uint16_t default_port);
|
2019-03-29 06:47:53 -04:00
|
|
|
|
|
|
|
/*!
|
|
|
|
Identifies an IPv4 subnet in CIDR notatioa and returns it as a generic
|
|
|
|
`network_address`. If the type is unsupported, it might be a hostname,
|
|
|
|
and `error() == net::error::kUnsupportedAddress` is returned.
|
|
|
|
|
|
|
|
\param address An ipv4 address.
|
|
|
|
\param allow_implicit_32 whether to accept "raw" IPv4 addresses, with CIDR notation
|
|
|
|
|
|
|
|
\return A tor or IPv4 address, else error.
|
|
|
|
*/
|
|
|
|
expect<epee::net_utils::ipv4_network_subnet>
|
|
|
|
get_ipv4_subnet_address(boost::string_ref address, bool allow_implicit_32 = false);
|
2018-12-16 12:57:44 -05:00
|
|
|
}
|
|
|
|
|