Index: src/OFDNSResolver.h ================================================================== --- src/OFDNSResolver.h +++ src/OFDNSResolver.h @@ -142,58 +142,94 @@ /** * @brief A dictionary of static hosts. * * This dictionary is checked before actually looking up a host. + * + * @warning If you change this, you need to set @ref configReloadInterval to 0 + * to disable reloading the config after some time. If you don't, the + * config will be reloaded and your change overridden. */ @property (copy, nonatomic) OFDictionary OF_GENERIC(OFString *, OFArray OF_GENERIC(OFString *) *) *staticHosts; /** * @brief An array of name servers to use. * * The name servers are tried in order. + * + * @warning If you change this, you need to set @ref configReloadInterval to 0 + * to disable reloading the config after some time. If you don't, the + * config will be reloaded and your change overridden. */ @property (copy, nonatomic) OFArray OF_GENERIC(OFString *) *nameServers; /** * @brief The local domain. + * + * @warning If you change this, you need to set @ref configReloadInterval to 0 + * to disable reloading the config after some time. If you don't, the + * config will be reloaded and your change overridden. */ @property OF_NULLABLE_PROPERTY (readonly, nonatomic) OFString *localDomain; /** * @brief The domains to search for queries for short names. + * + * @warning If you change this, you need to set @ref configReloadInterval to 0 + * to disable reloading the config after some time. If you don't, the + * config will be reloaded and your change overridden. */ @property (copy, nonatomic) OFArray OF_GENERIC(OFString *) *searchDomains; /** * @brief The timeout, in seconds, after which the next name server should be * tried. + * + * @warning If you change this, you need to set @ref configReloadInterval to 0 + * to disable reloading the config after some time. If you don't, the + * config will be reloaded and your change overridden. */ @property (nonatomic) OFTimeInterval timeout; /** * @brief The number of attempts before giving up to resolve a host. * * Trying all name servers once is considered a single attempt. + * + * @warning If you change this, you need to set @ref configReloadInterval to 0 + * to disable reloading the config after some time. If you don't, the + * config will be reloaded and your change overridden. */ @property (nonatomic) unsigned int maxAttempts; /** * @brief The minimum number of dots for a name to be considered absolute. + * + * @warning If you change this, you need to set @ref configReloadInterval to 0 + * to disable reloading the config after some time. If you don't, the + * config will be reloaded and your change overridden. */ @property (nonatomic) unsigned int minNumberOfDotsInAbsoluteName; /** * @brief Whether the resolver forces TCP to talk to a name server. + * + * @warning If you change this, you need to set @ref configReloadInterval to 0 + * to disable reloading the config after some time. If you don't, the + * config will be reloaded and your change overridden. */ @property (nonatomic) bool forcesTCP; /** * @brief The interval in seconds in which the config should be reloaded. * * Setting this to 0 disables config reloading. + * + * @warning If you change this to anything other than 0, the config will be + * reloaded eventually, which in turn can override the config + * reloading interval itself again. */ @property (nonatomic) OFTimeInterval configReloadInterval; /** * @brief Creates a new, autoreleased OFDNSResolver.