| -C
| Changes the attributes for a specified LogType. Use the
-C flag with the -f, -s, and -w
flags to change the File, Size, and Verbosity
attributes for the specified LogType. The -t
LogType flag is required.
If the -C flag is used,
the alog command does not copy standard input to standard output or
to a log file.
When the -C flag is
used to modify the attributes for the console log type, the console log file
is also modified and the console device driver is updated to use the new
values. This is a deviation from the normal operation of alog
-C and is done to accommodate special formatting in the console log
file.
Note: You must have root user authority to change
alog attributes.
|
| -f LogFile
| Specifies the name of a log file. If the specified
LogFile does not exist, one is created. If the
alog command is unable to write to LogFile, it writes to
/dev/null. Use the -f LogFile flag
with the -C and -t flags to change the File
attribute for a LogType defined in the alog configuration
database.
|
| -L
| Lists the log types currently defined in the alog configuration
database. If you use the -L flag with the -t
LogType flag, the attributes for a specified LogType are
listed. The current values of the File, Size, and
Verbosity attributes are listed as colon separated values:
<File>:<Size>:<Verbosity>
If the -L flag is used,
the alog command does not copy standard input to standard output or
to File.
|
| -o
| Lists the contents of LogFile. Writes the contents of
LogFile to standard output in sequential order.
|
| -q
| Copies standard input to LogFile but does not write to
standard output.
|
| -s Size
| Specifies the LogFile size limit in bytes. The space
for LogFile is reserved when it is created. If you create a
new LogFile and do not specify the Size attribute, the
minimum LogFile size, 4096 bytes, is used. If
LogFile already exists, its size will be changed. The size
you specify is rounded upward to the next integral multiple of 4096
bytes. If you decrease the size of LogFile, the oldest
entries in the log are deleted if they do not fit within the new size
limit. You must have write permission for LogFile to change
its size.
Use the -s
Size flag with the -C and the -t flags to change
the Size attribute for LogType defined in the alog
configuration database. The new Size attribute value is used
the next time LogFile is created.
|
| -t LogType
| Identifies a log defined in the alog configuration database. The
alog command gets the log's file name and size from the alog
configuration database. If LogFile does not exist, one is
created.
If the alog command
cannot get the information for the specified LogType from the alog
configuration database or if the alog command is unable to write to
LogFile, it writes to /dev/null.
If you specify LogType
and LogFile using the -f flag, LogFile is
used and LogType is ignored.
|
| -V
| Writes the current value of the Verbosity attribute for
LogType that is defined in the alog configuration database to
standard output. If you do not specify LogType, or the
LogType you specify is not defined, nothing is written to standard
output.
The value output using the
alog command with the -t LogType and the
-V flags can be used by a command that is piping its output to the
alog command to control the verbosity of the data it writes to the
pipe.
|
| -w
Verbosity
| Changes the Verbosity attribute for LogType defined
in the alog configuration database when used with the -C and the
-t flags.
The Verbosity attribute
can have a value from 0 to 9. If the value is 0, no information is
copied to LogFile by the alog command. All of the
information is still written to standard output. If the value is not 0,
all of the information piped to the alog command's standard
input is copied to LogFile and to standard output.
|
- To record the current
date and time in a log file named sample.log, enter:
date | alog -f /tmp/sample.log
- To list the contents of
/tmp/sample.log log file, enter:
alog -f /tmp/sample.log -o
- To change the size of
the log file named /tmp/sample.log to 8192 bytes,
enter:
echo "resizing log file" | alog -f /tmp/sample.log -s 8192
- To add a new log type
sample to the alog configuration database, create the
alog.add file in the following format:
SWservAt:
attribute="alog_type"
deflt="sample"
value="sample"
SWservAt:
attribute="sample_logname"
deflt="/tmp/sample.log"
value="/tmp/sample.log"
SWservAt:
attribute="sample_logsize"
deflt="4096"
value="4096"
SWservAt:
attribute="sample_logverb"
deflt="1"
value="1"
After creating the
alog.add file, enter:
odmadd alog.add
This adds the
alog.add file to the SWservAt database.
- To change the name of
the log file for the log type sample to
/var/sample.log in the alog configuration database,
enter:
alog -C -t sample -f /var/sample.log