aa0b72931d
Even though mdnsresponder seems to allow us to use _adb_secure_connect and _adb_secure_pairing as service names, these names violate the syntax outlined in RFC6763, and may not be compatible with other dns-sd implementations. Also address some comments from a previous CL. Bug: 154268895 Test: atest adbd_test Change-Id: Ia872e976fc4276587b500a827a41d46d9dc755dd Merged-In: Ia872e976fc4276587b500a827a41d46d9dc755dd
92 lines
3.5 KiB
C
92 lines
3.5 KiB
C
/*
|
|
* 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.
|
|
*/
|
|
|
|
#ifndef _ADB_MDNS_H_
|
|
#define _ADB_MDNS_H_
|
|
|
|
#include <android-base/macros.h>
|
|
|
|
// The rules for Service Names [RFC6335] state that they may be no more
|
|
// than fifteen characters long (not counting the mandatory underscore),
|
|
// consisting of only letters, digits, and hyphens, must begin and end
|
|
// with a letter or digit, must not contain consecutive hyphens, and
|
|
// must contain at least one letter.
|
|
#define ADB_MDNS_SERVICE_TYPE "adb"
|
|
#define ADB_MDNS_TLS_PAIRING_TYPE "adb-tls-pairing"
|
|
#define ADB_MDNS_TLS_CONNECT_TYPE "adb-tls-connect"
|
|
|
|
const int kADBTransportServiceRefIndex = 0;
|
|
const int kADBSecurePairingServiceRefIndex = 1;
|
|
const int kADBSecureConnectServiceRefIndex = 2;
|
|
|
|
// Each ADB Secure service advertises with a TXT record indicating the version
|
|
// using a key/value pair per RFC 6763 (https://tools.ietf.org/html/rfc6763).
|
|
//
|
|
// The first key/value pair is always the version of the protocol.
|
|
// There may be more key/value pairs added after.
|
|
//
|
|
// The version is purposely represented as the single letter "v" due to the
|
|
// need to minimize DNS traffic. The version starts at 1. With each breaking
|
|
// protocol change, the version is incremented by 1.
|
|
//
|
|
// Newer adb clients/daemons need to recognize and either reject
|
|
// or be backward-compatible with older verseions if there is a mismatch.
|
|
//
|
|
// Relevant sections:
|
|
//
|
|
// """
|
|
// 6.4. Rules for Keys in DNS-SD Key/Value Pairs
|
|
//
|
|
// The key MUST be at least one character. DNS-SD TXT record strings
|
|
// beginning with an '=' character (i.e., the key is missing) MUST be
|
|
// silently ignored.
|
|
//
|
|
// ...
|
|
//
|
|
// 6.5. Rules for Values in DNS-SD Key/Value Pairs
|
|
//
|
|
// If there is an '=' in a DNS-SD TXT record string, then everything
|
|
// after the first '=' to the end of the string is the value. The value
|
|
// can contain any eight-bit values including '='.
|
|
// """
|
|
|
|
#define ADB_SECURE_SERVICE_VERSION_TXT_RECORD(ver) ("v=" #ver)
|
|
|
|
// Client/service versions are initially defined to be matching,
|
|
// but may go out of sync as different clients and services
|
|
// try to talk to each other.
|
|
#define ADB_SECURE_SERVICE_VERSION 1
|
|
#define ADB_SECURE_CLIENT_VERSION ADB_SECURE_SERVICE_VERSION
|
|
|
|
const char* kADBSecurePairingServiceTxtRecord =
|
|
ADB_SECURE_SERVICE_VERSION_TXT_RECORD(ADB_SECURE_SERVICE_VERSION);
|
|
const char* kADBSecureConnectServiceTxtRecord =
|
|
ADB_SECURE_SERVICE_VERSION_TXT_RECORD(ADB_SECURE_SERVICE_VERSION);
|
|
|
|
#define ADB_FULL_MDNS_SERVICE_TYPE(atype) ("_" atype "._tcp")
|
|
const char* kADBDNSServices[] = {ADB_FULL_MDNS_SERVICE_TYPE(ADB_MDNS_SERVICE_TYPE),
|
|
ADB_FULL_MDNS_SERVICE_TYPE(ADB_MDNS_TLS_PAIRING_TYPE),
|
|
ADB_FULL_MDNS_SERVICE_TYPE(ADB_MDNS_TLS_CONNECT_TYPE)};
|
|
|
|
const char* kADBDNSServiceTxtRecords[] = {
|
|
nullptr,
|
|
kADBSecurePairingServiceTxtRecord,
|
|
kADBSecureConnectServiceTxtRecord,
|
|
};
|
|
|
|
const int kNumADBDNSServices = arraysize(kADBDNSServices);
|
|
|
|
#endif
|