IBM Carrier Grade X3650 T User Manual

IBM® Carrier Grade Server X3650 T
Revision 3.0
82
17.2.2.4 Errors
If any of the following conditions occur, the syscon_log_read() function shall return the corresponding
error number:
• [EINVAL]: The logdes argument is not a valid log descriptor (as returned by the syscon_log_open()
function), or the entry argument is NULL.
• [EAGAIN]: The read pointer associated with logdes is at the end of the log. A subsequent read at this
same read pointer will succeed only after one or more new events are logged, and only if logdes
references the active system log.
• [EIO]: An I/O error occurred in reading from the event log.
17.2.2.5 Cross-References
read(), syscon_log_open()
17.2.3 Notify Process of Availability of System Log Data
Functions: syscon_log_notify_add(), syscon_log_siginfo_recid(), syscon_log_sigval_recid(),
syscon_log_notify_get()
17.2.3.1 Synopsis
#include <signal.h>
#include <syscon.h>
int syscon_log_notify_add(const syscon_log_query_t *query,
const struct sigevent *notification, int flags,
syscon_log_notify_t *nfyhandle);
int syscon_log_siginfo_recid(const siginfo_t *info, void *context,
syscon_log_recid_t *recid);
int syscon_log_sigval_recid(union sigval sval, syscon_log_recid_t *recid);
int syscon_log_notify_get(syscon_log_notify_t nfyhandle,
struct sigevent *notification, int *flags, char *qsbuf,
size_t qslen, size_t *reqlen);
17.2.3.2 Description
17.2.3.2.1 syscon_log_notify_add()
The syscon_log_notify_add() function registers the calling process to be notified of event records
received by the system log that match the query parameters associated with the query object pointed to
by query. If the query argument is NULL, all newly received events shall be considered to match. When
the system log receives a matching event, the notification specified by the notification argument shall be
sent to the calling process.
If the nfyhandle argument is not NULL, syscon_log_notify_add() shall store an object of type
syscon_log_notify_t to the location pointed to by nfyhandle. This object can be used when removing this
notification request via the syscon_log_notify_remove() function. Subsequent to this
syscon_log_notify_add() call, changes to the query object pointed to by query shall have no effect on this
notification request, and removal of this notification request shall have no effect on the query object.
If query is not NULL and the indicated query object’s purpose code does not include the
{SYSCONLOG_PRPS_NOTIFY} flag, the syscon_log_notify_add() function shall fail.

IBM Carrier Grade X3650 T Specifications

General

Brand	IBM
Model	Carrier Grade X3650 T
Category	Server
Language	English