source4/dns_server/dnsserver_common.h

   1 /*
   2    Unix SMB/CIFS implementation.
   3
   4    DNS server utils
   5
   6    Copyright (C) 2014 Stefan Metzmacher
   7
   8    This program is free software; you can redistribute it and/or modify
   9    it under the terms of the GNU General Public License as published by
  10    the Free Software Foundation; either version 3 of the License, or
  11    (at your option) any later version.
  12
  13    This program is distributed in the hope that it will be useful,
  14    but WITHOUT ANY WARRANTY; without even the implied warranty of
  15    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16    GNU General Public License for more details.
  17
  18    You should have received a copy of the GNU General Public License
  19    along with this program.  If not, see <http://www.gnu.org/licenses/>.
  20 */
  21
  22 #include "rpc_server/dnsserver/dnsserver.h"
  23
  24 #ifndef __DNSSERVER_COMMON_H__
  25 #define __DNSSERVER_COMMON_H__
  26
  27 uint8_t werr_to_dns_err(WERROR werr);
  28 #define DNS_ERR(err_str) WERR_DNS_ERROR_RCODE_##err_str
  29
  30 struct ldb_message_element;
  31 struct ldb_context;
  32 struct dnsp_DnssrvRpcRecord;
  33
  34 struct dns_server_zone {
  35         struct dns_server_zone *prev, *next;
  36         const char *name;
  37         struct ldb_dn *dn;
  38 };
  39
  40 WERROR dns_common_extract(struct ldb_context *samdb,
  41                           const struct ldb_message_element *el,
  42                           TALLOC_CTX *mem_ctx,
  43                           struct dnsp_DnssrvRpcRecord **records,
  44                           uint16_t *num_records);
  45
  46 WERROR dns_common_lookup(struct ldb_context *samdb,
  47                          TALLOC_CTX *mem_ctx,
  48                          struct ldb_dn *dn,
  49                          struct dnsp_DnssrvRpcRecord **records,
  50                          uint16_t *num_records,
  51                          bool *tombstoned);
  52 WERROR dns_common_wildcard_lookup(struct ldb_context *samdb,
  53                                   TALLOC_CTX *mem_ctx,
  54                                   struct ldb_dn *dn,
  55                                   struct dnsp_DnssrvRpcRecord **records,
  56                                   uint16_t *num_records);
  57 WERROR dns_name_check(TALLOC_CTX *mem_ctx,
  58                       size_t len,
  59                       const char *name);
  60 WERROR dns_get_zone_properties(struct ldb_context *samdb,
  61                                TALLOC_CTX *mem_ctx,
  62                                struct ldb_dn *zone_dn,
  63                                struct dnsserver_zoneinfo *zoneinfo);
  64 bool dns_name_is_static(struct dnsp_DnssrvRpcRecord *records,
  65                         uint16_t rec_count);
  66 WERROR dns_common_replace(struct ldb_context *samdb,
  67                           TALLOC_CTX *mem_ctx,
  68                           struct ldb_dn *dn,
  69                           bool needs_add,
  70                           uint32_t serial,
  71                           struct dnsp_DnssrvRpcRecord *records,
  72                           uint16_t rec_count);
  73 bool dns_name_match(const char *zone, const char *name, size_t *host_part_len);
  74 WERROR dns_common_name2dn(struct ldb_context *samdb,
  75                           struct dns_server_zone *zones,
  76                           TALLOC_CTX *mem_ctx,
  77                           const char *name,
  78                           struct ldb_dn **_dn);
  79 bool dns_name_equal(const char *name1, const char *name2);
  80
  81 bool dns_record_match(struct dnsp_DnssrvRpcRecord *rec1,
  82                       struct dnsp_DnssrvRpcRecord *rec2);
  83
  84 /*
  85  * For this routine, base_dn is generally NULL.  The exception comes
  86  * from the python bindings to support setting ACLs on DNS objects
  87  * when joining Windows
  88  */
  89 NTSTATUS dns_common_zones(struct ldb_context *samdb,
  90                           TALLOC_CTX *mem_ctx,
  91                           struct ldb_dn *base_dn,
  92                           struct dns_server_zone **zones_ret);
  93
  94 bool dns_zoneinfo_load_zone_property(struct dnsserver_zoneinfo *zoneinfo,
  95                                      struct dnsp_DnsProperty *prop);
  96 /*
  97  * Log a DNS operation along with it's duration
  98  * Enabled by setting a log level of "dns:10"
  99  *
 100  * const char *operation
 101  * const char *result
 102  * const struct timeval *start
 103  * const char *zone
 104  * const char *name
 105  * const char *data
 106  */
 107 #define DNS_COMMON_LOG_OPERATION(result, start, zone, name, data) \
 108         if (CHECK_DEBUGLVLC(DBGC_DNS, DBGLVL_DEBUG)) { \
 109                 struct timeval now = timeval_current(); \
 110                 uint64_t duration = usec_time_diff(&now, (start));\
 111                 const char *re = (result);\
 112                 const char *zn = (zone); \
 113                 const char *nm = (name); \
 114                 const char *dt = (data); \
 115                 DBG_DEBUG( \
 116                         "DNS timing: result: [%s] duration: (%" PRIi64 ") " \
 117                         "zone: [%s] name: [%s] data: [%s]\n", \
 118                         re == NULL ? "" : re, \
 119                         duration, \
 120                         zn == NULL ? "" : zn, \
 121                         nm == NULL ? "" : nm, \
 122                         dt == NULL ? "" : dt); \
 123         }
 124
 125 /* There are this many nttime jiffies in an hour */
 126 #define NTTIME_TO_HOURS (3600ULL * 10ULL * 1000ULL * 1000ULL)
 127
 128 /*
 129  * convert unix time to a DNS timestamp
 130  * (hours in the NTTIME epoch, 32 bit).
 131  */
 132 uint32_t unix_to_dns_timestamp(time_t t);
 133
 134 /*
 135  * Convert a DNS timestamp into NTTIME.
 136  */
 137 NTSTATUS dns_timestamp_to_nt_time(NTTIME *_nt, uint32_t t);
 138
 139 #endif /* __DNSSERVER_COMMON_H__ */