2 ###############################################################################
4 # ddns - A dynamic DNS client for IPFire #
5 # Copyright (C) 2012 IPFire development team #
7 # This program is free software: you can redistribute it and/or modify #
8 # it under the terms of the GNU General Public License as published by #
9 # the Free Software Foundation, either version 3 of the License, or #
10 # (at your option) any later version. #
12 # This program is distributed in the hope that it will be useful, #
13 # but WITHOUT ANY WARRANTY; without even the implied warranty of #
14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the #
15 # GNU General Public License for more details. #
17 # You should have received a copy of the GNU General Public License #
18 # along with this program. If not, see <http://www.gnu.org/licenses/>. #
20 ###############################################################################
23 import logging
.handlers
28 logger
= logging
.getLogger("ddns.core")
31 from .providers
import *
32 from .system
import DDNSSystem
36 rootlogger
= logging
.getLogger("ddns")
37 rootlogger
.setLevel(logging
.INFO
)
39 # Setup a logger that logs to syslog.
40 handler
= logging
.handlers
.SysLogHandler(address
="/dev/log",
41 facility
=logging
.handlers
.SysLogHandler
.LOG_DAEMON
43 handler
.setLevel(logging
.INFO
)
44 rootlogger
.addHandler(handler
)
46 handler
= logging
.StreamHandler()
47 rootlogger
.addHandler(handler
)
51 class DDNSCore(object):
52 def __init__(self
, debug
=False):
53 # In debug mode, enable debug logging.
55 logger
.setLevel(logging
.DEBUG
)
56 logger
.debug(_("Debugging mode enabled"))
58 # Initialize the settings array.
61 # Dict with all providers, that are supported.
63 self
.register_all_providers()
65 # List of configuration entries.
68 # Add the system class.
69 self
.system
= DDNSSystem(self
)
71 def register_provider(self
, provider
):
73 Registers a new provider.
75 assert issubclass(provider
, DDNSProvider
)
77 provider_handle
= provider
.INFO
.get("handle")
78 assert provider_handle
80 assert not self
.providers
.has_key(provider_handle
), \
81 "Provider '%s' has already been registered" % provider_handle
83 provider_name
= provider
.INFO
.get("name")
86 logger
.debug("Registered new provider: %s (%s)" % (provider_name
, provider_handle
))
87 self
.providers
[provider_handle
] = provider
89 def register_all_providers(self
):
91 Simply registers all providers.
98 DDNSProviderFreeDNSAfraidOrg
,
100 DDNSProviderLightningWireLabs
,
103 DDNSProviderSelfhost
,
105 DDNSProviderVariomedia
,
107 self
.register_provider(provider
)
109 def get_provider_names(self
):
111 Returns a list of names of all registered providers.
113 return sorted(self
.providers
.keys())
115 def load_configuration(self
, filename
):
116 logger
.debug(_("Loading configuration file %s") % filename
)
118 configs
= ConfigParser
.SafeConfigParser()
119 configs
.read([filename
,])
121 # First apply all global configuration settings.
122 for k
, v
in configs
.items("config"):
125 for entry
in configs
.sections():
126 # Skip the special config section.
127 if entry
== "config":
131 for k
, v
in configs
.items(entry
):
133 settings
["hostname"] = entry
135 # Get the name of the provider.
136 provider
= settings
.get("provider", None)
138 logger
.warning("Entry '%s' lacks a provider setting. Skipping." % entry
)
141 # Try to find the provider with the wanted name.
143 provider
= self
.providers
[provider
]
145 logger
.warning("Could not find provider '%s' for entry '%s'." % (provider
, entry
))
148 # Create an instance of the provider object with settings from the
149 # configuration file.
150 entry
= provider(self
, **settings
)
152 # Add new entry to list (if not already exists).
153 if not entry
in self
.entries
:
154 self
.entries
.append(entry
)
156 def updateone(self
, hostname
, **kwargs
):
157 for entry
in self
.entries
:
158 if not entry
.hostname
== hostname
:
161 return self
._update
(entry
, **kwargs
)
163 raise DDNSHostNotFoundError(hostname
)
165 def updateall(self
, **kwargs
):
167 Update all configured entries.
169 # If there are no entries, there is nothing to do.
171 logger
.debug(_("Found no entries in the configuration file. Exiting."))
174 for entry
in self
.entries
:
175 self
._update
(entry
, **kwargs
)
177 def _update(self
, entry
, force
=False):
181 except DDNSUpdateError
, e
:
182 logger
.error(_("Dynamic DNS update for %(hostname)s (%(provider)s) failed:") % \
183 { "hostname" : entry
.hostname
, "provider" : entry
.name
})
184 logger
.error(" %s" % e
)
187 logger
.error(_("Dynamic DNS update for %(hostname)s (%(provider)s) throwed an unhandled exception:") % \
188 { "hostname" : entry
.hostname
, "provider" : entry
.name
})
189 logger
.error(" %s" % e
)
192 logger
.info(_("Dynamic DNS update for %(hostname)s (%(provider)s) successful") % \
193 { "hostname" : entry
.hostname
, "provider" : entry
.name
})