errsave or errlast Kernel Service

Kernel and Subsystems Technical Reference, Volume 1

errsave or errlast Kernel Service

Purpose

Allows the kernel and kernel extensions to write to the error log.

Syntax

#include <sys/types.h>
#include <sys/errno.h>
#include <sys/errids.h>

void errsave (buf, cnt)
char *buf;
unsigned int cnt;

void errlast (buf, cnt)
char *buf
unsigned int cnt;

Parameters

buf	Points to a buffer that contains an error record as described in the /usr/include/sys/err_rec.h file.
cnt	Specifies the number of bytes in the error record contained in the buffer pointed to by the buf parameter.

Description

The errsave kernel service allows the kernel and kernel extensions to write error log entries to the error device driver. The error record pointed to by the buf parameter includes the error ID resource name and detailed data.

In addition, the errlast kernel service disables any future error logging, thus any error logged with errlast will stay on NVRAM. This service is only for use prior to a pending system crash or stop. The errlast service should only be used in extreme circumstances where the system can not continue, such as the occurance of a machine check.

Execution Environment

The errsave kernel service can be called from either the process or interrupt environment.

Return Values

The errsave service has no return values.

Implementation Specifics

The errsave kernel service is part of Base Operating System (BOS) Runtime.

Related Information

The errlog subroutine.

For more information on error device drivers, see Error Logging Special Files in AIX Version 4.3 Files Reference.

RAS Kernel Services in AIX Version 4.3 Kernel Extensions and Device Support Programming Concepts.