diff --git a/doc/guide/bind10-guide.xml b/doc/guide/bind10-guide.xml index 0d1913f4e4..88c8483e1a 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 08a2fded59..00ff42ea22 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 f166683502..de7832dcfc 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 b5215f410a..426c478243 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 d8688f9f5a..78dde76fdb 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 5ac8783ff7..d7fe100d76 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 4d315ac168..871265ccbb 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 7935482020..5a80b7ac59 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 370fa046cc..72e46ac5df 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 53227db27e..eb8d869cd5 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 43c72a4061..8cef10c07a 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 ae73c3d327..afca976a0a 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 6c51debd2b..ad9a71e971 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 be91737d3a..4510110202 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 bbdb96e16d..83fdd36c22 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 0f3e99cea4..588048a494 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 0790f98e3b..2b201d0a1e 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 91cdfc25b8..1cb87ff0c7 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 ,