diff --git a/doc/guide/bind10-guide.xml b/doc/guide/bind10-guide.xml index 0d1913f4e44f6fec36ddcdbb53c4643de8867f8c..88c8483e1a21da4163c6b6a21e53c92a76502861 100644 --- a/doc/guide/bind10-guide.xml +++ b/doc/guide/bind10-guide.xml @@ -164,12 +164,12 @@ At first, running many different processes may seem confusing. - However, these processes are started, stopped, and maintained - by a single command, bind10. - This command starts a master process which will start other - required processes and other processes when configured. - The processes that may be started by the bind10 - command have names starting with "b10-", including: + However, these processes are started by running a single + command, bind10. This command starts + a master process, b10-init, which will + start other required processes and other processes when + configured. The processes that may be started have names + starting with "b10-", including: @@ -225,6 +225,7 @@ Recursive name server. This process handles incoming DNS queries and provides answers from its cache or by recursively doing remote lookups. + (This is an experimental proof of concept.) @@ -519,7 +520,7 @@ var/ executables that a user wouldn't normally run directly and are not run independently. These are the BIND 10 modules which are daemons started by - the bind10 tool. + the b10-init master process. @@ -826,16 +827,17 @@ as a dependency earlier --> Starting BIND 10 with <command>bind10</command> - BIND 10 provides the bind10 command which - starts up the required processes. - bind10 + BIND 10 is started with the bind10 command. + It runs the b10-init daemon which + starts up the required processes, and will also restart some processes that exit unexpectedly. - This is the only command needed to start the BIND 10 system. + bind10 is the only command needed to start + the BIND 10 system. After starting the b10-msgq communications channel, - bind10 connects to it, + b10-init connects to it, runs the configuration manager, and reads its own configuration. Then it starts the other modules. @@ -854,7 +856,7 @@ as a dependency earlier --> - In its default configuration, the bind10 + In its default configuration, the b10-init master process will also start up b10-cmdctl for administration tools to communicate with the system, and @@ -1003,7 +1005,7 @@ through bindctl and friends The configuration manager does not have any command line arguments. Normally it is not started manually, but is automatically - started using the bind10 master process + started using the b10-init master process (as covered in ). @@ -2077,7 +2079,7 @@ AND_MATCH := "ALL": [ RULE_RAW, RULE_RAW, ... ] This chapter explains how to control and configure the - bind10 parent. + b10-init parent. The startup of this resident process that runs the BIND 10 daemons is covered in . @@ -2086,7 +2088,7 @@ AND_MATCH := "ALL": [ RULE_RAW, RULE_RAW, ... ] Stopping bind10 The BIND 10 suite may be shut down by stopping the - parent bind10 process. This may be done + parent b10-init process. This may be done by running the Init shutdown command at the bindctl prompt. @@ -2097,7 +2099,7 @@ AND_MATCH := "ALL": [ RULE_RAW, RULE_RAW, ... ] The processes to be used can be configured for - bind10 to start, with the exception + b10-init to start, with the exception of the required b10-sockcreator, b10-msgq and b10-cfgmgr components. @@ -2154,7 +2156,7 @@ AND_MATCH := "ALL": [ RULE_RAW, RULE_RAW, ... ] dispensable (the default unless you set something else), it will get started again if it fails. If it is set to needed and it fails at startup, - the whole bind10 shuts down and exits + the whole b10-init shuts down and exits with an error exit code. But if it fails some time later, it is just started again. If you set it to core, you indicate that the system is not usable without the @@ -2243,7 +2245,7 @@ address, but the usual ones don't." mean? --> - The running processes started by bind10 + The running processes started by b10-init may be listed by running Init show_processes using bindctl. @@ -2258,7 +2260,7 @@ address, but the usual ones don't." mean? --> The b10-auth is the authoritative DNS server. It supports EDNS0, DNSSEC, IPv6, and SQLite3 and in-memory zone data backends. - Normally it is started by the bind10 master + Normally it is started by the b10-init master process. @@ -2675,7 +2677,7 @@ TODO Incoming zones are transferred using the b10-xfrin - process which is started by bind10. + process which is started by b10-init. When received, the zone is stored in the corresponding BIND 10 data source, and its records can be served by b10-auth. @@ -2770,7 +2772,7 @@ what if a NOTIFY is sent? The b10-zonemgr process is started by - bind10. + b10-init. It keeps track of SOA refresh, retry, and expire timers and other details for BIND 10 to perform as a slave. When the b10-auth authoritative DNS server @@ -2849,7 +2851,7 @@ http://bind10.isc.org/wiki/ScalableZoneLoadDesign#a7.2UpdatingaZone Outbound Zone Transfers The b10-xfrout process is started by - bind10. + b10-init. When the b10-auth authoritative DNS server receives an AXFR or IXFR request, b10-auth internally forwards the request to b10-xfrout, @@ -2915,7 +2917,7 @@ what is XfroutClient xfr_client?? BIND 10 supports the server side of the Dynamic DNS Update (DDNS) protocol as defined in RFC 2136. This service is provided by the b10-ddns - component, which is started by the bind10 + component, which is started by the b10-init process if configured so. @@ -3197,9 +3199,15 @@ what is XfroutClient xfr_client?? Recursive Name Server + + The b10-resolver is an experimental proof + of concept. + + - The b10-resolver process is started by - bind10. + The b10-resolver daemon provides an + iterative caching and forwarding DNS server. + The process is started by b10-init. diff --git a/src/bin/auth/b10-auth.xml b/src/bin/auth/b10-auth.xml index 08a2fded593875c0da353406691839af9a7e958f..00ff42ea22e1d210966f2274f87d428b395fc7ae 100644 --- a/src/bin/auth/b10-auth.xml +++ b/src/bin/auth/b10-auth.xml @@ -271,6 +271,9 @@ b10-ddns8 , + + b10-init8 + , b10-loadzone8 , diff --git a/src/bin/bind10/b10-init.xml b/src/bin/bind10/b10-init.xml index f166683502ca53097737a7df01d5e6472928b225..de7832dcfc76a50a905242b3e736f025f9d97a4f 100644 --- a/src/bin/bind10/b10-init.xml +++ b/src/bin/bind10/b10-init.xml @@ -457,6 +457,9 @@ xfrin SEE ALSO + + bind108 + , bindctl1 , @@ -484,6 +487,9 @@ xfrin b10-stats8 , + + b10-stats-httpd8 + , BIND 10 Guide. diff --git a/src/bin/bindctl/bindctl.xml b/src/bin/bindctl/bindctl.xml index b5215f410a43bc401efb74737e68426b81fade75..426c478243ee4239f09b45e2fbb7646a50e5fb6e 100644 --- a/src/bin/bindctl/bindctl.xml +++ b/src/bin/bindctl/bindctl.xml @@ -304,9 +304,6 @@ configuration location. SEE ALSO - - b10-auth8 - , b10-cfgmgr8 , @@ -314,7 +311,7 @@ configuration location. b10-cmdctl8 , - b10-xfrin8 + b10-init8 , bind108 diff --git a/src/bin/cfgmgr/b10-cfgmgr.xml b/src/bin/cfgmgr/b10-cfgmgr.xml index d8688f9f5a261c02783a20146c2c81d4ad033385..78dde76fdbaabbb30ffab2bda162d11c980438e5 100644 --- a/src/bin/cfgmgr/b10-cfgmgr.xml +++ b/src/bin/cfgmgr/b10-cfgmgr.xml @@ -65,7 +65,7 @@ The bindctl can be used to talk to this configuration manager via a b10-cmdctl connection. - + This daemon communicates over a b10-msgq C-Channel @@ -148,7 +148,13 @@ bind108 , - msgq8 + b10-cmdctl8 + . + + b10-init8 + , + + b10-msgq8 . diff --git a/src/bin/cmdctl/b10-certgen.xml b/src/bin/cmdctl/b10-certgen.xml index 5ac8783ff7b160fdb0871ccc471e4634703a0526..d7fe100d76c6e2e5492fbb018b15880a8ef30d7f 100644 --- a/src/bin/cmdctl/b10-certgen.xml +++ b/src/bin/cmdctl/b10-certgen.xml @@ -172,6 +172,9 @@ b10-cmdctl8 , + + bindctl1 + , BIND 10 Guide. diff --git a/src/bin/cmdctl/b10-cmdctl.xml b/src/bin/cmdctl/b10-cmdctl.xml index 4d315ac1680852f5d4d96fba0e4b280d04ec7f44..871265ccbb03484338091cad9d82689adfd02fe8 100644 --- a/src/bin/cmdctl/b10-cmdctl.xml +++ b/src/bin/cmdctl/b10-cmdctl.xml @@ -208,6 +208,9 @@ b10-cfgmgr8 , + + b10-init8 + , bind108 , diff --git a/src/bin/ddns/b10-ddns.xml b/src/bin/ddns/b10-ddns.xml index 7935482020841ba5e4382298bf4bb5aed908bfe1..5a80b7ac594cd5fbc6aa6a0169c8da0784677abe 100644 --- a/src/bin/ddns/b10-ddns.xml +++ b/src/bin/ddns/b10-ddns.xml @@ -170,6 +170,9 @@ b10-cfgmgr8 , + + b10-init8 + , b10-msgq8 , diff --git a/src/bin/dhcp4/b10-dhcp4.xml b/src/bin/dhcp4/b10-dhcp4.xml index 370fa046cc168ab74e88908097090efd2ba79c76..72e46ac5dfad5ea57dceb2bbf24e003267b4cd40 100644 --- a/src/bin/dhcp4/b10-dhcp4.xml +++ b/src/bin/dhcp4/b10-dhcp4.xml @@ -78,6 +78,9 @@ SEE ALSO + + b10-init8 + , bind108 . diff --git a/src/bin/dhcp6/b10-dhcp6.xml b/src/bin/dhcp6/b10-dhcp6.xml index 53227db27e8e9f8d3275590572254bdb87ba1a19..eb8d869cd5a268279b2d63cfc68456998215852a 100644 --- a/src/bin/dhcp6/b10-dhcp6.xml +++ b/src/bin/dhcp6/b10-dhcp6.xml @@ -78,6 +78,9 @@ SEE ALSO + + b10-init8 + , bind108 . diff --git a/src/bin/msgq/msgq.xml b/src/bin/msgq/msgq.xml index 43c72a4061152c245a2bdcfecfbb1b1b61974880..8cef10c07a0319f64304c565c60279ec097af98b 100644 --- a/src/bin/msgq/msgq.xml +++ b/src/bin/msgq/msgq.xml @@ -69,7 +69,7 @@ getlname - — receive local name. + — receive local name. @@ -133,6 +133,9 @@ SEE ALSO + + b10-init8 + , bind108 , diff --git a/src/bin/resolver/b10-resolver.xml b/src/bin/resolver/b10-resolver.xml index ae73c3d32705497853b4e7a398e9518819681cf3..afca976a0ae8ab73cb2860e253127b9ff85e4e63 100644 --- a/src/bin/resolver/b10-resolver.xml +++ b/src/bin/resolver/b10-resolver.xml @@ -56,6 +56,11 @@ process. + + The b10-resolver is an experimental proof + of concept. + + This daemon communicates with other BIND 10 components over a b10-msgq8 @@ -227,7 +232,7 @@ once that is merged you can for instance do 'config add Resolver/forward_address b10-cfgmgr8 , - b10-cmdctl8 + b10-init8 , b10-msgq8 diff --git a/src/bin/sockcreator/b10-sockcreator.xml b/src/bin/sockcreator/b10-sockcreator.xml index 6c51debd2b4e160c55560a58d1afa1e9c7dae9f3..ad9a71e9716f5716d569d2a52c1d6df4bbd2d852 100644 --- a/src/bin/sockcreator/b10-sockcreator.xml +++ b/src/bin/sockcreator/b10-sockcreator.xml @@ -53,7 +53,7 @@ The b10-sockcreator daemon's entire job is to create sockets and assign names to them. It is started by - bind108 + b10-init8 and communicates with it. The new socket is sent over a file descriptor. @@ -70,6 +70,9 @@ SEE ALSO + + b10-init8 + , bind108 , diff --git a/src/bin/stats/b10-stats-httpd.xml b/src/bin/stats/b10-stats-httpd.xml index be91737d3aca72236d26e7ec6226f000eca62387..451011020262cf226d74c77026c3ceae674030b3 100644 --- a/src/bin/stats/b10-stats-httpd.xml +++ b/src/bin/stats/b10-stats-httpd.xml @@ -151,7 +151,7 @@ is http://127.0.0.1:8000/bind10/statistics/xml. And also IPv6 addresses can be configured and they works in the runtime environment for dual stack. You can change the settings - through bindctl8. + through bindctl1. @@ -188,13 +188,16 @@ SEE ALSO - b10-stats8 + b10-cfgmgr8 + , + + b10-init8 , b10-msgq8 , - b10-cfgmgr8 + b10-stats8 , bind108 diff --git a/src/bin/stats/b10-stats.xml b/src/bin/stats/b10-stats.xml index bbdb96e16dca8c9cd0f5e258800a5d3eb64ce320..83fdd36c2271afaf7da13e910acf61f34fc20e19 100644 --- a/src/bin/stats/b10-stats.xml +++ b/src/bin/stats/b10-stats.xml @@ -222,6 +222,9 @@ SEE ALSO + + b10-init8 + , b10-stats-httpd8 , @@ -231,9 +234,6 @@ bindctl1 , - - b10-auth8 - , BIND 10 Guide. diff --git a/src/bin/xfrin/b10-xfrin.xml b/src/bin/xfrin/b10-xfrin.xml index 0f3e99cea4f597a344162c36e499bda575298213..588048a494692f3ce177254bdb793264d0d9937f 100644 --- a/src/bin/xfrin/b10-xfrin.xml +++ b/src/bin/xfrin/b10-xfrin.xml @@ -245,6 +245,9 @@ operation b10-cfgmgr8 , + + b10-init8 + , b10-msgq8 , diff --git a/src/bin/xfrout/b10-xfrout.xml b/src/bin/xfrout/b10-xfrout.xml index 0790f98e3b67d9b011b1665b33a50bf3eef9a921..2b201d0a1eb34f7c03160fc0bd27cd05cb5791e6 100644 --- a/src/bin/xfrout/b10-xfrout.xml +++ b/src/bin/xfrout/b10-xfrout.xml @@ -250,6 +250,9 @@ b10-cfgmgr8 , + + b10-init8 + , b10-msgq8 , diff --git a/src/bin/zonemgr/b10-zonemgr.xml b/src/bin/zonemgr/b10-zonemgr.xml index 91cdfc25b804417c0001b1598171982c9c0694c1..1cb87ff0c771b6916c53a0be4b6764171d598959 100644 --- a/src/bin/zonemgr/b10-zonemgr.xml +++ b/src/bin/zonemgr/b10-zonemgr.xml @@ -242,6 +242,9 @@ b10-cfgmgr8 , + + b10-init8 + , b10-msgq8 ,