tailspin(1) | General Commands Manual | tailspin(1) |
tailspin
—
configure, save and print tailspin output
tailspin
info
tailspin
enable
tailspin
disable
tailspin
set buffer-size
buffer-size-mbktrace-filter-descriptor
(add:|remove:)filter-desc
oncore-sampling-period
period-in-ns|disabled
full-system-sampling-period
period-in-ns|disabled
sampling-option
(add:|remove:)optionstailspin
reset
[buffer-size-mb|ktrace-filter-descriptor|oncore-sampling-period|full-system-sampling-period]tailspin
save
-r
reason-string]
[-l
num-seconds]
[-n
] path-to-filetailspin
augment
-s
] [-d
]
[-a
] [-l
]
[-L
path-to-log-archive]
path-to-filetailspin
stat
-v
] [-s
]
path-to-filetailspin
configures the system to
continuously sample callstacks of processes and select kdebug events in the
kernel trace buffer. When tailspin data is recorded to a file, the tailspin
file will contain information about the system state from about 20s prior to
the save. The tailspind daemon is a helper daemon for the tailspin feature
and should not be run manually.
tailspin data can be collected using the keychord when enabled: Shift-Control-Option-Command-Comma. When the command is completed, a Finder window will pop up with the saved tailspin file.
tailspin
uses a subcommand syntax to
separate different functionality into logical groups. Each subcommand takes
its own set of options.
info
enable
disable
set
buffer-size
buffer-size-mbktrace-filter-descriptor
(add:|remove:)filter-desconcore-sampling-period
period-in-nsfull-system-sampling-period
period-in-nssampling-option
(add:|remove:)optionsreset
[buffer-size-mb|ktrace-filter-descriptor|oncore-sampling-period|full-system-sampling-period]save
[-r
reason-string]
[-l
num-seconds]
[-n
] [path-to-file]Save the current contents of the kernel trace buffer containing tailspin data to path-to-file.
augment
[-d
] [-s
]
[-l
] [-L
-path-to-log-archive
] path-to-filestat
[-v
] [-s
]
path-to-fileA filter description is a comma-separated list of class and
subclass specifiers that indicate which events should be traced. A class
specifier starts with ‘C
’ followed by
a number between 0 and 255 inclusive, specified in either decimal or hex
(when prepended with "0x"). A subclass specifier starts with
‘S
’ and takes two bytes. The high byte
is the class and the low byte is the subclass of that class.
For example, this filter description would enable classes 0x1 and
0x25 and the subclasses 0x21 and 0x23 of class 0x5:
‘C1,C0x25,S0x0521,S0x0523
’. The
‘ALL
’ filter description enables
events from all classes.
Sampling options are specified via a comma-separated list of
recognized names that indicate what sampling should be enabled/disabled. The
names that are recognized are:
‘cswitch-sampling
’ and
‘syscall-sampling
’
tailspin data can be viewed by ktrace(1), spindump(8) and fs_usage(1).
The tailspin
utility exits 0 on
success, and >0 if an error occurs.
22 June 2016 | Darwin |