← Back to branch summary

~ubuntu-branches/debian/wheezy/linux-2.6/wheezy

« back to all changes in this revision

Viewing changes to tools/perf/Documentation/perf-probe.txt

  • Committer: Bazaar Package Importer
  • Author(s): Ben Hutchings, Ben Hutchings, Aurelien Jarno
  • Date: 2011-06-07 12:14:05 UTC
  • mfrom: (43.1.9 sid)
  • Revision ID: james.westby@ubuntu.com-20110607121405-i3h1rd7nrnd2b73h
Tags: 2.6.39-2
http://bugs.debian.org/627492
http://bugs.debian.org/596626
http://bugs.debian.org/628932
http://bugs.debian.org/628191
http://bugs.debian.org/627837
http://bugs.debian.org/622997
http://bugs.debian.org/622745
http://bugs.debian.org/619827
http://bugs.debian.org/629401
[ Ben Hutchings ]
* [x86] Enable BACKLIGHT_APPLE, replacing BACKLIGHT_MBP_NVIDIA
  (Closes: #627492)
* cgroups: Disable memory resource controller by default. Allow it
  to be enabled using kernel parameter 'cgroup_enable=memory'.
* rt2800usb: Enable support for more USB devices including
  Linksys WUSB600N (Closes: #596626) (this change was accidentally
  omitted from 2.6.39-1)
* [x86] Remove Celeron from list of processors supporting PAE. Most
  'Celeron M' models do not.
* Update debconf template translations:
  - Swedish (Martin Bagge) (Closes: #628932)
  - French (David Prévot) (Closes: #628191)
* aufs: Update for 2.6.39 (Closes: #627837)
* Add stable 2.6.39.1, including:
  - ext4: dont set PageUptodate in ext4_end_bio()
  - pata_cmd64x: fix boot crash on parisc (Closes: #622997, #622745)
  - ext3: Fix fs corruption when make_indexed_dir() fails
  - netfilter: nf_ct_sip: validate Content-Length in TCP SIP messages
  - sctp: fix race between sctp_bind_addr_free() and
    sctp_bind_addr_conflict()
  - sctp: fix memory leak of the ASCONF queue when free asoc
  - md/bitmap: fix saving of events_cleared and other state
  - cdc_acm: Fix oops when Droids MuIn LCD is connected
  - cx88: Fix conversion from BKL to fine-grained locks (Closes: #619827)
  - keys: Set cred->user_ns in key_replace_session_keyring (CVE-2011-2184)
  - tmpfs: fix race between truncate and writepage
  - nfs41: Correct offset for LAYOUTCOMMIT
  - xen/mmu: fix a race window causing leave_mm BUG()
  - ext4: fix possible use-after-free in ext4_remove_li_request()
  For the complete list of changes, see:
   http://www.kernel.org/pub/linux/kernel/v2.6/ChangeLog-2.6.39.1
* Bump ABI to 2
* netfilter: Enable IP_SET, IP_SET_BITMAP_IP, IP_SET_BITMAP_IPMAC,
  IP_SET_BITMAP_PORT, IP_SET_HASH_IP, IP_SET_HASH_IPPORT,
  IP_SET_HASH_IPPORTIP, IP_SET_HASH_IPPORTNET, IP_SET_HASH_NET,
  IP_SET_HASH_NETPORT, IP_SET_LIST_SET, NETFILTER_XT_SET as modules
  (Closes: #629401)

[ Aurelien Jarno ]
* [mipsel/loongson-2f] Disable_SCSI_LPFC to workaround GCC ICE.

Show diffs side-by-side

added added

removed removed

Lines of Context:
tools/perf/Documentation/perf-probe.txt
16
16
or
17
17
'perf probe' --list
18
18
or
19
 
'perf probe' [options] --line='FUNC[:RLN[+NUM|:RLN2]]|SRC:ALN[+NUM|:ALN2]'
 
19
'perf probe' [options] --line='LINE'
20
20
or
21
21
'perf probe' [options] --vars='PROBEPOINT'
22
22
 
73
73
        (Only for --vars) Show external defined variables in addition to local
74
74
        variables.
75
75
 
 
76
-F::
 
77
--funcs::
 
78
        Show available functions in given module or kernel.
 
79
 
 
80
--filter=FILTER::
 
81
        (Only for --vars and --funcs) Set filter. FILTER is a combination of glob
 
82
        pattern, see FILTER PATTERN for detail.
 
83
        Default FILTER is "!__k???tab_* & !__crc_*" for --vars, and "!_*"
 
84
        for --funcs.
 
85
        If several filters are specified, only the last filter is used.
 
86
 
76
87
-f::
77
88
--force::
78
89
        Forcibly add events with existing name.
117
128
-----------
118
129
Line range is described by following syntax.
119
130
 
120
 
 "FUNC[:RLN[+NUM|-RLN2]]|SRC[:ALN[+NUM|-ALN2]]"
 
131
 "FUNC[@SRC][:RLN[+NUM|-RLN2]]|SRC[:ALN[+NUM|-ALN2]]"
121
132
 
122
133
FUNC specifies the function name of showing lines. 'RLN' is the start line
123
134
number from function entry line, and 'RLN2' is the end line number. As same as
124
135
probe syntax, 'SRC' means the source file path, 'ALN' is start line number,
125
136
and 'ALN2' is end line number in the file. It is also possible to specify how
126
 
many lines to show by using 'NUM'.
 
137
many lines to show by using 'NUM'. Moreover, 'FUNC@SRC' combination is good
 
138
for searching a specific function when several functions share same name.
127
139
So, "source.c:100-120" shows lines between 100th to l20th in source.c file. And "func:10+20" shows 20 lines from 10th line of func function.
128
140
 
129
141
LAZY MATCHING
135
147
 
136
148
This provides some sort of flexibility and robustness to probe point definitions against minor code changes. For example, actual 10th line of schedule() can be moved easily by modifying schedule(), but the same line matching 'rq=cpu_rq*' may still exist in the function.)
137
149
 
 
150
FILTER PATTERN
 
151
--------------
 
152
 The filter pattern is a glob matching pattern(s) to filter variables.
 
153
 In addition, you can use "!" for specifying filter-out rule. You also can give several rules combined with "&" or "|", and fold those rules as one rule by using "(" ")".
 
154
 
 
155
e.g.
 
156
 With --filter "foo* | bar*", perf probe -V shows variables which start with "foo" or "bar".
 
157
 With --filter "!foo* & *bar", perf probe -V shows variables which don't start with "foo" and end with "bar", like "fizzbar". But "foobar" is filtered out.
138
158
 
139
159
EXAMPLES
140
160
--------