[packages] ddns-scripts: Introduce retry_interval option to periodically retry DDNS...
[packages.git] / net / ddns-scripts / files / etc / config / ddns
1 #################################################################
2 # In order to enable dynamic dns you need at least one section,
3 # and in that seciton the "enabled" option must be set to one
4
5 # Each section represents an update to a different service
6 #
7 # You specify your domain name, your username and your password
8 # with the optins "domain", "username" and "password" respectively
9 #
10 # Next you need to specify the name of the service you are 
11 # connecting to "eg. dyndns.org".  The format of the update
12 # urls for several different dynamic dns services is specified
13 # in the /usr/lib/ddns/services file.  This list is hardly complete
14 # as there are many, many different dynamic dns services.  If your
15 # service is on the list you can merely specify it with the 
16 # "service_name" option.  Otherwise you will need to determine
17 # the format of the url to update with.  You can either add an
18 # entry to the /usr/lib/ddns/services file or specify this with
19 # the "update_url" option.
20 #
21 # We also need to specify the source of the ip address to associate with
22 # your domain.  The "ip_source" option can be "network", "interface"
23 # or "web", with "network" as the default.  
24 #
25 # If "ip_source" is "network" you specify a network section in your 
26 # /etc/network config file (e.g. "wan", which is the default) with
27 # the "ip_network" option.  If you specify "wan", you will update
28 # with whatever the ip for your wan is.
29
30 # If "ip_source" is "interface" you specify a hardware interface 
31 # (e.g. "eth1") and whatever the current ip of this interface is
32 # will be associated with the domain when an update is performed.
33 #
34 # If "ip_source" is "script" you specify a script to obtain ip address.
35 # The "ip_script" option should contain path to your script.
36 #
37 # The last possibility is that "ip_source" is "web", which means
38 # that in order to obtain our ip address we will connect to a 
39 # website, and the first valid ip address listed on that page
40 # will be assumed to be ours.  If you are behind another firewall
41 # this is the best option since none of the local networks or 
42 # interfaces will have the external ip.  The website to connect
43 # to is specified by the "ip_url" option.  You may specify multiple
44 # urls in the option, separated by whitespace.
45 #
46 # Finally we need to specify how often to check whether we need
47 # to check whether the ip address has changed (and if so update
48 # it) and how often we need to force an update ( many services
49 # will expire your domain if you don't connect and do an update
50 # every so often).  Use the "check_interval" to specify how
51 # often to check whether an update is necessary, the "retry_interval"
52 # to specify how often to retry in case the update has failed, and
53 # the "force_interval" option to specify how often to force an
54 # update.  Specify the units for these values with the "check_unit",
55 # the "retry_init" and the "force_unit" options.  Units can be
56 # "days", "hours", "minutes" or "seconds".  The default force_unit
57 # is hours, the default retry_unit is seconds and the default
58 # check_unit is seconds.  The default check_interval is 600 seconds,
59 # or ten minutes.  The default retry_interval is 60 seconds, or one
60 # minute. The default force_interval is 72 hours or 3 days.
61 #
62 #
63 #########################################################
64
65 config service "myddns"
66         option enabled          "0"
67         option interface        "wan"
68
69         option service_name     "dyndns.org"
70         option domain           "mypersonaldomain.dyndns.org"
71         option username         "myusername"
72         option password         "mypassword"
73
74         option ip_source        "network" 
75         option ip_network       "wan"
76         
77
78         option force_interval   "72"
79         option force_unit       "hours"
80         option check_interval   "10"
81         option check_unit       "minutes"
82         option retry_interval   "60"
83         option retry_unit       "seconds"
84
85         #option ip_source       "interface"
86         #option ip_interface    "eth0.1"
87
88         #option ip_source       "script"
89         #option ip_script       "path to your scrip"
90
91         #option ip_source       "web"
92         #option ip_url          "http://www.whatismyip.com/automation/n09230945.asp"
93
94         #option update_url      "http://[USERNAME]:[PASSWORD]@members.dyndns.org/nic/update?hostname=[DOMAIN]&myip=[IP]"
95
96