From b67f7946c98535f1b35b22098c034af2b17ccd7a Mon Sep 17 00:00:00 2001 From: Joel Sherrill Date: Fri, 28 Aug 1998 14:32:01 +0000 Subject: Added log_write_any and part of log_copy. Reviewed log_close. --- doc/new_chapters/eventlog.t | 95 +++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 92 insertions(+), 3 deletions(-) (limited to 'doc/new_chapters/eventlog.t') diff --git a/doc/new_chapters/eventlog.t b/doc/new_chapters/eventlog.t index de7b928817..7fdb539038 100644 --- a/doc/new_chapters/eventlog.t +++ b/doc/new_chapters/eventlog.t @@ -20,10 +20,12 @@ The directives provided by the event logging manager are: @itemize @bullet @item @code{log_write} - Write to the Log +@item @code{log_write_any} - Write to any log file @item @code{log_open} - Open a log file @item @code{log_read} - Read from the system Log @item @code{log_notify} - Notify Process of writes to the system log @item @code{log_close} - Close log descriptor +@item @code{log_copy} - @item @code{log_seek} - Reposition log file offset @item @code{log_severity_before} - Compare event record severities @item @code{log_facilityemptyset} - Manipulate log facility sets @@ -159,6 +161,93 @@ attribute. The @code{_POSIX_LOGGING} feature flag is defined to indicate this service is available. +@page +@subsection log_write_any - Write to the any log file + +@subheading CALLING SEQUENCE: + +@ifset is-C +@example +#include + +int log_write_any( + const logd_t logdes, + const log_facility_t facility, + const int event_id, + const log_severity_t severity, + const void *buf, + const size_t len +); +@end example +@end ifset + +@ifset is-Ada +@end ifset + +@subheading STATUS CODES: + +@table @b +@item EINVAL +The facility argument is not a valid log_facility. + +@item EINVAL +The severity argument exceeds @code{LOG_SEVERITY_MAX} + +@item EINVAL +The len argument exceeds @code{LOG_ENTRY_MAXLEN} + +@item ENOSPC +The log file has run out of space on the device. + +@item EPERM +The caller does not have appropriate permission for writing to +the given facility. + +@item EIO +An I/O error occurred in writing to the system event log. + +@end table + +@subheading DESCRIPTION: + +The @code{log_write} function writes an event record, consisting +of event attributes, and the data identified by the @code{buf} +argument, to a log file. The @code{len} argument specifies +the length in bytes of the buffer pointed to by @code{buf}. The +@code{len} argument shall specify the value of the event record +length attribute. The value of @code{len} shall be less than or +equal to @code{LOG_ENTRY_MAXLEN} or the @code{log_write} shall fail. + +The @code{event_id} argument identifies the type of event record +being written. The @code{event_id} argument shall specify the value +of the event ID attribute of the event record. + +The argument @code{facility} indicates the facility from which the +event type is drawn. The @code{facility} argument shall specify the +value of the event record facility attribute. The value of the +@code{facility} argument shall be a valid log facility or the +@code{log_write} function shall fail. + +The @code{severity} argument indicates the severity level of the +event record. The @code{severity} argument shall specify the value +of the event record severity attribute. The value of the +@code{severity} argument shall be less than or equal to +@code{LOG_SEVERITY_MAX} or the @code{log_write} function shall fail. + +The effective_UID of the calling process shall specify the event +record UID attribute. The effective-GID of the calling process +shall specify the event record GID attribute. The process ID +of the calling process shall specify the event record process ID +attribute. The process group ID of the calling process shall +specify the event record process group ID attribute. The current +value of the system clock shall specify the event record timestamp +attribute. + +@subheading NOTES: + +The @code{_POSIX_LOGGING} feature flag is defined to indicate +this service is available. + @page @subsection log_open - Open a log file @@ -415,14 +504,14 @@ The @code{log_close} function deallocates the open log file descriptor indicated by @code{log_des}. When all log file descriptors associated with an open log file description -have been closed, the open log file description shall be freed. +have been closed, the open log file description is freed. If the link count of the log file is zero, when all log file descriptors -have been closed, the space occupied by the log file shall be freed and the +have been closed, the space occupied by the log file is freed and the log file shall no longer be accessible. If the process has successfully registered a notification request for the -log file descriptor, the registration shall be removed. +log file descriptor, the registration is removed. @subheading NOTES: -- cgit v1.2.3