query_module: added basic documentation and configuration reference

not sure where to put configuration string doc for each module

Knot.files

@@ -104,6 +104,8 @@ src/knot/dnssec/zone-sign.c
 src/knot/dnssec/zone-sign.h
 src/knot/knot.h
 src/knot/main.c
+src/knot/modules/synth_record.c
+src/knot/modules/synth_record.h
 src/knot/nameserver/axfr.c
 src/knot/nameserver/axfr.h
 src/knot/nameserver/chaos.c
@@ -116,8 +118,8 @@ src/knot/nameserver/nsec_proofs.c
 src/knot/nameserver/nsec_proofs.h
 src/knot/nameserver/process_query.c
 src/knot/nameserver/process_query.h
-src/knot/nameserver/synth_record.c
-src/knot/nameserver/synth_record.h
+src/knot/nameserver/query_module.c
+src/knot/nameserver/query_module.h
 src/knot/nameserver/update.c
 src/knot/nameserver/update.h
 src/knot/other/debug.h
@@ -279,6 +281,7 @@ tests/hhash.c
 tests/journal.c
 tests/pkt.c
 tests/process_query.c
+tests/query_module.c
 tests/rrl.c
 tests/rrset.c
 tests/sample_conf.h

doc/reference.texi

@@ -703,6 +703,7 @@ The @code{zones} statement contains definition of zones served by Knot DNS.
     [ @code{notify-in} @kbd{remote_id} [, @kbd{remote_id}, @dots{} ]@code{;} ]
     [ @code{notify-out} @kbd{remote_id} [, @kbd{remote_id}, @dots{} ]@code{;} ]
     [ @code{update-in} @kbd{remote_id} [, @kbd{remote_id}, @dots{} ]@code{;} ]
+    [ @code{query_module} @code{@{} @kbd{module_name} @code{"}@kbd{string}@code{"} [, @kbd{module_name} @code{"}@kbd{string}@code{"}, @dots{} ] @code{@}} ]
     [ @kbd{zone_options} ]
   @code{@}}
 @code{@}}

man/knot.conf.5.in

@@ -369,6 +369,13 @@ serves as an example of the configuration for knotc(8) and knotd(8).
 
     # List of servers to allow UPDATE queries
     update-in server0, admins;
+
+	# Query modules are dynamically loaded modules that can alter query plan
+	# Configuration is always module-specific, but passed as a simple string
+	query_module {
+		module_one "configuration string",
+		module_two "specific configuration string"
+	}
   }
  }
 

samples/knot.full.conf

@@ -365,6 +365,13 @@ zones {
 
     # List of servers to allow UPDATE queries
     update-in server0, admins;
+
+	# Query modules are dynamically loaded modules that can alter query plan processing
+	# Configuration is always module-specific, but passed as a simple string here 
+	query_module {
+		module_one "configuration string",
+		module_two "specific configuration string"
+	}
   }
 }