errdemon Daemon

AIX Version 4.3 Commands Reference, Volume 2

errdemon Daemon

Purpose

Starts error logging daemon (errdemon) and writes entries to the error log.

Syntax

errdemon [ [ -B BufferSize ] [ -i File ] [ -s LogSize ] | -l ]

Description

The error logging daemon reads error records from the /dev/error file and creates error log entries in the system error log. Besides writing an entry to the system error log each time an error is logged, the error logging daemon performs error notification as specified in the error notification database. The /etc/objrepos/errnotify file is the error notification database. The default system error log is maintained in the /var/adm/ras/errlog file. The last error entry is placed in nonvolatile random access memory (NVRAM). During system startup, this last error entry is read from NVRAM and added to the error log when the error logging daemon is started.

The error logging daemon does not create an error log entry for the logged error if the error record template specifies Log=FALSE .

If you use the error logging daemon without flags, the system restarts the error logging daemon using the values stored in the error log configuration database for the error log file name, the error log file size, and the internal buffer size.

Use the errclear command to remove entries from the system error log.

Attention: The error logging daemon is normally started during system initialization. Stopping the error logging daemon can cause error data temporarily stored in internal buffers to be overwritten before it can be recorded in the error log file.

Flags

-i File	Uses the error log file specified by the File variable. The specified file name is saved in the error log configuration database and is immediately put into use.
-l	Displays the values for the error log file name, file size, and buffer size from the error log configuration database.
-s LogSize	Uses the size specified by the LogSize variable for the maximum size of the error log file. The specified log file size limit is saved in the error log configuration database, and it is immediately put into use. If the log file size limit is smaller than the size of the log file currently in use, the error logging daemon renames the current log file by appending .old to the file name. The error logging daemon creates a new log file with the specified size limit. Generate a report form the old log file using the -i flag of the errpt command. If this parameter is not specified, the error logging daemon uses the log file size from the error log configuration database.
-B BufferSize	Uses the number of bytes specified by the BufferSize parameter for the error log device driver's in-memory buffer. The specified buffer size is saved in the error log configuration database. If the BufferSize parameter is larger than the buffer size currently in use, the in-memory buffer is immediately increased. If the BufferSize parameter is smaller than the buffer size currently in use, the new size is put into effect the next time the error logging daemon is started after the system is rebooted. The buffer cannot be made smaller than the hard-coded default of 8KB. If this parameter is not specified, the error logging daemon uses the buffer size from the error log configuration database. The size you specify is rounded up to the next integral multiple of the memory page size (4KB). The memory used for the error log device driver's in-memory buffer is not available for use by other processes. (The buffer is pinned). Be careful not to impact your system's performance by making the buffer excessively large. On the other hand, if you make the buffer too small, the buffer can become full if error entries arrive faster than they can be read from the buffer and put into the log file. When the buffer is full, new entries are discarded until space becomes available in the buffer. When this situation occurs, the error logging daemon creates an error log entry to inform you of the problem. You can correct the problem by enlarging the buffer.

Security

Access Control: Only the root user can run this daemon.

Examples

To start the error-logging daemon, enter:
```
/usr/lib/errdemon
```
To view the current maximum error-log size, enter:
```
/usr/lib/errdemon -l
```
To change the current maximum error-log size from 1MB to 64KB, enter:
```
/usr/lib/errdemon -s 65536
```

Files

/dev/error	Source of error records.
/var/adm/ras/errtmplt	Contains the error template repository.
/usr/lib/errdemon	Contains the errdemon daemon.
/etc/objrepos/SWservAt	Contains the software service aids attributes object class; that is, the error log configuration database.

Related Information

The errclear command, errdead command, errinstall command, errlogger command, errmsg command, errpt command, errstop command, errupdate command.

The errsave kernel service.

The error logging special files.

The errlog subroutine.

Error Logging Overview in AIX Version 4.3 Problem Solving Guide and Reference.