Commit Diff
Diff:
85ec11a54ab1d9816506f1e04f06a837d57b8150
acc6cd3b07150e6336bf862acfee7553ad1140a9
Commit:
acc6cd3b07150e6336bf862acfee7553ad1140a9
Tree:
7d7b0d6bcec542f934ac403361553761ab52e6c9
Author:
pjp <pjp@delphinusdns.org>
Committer:
pjp <pjp@delphinusdns.org>
Date:
Sun Apr 13 14:11:07 2014 UTC
Message:
* give install examples * we want to work at standardizing around berkeley db5 this is the first step.
blob - 7a1e63057a549199d09e3c30a266f1a230d22f0d
blob + befc4bb2548d5d213d5c620bc13d9feb7ae9c4ba
--- README
+++ README
@@ -1,8 +1,13 @@
-$Id: README,v 1.25 2013/10/30 12:20:03 pjp Exp $
+$Id: README,v 1.26 2014/04/13 14:11:07 pjp Exp $
1. README
2. WHY WILDCARDNS?
3. INSTALL HINTS
+ 3.1 Linux
+ 3.2 FreeBSD
+ 3.3 OpenBSD
+ 3.4 NetBSD
+ 3.5 Mac OS X
4. COMPATIBILITY
5. EXAMPLES
6. WHAT IT CAN'T DO
@@ -37,55 +42,102 @@ can send patches to the author who may implement them
To install, type sh ./configure on BSD and just ./configure on Linux. This
will copy the proper Makefile to ./Makefile. Then you would type make,
followed by su'ing and make install. Wildcarddnsd installs to /usr/local/sbin.
-(In Linux make a user named "wdnsd" for the chroot to work, the pwd of wdnsd
-is where the chroot is set).
-Under OpenSuse 10.3 and Ubuntu I noticed the following files missing:
-cvs, gcc development and sleepycat's berkeley db (4.8) development. These
-had to be install prior to making wildcarddnsd. You basically know when you
-need to install these, when make barfs with db.h missing (or in extreme cases
-sys/param.h missing). In Mac OS X Mountain Lion I installed berkeley db 4.8
-through Mac Ports.
-
By default installation the configuration file is not installed you need to
do this manually. Also by default the config file is specified as
/etc/wildcarddns.conf this can be changed by adding the -f option to
wildcarddnsd.
-Also make sure the /var/db directory exists as wildcardnsd's berkeley database
-will be set in /var/db/wdns, this is a new option starting in BETA_7 which
-is slated for a 2012 release.
-
A sample config file exists with the sources. example7.conf was a real life
config once.
-As of September 15th, 2010 wildcarddnsd uses OpenSSL if you run it under Linux
-you may have to install openssl-dev packages.
+3.1 Linux
+---------
+## configure the platform
+$ ./configure
+## this will install the development programs you'll need (as root)
+$ apt-get install bison cvs gcc libdb5.3-dev libssl-dev
+## add a privsep user with a chroot directory (option -m) (as root)
+$ useradd -m wdnsd
+## create the db directory (as root)
+$ mkdir -p /var/db/wdns
+## make the program
+$ make
+## install the binary (as root)
+$ make install
+## done, create a config file and start wildcarddnsd
+
+3.2 FreeBSD
+-----------
+
+## configure the platform
+$ sh configure
+## this will install the development programs you'll need (as root)
+$ cd /usr/ports/databases/db5 && make install clean
+## add a privsep user with a chroot directory (as root)
+$ vipw
+## or
+$ adduser
+## create the db directory (as root)
+$ mkdir -p /var/db/wdns
+## make the program
+$ make
+## install the binary (as root)
+$ make install
+## done, create a config file and start wildcarddnsd
+
+3.3 OpenBSD
+-----------
+
+## configure the platform
+$ sh configure
+## this will install the development programs you'll need (as root)
+$ pkg_add db-4.6.21p0v0
+## add a privsep user with a chroot directory (as root)
+$ vipw
+## or
+$ adduser
+## create the db directory (as root)
+$ mkdir -p /var/db/wdns
+## make the program
+$ make
+## install the binary (as root)
+$ make install
+## done, create a config file and start wildcarddnsd
+
+3.4 NetBSD
+----------
+
+I don't have a NetBSD box handy at the moment. Once I have one I'll look
+at this process.
+
+3.5 Mac OS X
+------------
+
+In Mac OS X Mountain Lion I installed berkeley db 4.8 through Mac Ports.
+
+
4. COMPATIBILITY
----------------
-------------------+--------------------+---------------------+
-Operating System**| makes and compiles | responds to queries |
-------------------+--------------------+---------------------+
-FreeBSD 7.3 | yes | yes |
-------------------+--------------------+---------------------+
-FreeBSD 8.2 | yes | yes |
-------------------+--------------------+---------------------+
-NetBSD 5.1 | yes* | yes |
-------------------+--------------------+---------------------+
-OpenBSD 5.0 | yes | yes |
-------------------+--------------------+---------------------+
-Ubuntu 10.10 | yes | yes |
-------------------+--------------------+---------------------+
-Debian 6.0 | yes | yes |
-------------------+--------------------+---------------------+
-Mac OS X Mountain | yes | yes with |
- Lion | | debug mode |
-------------------+--------------------+---------------------+
-Rasbian OS | yes *** | yes |
-------------------+--------------------+---------------------+
+------------------+--------------------+---------------------+-------------+
+Operating System**| makes and compiles | responds to queries | Berkeley DB |
+------------------+--------------------+---------------------+-------------+
+FreeBSD 10 | yes | yes | version 5 |
+------------------+--------------------+---------------------+-------------+
+NetBSD 5.1 | yes* | yes | version 4.6 |
+------------------+--------------------+---------------------+-------------+
+OpenBSD 5.4 | yes | yes | version 4.6 |
+------------------+--------------------+---------------------+-------------+
+Linux | yes | yes | version 5 |
+------------------+--------------------+---------------------+-------------+
+Mac OS X Mountain | yes | yes with | version 4.6 |
+ Lion | | debug mode | |
+------------------+--------------------+---------------------+-------------+
+Rasbian OS | yes *** | yes | version 5 |
+------------------+--------------------+---------------------+-------------+
* there was a period in time that NetBSD didn't compile
** All Operating Systems require Berkeley DB 4.6 or higher.
repomaster@centroid.eu