Technical Reference: Base Operating System and Extensions, Volume 1

errlog_write Subroutine

Purpose

Changes the previously read error log entry.

Syntax

library liberrlog.a

#include <sys/errlog.h>

int errlog_write(handle, entry)
errlog_handle_t handle;
errlog_entry_t *entry;

Description

The errlog_write subroutine is used to update the most recently read log entry. Neither the length nor the sequence number of the entry may be changed. The entry is simply updated in place.

If the errlog_write subroutine is used in a multi-threaded application, the program should obtain a lock around the read/write pair to avoid conflict.

Parameters

The handle parameter must contain a handle returned by a previous errlog_open call.

The entry parameter must point to an entry returned by the previous error log find function.

Return Values

Upon successful completion, the errlog_write subroutine returns 0.

If a parameter is invalid, the errlog_write subroutine returns LE_ERR_INVARG.

The errlog_write subroutine may also return one of the following:

Related Information

The errlog_open, errlog_close, errlog_find_first, errlog_find_next, errlog_find_sequence, errlog_set_direction, and errlog subroutines.

The /usr/include/sys/errlog.h include file.