Technical Reference: Base Operating System and Extensions, Volume 1

errlog_set_direction Subroutine

Purpose

Sets the direction for the error log find functions.

Syntax

library liberrlog.a

#include <sys/errlog.h>

int errlog_set_direction(handle, direction)
errlog_handle_t handle;
int direction;

Description

The errlog_find_next and errlog_find_sequence subroutines search the error log starting with the most recent log entry and going backward in time, by default. The errlog_set_direction subroutine is used to alter this direction.

Parameters

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

The direction parameter must be LE_FORWARD or LE_REVERSE. LE_REVERSE is the default if the errlog_set_direction subroutine is not used.

Return Values

Upon successful completion, the errlog_set_direction subroutine returns 0.

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

Related Information

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