${BSE}/log directory

The ${BSE}/log directory contains error messages, and some additional information, which is stored in a log file. Porting set version 9.0b uses these log file formats:

  • <program name>-<sequence>.log

    if log rotation is enabled.

  • <program name>.log

    If log rotation is not enabled.

Porting sets of an earlier version use the log.<program name> convention and do not support a configurable log rotation count.

The size of the log files in ${BSE}/log is adjustable. By default, the size of the log files is 2048 KB. When a log file exceeds that size, the bshell automatically rotates to the next file in sequence, for example from bshell-001.log to bshell-002.log.

To adjust the size of the log files, set the log_size resource.

The sequence number is limited by the log_rotation_count resource. The default value is two. When the sequence number reaches the log_rotation_count value, the rotation counter starts again at sequence number one.

Log rotation is disabled when log_rotation_count is less than two or when log_size has a negative value (which means unlimited). In that case, logging is written to a single file.

To set these resources, for example, add these lines to the $BSE/lib/defaults/all file:

log_size:1024
log_rotation_count:10