freebsd-src/contrib/bind/port

Porting BIND 8 to Another System

	Make sure to base your port on an existing one.  If your port is
	for a new release of an already supported operating system, please
	try to make the existing port support the new release instead of
	making a new port directory.  For an example of how to do this,
	look at how the Solaris port uses os_version.h in port_after.h.  See
	port/solaris/include/Makefile and port/solaris/bin/make_os_version
	to learn how an os_version.h is made.

	Porting problems fall into broad categories which have simple answers:

	    Include File Missing or Broken

		Make one (possibly empty) in port/*/include or in
		port/*/include/sys.  Broken include files can be fixed; see
		the BSD/OS and ULTRIX ports for examples of how to do this.

	    Library Function Missing:

		Make one (possibly copying it from some other port and hacking)
		and cause it to appear in port/libport.a by virtue of building
		it in port/*/Makefile.  An example is the __ansi_realloc()
		routine in the SunOS port.

	    Desired system feature absent or not prototyped or whatever:

		Edit port/*/include/port_{before,after}.h.  read a few source
		files in lib/ or bin/ to see when/why these are #included.

	    "Make" doesn't work even though my system has a port/* subdir:

		Type "uname -s -r" at your shell and see if the resulting
		string is present in your system's putative port/*/probe
		file.  If not, try adding it.  If it works, send mail to
		bind-bugs@isc.org.

	    My system doesn't have enough of ANSI and POSIX to allow a port:

		Give up.  Get a different system.

	Porting mistakes also fall into broad categories with simple answers:

	    I Can't Get It To Build Without Compiler (Not Linker!) Warnings:

		Keep trying, you're not done yet.

	    I Need To Add Another Portability #define And Some #ifdef's:

		Make sure it won't hurt any other port.  Send us some mail.

	    I Just Have To Edit A Source File To Get It To Compile:

		You are probably missing one of the above opportunities to do
		the right thing and you should rethink your approach and get
		some advice before you send in your port.  But it's possible
		that a non-UNIX system will need a different porting layer,
		especially in isc/eventlib.c and its friends, so contact us
		if you're stuck on this point, there may be something we can
		do.  Send mail to bind-bugs@isc.org.

	    My Employer Won't Allow Me To Send In Porting Diffs:

		You probably need a new employer.  But try really hard, OK?