DragonFly On-Line Manual Pages

LDAP2DNS(1)            DragonFly General Commands Manual           LDAP2DNS(1)

NAME
       ldap2dns - 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]

DESCRIPTION
       ldap2dns 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
              daemon.

              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
       specified, the "data" file is written to the current directory.

       The following environment variables are documented above with the
       command-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 ALSO
       ldap.conf(5), ldapsearch(1), tinydns, named.conf(5).

       Please visit the project homepage for more detail:
       [http://projects.alkaloid.net/]

AUTHOR
       ldap2dns 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)