osmd(1M) osmd(1M)
NAME
osmd - log OSM data
SYNOPSIS
osmd [-d] [-I] [-T] [-O] [-h] [-o name] [-c name] [-s size] [-m max]
[-f name] [-p name]
DESCRIPTION
The osmd daemon (OSM - Operating System Messages) logs a stream of
messages from a device (e. g. /dev/osm), file or pipe or from standard
input. In the process, it checks the size of the protocol files to
prevent the file system containing these files from overflowing.
The osmd daemon creates a cycle of three files, by default, under
/etc/.osm[.MM-DD-hh:mm], whereby the maximum size of each file is
5 MB. The messages are always written to the file without the suffix.
If the maximum size of this file will be exceeded by the next entry,
the file is assigned a suffix made up of date and time and a new file
is created without the suffix. The messages are written to this new
file. If the number of files in the cycle will consequently be
exceeded, the oldest files are deleted (generally one file unless the
number of files belonging to the cycle has been reduced). The defaults
for the osmd daemon can be overridden by values from the
/etc/default/osm.conf configuration file [see osm.conf(4)]. The signal
1 (SIGHUP) must be sent to the osmd daemon to enable it to load the
modified content of the /etc/default/osm.conf configuration file. The
values assigned with the options have the highest priority.
The osmd daemon is started with the /etc/rc2.d/S09osm script for log-
ging the OSM data when multiuser mode is initiated. The console ring
buffer is read from the beginning and further messages are awaited.
The osmd daemon takes account of the /etc/default/osm.filter filter
when reading the messages, provided this filter exists. The filter can
contain one regular expression per line against which the messages
read are compared. Each regular expression must be enclosed by termi-
nator characters (e.g.: /^$/ implies a blank line). If "-" is the only
character to appear in a line, this means that all messages containing
one of the regular expressions are ignored. This is the default . If
"+" is the only character to appear in a line, this means that only
lines that contain at least one of the regular expressions from the
filter are logged. The default is for no filter to be supplied, i. e.
the messages read by /dev/osm are not filtered.
OPTIONS
-d Activate test aids.
-I Standard input is read instead of /dev/osm (overwrites the -o
option).
-T Logging (not to standard output) with leading time stamps in the
form "MMM DD hh:mm:ss" (example: May 22 16:57:51).
Page 1 Reliant UNIX 5.44 Printed 11/98
osmd(1M) osmd(1M)
-O Additional output to standard output.
-h Output instructions for use.
-o Specify an alternative source for messages to be logged (default:
/dev/osm).
-c Specify an alternative configuration file (default:
/etc/default/osm.conf).
-s Specify an alternative maximum size for the protocol files in
bytes (range: 10000 bytes - ulimit value; default: 5 MB = 5120000
bytes).
-m Specify an alternative number of files that are to form a cycle
(range: 2 - 100; default: 3).
-f Specify an alternative filter (default: /etc/default/osm.filter).
-p Specify alternative log files (default: /etc/.osm[.MM-DD-hh:mm]).
FILES
/dev/osm
console ring buffer for kernel and driver messages
/etc/default/osm.conf
configuration file for the osmd daemon
/etc/default/osm.filter
filter file
/etc/.osm[.MM-DD-hh:mm]
protocol files
/var/adm/log/osm[.MM-DD-hh:mm]
SEE ALSO
osm(1M), osm.conf(4), osm(7).
Page 2 Reliant UNIX 5.44 Printed 11/98