diff options
Diffstat (limited to 'doc/devel/mainpage.dox')
-rw-r--r-- | doc/devel/mainpage.dox | 160 |
1 files changed, 160 insertions, 0 deletions
diff --git a/doc/devel/mainpage.dox b/doc/devel/mainpage.dox new file mode 100644 index 0000000..5151e15 --- /dev/null +++ b/doc/devel/mainpage.dox @@ -0,0 +1,160 @@ +// Copyright (C) 2012-2024 Internet Systems Consortium, Inc. ("ISC") +// +// This Source Code Form is subject to the terms of the Mozilla Public +// License, v. 2.0. If a copy of the MPL was not distributed with this +// file, You can obtain one at http://mozilla.org/MPL/2.0/. + +/** + * @mainpage Kea Developer's Guide + * + * Welcome to the Kea Developer's Guide. This documentation is addressed at + * either existing or prospective Kea developers and contributors, and + * provides information needed to extend and maintain Kea source code. + + * If you wish to write hook code - the code that is loaded by Kea at + * run-time and modifies its behavior, you should read the section + * @ref hooksdgDevelopersGuide. + * + * Kea maintenance information is divided into a number of sections. + * Information on DHCP-specific topics can be found + * in the @ref dhcpMaintenanceGuide. General topics are discussed in + * @ref miscellaneousTopics. + * + * If you are a user or system administrator, rather than software engineer, + * you should read the + * <a href="https://kea.readthedocs.io">Kea + * Administrator Reference Manual</a> instead. If you are using a beta or + * development version of Kea, the + * <a href="https://kea.readthedocs.io/"> + * development version of the manual</a> is recommended. + * + * Regardless of your field of expertise, you are encouraged to visit the + * <a href="https://gitlab.isc.org/isc-projects/kea/wikis/home">Kea wikipage (https://gitlab.isc.org/isc-projects/kea/wikis/home)</a> + * + * @section contrib Contributor's Guide + * - @subpage contributorGuide - This page describes the process of sending + * a patch to ISC and what happens next. Please read it if you are considering + * sending us any code. + * + * @section qa Quality Assurance + * - @subpage qaIntro + * - @subpage unitTests + * - @subpage unitTestsEnvironmentVariables + * - @subpage unitTestsSanitizers + * - @subpage unitTestsDatabaseConfig + * - @subpage unitTestsSysrepo + * - @subpage writingShellScriptsAndTests + * - @subpage performance + * - @subpage fuzzer + * - @subpage qa + * - @subpage ciGithub + * - @subpage ciGitlab + * - @subpage ciJenkins + * + * @section hooksFramework Hooks Framework + * - @subpage hooksdgDevelopersGuide + * - @subpage dhcpv4Hooks + * - @subpage dhcpv6Hooks + * - @subpage agentHooks + * - @subpage d2Hooks + * - @subpage hooksComponentDeveloperGuide + * - @subpage hooksmgMaintenanceGuide + * - @subpage libdhcp_ha + * - @subpage libdhcp_user_chk + * - @subpage libdhcp_lease_cmds + * - @subpage libdhcp_stat_cmds + * + * @section dhcpMaintenanceGuide DHCP Maintenance Guide + * - @subpage dhcp4 + * - @subpage dhcpv4ConfigParser + * - @subpage dhcpv4ConfigInherit + * - @subpage dhcpv4OptionsParse + * - @subpage dhcpv4DDNSIntegration + * - @subpage dhcpv4Classifier + * - @subpage dhcpv4ConfigBackend + * - @subpage dhcpv4SignalBasedReconfiguration + * - @subpage dhcpv4Other + * - @subpage dhcpv4o6Dhcp4 + * - @subpage dhcp6 + * - @subpage dhcpv6ConfigParser + * - @subpage dhcpv6ConfigInherit + * - @subpage dhcpv6DDNSIntegration + * - @subpage dhcpv6OptionsParse + * - @subpage dhcpv6Classifier + * - @subpage dhcpv6ConfigBackend + * - @subpage dhcpv6SignalBasedReconfiguration + * - @subpage dhcpv6Other + * - @subpage dhcpv4o6Dhcp6 + * - @subpage congestionHandling + * - @subpage d2 + * - @subpage d2ProcessDerivation + * - @subpage d2ConfigMgt + * - @subpage d2NCRReceipt + * - @subpage d2DDNSUpdateExecution + * - @subpage d2EventLoop + * - @subpage d2TransDetail + * - @subpage d2StateModel + * - @subpage d2TransExecExample + * - @subpage controlAgent + * - @subpage ctrlAgentHttp + * - @subpage ctrlAgentCreatingResponse + * - @subpage ctrlAgentCommandMgr + * - @subpage CtrlAgentSecurity + * - @subpage lfc + * - @subpage lfcProcessing + * - @subpage lfcFiles + * - @subpage ctrlSocket + * - @subpage ctrlSocketOverview + * - @subpage ctrlSocketClient + * - @subpage ctrlSocketImpl + * - @subpage ctrlSocketConnections + * - @subpage dhcpDatabaseBackends + * - @subpage configBackend + * - @subpage configBackendJSONDesign + * + * @section libraries Kea libraries + * - @subpage libutil + * - @subpage libasiolink + * - @subpage libcc + * - @subpage libdatabase + * - @subpage libdhcp + * - @subpage libdhcpIntro + * - @subpage libdhcpRelay + * - @subpage libdhcpIfaceMgr + * - @subpage libdhcpPktFilter + * - @subpage libdhcpPktFilter6 + * - @subpage libdhcpErrorLogging + * - @subpage libstats + * - @subpage libdhcp_ddns + * - @subpage libdhcpsrv + * - @subpage leasemgr + * - @subpage cfgmgr + * - @subpage hostmgr + * - @subpage optionsConfig + * - @subpage allocengine + * - @subpage timerManager + * - @subpage leaseReclamationRoutine + * - @subpage subnetSelect + * - @subpage dhcp4o6Ipc + * - @subpage libeval + * - @subpage libprocess + * - @subpage cpl + * - @subpage cplSignals + * - @subpage libyang + * - @subpage libhttp + * + * @section miscellaneousTopics Miscellaneous Topics + * - @subpage terminology + * - @subpage parser + * - @subpage logKeaLogging + * - @subpage logBasicIdeas + * - @subpage logDeveloperUse + * - @subpage logNotes + * - @subpage LoggingApi + * - @subpage SocketSessionUtility + * - @subpage crossCompile + * - @subpage debug + * - @subpage docs + * - <a href="./doxygen-error.log"><b>Documentation Warnings and Errors</b></a> + * + */ |