The dfstrace lslog command provides size and allocation information on specified trace logs. To list information about a trace log, do the following:
1. Verify that you have the necessary privilege. To list information about a kernel log, you must be logged in as root on the local machine. To list information about a server process log, you must be listed in the administrative list associated with that process on the corresponding machine; if necessary, issue the bos lsadmin command to check.
2. Issue the dfstrace lslog command to list information about each specified log:
$ dfstrace lslog [{-set set_name... | -log log_name...}] [-long]
[-cdsentry server_entry_in_CDS]
The -set set_name option specifies the name of each event set whose corresponding logs you want to list. Specify this option or the -log option; omit both to list all kernel logs on the local machine or all server process logs for the server process specified with the -cdsentry option.
The -long option directs the dfstrace lslog command to also provide information on the size of each log in kwords and whether the log is physically allocated in the kernel or server process memory.
When run without the -long option, the dfstrace lslog command lists the logs only. When run with the -long option, the command lists the logs, the size of each log in kwords, and the allocation state of each log.
A log can also be persistent; however, the persistence of a log cannot currently be determined using dfstrace commands. If a log is persistent, it cannot be cleared during a global log clearing (executed by issuing the dfstrace clear command without the -set or -log option). Of course, the log can still be cleared if it is otherwise named with the dfstrace clear command. The persistent attribute prevents accidental clearing of important logs. The attribute is assigned to a log when the kernel or server process is compiled and cannot be changed.
The following command lists all kernel logs on the local machine:
# dfstrace lsl
Available logs:
cmfx
DFS syslog
The following command lists all server process logs used by the flserver process on the machine named fs1; it also provides the size and the allocation status of each log.
$ dfstrace lsl -long -cdsentry /.:/hosts/fs1/flserver
Available logs:
ubikvote : 30 kwords (allocated)
common : 30 kwords (allocated)