Browse files

Document the 'special queries'

  • Loading branch information...
abh committed Mar 6, 2012
1 parent e62858d commit 15c3d3514afbbcb902eed88f832e83978d68d5e2
Showing with 28 additions and 0 deletions.
  1. +28 −0
@@ -120,4 +120,32 @@ Set the default time-to-live for the zone in seconds.
Include another filename.
+## Special queries
+To ease monitoring pgeodns supports some special queries, all `txt` type.
+They work with both 'IN' (internet) and 'CH' (chaos) class queries; in the
+future we might only support CH.
+* status.pgeodns
+Returns a text status with the "id"
+* version.pgeodns
+For example:
+dig +short -t txt version.pgeodns
+", v1.41"
+For historical reasons the special queries work on both the 'pgeodns' top level
+domain and on any other configured base domain; combined with working with the
+internet class this has the side effect of making it easy to see which server
+is responding to your queries:
+$ dig +short -t txt -c in
+", upt: 8901928, q: 993862438, 111.65/qps"

0 comments on commit 15c3d35

Please sign in to comment.