interesting
/
getdns
mirror of https://github.com/getdnsapi/getdns.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
127 Commits 58 Branches 69 Tags 14 MiB
C 89.5%
HTML 5.8%
CMake 2.6%
Shell 2.1%
Go to file
Melinda Shore d520d62da9 Added address-to-hostname lookup. Note: need a more robust address reverser 2013-10-30 13:16:51 -07:00
doc thinking 2013-08-30 11:35:18 -04:00
m4 Removed symlink ltmain.sh. Add m4 for lt. 2013-08-09 10:48:22 -04:00
src Added address-to-hostname lookup. Note: need a more robust address reverser 2013-10-30 13:16:51 -07:00
.gitignore Let git ignore build executables 2013-10-29 20:36:34 +01:00
AUTHORS Moving things around to run configure at top level of directory tree 2013-07-30 11:55:09 -08:00
COPYING another file required by automake. using a symlink to LICENSE 2013-08-08 17:39:45 -08:00
ChangeLog Converted makefile generation to automake 2013-08-08 17:21:05 -08:00
INSTALL Removed symlink ltmain.sh. Add m4 for lt. 2013-08-09 10:48:22 -04:00
LICENSE Change license from MIT to BSD-new 2013-09-11 18:41:23 -04:00
Makefile.in no longer using automake 2013-10-07 08:10:06 -07:00
NEWS Moving things around to run configure at top level of directory tree 2013-07-30 11:55:09 -08:00
README automake version dep noted 2013-08-30 14:19:03 -04:00
README.md Initial integration of unbound. 2013-10-15 17:28:23 -04:00
aclocal.m4 adding back generated files needed by automake 2013-08-30 08:12:33 -08:00
config.guess Make config.guess and sub actual scripts rather than symlinks 2013-10-14 13:43:07 -04:00
config.sub Make config.guess and sub actual scripts rather than symlinks 2013-10-14 13:43:07 -04:00
configure.ac Get rid of pthread usage in getdns_general_sync 2013-10-29 21:25:04 +01:00
depcomp adding back generated files needed by automake 2013-08-30 08:12:33 -08:00
install-sh Converted makefile generation to automake 2013-08-08 17:21:05 -08:00
ltmain.sh adding back generated files needed by automake 2013-08-30 08:12:33 -08:00
missing necessary for automake/autoconf 2013-08-08 17:31:42 -08:00
unbound.2985.patch Initial integration of unbound. 2013-10-15 17:28:23 -04:00

README.md

getdns API

getdns is a modern asynchronous DNS API intended to make all types of DNS information easily available as described by Paul Hoffman. This implementation is licensed under the New BSD License (BSD-new).

The getdns-api mailing list is a good place to engage in discussions regarding the design of the API.

This file captures the goals and direction of the project and the current state of the implementation.

The goals of this implementation of the getdns API are:

  • Provide an open source implementation, in C, of the formally described getdns API by Paul Hoffman at http://www.vpnc.org/getdns-api/
  • Initial support for FreeBSD x.y, MS-Windows Ver. X, OSX 10.x, Linux (CentOS/RHEL R6uX, Ubuntu Ver X) via functional "configure" script
  • Initial support to include the Android platform
  • Include examples and tests as part of the build
  • Document code using doxygen
  • Leverage github as much as possible for project coordination
  • Coding style/standards follow the BSD coding style ftp://ftp.netbsd.org/pub/NetBSD/NetBSD-current/src/share/misc/style
  • Follow the git flow branching model described at http://nvie.com/posts/a-successful-git-branching-model/ ** the master branch is always in a production ready state ** the develop branch contains the latest development changes which are merged from develop into master once they are considered production ready
  • Both synchronous and asynchronous entry points with an early focus on the asynchronous model

Non-goals (things we will not be doing) include:

  • implementation of the traditional DNS related routines (gethostbyname, etc.)

Contributors

  • Neel Goyal, Verisign, Inc.
  • Allison Mankin, Verisign, Inc.
  • Melinda Shore, No Mountain Software LLC
  • Glen Wiley, Verisign, Inc.

External Dependencies

External dependencies are linked outside the getdns API build tree (we rely on configure to find them).

The project relies on libldns from NL for parsing and constructing DNS packets. Version 1.6.16 (note that building ldns may require openssl headers and libraries)

The project also relies on libunbound from NL. Currently it relies on svn revision 2985. The unbound.2985.patch must be applied to the source tree as well. The ./configure must be run with the --with-libevent option (recommended to also use --with-libunbound-only)

Although libevent is used initially to implement the asynchronous model, future work may include a move to other mechanisms (epoll based etc.). Version 2.0.21 stable

Doxygen is used to generate documentation, while this is not technically necessary for the build it makes things a lot more pleasant.

GNU autoconf is used to generate the configure script (and consequently the Makefiles)

Automake 1.12 is required if you are building the distribution tarball.

Current State of the Implementation

We are currently in the early stages of building the API so the code should be considered incomplete. The current target platforms and the personal primarily responsible for ensuring it builds and runs on that platform include:

  • Android, Neel Goyal
  • FreeBSD, Melinda Shore
  • Linux RHEL/CentOS 6.x, Glen Wiley
  • MS-Windows 8, Neel Goyal
  • OSX 10.8, Glen Wiley

-- end README