B.3 DYNDNS

B.3.1 Adding Of New Providers

Adding new providers is easy because update-scripts are separated from provider data completely. For a new provider adapt the following files:

B.3.1.1 opt/etc/dyndns/provider.NAME

This file defines how an update is working with this provider. It mostly consists only of a list of variables but is a normal shell script that even allows complex operations to be done. This should not be necessary in most cases. These variables can be used in the file:

$ip: The IP of the interface that should get the dynamic hostname.
$host: The complete hostname the user specified in his configuration.
$subdom: All components of the hostname ending with the dot next to last (name.provider.dom)
$domain: the both last components of the hostname (name.provider.dom)
$provider: The symbolic name of the provider the user specified in his configuration file.
$user: The username for this service.
$pass: The password.

These variables can be put in curly brackets to be cleary distinguishable from normal text, $ip i.e. becomes ${ip}. If using quotation marks it should be noted that within single quotes the variables mentioned above are not expanded while this works with double quotes. As a rule of thumb: Always use single quotes but when using variables double quotes are needed.

The following variables must be defined in this file in order to get an update working with the provider:

provider_update_type

This determines the type of query sent to the provider's server. These types are supported at the moment:

http: A predefined website of the provider will be loaded to update the DynDNS-entry.
netcat: A predefined text will be sent to the provider's server triggering an update.
gnudip: An update process relatively easy and secure done by two HTTP-queries.

provider_host

The provider's hostname that is to be contacted during an update.

provider_port

The port to be contacted on the provider's host. Standard-port for HTTP is 80.

Depending on the update type further variables have to be specified:

HTTP

provider_url: The relative URL (without the hostname, but with an / at the beginning) for the provider script. For examples please have a look at the files for other providers.
provider_auth: (optional) If the provider needs a login via basic authentication provide the information needed here. The format is "USER:PASSWORD".

Netcat

provider_data: The text to be sent to the provider's server. See provider.DYNEISFAIR as an example.

GNUDip

provider_script: The path tot he GNUDip-script on the server, mostly something like '/cgi-bin/gdipupdt.cgi'.

B.3.1.2 opt/dyndns.txt

One or more lines for the new provider have to be inserted here. Usually a line like that is enough:

	dyndns_%_provider   NAME   etc/dyndns/provider.NAME

If HTTP and Basic Authentication are used by the provider you will need the base64 executable:

	dyndns_%_provider   NAME   files/usr/local/bin/base64

If other tools are needed sent an email so we can validate if this is suitable for OPT_DYNDNS.

B.3.1.3 check/dyndns.exp

In this file the provider name has to be added at the end of the long line starting with DYNPROVIDER = , seperated by a '|'.

B.3.1.4 doc/<Language>/tex/dyndns/dyndns_main.tex

Add a new paragraph to the documentation. The providers have to be sorted alphabetically by the short name given by the user in the config file. The prov-macro is documented at the beginning of the file, enough examples should be present.

B.3.2 Note Of Thanks

At first I wish to thank Thomas Müller (email: opt_dyndns@s2h.cx) who originally developed this package and maintained it for a long time. He has done exceptional work here, without him this packages would not have been possible.

I would like to thank as well Marcel Döring (email: m@rcel.to), who maintained the package for quite some time.

A lot of people have been helping and providing ideas at the development of the package. Many thanks also to all those hard-working people.

Further thanks got to all the people contributing to the package by providing tips, new providers, bug reports and so on:

Last but not least my thanks go to Frank Meyer and the rest of the fli4l team for their tireless work to tinker with the best router in the world (;-) Please do not take this too serious).

B.3.3 Licence

This program is free software. It is distributed under the terms of the GNU General Public License as provided by the Free Software Foundation. For further informations on the licence please refer to http://www.gnu.org/licenses/gpl.txt.