Commands Reference, Volume 3

locktrace Command

Purpose

Controls kernel lock tracing.

Syntax

locktrace [ -r ClassName | -s ClassName | -S | -R | -l ]

Description

The locktrace command controls which kernel locks are being traced by the trace subsystem. The default is to trace none. If the machine has been rebooted after running the bosboot -L command, kernel lock tracing can be turned on or off for one or more individual lock classes, or for all lock classes. If bosboot -L was not run, lock tracing can only be turned on for all locks or none. The trace events collected in this case when locks are taken or missed (hook id 112), and released (hook id 113) do not have the lock class name available.

Flags

-r classname	Turn off lock tracing for all the kernel locks belonging to the specified class. This option always fails if `bosboot -L` was not run.
-s classname	Turn on lock tracing for all the kernel locks belonging to the specified class. This option always fails if `bosboot -L` has not been executed.
-R	Turn off all lock tracing.
-S	Turn on lock tracing for all locks regardless of their class membership.
-l	List kernel lock tracing current status.

Examples

To start tracing the SEM_LOCK_CLASS, type:
```
locktrace -s SEM_LOCK_CLASS
```
To stop all lock tracing, type:
```
locktrace -R
```

File

/usr/bin/locktrace	Contains the locktrace command.
/usr/include/sys/lockname.h	Contains the lock class names.

Related Information

The bosboot command, and the trace command.