include/netd_resolv/params.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.
 */

#ifndef NETD_RESOLV_PARAMS_H
#define NETD_RESOLV_PARAMS_H

#include <stdint.h>

/* Hard-coded defines */
#define MAXNS 4           /* max # name servers we'll track */
#define MAXDNSRCH 6       /* max # domains in search path */
#define MAXDNSRCHPATH 256 /* max length of domain search paths */
#define MAXNSSAMPLES 64   /* max # samples to store per server */

// Per-netid configuration parameters passed from netd to the resolver
// TODO: rename to res_params
struct __res_params {
    uint16_t sample_validity;  // sample lifetime in s
    // threshold of success / total samples below which a server is considered broken
    uint8_t success_threshold;  // 0: disable, value / 100 otherwise
    uint8_t min_samples;        // min # samples needed for statistics to be considered meaningful
    uint8_t max_samples;        // max # samples taken into account for statistics
    int base_timeout_msec;      // base query retry timeout (if 0, use RES_TIMEOUT)
    int retry_count;            // number of retries
};

// The DNS over TLS mode on a specific netId.
enum class PrivateDnsMode : uint8_t { OFF, OPPORTUNISTIC, STRICT };

// Validation status of a DNS over TLS server (on a specific netId).
enum class Validation : uint8_t { in_process, success, fail, unknown_server, unknown_netid };

#define LIBNETD_RESOLV_PUBLIC extern "C" [[gnu::visibility("default")]]

#endif  // NETD_RESOLV_PARAMS_H