Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Browse files

Document the 'special queries'

  • Loading branch information...
commit 15c3d3514afbbcb902eed88f832e83978d68d5e2 1 parent e62858d
@abh authored
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"
Please sign in to comment.
Something went wrong with that request. Please try again.