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