LDAP2DNS(1)LDAP2DNS(1)NAMEldap2dns - LDAP based DNS management system
SYNOPSIS
ldap2dns[d] [-o data|db] [-h host] [-p port] [-H hostURI] [-D binddn]
[-w password] [-L[filename]] [-u numsecs] [-b searchbase] [-v[v]]] [-V]
[-t timeout] [-M maxrecords]
DESCRIPTIONldap2dns is a program to read DNS records from an LDAP directory and
format them into flat files suitable for serving from TinyDNS or BIND.
ldap2dns is designed to write ASCII data files used by tinydns from the
djbdns package, but also may be used to write zone db files used by
named as found BIND in the package.
OPTIONS
A summary of each command line option is shown below along with its
environment variable equivalent. Each option may be set in either
location, with the command line taking precedence over the environment
variables.
-o [data|db] ($LDAP2DNS_OUTPUT)
Generate a "data" file to be processed by tinydns-data or a set
of zone "db"s (one per zone) to be used by named
-h host ($LDAP2DNS_HOST)
Hostname of LDAP server, defaults to localhost.
-p port ($LDAP2DNS_PORT)
Port number on which to connect to LDAP server, defaults to 389
-H hostURI ($LDAP2DNS_URI)
URI for the LDAP server. Examples:
ldap://localhost:389
ldaps://host.example.com:636
-D binddn ($LDAP2DNS_BINDDN)
Use the distinguished name binddn to bind to the LDAP directory.
-w bindpasswd ($LDAP2DNS_PASSWORD)
Use bindpasswd as the password for simple authentication.
-b searchbase ($LDAP2DNS_BASEDN)
Use searchbase as the starting point for the search instead of
the default.
-L[filename] (Command-line only)
Print output in LDIF format for reimport. If filename is not
specified default to STDOUT.
-u numsecs ($LDAP2DNS_UPDATE)
Update DNS data after numsecs. Defaults to 59 if started as dae‐
mon.
NOTE: Zone data is only updated when the zone serial number
increments.
-v[v] ($LDAP2DNS_VERBOSE)
Set verbose level. On the command line, increase verbosity by
adding 'v's. When setting via the environment, specify the
level directly. Maximum meaningful value is 2 (-vv).
-t timeout ($LDAP2DNS_TIMEOUT)
LDAP search timeout (in seconds).
-M maxrecords ($LDAP2DNS_MAXRECORDS)
Limit LDAP search results to maxrecords number of records.
-V (Command-line only)
Print version number and exit.
-e exec-cmd ($LDAP2DNS_EXEC)
This command is executed after ldap2dns successfully regenerates
its zone data files. Typically called to either notify named to
reread the configuration or run tinydns-data to update data.cdb.
ENVIRONMENT
LDAP2DNS_TINYDNSDIR The root-directory used by tinydns, ie. the one in
which to tinydns expects its 'data'-file. If this option is not speci‐
fied, the "data" file is written to the current directory.
The following environment variables are documented above with the com‐
mand-line options. They are listed here for convenience.
LDAP2DNS_OUTPUT
LDAP2DNS_HOST
LDAP2DNS_PORT
LDAP2DNS_URI
LDAP2DNS_BINDDN
LDAP2DNS_PASSWORD
LDAP2DNS_BASEDN
LDAP2DNS_UPDATE
LDAP2DNS_VERBOSE
LDAP2DNS_TIMEOUT
LDAP2DNS_MAXRECORDS
LDAP2DNS_EXEC
FILES
/usr/local/etc/openldap/ldap.conf
will read the options HOST, PORT, URI, BINDDN, and BINDPW from
ldap.conf. Their purpose and definition is the same as documented
above and in the OpenLDAP package.
SEE ALSOldap.conf(5), ldapsearch(1), tinydns, named.conf(5).
Please visit the project homepage for more detail:
[http://projects.alkaloid.net/]
AUTHORldap2dns is has been maintained since version 0.3.5 by Ben Klang
<ben@alkaloid.net>. It is released under the terms of the GPL version
2.
Jacob Rief <jacob.rief@tiscover.com> is the original author of this
program.
December 24, 2006 LDAP2DNS(1)
