errlog_set_direction, Subroutine

Zweck

Legt die Richtung für die Fehlerprotokollsuchfunktionen fest.

Syntax

library liberrlog.a

#include <sys/errlog.h>

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

Beschreibung

Die Subroutinen errlog_find_next und errlog_find_folge durchsuchen das Fehlerprotokoll standardmäßig beginnend mit dem neuesten Protokolleintrag und in der Zeit rückwärts. Diese Richtung wird mit der Subroutine Fehlerprotokollsatzrichtung geändert.

Parameter

Der Kennungsparameter muss eine Kennung enthalten, die von einem vorherigen Fehlerprotokoll_geöffnet -Aufruf zurückgegeben wurde.

Der Richtungsparameter muss LE_VORWÄRTS oder LE_UMKEHRENlauten. LE_UMKEHREN ist der Standardwert, wenn die Subroutine Fehlerprotokollsatzrichtung nicht verwendet wird.

Rückgabewerte

Nach erfolgreicher Beendigung gibt die Subroutine Fehlerprotokollsatzrichtung den Wert 0 zurück.

Wenn ein Parameter ungültig ist, gibt die Subroutine Fehlerprotokollsatzrichtung LE_ERR_INVARGzurück.