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

Item Description
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.