From: Marcin Siodelski Date: Mon, 18 May 2015 14:12:26 +0000 (+0200) Subject: [3807] Updated Kea Guide with new loggers for DHCPv6. X-Git-Tag: trac3732a_base~19^2~4 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=8d99b049813b4a7d29ca8b65a829c3d3bc981879;p=thirdparty%2Fkea.git [3807] Updated Kea Guide with new loggers for DHCPv6. --- diff --git a/doc/guide/logging.xml b/doc/guide/logging.xml index bf6a0b9ccc..793c48033a 100644 --- a/doc/guide/logging.xml +++ b/doc/guide/logging.xml @@ -120,7 +120,7 @@ with the root logger kea-dhcp4 logging at the INFO level. In order to enable DEBUG verbosity for the DHCPv4 packet drops, you must create configuration entry for the - logger called kea-dhcp4.bad_packet and specify + logger called kea-dhcp4.bad-packets and specify severity DEBUG for this logger. All other configuration parameters may be omited for this logger if the logger should use the default values specified in the root logger's @@ -161,30 +161,12 @@ provided. - kea-dhcp4.bad_packet - this is the + kea-dhcp4.bad-packets - this is the logger used by the DHCPv4 server deamon for logging inbound client packets that were dropped or to which the server responded with a DHCPNAK. The allows adminstrators to configure a separate log output that contains only packet drop and reject entries. - - kea-dhcp4.dhcp4 - this is the logger - used solely by the DHCPv4 server deamon. This logger does not - specify logging settings for libraries used by the deamon. - - - kea-dhcp4.dhcpsrv - this logger is used - by the libdhcpsrv library. This covers mostly DHCP engine (the lease - allocation and renewal process), database operations and - configuration. - - - kea-dhcp4.hooks - this logger is used - to log messages related to management of hooks libraries, e.g. - registration and deregistration of the libraries, and to the - initialization of the callouts execution for various hook points - within the DHCPv4 server. - kea-dhcp4.callouts - this logger is used to log messages pertaining to the callouts registration and execution @@ -197,6 +179,21 @@ Hostname option processing. It also includes log messages related to the relevant DNS updates. + + kea-dhcp4.dhcp4 - this is the logger + by the DHCPv4 server deamon to log basic operations. + + + kea-dhcp4.dhcpsrv - this is a base + logger for the libdhcpsrv library. + + + kea-dhcp4.hooks - this logger is used + to log messages related to management of hooks libraries, e.g. + registration and deregistration of the libraries, and to the + initialization of the callouts execution for various hook points + within the DHCPv4 server. + kea-dhcp4.hosts - this logger is used within the libdhcpsrv and it logs messages related to the management @@ -236,20 +233,9 @@ provided. - kea-dhcp6.dhcp6 - this is the logger - used solely by the DHCPv6 server deamon. This logger does not - specify logging settings for libraries used by the daemon. - - - kea-dhcp6.dhcpsrv - this logger is used - by the libdhcpsrv library. This covers mostly DHCP engine (the lease - allocation and renewal process), database operations and - configuration. - - - kea-dhcp6.hooks - this logger is used - during DHCPv6 hooks operation, i.e. anything related to user - registration and deregistration of the libraries. + kea-dhcp6.bad-packets - this is the + logger used by the DHCPv6 server deamon for logging inbound client + packets that were dropped. kea-dhcp6.callouts - this logger is used @@ -257,12 +243,59 @@ for the particular hook point. + + kea-dhcp6.ddns - this logger is used by + the DHCPv6 server to log messages related to the Client FQDN option + processing. It also includes log messages related to the relevant + DNS updates. + + + kea-dhcp6.dhcp6 - this is the logger + used DHCPv6 server deamon to log basic operations. + + + kea-dhcp6.dhcpsrv - this is a base + logger for the libdhcpsrv library. + + + kea-dhcp6.hooks - this logger is used + to log messages related to management of hooks libraries, e.g. + registration and deregistration of the libraries, and to the + initialization of the callouts execution for various hook points + within the DHCPv6 server. + kea-dhcp6.hosts - this logger is used within the libdhcpsrv and it logs messages related to the management of the DHCPv6 host reservations, i.e. retrieval of the resevations and adding new reservations. + + kea-dhcp6.leases - this logger is used + by the DHCPv6 server to log messages related to the lease allocation. + The messages include detailed information about the allocated or + offered leases, errors during the lease allocation etc. + + + + kea-dhcp6.options - this logger is + used by the DHCPv6 server to log messages related to processing + of the options in the DHCPv6 messages, i.e. parsing options, + encoding options into on-wire format and packet classification + using options contained in the received packets. + + + kea-dhcp6.packets - this logger + is mostly used to log messages related to transmission of the DHCPv6 + packets, i.e. packet reception and sending a response. Such messages + include the information about the source and destination IP addresses + and interfaces used to transmit packets. This logger is also used + to log messages related to subnet selection, as this selection is + usually based on the IP addresses and/or interface names, which can + be retrieved from the received packet, even before the DHCPv6 message + carried in the packet is parsed. + + kea-dhcp-ddns - this is the root logger for the kea-dhcp-ddns deamon. All components used by this deamon inherit