errlog_write, Subroutine

Zweck

Ändert den zuvor gelesenen Fehlerprotokolleintrag.

Syntax

library liberrlog.a

#include <sys/errlog.h>

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

Beschreibung

Mit der Subroutine Fehlerprotokoll schreiben wird der zuletzt gelesene Protokolleintrag aktualisiert. Weder die Länge noch die Folgenummer des Eintrags können geändert werden. Der Eintrag wird einfach aktualisiert.

Wenn die Subroutine Fehlerprotokoll schreiben in einer Multithread-Anwendung verwendet wird, sollte das Programm eine Sperre um das Lese-/Schreibpaar erhalten, um Konflikte zu vermeiden.

Parameter

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

Der Parameter entry muss auf einen Eintrag verweisen, der von der vorherigen Suchfunktion des Fehlerprotokolls zurückgegeben wurde.

Rückgabewerte

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

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

Die Subroutine Fehlerprotokoll schreiben kann auch einen der folgenden Werte zurückgeben:

Element Beschreibung
LE_ERR_INVFILE Die Daten in der Datei sind ungültig.
LE_ERR_IO E/A-Fehler aufgetreten.
LE_ERR_NOWRITE Der zu schreibende Eintrag stimmt nicht mit dem zu aktualisierenden Eintrag überein.