mirror of
https://gitlab.isc.org/isc-projects/bind9
synced 2025-09-09 19:15:26 +00:00
a011d42211
Previously, netmgr, taskmgr, timermgr and socketmgr all had their own isc_<*>mgr_create() and isc_<*>mgr_destroy() functions. The new isc_managers_create() and isc_managers_destroy() fold all four into a single function and makes sure the objects are created and destroy in correct order. Especially now, when taskmgr runs on top of netmgr, the correct order is important and when the code was duplicated at many places it's easy to make mistake. The former isc_<*>mgr_create() and isc_<*>mgr_destroy() functions were made private and a single call to isc_managers_create() and isc_managers_destroy() is required at the program startup / shutdown.
66 lines
1.4 KiB
C
66 lines
1.4 KiB
C
/*
|
|
* Copyright (C) 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 https://mozilla.org/MPL/2.0/.
|
|
*
|
|
* See the COPYRIGHT file distributed with this work for additional
|
|
* information regarding copyright ownership.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <isc/mem.h>
|
|
#include <isc/result.h>
|
|
#include <isc/timer.h>
|
|
|
|
isc_result_t
|
|
isc__timermgr_create(isc_mem_t *mctx, isc_timermgr_t **managerp);
|
|
/*%<
|
|
* Create a timer manager.
|
|
*
|
|
* Notes:
|
|
*
|
|
*\li All memory will be allocated in memory context 'mctx'.
|
|
*
|
|
* Requires:
|
|
*
|
|
*\li 'mctx' is a valid memory context.
|
|
*
|
|
*\li 'managerp' points to a NULL isc_timermgr_t.
|
|
*
|
|
* Ensures:
|
|
*
|
|
*\li '*managerp' is a valid isc_timermgr_t.
|
|
*
|
|
* Returns:
|
|
*
|
|
*\li Success
|
|
*\li No memory
|
|
*\li Unexpected error
|
|
*/
|
|
|
|
void
|
|
isc__timermgr_destroy(isc_timermgr_t **managerp);
|
|
/*%<
|
|
* Destroy a timer manager.
|
|
*
|
|
* Notes:
|
|
*
|
|
*\li This routine blocks until there are no timers left in the manager,
|
|
* so if the caller holds any timer references using the manager, it
|
|
* must detach them before calling isc_timermgr_destroy() or it will
|
|
* block forever.
|
|
*
|
|
* Requires:
|
|
*
|
|
*\li '*managerp' is a valid isc_timermgr_t.
|
|
*
|
|
* Ensures:
|
|
*
|
|
*\li *managerp == NULL
|
|
*
|
|
*\li All resources used by the manager have been freed.
|
|
*/
|