Download everything from the project homepage at SourceForge. SourceForge


TiniDynDns

===================================================
TiniDynDns: DynDNS.org client for the TINI platform
===================================================

Project Info:  http://tinidyndns.sourceforge.net/
Project Lead:  Stefan Diener (stefan.diener@comvipro.de)

(C) Copyright 2005-2006, by COMVIPRO and Contributors.

This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
details.

You should have received a copy of the GNU General Public License along with
this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA.

---------------
1. Introduction
---------------
TiniDynDns is a dynamic DNS client for the DynDNS.org service. It is designed
for use on the TINI platform (http://www.ibutton.com/tini/), but runs on all
platforms that provide a JAVA virtual machine.

TiniDynDns runs as daemon process and provides no GUI for user interaction.

1.1 Configuration File
----------------------
TiniDynDns is configured using a simple configuration file. The name of the
configuration file is "dyndns.cfg".

The configuration file is structured in the following way:
- All lines starting with '#' are comments.
- 1st non-comment line: your DynDNS.org host name [mandatory]
- 2nd non-comment line: user name for the DynDNS.org service [mandatory]
- 3rd non-comment line: password for the DynDNS.org service [mandatory]
- 4th non-comment line: use logging? [optional, default: false]
- 5th non-comment line: update delay in minutes [optional, default: 5]

See the included file "dyndns_sample.cfg" as example. You may copy the file to
"dyndns.cfg" and edit it according to your account settings.

1.2 Log File
------------
If logging is enabled, TiniDynDns will create a file named "messages.log" that
contains the log messages.

1.3 History File
----------------
TiniDynDns will create a file named "history.cfg" that stores the time of the
last IP address update on the DynDNS.org server. This is to prevent data loss
on power down. Please note that the application will perform an update on the
DynDNS.org server at least after 1 week (if nothing changes in the meantime).

1.4 Automatic Application Launch
--------------------------------

If you are using Slush on your TINI and want to automatically launch TiniDynDns
on system boot, you just need to add a single line to the file "/etc/.startup".
Transfer the file to your PC using a FTP software and add the following line
to the file:

java /TiniDynDns.tini

Note: It is assumed that you installed TiniDynDns into the root directory of
your TINI. The configuration file (see chapter 1.1) has to be stored in the
root directory too.

Transfer the edited file to your TINI (ASCII mode) and restart your TINI. The
TiniDynDns should be running after the system boot.

1.5 Legal Stuff
---------------
TiniDynDns is licensed under the terms of the GNU General Public Licence (GPL).
A copy of the licence is included in the download.

Please note that TiniDynDns is distributed WITHOUT ANY WARRANTY;
without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. Please refer to the license for details.

Special thanks go to Shawn Silverman. This project is based on his
"DynDNS.org Developer's Component". Please note that the original copyright
for the included source files from that project remains by Shawn Silverman.

-----------------
2. Latest Version
-----------------
The latest version of this software can be obtained from:

    http://tinidyndns.sourceforge.net/

If you have an comments, suggestions or bugs to report, please post a
message in the project forum.

-------------------
3. Ant Build Script
-------------------

An Ant build script (build.xml) is included in the distribution. This
is the same script that is used to create the TiniDynDns distribution.
You may download Ant from http://ant.apache.org/

Please note that you need an installed TINI development kit when trying to
create a binary file ready for TINI use. Version 1.17 (or higher) is
recommended. Please customize the path to the TINI development kit files
inside the Ant build script before running the "tini" target.

List of useful Ant targets:

compile
  Compile all production code classes not up to date (without debug
  information).

debug
  Like "compile" but with debug information.

docs
  Creates the HTML documentation for the complete production code.

jars
  Generates JARs for deployment.

tini
  Create file ready for TINI use.

clean
  Delete all class files, HTML documentation and distribution JARs.

-------------
4. What's New
-------------
A list of changes in recent versions:

1.0 : (12-Mar-2006)
    - initial version