NetBSD/external/bsd/libbind/dist
sevan cc576e1d8e Update supporting files for components which rely on autoconf to allow systems
introducing since release of software to be recognised. This should hopefully
allow the builds to progress a littles further on systems such as the POWER8
which features a little endian 64-bit PowerPC CPU identified as ppc64le.
2017-02-01 09:26:39 +00:00
..
bsd
doc
dst
include
inet
irs
isc
make
nameser
port
resolv
tests
CHANGES
COPYRIGHT
Makefile.in
README
aclocal.m4
api
config.guess Update supporting files for components which rely on autoconf to allow systems 2017-02-01 09:26:39 +00:00
config.h.in
config.sub Update supporting files for components which rely on autoconf to allow systems 2017-02-01 09:26:39 +00:00
config.threads.in
configure
configure.in
include4netbsd
install-sh
libbind2netbsd
libc4netbsd
libtool.m4
ltmain.sh
mkinstalldirs
port_after.h.in
port_before.h.in
version

README

Introduction

	ISC's libbind provides the standard resolver library,
	along with header files and documentation, for communicating
	with domain name servers, retrieving network host entries
	from /etc/hosts or via DNS, converting CIDR network addresses,
	perform Hesiod information lookups, retrieve network entries
	from /etc/networks, implement TSIG transaction/request
	security of DNS messages, perform name-to-address and
	address-to-name translations, utilize /etc/resolv.conf
	for resolver configuration.

	It contains many of the same historical functions and headers
	included with many Unix operating systems.

	Originally written for BIND 8, it was included in BIND 9 as
	optionally-compiled code through release 9.5.  It has been
	removed from subsequent releases of BIND 9 and is now
	provided as a separate package.

Building

	The libbind library requires a system with an ANSI C compiler
	and basic POSIX support.

	To build, just

		./configure
		make

	Several environment variables that can be set before running
	configure will affect compilation:

	    CC
		The C compiler to use.	configure tries to figure
		out the right one for supported systems.

	    CFLAGS
		C compiler flags.  Defaults to include -g and/or -O2
		as supported by the compiler.  

	    STD_CINCLUDES
		System header file directories.	 Can be used to specify
		where add-on thread or IPv6 support is, for example.
		Defaults to empty string.

	    STD_CDEFINES
		Any additional preprocessor symbols you want defined.
		Defaults to empty string.

		Possible settings:
		Change the default syslog facility of named/lwresd.
		  -DISC_FACILITY=LOG_LOCAL0	
		Enable DNSSEC signature chasing support in dig.
		  -DDIG_SIGCHASE=1 (sets -DDIG_SIGCHASE_TD=1 and
				    -DDIG_SIGCHASE_BU=1)
		Disable dropping queries from particular well known ports.
		  -DNS_CLIENT_DROPPORT=0
		Sibling glue checking in named-checkzone is enabled by default.
		To disable the default check set.  -DCHECK_SIBLING=0
		named-checkzone checks out-of-zone addresses by default.
		To disable this default set.  -DCHECK_LOCAL=0
		Enable workaround for Solaris kernel bug about /dev/poll
		  -DISC_SOCKET_USE_POLLWATCH=1
		  The watch timeout is also configurable, e.g.,
		  -DISC_SOCKET_POLLWATCH_TIMEOUT=20

	    LDFLAGS
		Linker flags. Defaults to empty string.

	The following need to be set when cross compiling.

	    BUILD_CC
		The native C compiler.
	    BUILD_CFLAGS (optional)
	    BUILD_CPPFLAGS (optional)
		Possible Settings:
		-DNEED_OPTARG=1		(optarg is not declared in <unistd.h>)
	    BUILD_LDFLAGS (optional)
	    BUILD_LIBS (optional)

	"make install" will install the library.  By default, installation
	is into /usr/local, but this can be changed with the "--prefix"
	option when running "configure".

	To see additional configure options, run "configure --help".

	If you need to re-run configure please run "make distclean" first.
	This will ensure that all the option changes take.

Notes on Usage

        - Installing both libbind and BIND 9 on the same system
          will produce two incompatible header files with similar
          names: $PREFIX/include/isc/list.h (from BIND 9) and
          $PREFIX/include/bind/isc/list.h (from libbind).  When
          compiling code against libbind, be sure to set -I flags
          appropriately.

Documentation

	Man pages for libbind routines, in *roff and plaintext format,
	are included with the release.

Bug Reports and Mailing Lists

	Bugs reports should be sent to

		libbind-bugs@isc.org

	Discussions of libbind can be send to the BIND Users mailing
	list.  To subscribe, send mail to:

		bind-users-subscribe@isc.org

	Archives of that list can be found at:

		https://lists.isc.org/pipermail/bind-users/

	If you're planning on making changes to the libbind source
	code, you might want to join the BIND Workers mailing list.
	To subscribe, send mail to:

		bind-workers-subscribe@isc.org