mirror of
https://gitlab.isc.org/isc-projects/bind9
synced 2025-08-22 10:10:06 +00:00
f3635bcc14
Unify the header guard style and replace the inconsistent include guards with #pragma once. The #pragma once is widely and very well supported in all compilers that BIND 9 supports, and #pragma once was already in use in several new or refactored headers. Using simpler method will also allow us to automate header guard checks as this is simpler to programatically check. For reference, here are the reasons for the change taken from Wikipedia[1]: > In the C and C++ programming languages, #pragma once is a non-standard > but widely supported preprocessor directive designed to cause the > current source file to be included only once in a single compilation. > > Thus, #pragma once serves the same purpose as include guards, but with > several advantages, including: less code, avoidance of name clashes, > and sometimes improvement in compilation speed. On the other hand, > #pragma once is not necessarily available in all compilers and its > implementation is tricky and might not always be reliable. 1. https://en.wikipedia.org/wiki/Pragma_once
80 lines
1.9 KiB
C
80 lines
1.9 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/socket.h>
|
|
|
|
isc_result_t
|
|
isc__socketmgr_create(isc_mem_t *mctx, isc_socketmgr_t **managerp,
|
|
unsigned int maxsocks, int nthreads);
|
|
/*%<
|
|
* Create a socket manager. If "maxsocks" is non-zero, it specifies the
|
|
* maximum number of sockets that the created manager should handle.
|
|
*
|
|
* 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_socketmgr_t.
|
|
*
|
|
* Ensures:
|
|
*
|
|
*\li '*managerp' is a valid isc_socketmgr_t.
|
|
*
|
|
* Returns:
|
|
*
|
|
*\li #ISC_R_SUCCESS
|
|
*\li #ISC_R_NOMEMORY
|
|
*\li #ISC_R_UNEXPECTED
|
|
*\li #ISC_R_NOTIMPLEMENTED
|
|
*/
|
|
|
|
void
|
|
isc__socketmgr_destroy(isc_socketmgr_t **managerp);
|
|
/*%<
|
|
* Destroy a socket manager.
|
|
*
|
|
* Notes:
|
|
*
|
|
*\li This routine blocks until there are no sockets left in the manager,
|
|
* so if the caller holds any socket references using the manager, it
|
|
* must detach them before calling isc_socketmgr_destroy() or it will
|
|
* block forever.
|
|
*
|
|
* Requires:
|
|
*
|
|
*\li '*managerp' is a valid isc_socketmgr_t.
|
|
*
|
|
*\li All sockets managed by this manager are fully detached.
|
|
*
|
|
* Ensures:
|
|
*
|
|
*\li *managerp == NULL
|
|
*
|
|
*\li All resources used by the manager have been freed.
|
|
*/
|
|
|
|
#include <sys/time.h>
|
|
|
|
typedef struct isc_socketwait isc_socketwait_t;
|
|
int
|
|
isc__socketmgr_waitevents(isc_socketmgr_t *, struct timeval *,
|
|
isc_socketwait_t **);
|
|
isc_result_t
|
|
isc__socketmgr_dispatch(isc_socketmgr_t *, isc_socketwait_t *);
|