/* * Copyright (C) 2020 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 #include #include "adb_wifi.h" namespace mdns { struct MdnsInstance { std::string instance_name; // "my name" std::string service_name; // "_adb-tls-connect" std::string transport_type; // either "_tcp" or "_udp" MdnsInstance(std::string_view inst, std::string_view serv, std::string_view trans) : instance_name(inst), service_name(serv), transport_type(trans) {} }; // This parser is based on https://tools.ietf.org/html/rfc6763#section-4.1 for // structured service instance names, where the whole name is in the format // ... // // In our case, we ignore portion of the name, which // we always assume to be ".local", or link-local mDNS. // // The string can be in one of the following forms: // - ...? // - e.g. "instance._service._tcp.local" (or "...local.") // - ..? (must contain either "_tcp" or "_udp" at the end) // - e.g. "instance._service._tcp" (or "..._tcp.) // - (can contain dots '.') // - e.g. "myname", "name.", "my.name." // // Returns an MdnsInstance with the appropriate fields filled in (instance name is never empty), // otherwise returns std::nullopt. std::optional mdns_parse_instance_name(std::string_view name); } // namespace mdns