|-set <set name>+||Names the event set for which to display information about the corresponding trace log. The only acceptable value is cm (for which the associated trace log is cmfx). Provide either this argument or the -log argument, or omit both to display information about the cmfx log by default.|
|-log <log name>||Names the trace log about which to report. The only acceptable value is cmfx. Provide either this argument or the -set argument, or omit both to report on the cmfx log by default.|
|-long||Reports the defined size of the log in kilobyte units and whether that amount of space is currently allocated in kernel memory.|
|-help||Prints the online help for this command. All other valid options are ignored.|
By default, the fstrace lslog command displays only the name of the available log, cmfx, in the following format:
Available logs: cmfx
When the -long flag is included, the output also reports the defined size of the log in kilobytes, and whether or not that amount of space is currently allocated in kernel memory, in the following format:
Available logs: cmfx : <log_size> kbytes (allocated | unallocated)
The allocated state indicates that the indicated number of kilobytes is reserved for the cmfx trace log in kernel memory. The cm event sets state is either active or inactive, as reported by the fstrace lsset command, and set by the fstrace setset commands -active or -inactive flags respectively.
The unallocated state indicates that no kernel memory is currently reserved for the cmfx trace log. The cm event sets state is dormant, as reported by the fstrace lsset command and set by the fstrace setset commands -dormant flag. If the event sets state is later changed to active or inactive, the number of kilobytes indicated as <log_size> are again allocated in kernel memory.
The following example uses the -long flag to display information about the cmfx log:
# fstrace lslog -log cmfx -long Available logs: cmfx : 60 kbytes (allocated)
The issuer must be logged in as the local superuser root.
fstrace(8), fstrace_lsset(8), fstrace_setlog(8)
IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
This documentation is covered by the IBM Public License Version 1.0. It was converted from HTML to POD by software written by Chas Williams and Russ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.