socket_spec.h

/*
 * Copyright (C) 2016 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#pragma once

#include <string>
#include <tuple>

#include "adb_unique_fd.h"

extern bool gListenAll;

// Returns true if the argument starts with a plausible socket prefix.
bool is_socket_spec(std::string_view spec);
bool is_local_socket_spec(std::string_view spec);

// Connect to 'address'.
// - fd (out): The file descriptor of the connection.
// - address (in) : Can be IP:PORT, or a HOSTNAME (even .local) to resolve.
// - port (out): port the connection was established on.
// - transport_name (out): name of the transport_name (see Transport::name).
// - error (out): error string if the function returns false.
bool socket_spec_connect(unique_fd* fd, std::string_view address, int* port,
                         std::string* transport_name, std::string* error);

int socket_spec_listen(std::string_view spec, std::string* error, int* resolved_tcp_port = nullptr);

bool parse_tcp_socket_spec(std::string_view spec, std::string* hostname, int* port,
                           std::string* canonical_address, std::string* error);

int get_host_socket_spec_port(std::string_view spec, std::string* error);