Quelle  dns_resolver.h   Sprache: C

/* SPDX-License-Identifier: GPL-2.0+ WITH Linux-syscall-note */
/* DNS resolver interface definitions.
 *
 * Copyright (C) 2018 Red Hat, Inc. All Rights Reserved.
 * Written by David Howells (dhowells@redhat.com)
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public Licence
 * as published by the Free Software Foundation; either version
 * 2 of the Licence, or (at your option) any later version.
 */

#ifndef _UAPI_LINUX_DNS_RESOLVER_H
#define _UAPI_LINUX_DNS_RESOLVER_H

#include <linux/types.h>

/*
 * Type of payload.
 */
enum dns_payload_content_type {
 DNS_PAYLOAD_IS_SERVER_LIST = 0, /* List of servers, requested by srv=1 */
};

/*
 * Type of address that might be found in an address record.
 */
enum dns_payload_address_type {
 DNS_ADDRESS_IS_IPV4  = 0, /* 4-byte AF_INET address */
 DNS_ADDRESS_IS_IPV6  = 1, /* 16-byte AF_INET6 address */
};

/*
 * Type of protocol used to access a server.
 */
enum dns_payload_protocol_type {
 DNS_SERVER_PROTOCOL_UNSPECIFIED = 0,
 DNS_SERVER_PROTOCOL_UDP  = 1, /* Use UDP to talk to the server */
 DNS_SERVER_PROTOCOL_TCP  = 2, /* Use TCP to talk to the server */
};

/*
 * Source of record included in DNS resolver payload.
 */
enum dns_record_source {
 DNS_RECORD_UNAVAILABLE  = 0, /* No source available (empty record) */
 DNS_RECORD_FROM_CONFIG  = 1, /* From local configuration data */
 DNS_RECORD_FROM_DNS_A  = 2, /* From DNS A or AAAA record */
 DNS_RECORD_FROM_DNS_AFSDB = 3, /* From DNS AFSDB record */
 DNS_RECORD_FROM_DNS_SRV  = 4, /* From DNS SRV record */
 DNS_RECORD_FROM_NSS  = 5, /* From NSS */
 NR__dns_record_source
};

/*
 * Status of record included in DNS resolver payload.
 */
enum dns_lookup_status {
 DNS_LOOKUP_NOT_DONE  = 0, /* No lookup has been made */
 DNS_LOOKUP_GOOD   = 1, /* Good records obtained */
 DNS_LOOKUP_GOOD_WITH_BAD = 2, /* Good records, some decoding errors */
 DNS_LOOKUP_BAD   = 3, /* Couldn't decode results */
 DNS_LOOKUP_GOT_NOT_FOUND = 4, /* Got a "Not Found" result */
 DNS_LOOKUP_GOT_LOCAL_FAILURE = 5, /* Local failure during lookup */
 DNS_LOOKUP_GOT_TEMP_FAILURE = 6, /* Temporary failure during lookup */
 DNS_LOOKUP_GOT_NS_FAILURE = 7, /* Name server failure */
 NR__dns_lookup_status
};

/*
 * Header at the beginning of binary format payload.
 */
struct dns_payload_header {
 __u8  zero;  /* Zero byte: marks this as not being text */
 __u8  content; /* enum dns_payload_content_type */
 __u8  version; /* Encoding version */
} __packed;

/*
 * Header at the beginning of a V1 server list.  This is followed directly by
 * the server records.  Each server records begins with a struct of type
 * dns_server_list_v1_server.
 */
struct dns_server_list_v1_header {
 struct dns_payload_header hdr;
 __u8  source;  /* enum dns_record_source */
 __u8  status;  /* enum dns_lookup_status */
 __u8  nr_servers; /* Number of server records following this */
} __packed;

/*
 * Header at the beginning of each V1 server record.  This is followed by the
 * characters of the name with no NUL-terminator, followed by the address
 * records for that server.  Each address record begins with a struct of type
 * struct dns_server_list_v1_address.
 */
struct dns_server_list_v1_server {
 __u16  name_len; /* Length of name (LE) */
 __u16  priority; /* Priority (as SRV record) (LE) */
 __u16  weight;  /* Weight (as SRV record) (LE) */
 __u16  port;  /* UDP/TCP port number (LE) */
 __u8  source;  /* enum dns_record_source */
 __u8  status;  /* enum dns_lookup_status */
 __u8  protocol; /* enum dns_payload_protocol_type */
 __u8  nr_addrs;
} __packed;

/*
 * Header at the beginning of each V1 address record.  This is followed by the
 * bytes of the address, 4 for IPV4 and 16 for IPV6.
 */
struct dns_server_list_v1_address {
 __u8  address_type; /* enum dns_payload_address_type */
} __packed;

#endif /* _UAPI_LINUX_DNS_RESOLVER_H */