1 /*
   2  * Copyright 2009 Sun Microsystems, Inc.  All rights reserved.
   3  * Use is subject to license terms.
   4  */
   5 
   6 /*      Copyright (c) 1983, 1984, 1985, 1986, 1987, 1988, 1989 AT&T */
   7 /*        All Rights Reserved   */
   8 
   9 /*
  10  * BIND 4.9.3:
  11  *
  12  * Copyright (c) 1980, 1983, 1988, 1993
  13  *      The Regents of the University of California.  All rights reserved.
  14  *
  15  * Redistribution and use in source and binary forms, with or without
  16  * modification, are permitted provided that the following conditions
  17  * are met:
  18  * 1. Redistributions of source code must retain the above copyright
  19  *    notice, this list of conditions and the following disclaimer.
  20  * 2. Redistributions in binary form must reproduce the above copyright
  21  *    notice, this list of conditions and the following disclaimer in the
  22  *    documentation and/or other materials provided with the distribution.
  23  * 3. All advertising materials mentioning features or use of this software
  24  *    must display the following acknowledgement:
  25  *      This product includes software developed by the University of
  26  *      California, Berkeley and its contributors.
  27  * 4. Neither the name of the University nor the names of its contributors
  28  *    may be used to endorse or promote products derived from this software
  29  *    without specific prior written permission.
  30  *
  31  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  32  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  33  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  34  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  35  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  36  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  37  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  38  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  39  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  40  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  41  * SUCH DAMAGE.
  42  * -
  43  * Portions Copyright (c) 1993 by Digital Equipment Corporation.
  44  *
  45  * Permission to use, copy, modify, and distribute this software for any
  46  * purpose with or without fee is hereby granted, provided that the above
  47  * copyright notice and this permission notice appear in all copies, and that
  48  * the name of Digital Equipment Corporation not be used in advertising or
  49  * publicity pertaining to distribution of the document or software without
  50  * specific, written prior permission.
  51  *
  52  * THE SOFTWARE IS PROVIDED "AS IS" AND DIGITAL EQUIPMENT CORP. DISCLAIMS ALL
  53  * WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES
  54  * OF MERCHANTABILITY AND FITNESS.   IN NO EVENT SHALL DIGITAL EQUIPMENT
  55  * CORPORATION BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
  56  * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
  57  * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
  58  * ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
  59  * SOFTWARE.
  60  * --Copyright--
  61  *
  62  * End BIND 4.9.3
  63  */
  64 
  65 /*
  66  * Structures returned by network data base library.
  67  * All addresses are supplied in host order, and
  68  * returned in network order (suitable for use in system calls).
  69  */
  70 
  71 #ifndef _NETDB_H
  72 #define _NETDB_H
  73 
  74 #include <sys/types.h>
  75 #include <netinet/in.h>
  76 #if !defined(_XPG4_2) || defined(_XPG6) || defined(__EXTENSIONS__)
  77 #include <sys/socket.h>
  78 #endif /* !defined(_XPG4_2) || defined(_XPG6) || defined(__EXTENSIONS__) */
  79 #include <sys/feature_tests.h>
  80 
  81 #ifdef  __cplusplus
  82 extern "C" {
  83 #endif
  84 
  85 #define _PATH_HEQUIV    "/etc/hosts.equiv"
  86 #define _PATH_HOSTS     "/etc/hosts"
  87 #define _PATH_IPNODES   "/etc/inet/ipnodes"
  88 #define _PATH_IPSECALGS "/etc/inet/ipsecalgs"
  89 #define _PATH_NETMASKS  "/etc/netmasks"
  90 #define _PATH_NETWORKS  "/etc/networks"
  91 #define _PATH_PROTOCOLS "/etc/protocols"
  92 #define _PATH_SERVICES  "/etc/services"
  93 
  94 struct  hostent {
  95         char    *h_name;        /* official name of host */
  96         char    **h_aliases;    /* alias list */
  97         int     h_addrtype;     /* host address type */
  98         int     h_length;       /* length of address */
  99         char    **h_addr_list;  /* list of addresses from name server */
 100 #define h_addr  h_addr_list[0]  /* address, for backward compatiblity */
 101 };
 102 
 103 
 104 /*
 105  * addrinfo introduced with IPv6 for Protocol-Independent Hostname
 106  * and Service Name Translation.
 107  */
 108 
 109 #if !defined(_XPG4_2) || defined(_XPG6) || defined(__EXTENSIONS__)
 110 struct addrinfo {
 111         int ai_flags;           /* AI_PASSIVE, AI_CANONNAME, ... */
 112         int ai_family;          /* PF_xxx */
 113         int ai_socktype;        /* SOCK_xxx */
 114         int ai_protocol;        /* 0 or IPPROTO_xxx for IPv4 and IPv6 */
 115 #ifdef __sparcv9
 116         int _ai_pad;            /* for backwards compat with old size_t */
 117 #endif /* __sparcv9 */
 118         socklen_t ai_addrlen;
 119         char *ai_canonname;     /* canonical name for hostname */
 120         struct sockaddr *ai_addr;       /* binary address */
 121         struct addrinfo *ai_next;       /* next structure in linked list */
 122 };
 123 
 124 
 125 /* addrinfo flags */
 126 #define AI_PASSIVE      0x0008  /* intended for bind() + listen() */
 127 #define AI_CANONNAME    0x0010  /* return canonical version of host */
 128 #define AI_NUMERICHOST  0x0020  /* use numeric node address string */
 129 #define AI_NUMERICSERV  0x0040  /* servname is assumed numeric */
 130 
 131 /* getipnodebyname() flags */
 132 #define AI_V4MAPPED     0x0001  /* IPv4 mapped addresses if no IPv6 */
 133 #define AI_ALL          0x0002  /* IPv6 and IPv4 mapped addresses */
 134 #define AI_ADDRCONFIG   0x0004  /* AAAA or A records only if IPv6/IPv4 cnfg'd */
 135 
 136 
 137 /*
 138  * These were defined in RFC 2553 but not SUSv3
 139  * or RFC 3493 which obsoleted 2553.
 140  */
 141 #if !defined(_XPG6) || defined(__EXTENSIONS__)
 142 #define AI_DEFAULT      (AI_V4MAPPED | AI_ADDRCONFIG)
 143 
 144 /* addrinfo errors */
 145 #define EAI_ADDRFAMILY  1       /* address family not supported */
 146 #define EAI_NODATA      7       /* no address */
 147 #endif /* !defined(_XPG6) || defined(__EXTENSIONS__) */
 148 #define EAI_AGAIN       2       /* DNS temporary failure */
 149 #define EAI_BADFLAGS    3       /* invalid ai_flags */
 150 #define EAI_FAIL        4       /* DNS non-recoverable failure */
 151 #define EAI_FAMILY      5       /* ai_family not supported */
 152 #define EAI_MEMORY      6       /* memory allocation failure */
 153 #define EAI_NONAME      8       /* host/servname not known */
 154 #define EAI_SERVICE     9       /* servname not supported for ai_socktype */
 155 #define EAI_SOCKTYPE    10      /* ai_socktype not supported */
 156 #define EAI_SYSTEM      11      /* system error in errno */
 157 #define EAI_OVERFLOW    12      /* argument buffer overflow */
 158 #define EAI_PROTOCOL    13
 159 #define EAI_MAX         14
 160 
 161 /* getnameinfo flags */
 162 #define NI_NOFQDN       0x0001
 163 #define NI_NUMERICHOST  0x0002  /* return numeric form of address */
 164 #define NI_NAMEREQD     0x0004  /* request DNS name */
 165 #define NI_NUMERICSERV  0x0008
 166 #define NI_DGRAM        0x0010
 167 
 168 #if !defined(_XPG6) || defined(__EXTENSIONS__)
 169 /* Not listed in any standards document */
 170 #define NI_WITHSCOPEID  0x0020
 171 #define NI_NUMERICSCOPE 0x0040
 172 
 173 /* getnameinfo max sizes as defined in RFC 2553 obsoleted in RFC 3493 */
 174 #define NI_MAXHOST      1025
 175 #define NI_MAXSERV      32
 176 #endif /* !defined(_XPG6) || defined(__EXTENSIONS__) */
 177 #endif /* !defined(_XPG4_2) || defined(_XPG6) || defined(__EXTENSIONS__) */
 178 
 179 /*
 180  * Scope delimit character
 181  */
 182 #define SCOPE_DELIMITER '%'
 183 
 184 
 185 /*
 186  * Algorithm entry for /etc/inet/ipsecalgs which defines IPsec protocols
 187  * and algorithms.
 188  */
 189 #if !defined(_XPG4_2) || defined(__EXTENSIONS__)
 190 typedef struct ipsecalgent {
 191         char **a_names;         /* algorithm names */
 192         int a_proto_num;        /* protocol number */
 193         int a_alg_num;          /* algorithm number */
 194         char *a_mech_name;      /* encryption framework mechanism name */
 195         int *a_block_sizes;     /* supported block sizes */
 196         int *a_key_sizes;       /* supported key sizes */
 197         int a_key_increment;    /* key size increment */
 198         int *a_mech_params;     /* mechanism specific parameters */
 199         int a_alg_flags;        /* algorithm flags */
 200 } ipsecalgent_t;
 201 
 202 /* well-known IPsec protocol numbers */
 203 
 204 #define IPSEC_PROTO_AH          2
 205 #define IPSEC_PROTO_ESP         3
 206 #endif /* !defined(_XPG4_2) || defined(__EXTENSIONS__) */
 207 
 208 /*
 209  * Assumption here is that a network number
 210  * fits in 32 bits -- probably a poor one.
 211  */
 212 struct  netent {
 213         char            *n_name;        /* official name of net */
 214         char            **n_aliases;    /* alias list */
 215         int             n_addrtype;     /* net address type */
 216         in_addr_t       n_net;          /* network # */
 217 };
 218 
 219 struct  protoent {
 220         char    *p_name;        /* official protocol name */
 221         char    **p_aliases;    /* alias list */
 222         int     p_proto;        /* protocol # */
 223 };
 224 
 225 struct  servent {
 226         char    *s_name;        /* official service name */
 227         char    **s_aliases;    /* alias list */
 228         int     s_port;         /* port # */
 229         char    *s_proto;       /* protocol to use */
 230 };
 231 
 232 #ifdef  __STDC__
 233 #if !defined(_XPG4_2) || defined(__EXTENSIONS__)
 234 struct hostent  *gethostbyname_r
 235         (const char *, struct hostent *, char *, int, int *h_errnop);
 236 struct hostent  *gethostbyaddr_r
 237         (const char *, int, int, struct hostent *, char *, int, int *h_errnop);
 238 struct hostent  *getipnodebyname(const char *, int, int, int *);
 239 struct hostent  *getipnodebyaddr(const void *, size_t, int, int *);
 240 void            freehostent(struct hostent *);
 241 struct hostent  *gethostent_r(struct hostent *, char *, int, int *h_errnop);
 242 
 243 struct servent  *getservbyname_r
 244         (const char *name, const char *, struct servent *, char *, int);
 245 struct servent  *getservbyport_r
 246         (int port, const char *, struct servent *, char *, int);
 247 struct servent  *getservent_r(struct    servent *, char *, int);
 248 
 249 struct netent   *getnetbyname_r
 250         (const char *, struct netent *, char *, int);
 251 struct netent   *getnetbyaddr_r(long, int, struct netent *, char *, int);
 252 struct netent   *getnetent_r(struct netent *, char *, int);
 253 
 254 struct protoent *getprotobyname_r
 255         (const char *, struct protoent *, char *, int);
 256 struct protoent *getprotobynumber_r
 257         (int, struct protoent *, char *, int);
 258 struct protoent *getprotoent_r(struct protoent *, char *, int);
 259 
 260 int getnetgrent_r(char **, char **, char **, char *, int);
 261 int innetgr(const char *, const char *, const char *, const char *);
 262 #endif /* !defined(_XPG4_2) || defined(__EXTENSIONS__) */
 263 
 264 /* Old interfaces that return a pointer to a static area;  MT-unsafe */
 265 struct hostent  *gethostbyname(const char *);
 266 struct hostent  *gethostent(void);
 267 struct netent   *getnetbyaddr(in_addr_t, int);
 268 struct netent   *getnetbyname(const char *);
 269 struct netent   *getnetent(void);
 270 struct protoent *getprotobyname(const char *);
 271 struct protoent *getprotobynumber(int);
 272 struct protoent *getprotoent(void);
 273 struct servent  *getservbyname(const char *, const char *);
 274 struct servent  *getservbyport(int, const char *);
 275 struct servent  *getservent(void);
 276 
 277 /* gethostbyaddr() second argument is a size_t only in unix95/unix98 */
 278 #if !defined(_XPG4_2) || defined(_XPG6) || defined(__EXTENSIONS__)
 279 struct hostent  *gethostbyaddr(const void *, socklen_t, int);
 280 #else
 281 struct hostent  *gethostbyaddr(const void *, size_t, int);
 282 #endif /* !defined(_XPG4_2) || defined(_XPG6) || defined(__EXTENSIONS__) */
 283 
 284 #if !defined(_XPG4_2) || defined(__EXTENSIONS__)
 285 int endhostent(void);
 286 int endnetent(void);
 287 int endprotoent(void);
 288 int endservent(void);
 289 int sethostent(int);
 290 int setnetent(int);
 291 int setprotoent(int);
 292 int setservent(int);
 293 #else
 294 void endhostent(void);
 295 void endnetent(void);
 296 void endprotoent(void);
 297 void endservent(void);
 298 void sethostent(int);
 299 void setnetent(int);
 300 void setprotoent(int);
 301 void setservent(int);
 302 #endif /* !defined(_XPG4_2) || defined(__EXTENSIONS__) */
 303 
 304 #if !defined(_XPG4_2) || defined(_XPG6) || defined(__EXTENSIONS__)
 305 
 306 #ifdef  _XPG6
 307 #ifdef  __PRAGMA_REDEFINE_EXTNAME
 308 #pragma redefine_extname getaddrinfo __xnet_getaddrinfo
 309 #else   /* __PRAGMA_REDEFINE_EXTNAME */
 310 #define getaddrinfo __xnet_getaddrinfo
 311 #endif  /* __PRAGMA_REDEFINE_EXTNAME */
 312 #endif  /* _XPG6 */
 313 
 314 int             getaddrinfo(const char *_RESTRICT_KYWD,
 315                         const char *_RESTRICT_KYWD,
 316                         const struct addrinfo *_RESTRICT_KYWD,
 317                         struct addrinfo **_RESTRICT_KYWD);
 318 void            freeaddrinfo(struct addrinfo *);
 319 const char      *gai_strerror(int);
 320 int             getnameinfo(const struct sockaddr *_RESTRICT_KYWD,
 321                         socklen_t, char *_RESTRICT_KYWD, socklen_t,
 322                         char *_RESTRICT_KYWD, socklen_t, int);
 323 #endif /* !defined(_XPG4_2) || defined(_XPG6) || defined(__EXTENSIONS__) */
 324 
 325 #if !defined(_XPG4_2) || defined(__EXTENSIONS__)
 326 int getnetgrent(char **, char **, char **);
 327 int setnetgrent(const char *);
 328 int endnetgrent(void);
 329 int rcmd(char **, unsigned short,
 330         const char *, const char *, const char *, int *);
 331 int rcmd_af(char **, unsigned short,
 332         const char *, const char *, const char *, int *, int);
 333 int rresvport_af(int *, int);
 334 int rresvport_addr(int *, struct sockaddr_storage *);
 335 int rexec(char **, unsigned short,
 336         const char *, const char *, const char *, int *);
 337 int rexec_af(char **, unsigned short,
 338         const char *, const char *, const char *, int *, int);
 339 int rresvport(int *);
 340 int ruserok(const char *, int, const char *, const char *);
 341 /* BIND */
 342 struct hostent  *gethostbyname2(const char *, int);
 343 void            herror(const char *);
 344 const char      *hstrerror(int);
 345 /* End BIND */
 346 
 347 /* IPsec algorithm prototype definitions */
 348 struct ipsecalgent *getipsecalgbyname(const char *, int, int *);
 349 struct ipsecalgent *getipsecalgbynum(int, int, int *);
 350 int getipsecprotobyname(const char *doi_name);
 351 char *getipsecprotobynum(int doi_domain);
 352 void freeipsecalgent(struct ipsecalgent *ptr);
 353 /* END IPsec algorithm prototype definitions */
 354 
 355 #endif /* !defined(_XPG4_2) || defined(__EXTENSIONS__) */
 356 #else   /* __STDC__ */
 357 struct hostent  *gethostbyname_r();
 358 struct hostent  *gethostbyaddr_r();
 359 struct hostent  *getipnodebyname();
 360 struct hostent  *getipnodebyaddr();
 361 void             freehostent();
 362 struct hostent  *gethostent_r();
 363 struct servent  *getservbyname_r();
 364 struct servent  *getservbyport_r();
 365 struct servent  *getservent_r();
 366 struct netent   *getnetbyname_r();
 367 struct netent   *getnetbyaddr_r();
 368 struct netent   *getnetent_r();
 369 struct protoent *getprotobyname_r();
 370 struct protoent *getprotobynumber_r();
 371 struct protoent *getprotoent_r();
 372 int              getnetgrent_r();
 373 int              innetgr();
 374 
 375 /* Old interfaces that return a pointer to a static area;  MT-unsafe */
 376 struct hostent  *gethostbyname();
 377 struct hostent  *gethostbyaddr();
 378 struct hostent  *gethostent();
 379 struct netent   *getnetbyname();
 380 struct netent   *getnetbyaddr();
 381 struct netent   *getnetent();
 382 struct servent  *getservbyname();
 383 struct servent  *getservbyport();
 384 struct servent  *getservent();
 385 struct protoent *getprotobyname();
 386 struct protoent *getprotobynumber();
 387 struct protoent *getprotoent();
 388 int              getnetgrent();
 389 
 390 int sethostent();
 391 int endhostent();
 392 int setnetent();
 393 int endnetent();
 394 int setservent();
 395 int endservent();
 396 int setprotoent();
 397 int endprotoent();
 398 int setnetgrent();
 399 int endnetgrent();
 400 int rcmd();
 401 int rcmd_af();
 402 int rexec();
 403 int rexec_af();
 404 int rresvport();
 405 int rresvport_af();
 406 int rresvport_addr();
 407 int ruserok();
 408 /* BIND */
 409 struct hostent  *gethostbyname2();
 410 void            herror();
 411 char            *hstrerror();
 412 /* IPv6 prototype definitons */
 413 int             getaddrinfo();
 414 void            freeaddrinfo();
 415 const char      *gai_strerror();
 416 int             getnameinfo();
 417 /* END IPv6 prototype definitions */
 418 /* End BIND */
 419 
 420 #if !defined(_XPG4_2) || defined(__EXTENSIONS__)
 421 /* IPsec algorithm prototype definitions */
 422 struct ipsecalgent *getalgbyname();
 423 struct ipsecalgent *getalgbydoi();
 424 int getdoidomainbyname();
 425 const char *getdoidomainbynum();
 426 void freealgent();
 427 /* END IPsec algorithm prototype definitions */
 428 #endif /* !defined(_XPG4_2) || defined(__EXTENSIONS__) */
 429 
 430 #endif  /* __STDC__ */
 431 
 432 /*
 433  * Error return codes from gethostbyname() and gethostbyaddr()
 434  * (when using the resolver)
 435  */
 436 
 437 extern  int h_errno;
 438 
 439 #ifdef  _REENTRANT
 440 #ifdef  __STDC__
 441 extern int      *__h_errno(void);
 442 #else
 443 extern int      *__h_errno();
 444 #endif  /* __STDC__ */
 445 
 446 /* Only #define h_errno if there is no conflict with other use */
 447 #ifdef  H_ERRNO_IS_FUNCTION
 448 #define h_errno (*__h_errno())
 449 #endif  /* NO_H_ERRNO_DEFINE */
 450 #endif  /* _REENTRANT */
 451 
 452 /*
 453  * Error return codes from gethostbyname() and gethostbyaddr()
 454  * (left in extern int h_errno).
 455  */
 456 #define HOST_NOT_FOUND  1 /* Authoritive Answer Host not found */
 457 #define TRY_AGAIN       2 /* Non-Authoritive Host not found, or SERVERFAIL */
 458 #define NO_RECOVERY     3 /* Non recoverable errors, FORMERR, REFUSED, NOTIMP */
 459 #define NO_DATA         4 /* Valid name, no data record of requested type */
 460 
 461 #if !defined(_XPG4_2) || defined(__EXTENSIONS__)
 462 #define NO_ADDRESS      NO_DATA         /* no address, look for MX record */
 463 
 464 /* BIND */
 465 #define NETDB_INTERNAL  -1      /* see errno */
 466 #define NETDB_SUCCESS   0       /* no problem */
 467 /* End BIND */
 468 
 469 #define MAXHOSTNAMELEN  256
 470 
 471 #define MAXALIASES      35
 472 #define MAXADDRS        35
 473 #endif /* !defined(_XPG4_2) || defined(__EXTENSIONS__) */
 474 
 475 #ifdef  __cplusplus
 476 }
 477 #endif
 478 
 479 #endif  /* _NETDB_H */