Listing Information about Event Sets

The dfstrace lsset command provides state and persistence information on specified event sets. To list information about event sets, do the following:

1. Verify that you have the necessary privilege. To list information about a kernel event set, you must be logged in as root on the local machine. To list information about a server process event set, 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 lsset command to list information about each specified event set:

$ dfstrace lsset [-set set_name...] [-cdsentry server_entry_in_CDS]

The -set set_name option specifies the name of each event set you want to list. Omit this option to list all kernel event sets on the local machine or all server process event sets for the server process specified with the -cdsentry option.

The command lists each event set and its state; if the event set is persistent, the word persistent appears after the state. If an event set is persistent, its state cannot be set during a global state setting (executed by issuing the dfstrace setset command with the -set option). Of course, the event set's state can still be set if the event set is otherwise specified with the dfstrace setset command. The persistent attribute prevents accidental resetting of an event set's state. The attribute is assigned to an event set when the kernel or server process is compiled and it cannot be changed.

The following command lists all kernel event sets and their states on the local machine:

# dfstrace lss

Available sets:

cm: active

fx: active

fshost: active

xops: active

episode/anode: dormant

episode/logbuf: dormant

episode/vnops: dormant

tkc: inactive

tpq: active

tkm: active

The following command lists state information on the event set ubikvote for the flserver process on the machine named fs1:

$ dfstrace lss -set ubikvote -cdsentry /.:/hosts/fs1/flserver

ubikvote: active