Go to main content

マニュアルページ セクション 1: ユーザーコマンド

印刷ビューの終了

更新: 2022年7月27日
 
 

stackdiag (1)

名前

stackdiag - libstackdiag CLI for manual bug queries

形式

/usr/bin/stackdiag [-l] [-n max-results] [-d stackDB-path]
     [-s] stack-resource

説明

stackdiag queries the stackDB database of known bugs by using libstackdiag and displays potential bugs (Oracle CRs). It takes a standardized string representation of a thread stack as input from a file, standard input, or as an operand.

The operand stack-resource tells stackdiag where to get the stack string from. If given a file path, the file is opened and its contents are assumed to be a stack string. If given "-", stackdiag reads the stack string from standard input until the EOF. If –s option is passed, stackdiag treats the operand itself as the stack string.

The stack string format is a sequence of frames, separated by a pipe character, where each frame looks like:

[module:]function[+offset][(arguments)]

This is a representation of a thread stack frame with module, function name, instruction offset, and function arguments as components. The module, offset, and argument parts are optional.

The argument part is a list of comma-separated hexadecimal integers representing pointers or integers passed, enclosed in a pair of parenthesis. Offset should be a hexadecimal number, with an optional 0x prefix. Whitespace is ignored everywhere. The last pipe in the stack string is optional.

オプション

The following options are supported:

–n max results

The number following the –n option specifies the maximum number of potential bugs to output. The default is 5.

–d stackDB-path

The operand following the –d option specifies the location of the stackDB database file which stackdiag should use as the database to query. Default is /var/db/stackDB/stackDB.

–s

If passed, the operand stack-resource is assumed to be the stack string. Useful for manually entering stacks on the command line.

–l

Displays all results. Results are organized in groups if they are similar enough. By default, stackdiag only prints one result in each group.

オペランド

The following operand is supported:

stack-resource

Path to the file containing the stack string. If "-", then standard input is used. If –s option is passed, then the operand is taken as the stack string.

終了ステータス

0

Successful execution.

>0

An error occurred.

使用例 1 Querying for bugs with the stack string Containing the Symbols "kadmin" and "uadmin", and Report a Maximum of 3 bugs
$ stackdiag -n 3 -s "kadmin | uadmin"
使用例 2 Querying for bugs by Using a Different Stack Database, and the stack String Being Present in a File
$ stackdiag -d ./mystackDB ./panicstack.txt

属性

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
system/fault-management/fault-management-utilities
CSI
Enabled
Interface Stability
Uncommitted
Standard
None

関連項目

asr-notify(8), fmadm(8), smtp-notify(8), snmp-notify(8)