[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]

General Programming Concepts:
Writing and Debugging Programs

Error Logging Controls

To control the error-logging facility, you can use error-logging commands, subroutines and kernel services, as well as files.

Error-Logging Commands

errclear Deletes entries from the error log. This command can erase the entire error log. Removes entries with specified error ID numbers, classes, or types.
errdead Extracts errors contained in the /dev/error buffer captured in the system dump. The system dump will contain error records if the errdemon daemon was not active prior to the dump.
errdemon Reads error records from the /dev/error file and writes error log entries to the system error log. The errdemon also performs error notification as specified in the error notification objects in the Object Data Manager (ODM). This daemon is started automatically during system initialization.
errinstall Can be used to add or replace messages in the error message catalog. Provided for use by software installation procedures. The system creates a backup file named File.undo. The undo file allows you to cancel the changes you made by issuing the errinstall command.
errlogger Writes an operator message entry to the error log.
errmsg Implements error logging in in-house applications. The errmsg command lists, adds, or deletes messages stored in the error message catalog. Using this command, text can be added to the Error Description, Probable Cause, User Cause, Install Cause, Failure Cause, Recommended Action, and Detailed Data message sets.
errpt Generates an error report from entries in the system error log. The report can be formatted as a single line of data for each entry, or the report can be a detailed listing of data associated with each entry in the error log. Entries of varying classes and types can be omitted from or included in the report.
errstop Stops the errdemon daemon, which is initiated during system initialization. Running the errstop command also disables some diagnostic and recovery functions of the system.
errupdate Adds or deletes templates in the Error Record Template Repository. Modifies the Alert, Log, and Report attributes of an error template. Provided for use by software installation procedures.

Error Logging Subroutines and Kernel Services

errlog Writes an error to the error log device driver
errsave and errlast Allows the kernel and kernel extensions to write to the error log
errlog_open Opens an error log
errlog_close Closes an error log
errlog_find_first Finds the first occurrence of an error log entry
errlog_find_next Finds the next occurrence of an error log entry
errlog_find_sequence Finds the error log entry with the specified sequence number
errlog_set_direction Sets the direction for the error log find functions
errlog_write Updates an error log entry
errresume Resumes error logging after an errlast command was issued.

Error Logging Files

/dev/error Provides standard device driver interfaces required by the error log component
/dev/errorctl Provides nonstandard device driver interfaces for controlling the error logging system
/usr/include/sys/err_rec.h Contains structures defined as arguments to the errsave kernel service and the errlog subroutine
/usr/include/sys/errlog.h Defines the interface to the liberrlog subroutines
/var/adm/ras/errlog Stores instances of errors and failures encountered by the system
/var/adm/ras/errtmplt Contains the Error Record Template Repository

[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]