1*4882a593Smuzhiyunperf-lock(1) 2*4882a593Smuzhiyun============ 3*4882a593Smuzhiyun 4*4882a593SmuzhiyunNAME 5*4882a593Smuzhiyun---- 6*4882a593Smuzhiyunperf-lock - Analyze lock events 7*4882a593Smuzhiyun 8*4882a593SmuzhiyunSYNOPSIS 9*4882a593Smuzhiyun-------- 10*4882a593Smuzhiyun[verse] 11*4882a593Smuzhiyun'perf lock' {record|report|script|info} 12*4882a593Smuzhiyun 13*4882a593SmuzhiyunDESCRIPTION 14*4882a593Smuzhiyun----------- 15*4882a593SmuzhiyunYou can analyze various lock behaviours 16*4882a593Smuzhiyunand statistics with this 'perf lock' command. 17*4882a593Smuzhiyun 18*4882a593Smuzhiyun 'perf lock record <command>' records lock events 19*4882a593Smuzhiyun between start and end <command>. And this command 20*4882a593Smuzhiyun produces the file "perf.data" which contains tracing 21*4882a593Smuzhiyun results of lock events. 22*4882a593Smuzhiyun 23*4882a593Smuzhiyun 'perf lock report' reports statistical data. 24*4882a593Smuzhiyun 25*4882a593Smuzhiyun 'perf lock script' shows raw lock events. 26*4882a593Smuzhiyun 27*4882a593Smuzhiyun 'perf lock info' shows metadata like threads or addresses 28*4882a593Smuzhiyun of lock instances. 29*4882a593Smuzhiyun 30*4882a593SmuzhiyunCOMMON OPTIONS 31*4882a593Smuzhiyun-------------- 32*4882a593Smuzhiyun 33*4882a593Smuzhiyun-i:: 34*4882a593Smuzhiyun--input=<file>:: 35*4882a593Smuzhiyun Input file name. (default: perf.data unless stdin is a fifo) 36*4882a593Smuzhiyun 37*4882a593Smuzhiyun-v:: 38*4882a593Smuzhiyun--verbose:: 39*4882a593Smuzhiyun Be more verbose (show symbol address, etc). 40*4882a593Smuzhiyun 41*4882a593Smuzhiyun-D:: 42*4882a593Smuzhiyun--dump-raw-trace:: 43*4882a593Smuzhiyun Dump raw trace in ASCII. 44*4882a593Smuzhiyun 45*4882a593Smuzhiyun-f:: 46*4882a593Smuzhiyun--force:: 47*4882a593Smuzhiyun Don't complan, do it. 48*4882a593Smuzhiyun 49*4882a593SmuzhiyunREPORT OPTIONS 50*4882a593Smuzhiyun-------------- 51*4882a593Smuzhiyun 52*4882a593Smuzhiyun-k:: 53*4882a593Smuzhiyun--key=<value>:: 54*4882a593Smuzhiyun Sorting key. Possible values: acquired (default), contended, 55*4882a593Smuzhiyun avg_wait, wait_total, wait_max, wait_min. 56*4882a593Smuzhiyun 57*4882a593SmuzhiyunINFO OPTIONS 58*4882a593Smuzhiyun------------ 59*4882a593Smuzhiyun 60*4882a593Smuzhiyun-t:: 61*4882a593Smuzhiyun--threads:: 62*4882a593Smuzhiyun dump thread list in perf.data 63*4882a593Smuzhiyun 64*4882a593Smuzhiyun-m:: 65*4882a593Smuzhiyun--map:: 66*4882a593Smuzhiyun dump map of lock instances (address:name table) 67*4882a593Smuzhiyun 68*4882a593SmuzhiyunSEE ALSO 69*4882a593Smuzhiyun-------- 70*4882a593Smuzhiyunlinkperf:perf[1] 71