1 /* 2 * CDDL HEADER START 3 * 4 * The contents of this file are subject to the terms of the 5 * Common Development and Distribution License (the "License"). 6 * You may not use this file except in compliance with the License. 7 * 8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 9 * or http://www.opensolaris.org/os/licensing. 10 * See the License for the specific language governing permissions 11 * and limitations under the License. 12 * 13 * When distributing Covered Code, include this CDDL HEADER in each 14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 15 * If applicable, add the following below this CDDL HEADER, with the 16 * fields enclosed by brackets "[]" replaced with your own identifying 17 * information: Portions Copyright [yyyy] [name of copyright owner] 18 * 19 * CDDL HEADER END 20 */ 21 /* 22 * Copyright 2008 Sun Microsystems, Inc. All rights reserved. 23 * Use is subject to license terms. 24 */ 25 26 #ifndef _SMBSRV_DYNDNS_H 27 #define _SMBSRV_DYNDNS_H 28 29 #pragma ident "%Z%%M% %I% %E% SMI" 30 31 #include <smbsrv/libsmbns.h> 32 33 /* 34 * Header section format: 35 * 36 * The header contains the following fields: 37 * 38 * 1 1 1 1 1 1 39 * 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 40 * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+ 41 * | ID | 42 * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+ 43 * |QR| Opcode |AA|TC|RD|RA| Z | RCODE | 44 * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+ 45 * | QDCOUNT | 46 * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+ 47 * | ANCOUNT | 48 * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+ 49 * | NSCOUNT | 50 * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+ 51 * | ARCOUNT | 52 * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+ 53 * 54 * where: 55 * 56 * ID A 16 bit identifier assigned by the program that 57 * generates any kind of query. This identifier is copied 58 * the corresponding reply and can be used by the requester 59 * to match up replies to outstanding queries. 60 * 61 * QR A one bit field that specifies whether this message is a 62 * query (0), or a response (1). 63 * 64 * OPCODE A four bit field that specifies kind of query in this 65 * message. This value is set by the originator of a query 66 * and copied into the response. The values are: 67 * 68 * 0 a standard query (QUERY) 69 * 70 * 1 an inverse query (IQUERY) 71 * 72 * 2 a server status request (STATUS) 73 * 74 * 3-15 reserved for future use 75 * 76 * AA Authoritative Answer - this bit is valid in responses, 77 * and specifies that the responding name server is an 78 * authority for the domain name in question section. 79 * 80 * Note that the contents of the answer section may have 81 * multiple owner names because of aliases. The AA bit 82 * 83 * corresponds to the name which matches the query name, or 84 * the first owner name in the answer section. 85 * 86 * TC TrunCation - specifies that this message was truncated 87 * due to length greater than that permitted on the 88 * transmission channel. 89 * 90 * RD Recursion Desired - this bit may be set in a query and 91 * is copied into the response. If RD is set, it directs 92 * the name server to pursue the query recursively. 93 * Recursive query support is optional. 94 * 95 * RA Recursion Available - this be is set or cleared in a 96 * response, and denotes whether recursive query support is 97 * available in the name server. 98 * 99 * Z Reserved for future use. Must be zero in all queries 100 * and responses. 101 * 102 * RCODE Response code - this 4 bit field is set as part of 103 * responses. The values have the following 104 * interpretation: 105 * 106 * 0 No error condition 107 * 108 * 1 Format error - The name server was 109 * unable to interpret the query. 110 * 111 * 2 Server failure - The name server was 112 * unable to process this query due to a 113 * problem with the name server. 114 * 115 * 3 Name Error - Meaningful only for 116 * responses from an authoritative name 117 * server, this code signifies that the 118 * domain name referenced in the query does 119 * not exist. 120 * 121 * 4 Not Implemented - The name server does 122 * not support the requested kind of query. 123 * 124 * 5 Refused - The name server refuses to 125 * perform the specified operation for 126 * policy reasons. For example, a name 127 * server may not wish to provide the 128 * information to the particular requester, 129 * or a name server may not wish to perform 130 * a particular operation (e.g., zone 131 * 132 * transfer) for particular data. 133 * 134 * 6-15 Reserved for future use. 135 * 136 * QDCOUNT an unsigned 16 bit integer specifying the number of 137 * entries in the question section. 138 * 139 * ANCOUNT an unsigned 16 bit integer specifying the number of 140 * resource records in the answer section. 141 * 142 * NSCOUNT an unsigned 16 bit integer specifying the number of name 143 * server resource records in the authority records 144 * section. 145 * 146 * ARCOUNT an unsigned 16 bit integer specifying the number of 147 * resource records in the additional records section. 148 */ 149 150 #include <sys/types.h> 151 152 #ifdef __cplusplus 153 extern "C" { 154 #endif 155 156 /* Other definitions: */ 157 #define REQ_QUERY 1 /* DNS query request */ 158 #define REQ_UPDATE 0 /* DNS update request */ 159 #define UPDATE_FORW 1 /* Update forward lookup zone */ 160 #define UPDATE_REV 0 /* Update reverse lookup zone */ 161 #define UPDATE_ADD 1 /* Update add request */ 162 #define UPDATE_DEL 0 /* Update remove request */ 163 #define MODE_GSS_API 3 /* Key negotiation mode */ 164 165 /* Max buffer size for send and receive buffer */ 166 #define MAX_BUF_SIZE 2000 167 #define MAX_RETRIES 3 /* Max number of send retries if no response */ 168 #define TSIG_SIGNED 1 /* TSIG contains signed data */ 169 #define TSIG_UNSIGNED 0 /* TSIG does not conain signed data */ 170 #define DNS_CHECK 1 /* Check DNS for entry */ 171 #define DNS_NOCHECK 0 /* Don't check DNS for entry */ 172 #define MAX_TCP_SIZE 2000 /* max tcp DNS message size */ 173 174 /* Delete 1 entry */ 175 #define DEL_ONE 1 176 /* Delete all entries of the same resource name */ 177 #define DEL_ALL 0 178 179 #define DNSF_RECUR_SUPP 0x80 /* Server can do recursive queries */ 180 #define DNSF_RECUR_QRY 0x100 /* Query is recursive */ 181 182 #define BUFLEN_TCP(x, y) (MAX_TCP_SIZE-(x-y)) 183 #define BUFLEN_UDP(x, y) (NS_PACKETSZ-(x-y)) 184 185 extern int dns_get_msgid(void); 186 extern char *dyndns_get_nshort(char *, uint16_t *); 187 extern char *dyndns_get_int(char *, int *); 188 extern int dyndns_build_header(char **, int, uint16_t, int, 189 uint16_t, uint16_t, uint16_t, uint16_t, int); 190 extern int dyndns_build_quest_zone(char **, int, char *, int, int); 191 extern int dyndns_open_init_socket(int sock_type, unsigned long dest_addr, 192 int port); 193 extern int dyndns_udp_send_recv(int, char *, int, char *); 194 extern void dyndns_msg_err(int); 195 196 /* 197 * DDNS_TTL is the time to live in DNS caches. Note that this 198 * does not affect the entry in the authoritative DNS database. 199 */ 200 #define DDNS_TTL 1200 201 202 #ifdef __cplusplus 203 } 204 #endif 205 206 #endif /* _SMBSRV_DYNDNS_H */ 207