From c97e785a98b7d1f82016a6449e7385e324f81eed Mon Sep 17 00:00:00 2001 From: Peter van Dijk Date: Fri, 6 Apr 2012 10:29:04 +0000 Subject: [PATCH] doc updates, mostly for backend writers git-svn-id: svn://svn.powerdns.com/pdns/trunk/pdns@2557 d19b8d6e-7fed-0310-83ef-9ca221ded41b --- pdns/docs/pdns.xml | 32 ++++++++++++++++++-------------- 1 file changed, 18 insertions(+), 14 deletions(-) diff --git a/pdns/docs/pdns.xml b/pdns/docs/pdns.xml index 61e320dfd..71de90f19 100644 --- a/pdns/docs/pdns.xml +++ b/pdns/docs/pdns.xml @@ -10221,7 +10221,7 @@ local0.err /var/log/pdns.err Another very important setting cache-ttl. PDNS caches entire packets it sends out so as to save the - time to query backends to assemble all data. The default setting of 10 seconds may be low for high traffic sites, a value of + time to query backends to assemble all data. The default setting of 20 seconds may be low for high traffic sites, a value of 60 seconds rarely leads to problems. @@ -13437,7 +13437,7 @@ To enable a Lua script for a particular slave zone, determine the domain_id for slave-cycle-interval=60 - Schedule slave up-to-date checks of domains whose status is unknown every .. seconds. See . + Schedule slave up-to-date checks of domains whose status is unknown every .. seconds. smtpredirector=... @@ -17333,10 +17333,10 @@ VALUES (:zoneid, :ip) { public: - virtual bool lookup(const QType &qtype, const string &qdomain, DNSPacket *pkt_p=0, int zoneId=-1)=0; - virtual bool list(int domain_id)=0; + virtual void lookup(const QType &qtype, const string &qdomain, DNSPacket *pkt_p=0, int zoneId=-1)=0; + virtual bool list(const string &target, int domain_id)=0; virtual bool get(DNSResourceRecord &r)=0; - virtual bool getSOA(const string &name, SOAData &soadata); + virtual bool getSOA(const string &name, SOAData &soadata, DNSPacket *p=0); }; @@ -17406,7 +17406,8 @@ VALUES (:zoneid, :ip) class RandomBackend : public DNSBackend { public: - bool list(int id) { + bool list(const string &target, int id) + { return false; // we don't support AXFR } @@ -17506,10 +17507,10 @@ static RandomLoader randomloader; string contentASCII representation of right hand side - u_int16_t prioritypriority of an MX record. + uint16_t prioritypriority of an MX record. - u_int32_t ttlTime To Live of this record + uint32_t ttlTime To Live of this record int domain_idID of the domain this record belongs to @@ -17517,6 +17518,9 @@ static RandomLoader randomloader; time_t last_modifiedIf unzero, last time_t this record was changed + + bool authUsed for DNSSEC operations. See and more specifically . It is also useful to check out the rectifyZone() in pdnssec.cc + @@ -17591,7 +17595,7 @@ static RandomLoader randomloader; that the backend considers itself broken - not that no answers are available for a question. - It is legal to return here, and have the first call to get() return false. This is interpreted as 'no data' + It is legal to return here, and have the first call to get() return false. This is interpreted as 'no data'. @@ -17823,16 +17827,16 @@ static RandomLoader randomloader; - int idID of this zone within this backend + uint32_t idID of this zone within this backend string masterIP address of the master of this domain, if any - u_int32_t serialSerial number of this zone + uint32_t serialSerial number of this zone - u_int32_t notified_serialLast serial number of this zone that slaves have seen + uint32_t notified_serialLast serial number of this zone that slaves have seen time_t last_checkLast time this zone was checked over at the master for changes @@ -17993,7 +17997,7 @@ static RandomLoader randomloader; public: /* ... */ virtual void getUpdatedMasters(vector<DomainInfo>* domains); - virtual void setNotified(int id, u_int32_t serial); + virtual void setNotified(uint32_t id, uint32_t serial); /* ... */ } @@ -18014,7 +18018,7 @@ static RandomLoader randomloader; - bool setNotified(int domain_id, u_int32_t serial) + bool setNotified(uint32_t domain_id, uint32_t serial) Indicate that notifications have been queued for this domain and that it need not be considered 'updated' anymore -- 2.40.0