EPICS_base/epics-base
0
0
Fork 0
Code Issues Pull Requests Projects Wiki Activity

Release notes; HAS_DBSERVER_STATS in dbServer.h

Browse Source
This commit is contained in:
Andrew Johnson
2025-02-03 13:35:49 -06:00
parent fd86f0ff04
commit 90f97a7037
2 changed files with 14 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
documentation/RELEASE_NOTES.md
View File

@ -18,6 +18,13 @@ __This version of EPICS has not been released yet.__
__Add new items below here__ __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 ## EPICS Release 7.0.9

7
modules/database/src/ioc/db/dbServer.h
View File

@ -142,6 +142,11 @@ DBCORE_API void dbsr(unsigned level);
*/ */
DBCORE_API int dbServerClient(char *pBuf, size_t bufSize); 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. /** @brief Fetch statistics from named server.
* *
* This is an API for iocStats and similar to fetch the number of channels * 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 * @param clients Where to return the client count
* @returns 0 on success; -1 if IOC isn't running, no such named server, * @returns 0 on success; -1 if IOC isn't running, no such named server,
* or that server doesn't implement the stats method. * or that server doesn't implement the stats method.
*
* @since UNRELEASED
*/ */
DBCORE_API int dbServerStats(const char *name, unsigned *channels, unsigned *clients); DBCORE_API int dbServerStats(const char *name, unsigned *channels, unsigned *clients);