IBM Carrier Grade X3650 T, Руководство пользователя

Страница: 88 / 108

IBM® Carrier Grade Server X3650 T
Revision 3.0 80
17.1.2.4 Errors
If any of the following conditions occur, the syscon_log_printf () function shall return the corresponding
error number:
•
[EINVAL]: The event_type argument is invalid, or the severity argument is invalid.
•
[EINVAL]: The format argument is NULL .
•
[ENOSPC]: The log has run out of space.
•
[EIO]: An I/O error occurred in writing to the system log.
For each of the following conditions, if the condition is detected, the syscon_log_printf () function shall
return the corresponding error number:
•
[EPERM]: See the description of the [EPERM] error condition under syscon_log_write ().
•
[ECANCELED]: See the description of the [ECANCELED] error condition under
syscon_log_write ().
17.2 Log Processing Functions
17.2.1 Open an Event Log for Read Access
Function: syscon_log_open()
17.2.1.1 Synopsis
#include <syscon.h>
int syscon_log_open(syscon_logd_t *logdes, const char *path);
17.2.1.2 Description
The syscon_log_open () function establishes a connection between an event log and a log descriptor.
The log descriptor is used by other log functions to refer to that log. The path argument points to a
pathname, naming a log file. A path argument of NULL specifies the active system log.
The read pointer associated with this log descriptor is set to the beginning of the log.
17.2.1.3 Returns
Upon successful completion, syscon_log_open () shall open the specified event log and store a log
descriptor into the location pointed to by logdes , and return zero. Otherwise, an error number shall be
returned to indicate the error.
17.2.1.4 Errors
If any of the following conditions occur, the syscon_log_open () function shall return the corresponding
error number: