1
0
mirror of https://github.com/samba-team/samba.git synced 2024-12-24 21:34:56 +03:00
samba-mirror/lib/addns/dns.h
2012-05-27 13:15:56 +10:00

452 lines
13 KiB
C

/*
Linux DNS client library implementation
Copyright (C) 2006 Krishna Ganugapati <krishnag@centeris.com>
Copyright (C) 2006 Gerald Carter <jerry@samba.org>
** NOTE! The following LGPL license applies to the libaddns
** library. This does NOT imply that all of Samba is released
** under the LGPL
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, see <http://www.gnu.org/licenses/>.
*/
#ifndef _DNS_H
#define _DNS_H
#include "../replace/replace.h"
#include "system/network.h"
#include "system/kerberos.h"
#include "system/gssapi.h"
/* make sure we have included the correct config.h */
#ifndef NO_CONFIG_H /* for some tests */
#ifndef CONFIG_H_IS_FROM_SAMBA
#error "make sure you have removed all config.h files from standalone builds!"
#error "the included config.h isn't from samba!"
#endif
#endif /* NO_CONFIG_H */
#include <fcntl.h>
#include <time.h>
#include <netdb.h>
#include <talloc.h>
/*******************************************************************
Type definitions for int16, int32, uint16 and uint32. Needed
for Samba coding style
*******************************************************************/
#ifndef uint8
# define uint8 unsigned char
#endif
#if !defined(int16) && !defined(HAVE_INT16_FROM_RPC_RPC_H)
# if (SIZEOF_SHORT == 4)
# define int16 __ERROR___CANNOT_DETERMINE_TYPE_FOR_INT16;
# else /* SIZEOF_SHORT != 4 */
# define int16 short
# endif /* SIZEOF_SHORT != 4 */
/* needed to work around compile issue on HP-UX 11.x */
# define _INT16 1
#endif
/*
* Note we duplicate the size tests in the unsigned
* case as int16 may be a typedef from rpc/rpc.h
*/
#if !defined(uint16) && !defined(HAVE_UINT16_FROM_RPC_RPC_H)
# if (SIZEOF_SHORT == 4)
# define uint16 __ERROR___CANNOT_DETERMINE_TYPE_FOR_INT16;
# else /* SIZEOF_SHORT != 4 */
# define uint16 unsigned short
# endif /* SIZEOF_SHORT != 4 */
#endif
#if !defined(int32) && !defined(HAVE_INT32_FROM_RPC_RPC_H)
# if (SIZEOF_INT == 4)
# define int32 int
# elif (SIZEOF_LONG == 4)
# define int32 long
# elif (SIZEOF_SHORT == 4)
# define int32 short
# else
/* uggh - no 32 bit type?? probably a CRAY. just hope this works ... */
# define int32 int
# endif
# ifndef _INT32
/* needed to work around compile issue on HP-UX 11.x */
# define _INT32 1
# endif
#endif
/*
* Note we duplicate the size tests in the unsigned
* case as int32 may be a typedef from rpc/rpc.h
*/
#if !defined(uint32) && !defined(HAVE_UINT32_FROM_RPC_RPC_H)
# if (SIZEOF_INT == 4)
# define uint32 unsigned int
# elif (SIZEOF_LONG == 4)
# define uint32 unsigned long
# elif (SIZEOF_SHORT == 4)
# define uint32 unsigned short
# else
/* uggh - no 32 bit type?? probably a CRAY. just hope this works ... */
# define uint32 unsigned
# endif
#endif
/*
* check for 8 byte long long
*/
#if !defined(uint64)
# if (SIZEOF_LONG == 8)
# define uint64 unsigned long
# elif (SIZEOF_LONG_LONG == 8)
# define uint64 unsigned long long
# endif /* don't lie. If we don't have it, then don't use it */
#endif
/* needed on Sun boxes */
#ifndef INADDR_NONE
#define INADDR_NONE 0xFFFFFFFF
#endif
#include "dnserr.h"
#define DNS_TCP 1
#define DNS_UDP 2
#define DNS_OPCODE_UPDATE 1
/* DNS Class Types */
#define DNS_CLASS_IN 1
#define DNS_CLASS_ANY 255
#define DNS_CLASS_NONE 254
/* DNS RR Types */
#define DNS_RR_A 1
#define DNS_TCP_PORT 53
#define DNS_UDP_PORT 53
#define QTYPE_A 1
#define QTYPE_NS 2
#define QTYPE_MD 3
#define QTYPE_CNAME 5
#define QTYPE_SOA 6
#define QTYPE_AAAA 28
#define QTYPE_ANY 255
#define QTYPE_TKEY 249
#define QTYPE_TSIG 250
/*
MF 4 a mail forwarder (Obsolete - use MX)
CNAME 5 the canonical name for an alias
SOA 6 marks the start of a zone of authority
MB 7 a mailbox domain name (EXPERIMENTAL)
MG 8 a mail group member (EXPERIMENTAL)
MR 9 a mail rename domain name (EXPERIMENTAL)
NULL 10 a null RR (EXPERIMENTAL)
WKS 11 a well known service description
PTR 12 a domain name pointer
HINFO 13 host information
MINFO 14 mailbox or mail list information
MX 15 mail exchange
TXT 16 text strings
*/
#define QR_QUERY 0x0000
#define QR_RESPONSE 0x0001
#define OPCODE_QUERY 0x00
#define OPCODE_IQUERY 0x01
#define OPCODE_STATUS 0x02
#define AA 1
#define RECURSION_DESIRED 0x01
#define RCODE_NOERROR 0
#define RCODE_FORMATERROR 1
#define RCODE_SERVER_FAILURE 2
#define RCODE_NAME_ERROR 3
#define RCODE_NOTIMPLEMENTED 4
#define RCODE_REFUSED 5
#define SENDBUFFER_SIZE 65536
#define RECVBUFFER_SIZE 65536
/*
* TKEY Modes from rfc2930
*/
#define DNS_TKEY_MODE_SERVER 1
#define DNS_TKEY_MODE_DH 2
#define DNS_TKEY_MODE_GSSAPI 3
#define DNS_TKEY_MODE_RESOLVER 4
#define DNS_TKEY_MODE_DELETE 5
#define DNS_ONE_DAY_IN_SECS 86400
#define DNS_TEN_HOURS_IN_SECS 36000
#define SOCKET_ERROR -1
#define INVALID_SOCKET -1
#define DNS_NO_ERROR 0
#define DNS_FORMAT_ERROR 1
#define DNS_SERVER_FAILURE 2
#define DNS_NAME_ERROR 3
#define DNS_NOT_IMPLEMENTED 4
#define DNS_REFUSED 5
typedef long HANDLE;
enum dns_ServerType { DNS_SRV_ANY, DNS_SRV_WIN2000, DNS_SRV_WIN2003 };
struct dns_domain_label {
struct dns_domain_label *next;
char *label;
size_t len;
};
struct dns_domain_name {
struct dns_domain_label *pLabelList;
};
struct dns_question {
struct dns_domain_name *name;
uint16 q_type;
uint16 q_class;
};
/*
* Before changing the definition of dns_zone, look
* dns_marshall_update_request(), we rely on this being the same as
* dns_question right now.
*/
struct dns_zone {
struct dns_domain_name *name;
uint16 z_type;
uint16 z_class;
};
struct dns_rrec {
struct dns_domain_name *name;
uint16 type;
uint16 r_class;
uint32 ttl;
uint16 data_length;
uint8 *data;
};
struct dns_tkey_record {
struct dns_domain_name *algorithm;
time_t inception;
time_t expiration;
uint16 mode;
uint16 error;
uint16 key_length;
uint8 *key;
};
struct dns_request {
uint16 id;
uint16 flags;
uint16 num_questions;
uint16 num_answers;
uint16 num_auths;
uint16 num_additionals;
struct dns_question **questions;
struct dns_rrec **answers;
struct dns_rrec **auths;
struct dns_rrec **additionals;
};
/*
* Before changing the definition of dns_update_request, look
* dns_marshall_update_request(), we rely on this being the same as
* dns_request right now.
*/
struct dns_update_request {
uint16 id;
uint16 flags;
uint16 num_zones;
uint16 num_preqs;
uint16 num_updates;
uint16 num_additionals;
struct dns_zone **zones;
struct dns_rrec **preqs;
struct dns_rrec **updates;
struct dns_rrec **additionals;
};
struct dns_connection {
int32 hType;
int s;
struct sockaddr RecvAddr;
};
struct dns_buffer {
uint8 *data;
size_t size;
size_t offset;
DNS_ERROR error;
};
/* from dnsutils.c */
DNS_ERROR dns_domain_name_from_string( TALLOC_CTX *mem_ctx,
const char *pszDomainName,
struct dns_domain_name **presult );
char *dns_generate_keyname( TALLOC_CTX *mem_ctx );
/* from dnsrecord.c */
DNS_ERROR dns_create_query( TALLOC_CTX *mem_ctx, const char *name,
uint16 q_type, uint16 q_class,
struct dns_request **preq );
DNS_ERROR dns_create_update( TALLOC_CTX *mem_ctx, const char *name,
struct dns_update_request **preq );
DNS_ERROR dns_create_probe(TALLOC_CTX *mem_ctx, const char *zone,
const char *host, int num_ips,
const struct sockaddr_storage *sslist,
struct dns_update_request **preq);
DNS_ERROR dns_create_rrec(TALLOC_CTX *mem_ctx, const char *name,
uint16 type, uint16 r_class, uint32 ttl,
uint16 data_length, uint8 *data,
struct dns_rrec **prec);
DNS_ERROR dns_add_rrec(TALLOC_CTX *mem_ctx, struct dns_rrec *rec,
uint16 *num_records, struct dns_rrec ***records);
DNS_ERROR dns_create_tkey_record(TALLOC_CTX *mem_ctx, const char *keyname,
const char *algorithm_name, time_t inception,
time_t expiration, uint16 mode, uint16 error,
uint16 key_length, const uint8 *key,
struct dns_rrec **prec);
DNS_ERROR dns_create_name_in_use_record(TALLOC_CTX *mem_ctx,
const char *name,
const struct sockaddr_storage *ip,
struct dns_rrec **prec);
DNS_ERROR dns_create_delete_record(TALLOC_CTX *mem_ctx, const char *name,
uint16 type, uint16 r_class,
struct dns_rrec **prec);
DNS_ERROR dns_create_name_not_in_use_record(TALLOC_CTX *mem_ctx,
const char *name, uint32 type,
struct dns_rrec **prec);
DNS_ERROR dns_create_a_record(TALLOC_CTX *mem_ctx, const char *host,
uint32 ttl, const struct sockaddr_storage *pss,
struct dns_rrec **prec);
DNS_ERROR dns_create_aaaa_record(TALLOC_CTX *mem_ctx, const char *host,
uint32 ttl, const struct sockaddr_storage *pss,
struct dns_rrec **prec);
DNS_ERROR dns_unmarshall_tkey_record(TALLOC_CTX *mem_ctx, struct dns_rrec *rec,
struct dns_tkey_record **ptkey);
DNS_ERROR dns_create_tsig_record(TALLOC_CTX *mem_ctx, const char *keyname,
const char *algorithm_name,
time_t time_signed, uint16 fudge,
uint16 mac_length, const uint8 *mac,
uint16 original_id, uint16 error,
struct dns_rrec **prec);
DNS_ERROR dns_add_rrec(TALLOC_CTX *mem_ctx, struct dns_rrec *rec,
uint16 *num_records, struct dns_rrec ***records);
DNS_ERROR dns_create_update_request(TALLOC_CTX *mem_ctx,
const char *domainname,
const char *hostname,
const struct sockaddr_storage *ip_addr,
size_t num_adds,
struct dns_update_request **preq);
/* from dnssock.c */
DNS_ERROR dns_open_connection( const char *nameserver, int32 dwType,
TALLOC_CTX *mem_ctx,
struct dns_connection **conn );
DNS_ERROR dns_send(struct dns_connection *conn, const struct dns_buffer *buf);
DNS_ERROR dns_receive(TALLOC_CTX *mem_ctx, struct dns_connection *conn,
struct dns_buffer **presult);
DNS_ERROR dns_transaction(TALLOC_CTX *mem_ctx, struct dns_connection *conn,
const struct dns_request *req,
struct dns_request **resp);
DNS_ERROR dns_update_transaction(TALLOC_CTX *mem_ctx,
struct dns_connection *conn,
struct dns_update_request *up_req,
struct dns_update_request **up_resp);
/* from dnsmarshall.c */
struct dns_buffer *dns_create_buffer(TALLOC_CTX *mem_ctx);
void dns_marshall_buffer(struct dns_buffer *buf, const uint8 *data,
size_t len);
void dns_marshall_uint16(struct dns_buffer *buf, uint16 val);
void dns_marshall_uint32(struct dns_buffer *buf, uint32 val);
void dns_unmarshall_buffer(struct dns_buffer *buf, uint8 *data,
size_t len);
void dns_unmarshall_uint16(struct dns_buffer *buf, uint16 *val);
void dns_unmarshall_uint32(struct dns_buffer *buf, uint32 *val);
void dns_unmarshall_domain_name(TALLOC_CTX *mem_ctx,
struct dns_buffer *buf,
struct dns_domain_name **pname);
void dns_marshall_domain_name(struct dns_buffer *buf,
const struct dns_domain_name *name);
void dns_unmarshall_domain_name(TALLOC_CTX *mem_ctx,
struct dns_buffer *buf,
struct dns_domain_name **pname);
DNS_ERROR dns_marshall_request(TALLOC_CTX *mem_ctx,
const struct dns_request *req,
struct dns_buffer **pbuf);
DNS_ERROR dns_unmarshall_request(TALLOC_CTX *mem_ctx,
struct dns_buffer *buf,
struct dns_request **preq);
DNS_ERROR dns_marshall_update_request(TALLOC_CTX *mem_ctx,
struct dns_update_request *update,
struct dns_buffer **pbuf);
DNS_ERROR dns_unmarshall_update_request(TALLOC_CTX *mem_ctx,
struct dns_buffer *buf,
struct dns_update_request **pupreq);
struct dns_request *dns_update2request(struct dns_update_request *update);
struct dns_update_request *dns_request2update(struct dns_request *request);
uint16 dns_response_code(uint16 flags);
const char *dns_errstr(DNS_ERROR err);
/* from dnsgss.c */
#ifdef HAVE_GSSAPI
void display_status( const char *msg, OM_uint32 maj_stat, OM_uint32 min_stat );
DNS_ERROR dns_negotiate_sec_ctx( const char *target_realm,
const char *servername,
const char *keyname,
gss_ctx_id_t *gss_ctx,
enum dns_ServerType srv_type );
DNS_ERROR dns_sign_update(struct dns_update_request *req,
gss_ctx_id_t gss_ctx,
const char *keyname,
const char *algorithmname,
time_t time_signed, uint16 fudge);
#endif /* HAVE_GSSAPI */
#endif /* _DNS_H */