/* NETDB.H

 * 

 * Portions copyright (c) 1993-1999 Symbian Ltd.  All rights reserved.

 */

/*-

 * Copyright (c) 1980, 1983, 1988, 1993

 *	The Regents of the University of California.  All rights reserved.

 *

 * Redistribution and use in source and binary forms, with or without

 * modification, are permitted provided that the following conditions

 * are met:

 * 1. Redistributions of source code must retain the above copyright

 *    notice, this list of conditions and the following disclaimer.

 * 2. Redistributions in binary form must reproduce the above copyright

 *    notice, this list of conditions and the following disclaimer in the

 *    documentation and/or other materials provided with the distribution.

 * 3. All advertising materials mentioning features or use of this software

 *    must display the following acknowledgement:

 *	This product includes software developed by the University of

 *	California, Berkeley and its contributors.

 * 4. Neither the name of the University nor the names of its contributors

 *    may be used to endorse or promote products derived from this software

 *    without specific prior written permission.

 *

 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND

 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE

 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE

 * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE

 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL

 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS

 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)

 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT

 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY

 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF

 * SUCH DAMAGE.

 *

 * Portions Copyright (c) 1993 by Digital Equipment Corporation.

 *

 * Permission to use, copy, modify, and distribute this software for any

 * purpose with or without fee is hereby granted, provided that the above

 * copyright notice and this permission notice appear in all copies, and that

 * the name of Digital Equipment Corporation not be used in advertising or

 * publicity pertaining to distribution of the document or software without

 * specific, written prior permission.

 *

 * THE SOFTWARE IS PROVIDED "AS IS" AND DIGITAL EQUIPMENT CORP. DISCLAIMS ALL

 * WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES

 * OF MERCHANTABILITY AND FITNESS.   IN NO EVENT SHALL DIGITAL EQUIPMENT

 * CORPORATION BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL

 * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR

 * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS

 * ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS

 * SOFTWARE.

 * -

 * --Copyright--

 */

/** @file

@publishedAll

@released

*/

#ifndef _NETDB_H_

#define _NETDB_H_

#ifdef __cplusplus

extern "C" {

#endif

#include <_ansi.h>

#include <sys/errno.h>

#define	_PATH_HEQUIV	"/etc/hosts.equiv"

#define	_PATH_HOSTS	"/etc/hosts"

#define	_PATH_NETWORKS	"/etc/networks"

#define	_PATH_PROTOCOLS	"/etc/protocols"

#define	_PATH_SERVICES	"/etc/services"

#define h_errno	errno

/**

Structures returned by network data base library.  All addresses are

supplied in host order, and returned in network order (suitable for

use in system calls).

*/

struct	hostent {

	char	*h_name;	/* official name of host */

	char	**h_aliases;	/* alias list */

	int	h_addrtype;	/* host address type */

	int	h_length;	/* length of address */

	char	**h_addr_list;	/* list of addresses from name server */

#define	h_addr	h_addr_list[0]	/* address, for backward compatibility */

};

/**

Assumption here is that a network number

fits in an unsigned long -- probably a poor one.

*/

struct	netent {

	char		*n_name;	/* official name of net */

	char		**n_aliases;	/* alias list */

	int		n_addrtype;	/* net address type */

	unsigned long	n_net;		/* network # */

};

struct	servent {

	char	*s_name;	/* official service name */

	char	**s_aliases;	/* alias list */

	int	s_port;		/* port # */

	char	*s_proto;	/* protocol to use */

};

struct	protoent {

	char	*p_name;	/* official protocol name */

	char	**p_aliases;	/* alias list */

	int	p_proto;	/* protocol # */

};

/**

Error return codes from gethostbyname() and gethostbyaddr()

*/

#define	NETDB_INTERNAL	-1	/* see errno */

#define	NETDB_SUCCESS	0	/* no problem */

#define	HOST_NOT_FOUND	ENOENT		/* Authoritative Answer Host not found */

#define	TRY_AGAIN	ETIMEDOUT	/* Non-Authoritative Host not found, or SERVERFAIL */

#define	NO_RECOVERY	ECOMM		/* Non recoverable errors, FORMERR, REFUSED, NOTIMP */

#define	NO_DATA		4		/* Valid name, no data record of requested type */

#define	NO_ADDRESS	NO_DATA		/* no address, look for MX record */

#if 0

/* not supported on EPOC32 */

/**

@internalComponent

*/

void		sethostent (int);

/**

@internalComponent

*/

struct hostent	*gethostent (void);

/**

@internalComponent

*/

void		endhostent (void);

/**

@internalComponent

*/

void		setnetent (int);

/**

@internalComponent

*/

struct netent	*getnetent (void);

/**

@internalComponent

*/

void		endnetent (void);

/**

@internalComponent

*/

void		setprotoent (int);

/**

@internalComponent

*/

struct protoent	*getprotoent (void);

/**

@internalComponent

*/

void		endprotoent (void);

/**

@internalComponent

*/

void		setservent (int);

/**

@internalComponent

*/

struct servent	*getservent (void);

/**

@internalComponent

*/

void		endservent (void);

#endif

IMPORT_C struct hostent	*gethostbyaddr (const char *, int, int);

IMPORT_C struct hostent	*gethostbyname (const char *);

struct servent	*getservbyname (const char *, const char *);

struct servent	*getservbyport (int, const char *);

struct netent	*getnetbyaddr (unsigned long, int);

struct netent	*getnetbyname (const char *);

struct protoent	*getprotobyname (const char *);

struct protoent	*getprotobynumber (int);

#ifdef __cplusplus

}

#endif

#endif /* !_NETDB_H_ */