diff --git a/documentation/RELEASE_NOTES.md b/documentation/RELEASE_NOTES.md index 732c98654..1b0f0e6b7 100644 --- a/documentation/RELEASE_NOTES.md +++ b/documentation/RELEASE_NOTES.md @@ -18,6 +18,13 @@ __This version of EPICS has not been released yet.__ __Add new items below here__ +### New `dbServerStats()` API for iocStats + +A new routine provides the ability to request channel and client counts from +name server layers that implement the `stats()` method. A preprocessor macro +`HAS_DBSERVER_STATS` macro is defined in the `dbServer.h` header file to +simplify code that needs to support older versions of Base as well. + ----- ## EPICS Release 7.0.9 diff --git a/modules/database/src/ioc/db/dbServer.h b/modules/database/src/ioc/db/dbServer.h index d816311dd..86c3f7d82 100644 --- a/modules/database/src/ioc/db/dbServer.h +++ b/modules/database/src/ioc/db/dbServer.h @@ -142,6 +142,11 @@ DBCORE_API void dbsr(unsigned level); */ DBCORE_API int dbServerClient(char *pBuf, size_t bufSize); +/** @brief CPP Macro indicating the dbServerStats() routine exists. + * @since UNRELEASED + */ +#define HAS_DBSERVER_STATS + /** @brief Fetch statistics from named server. * * This is an API for iocStats and similar to fetch the number of channels @@ -151,6 +156,8 @@ DBCORE_API int dbServerClient(char *pBuf, size_t bufSize); * @param clients Where to return the client count * @returns 0 on success; -1 if IOC isn't running, no such named server, * or that server doesn't implement the stats method. + * + * @since UNRELEASED */ DBCORE_API int dbServerStats(const char *name, unsigned *channels, unsigned *clients);