Lists information on server process or kernel trace logs
Synopsis
dfstrace lslog [{-set set_name... | -log log_name...}] [-long]
[-cdsentry server_entry_in_CDS]
[-help]
Options
-set set_name
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.
-log log_name
Specifies the name of each log that you want to list. Specify this option or the -set 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.
-long
Directs the dfstrace lslog command to also provide information on the size of each log in 4-kilobyte units (kwords) and whether the log is physically allocated
in the kernel.
-cdsentry server_entry_in_CDS
Specifies the full DCE path name (/.:/hosts/machine/process_name) of a server process whose logs you
want to list. Use the -set or -log option with this option to list specific server process logs; use this option without the -set or -log option to list all
logs associated with the server process. Omit this option to list kernel logs.
-help
Prints the online help for this command. All other valid options specified with this option are ignored.
Description
The dfstrace lslog command lists the specified server process or kernel trace logs. To display size and allocation information for the logs, run the
command with the -long option. If you want to list a kernel log, it must reside on the local machine. If you want to list a server process log, it can reside on any machine; however, you
must use the -cdsentry option to specify the appropriate server process.
To list a specific log, identify the log with the -set or -log option. Use the -cdsentry option to list a specific server process log, omit that option to list a specific kernel log.
To list all kernel logs on a machine, run the dfstrace lslog command without the -set or -log option. To list all server process logs associated with a particular server process, run the command with the -cdsentry option, but without the -set or -log option.
Privilege Required
To list a kernel log, the issuer must be logged in as root on the local machine. To list a server process log, the issuer must be listed in the
admin list associated with that process on the machine specified by the -cdsentry option (for example, admin.fl for the flserver process and admin.ft for
the ftserver process).
Output
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. There are two allocation states:
· allocated - Space is allocated for the log in the kernel or server process memory. This indicates that one or more of the event sets that write to this log are either active or inactive.
· unallocated - Space is not allocated for the log in the kernel or server process memory. This indicates that all of the event sets that write to this log are dormant.
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 dfstrace clear 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.
Examples
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 dewitt; it also provides the size and the allocation status of each log:
$ dfstrace lsl -long -cdsentry /.:/hosts/dewitt/flserver
Available logs:
ubikvote : 30 kwords (allocated)
common : 30 kwords (allocated)
Related Information
Commands: dfstrace lsset(8dfs)