fstrace lslog - Displays information about a log

fstrace lslog << [-set <set name+] >>> << [-log <log name] >>> [-long] [-help]

fstrace lsl << [-s <set name+] >>> << [-log <log name] >>> [-lon] [-h]

The fstrace lslog command reports whether the CWcmfx log is available for use. If the -long argument is included, the output reports the log's defined size, and whether that amount of space is currently allocated in kernel memory or not.

To change the CWcmfx trace log's size, use the fstrace setlog command. To display or set whether space is allocated for it in kernel memory, use the fstrace lsset or fstrace setset command to display or set the state of the corresponding CWcm event set, respectively.

Names the event set for which to display information about the corresponding trace log. The only acceptable value is CWcm (for which the associated trace log is CWcmfx). Provide either this argument or the -log argument, or omit both to display information about the CWcmfx log by default. Names the trace log about which to report. The only acceptable value is CWcmfx. Provide either this argument or the -set argument, or omit both to report on the CWcmfx log by default. Reports the defined size of the log in kilobyte units and whether that amount of space is currently allocated in kernel memory. 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, CWcmfx, in the following format:

   Available logs:
   cmfx

   Available logs:
   cmfx : <log_size> kbytes (allocated | unallocated)

The CWunallocated state indicates that no kernel memory is currently reserved for the CWcmfx trace log. The cm event set's state is CWdormant, as reported by the fstrace lsset command and set by the fstrace setset command's -dormant flag. If the event set's 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 CWcmfx log:

   # fstrace lslog -log cmfx -long
   Available logs:
   cmfx : 60 kbytes (allocated)

The issuer must be logged in as the local superuser CWroot.

the fstrace(8) manpage, the fstrace_lsset(8) manpage, the fstrace_setlog(8) manpage

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.