parse.h

Go to the documentation of this file.

// Copyright (c) 2018-2022, 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/asio/ip/tcp.hpp>
#include <boost/optional/optional.hpp>
#include <boost/utility/string_ref.hpp>
#include <cstdint>
 
#include "common/expect.h"
#include "net/fwd.h"
#include "net/net_utils_base.h"
 
namespace net
{
    struct scheme_and_authority
    {
        explicit scheme_and_authority(boost::string_ref uri);
 
        std::string scheme;
        std::string authority;
    };

    struct userinfo_and_hostport
    {
        explicit userinfo_and_hostport(boost::string_ref authority);
 
        std::string userinfo;
        std::string hostport;
    };

    struct user_and_pass
    {
        user_and_pass()
          : user(), pass()
        {}

        static boost::optional<user_and_pass> get(boost::string_ref userinfo);
 
        std::string user;
        std::string pass;
    };

    struct uri_components
    {
        uri_components()
          : scheme(), userinfo(), hostport()
        {}

        static boost::optional<uri_components> get(boost::string_ref uri);
 
        std::string scheme;
        user_and_pass userinfo;
        std::string hostport;
    };

    void get_network_address_host_and_port(const std::string& address, std::string& host, std::string& port);

    expect<epee::net_utils::network_address>
        get_network_address(boost::string_ref address, std::uint16_t default_port);

    expect<epee::net_utils::ipv4_network_subnet>
        get_ipv4_subnet_address(boost::string_ref address, bool allow_implicit_32 = false);
 
    expect<boost::asio::ip::tcp::endpoint> get_tcp_endpoint(const boost::string_ref address);
 
    namespace socks
    {
        struct endpoint
        {
            endpoint();
            explicit endpoint(const boost::asio::ip::tcp::endpoint& address);

            static expect<endpoint> get(boost::string_ref uri);
 
            boost::asio::ip::tcp::endpoint address;
            user_and_pass userinfo;
            version ver;
        };
    }
}