NAME

fstrace_lsset - Reports the status of an event set

SYNOPSIS

fstrace lsset [-set <set name>+] [-listevents] [-help]

DESCRIPTION

The fstrace lsset command displays a list of the available event sets and reports their current status (active, inactive, or dormant).

To change an event set's status, use the fstrace setset command.

OPTIONS

-set <set name>+

Names the event set for which to display the status. The only acceptable value is cm, which is also the default if this argument is omitted.

-listevents

Also print out a detailed list of the events enabled for this set.

By default this will be all currently defined events, but events can be enabled or disabled by using the fstrace_changeset(8) command.

-help

Prints the online help for this command. All other valid options are ignored.

OUTPUT

The output lists the available event sets and the status of each, in the following format:

   Available sets:
   cm (active | inactive | dormant)

where

active

Indicates that tracing is enabled for the event set, and kernel memory allocated for the corresponding trace log.

inactive

Indicates that tracing is temporarily disabled for the event set, but kernel memory still allocated for the corresponding trace log.

dormant

Indicates that tracing is disabled for the event set, and no kernel memory allocated for the corresponding trace log.

EXAMPLES

The following example displays the available event set and its status:

   # fstrace lsset
   Available sets:
   cm active

PRIVILEGE REQUIRED

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

SEE ALSO

fstrace(8), fstrace_changeset(8) fstrace_setset(8)

COPYRIGHT

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.

ACKNOWLEDGEMENTS

"AFS" is a registered mark of International Business Machines Corporation, used under license. (USPTO Registration 1598389)

"OpenAFS" is a registered mark of International Business Machines Corporation. (USPTO Registration 4577045)

The "AuriStor" name, log 'S' brand mark, and icon are registered marks of AuriStor, Inc. (USPTO Registrations 4849419, 4849421, and 4928460) (EUIPO Registration 015539653).

"Your File System" is a registered mark of AuriStor, Inc. (USPTO Registrations 4801402 and 4849418).

"YFS" and "AuriStor File System" are trademarks of AuriStor, Inc.