151N/ACopyright (C) 2004 Internet Systems Consortium, Inc. ("ISC")
151N/ACopyright (C) 1999-2001 Internet Software Consortium.
151N/A$Id: windows-nt,v 1.8 2004/03/05 05:04:47 marka Exp $
151N/A Windows NT Portability Notes
151N/AA primary goal in the overall design of BIND9 was to isolate functions
151N/Athat were specific to operating systems from those that are available
151N/Awith ANSI C. Even though development was being done on Unix-like
151N/Amachines, the main intention was that a Windows NT port could be done
151N/Awith far less hassle if the incompatible bits were encapsulated into
151N/Atheir own dedicated modules. A libisc API was designed for each
151N/Aoperating system feature that was needed, and initial implementations
151N/Aof those APIs were done for the various Unix operating systems. Some
151N/Aof the APIs have been implemented in Win32, but not yet all.
151N/AThe target Windows NT build environment was specified as having nmake
151N/Aand the Microsoft Visual C++ 6.0 compiler, but explicitly _not_ having
151N/ACygwin or any other external portability package, because we wanted to
151N/Akeep the prerequisites as minimal as possible.
151N/AIn the source tree, the Unix implementations for the OS APIs are in a
151N/A"unix" subdirectory of
lib/isc, while the thread APIs based on POSIX
151N/Adirectory of the BIND9 sources. Its usage is:
151N/Awhere "remotedest" is the path under which the sources will be
151N/Acompiled on the NT machine, and "localdest" is where the munged
151N/Asource tree will be placed on the local machine in preparation for
151N/Aenvironment and I'm the one working on this. Use forward slashes when
151N/Aspecifying the remote path.
151N/AThe default localdest is ../bind9-nt.
151N/Adirectory of "localdest" if the -zip flag is specified; otherwise,
151N/Anone is made by default.
151N/AThis module defines several functions that are useful for writing an
151N/Aapplication that uses the ISC library. Bob Halley originally said,
151N/A"The main reason I wrote it was to help with the sometimes difficult
151N/Aproblems that occur when you try to do a controlled shutdown of a
151N/Amultithreaded application. This scheme [using isc_app_start/
as-yet-unwritten single-threaded version of the ISC library without
any source code changes." XXX It has not yet been implemented for
This module provides compatibility with the pthread_cond_* functions
of POSIX, which can be used to synchronize threads based on a
This module implements the directory scanning routines isc_dir_open,
isc_dir_read and isc_dir_close, used to iterate over the filenames in
a directory. XXX It also implements isc_dir_chdir to set the current
directory, but this function has not yet been written for Win32.
The File module is for functions that access
and/or modify operating
system information about files. XXX It has not yet been written for Win32.
This module implements the pthreads functions flockfile, funlockfile
and getc_unlocked, which synchronize stdio calls from multiple
threads. XXX It has not yet been written for Win32. Or for Unix
for that matter. Merge into File?
This module implements the isc_interfaceiter_first, _next, _current
and _destroy functions to list all of the network interfaces on a
machine. XXX It has not yet been written for Win32.
XXX It has not yet been written for Win32.
XXX It has not yet been written for Win32.
This module ensures that a particular function, such as an
initialization routine, is only executed once, ensuring that any other
threads that need to have the target function executed before they can
work are blocked until the target function has completely finished.
XXX It has not yet been written for Win32.
This module defines isc_stdtime_get, which stores the number of
seconds since 1 Jan 1970 00:00:00 UTC in an isc_stdtime_t variable.
This module provides the isc_thread_create and isc_thread_join
functions, which behave like the POSIX Thread routines pthread_create
and pthread_join. XXX It also defines isc_thread_self to return the id of
This module defines several time management routines, such getting the
current time, adding or subtracting an interval, finding the
difference between two times, or simply determining whether one time