3 # Copyright (C) - 2020 EfficiOS, inc
5 # This library is free software; you can redistribute it and/or modify it under
6 # the terms of the GNU Lesser General Public License as published by the Free
7 # Software Foundation; version 2.1 of the License.
9 # This library is distributed in the hope that it will be useful, but WITHOUT
10 # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
11 # FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
14 # You should have received a copy of the GNU Lesser General Public License
15 # along with this library; if not, write to the Free Software Foundation, Inc.,
16 # 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
18 # Test the `lttng list-trigger` command line interface.
20 CURDIR
="$(dirname "$0")"
21 TESTDIR
="$CURDIR/../../.."
23 # shellcheck source=../../../utils/utils.sh
24 source "$TESTDIR/utils/utils.sh"
29 FULL_LTTNG_BIN
="${TESTDIR}/../src/bin/lttng/${LTTNG_BIN}"
31 tmp_stdout
=$
(mktemp
-t test_list_triggers_cli_stdout.XXXXXX
)
32 tmp_stderr
=$
(mktemp
-t test_list_triggers_cli_stderr.XXXXXX
)
33 tmp_expected_stdout
=$
(mktemp
-t test_list_triggers_cli_expected_stdout.XXXXXX
)
34 uprobe_elf_binary
=$
(realpath
"${TESTDIR}/utils/testapp/userspace-probe-elf-binary/.libs/userspace-probe-elf-binary")
35 uprobe_sdt_binary
=$
(realpath
"${TESTDIR}/utils/testapp/userspace-probe-sdt-binary/.libs/userspace-probe-sdt-binary")
40 if [ "$uid" == "0" ]; then
42 ls "$uprobe_sdt_binary" >/dev
/null
2>&1
54 function list_triggers_matches_ok
()
57 local expected_stdout_file
="$2"
59 "${FULL_LTTNG_BIN}" list-triggers > "${tmp_stdout}" 2> "${tmp_stderr}"
60 ok $?
"${test_name}: exit code is 0"
62 diff -u "${expected_stdout_file}" "${tmp_stdout}"
63 ok $?
"${test_name}: expected stdout"
65 diff -u /dev
/null
"${tmp_stderr}"
66 ok $?
"${test_name}: expected stderr"
69 test_top_level_options
()
71 diag
"Listing top level options"
73 lttng_add_trigger_ok
"hello" --condition event-rule-matches
-u test-id
--action notify
75 cat > "${tmp_expected_stdout}" <<- EOF
78 condition: event rule hit
79 rule: test-id (type: tracepoint, domain: ust)
86 list_triggers_matches_ok
"top level options" "${tmp_expected_stdout}"
88 lttng_remove_trigger_ok
"hello"
91 test_on_event_tracepoint
()
93 diag
"Listing on-event tracepoint"
95 lttng_add_trigger_ok
"C" --condition event-rule-matches
-u -a --action notify
96 lttng_add_trigger_ok
"A" --condition event-rule-matches aaa
-u --filter 'p == 2' --action notify
97 lttng_add_trigger_ok
"D" --condition event-rule-matches
'hello*' -u -x 'hello2,hello3,hello4' --action notify
98 lttng_add_trigger_ok
"B" --condition event-rule-matches
-u gerboise
--loglevel INFO
--action notify
99 lttng_add_trigger_ok
"E" --condition event-rule-matches
-u lemming
--loglevel-only WARNING
--action notify
100 lttng_add_trigger_ok
"F" --condition event-rule-matches
-u capture-payload-field
--capture a
--action notify
101 lttng_add_trigger_ok
"G" --condition event-rule-matches
-u capture-array
--capture 'a[2]' --capture '$ctx.tourlou[18]' --action notify
102 lttng_add_trigger_ok
"H" --condition event-rule-matches
-u capture-chan-ctx
--capture '$ctx.vpid' --action notify
103 lttng_add_trigger_ok
"I" --condition event-rule-matches
-u capture-app-ctx
--capture '$app.iga:active_clients' --action notify
105 cat > "${tmp_expected_stdout}" <<- EOF
108 condition: event rule hit
109 rule: aaa (type: tracepoint, domain: ust, filter: p == 2)
116 condition: event rule hit
117 rule: gerboise (type: tracepoint, domain: ust, log level at least INFO)
124 condition: event rule hit
125 rule: * (type: tracepoint, domain: ust)
132 condition: event rule hit
133 rule: hello* (type: tracepoint, domain: ust, exclusions: hello2,hello3,hello4)
140 condition: event rule hit
141 rule: lemming (type: tracepoint, domain: ust, log level is WARNING)
148 condition: event rule hit
149 rule: capture-payload-field (type: tracepoint, domain: ust)
158 condition: event rule hit
159 rule: capture-array (type: tracepoint, domain: ust)
169 condition: event rule hit
170 rule: capture-chan-ctx (type: tracepoint, domain: ust)
179 condition: event rule hit
180 rule: capture-app-ctx (type: tracepoint, domain: ust)
182 - \$app.iga:active_clients
189 list_triggers_matches_ok
"event-rule-matches, tracepoint event rule" "${tmp_expected_stdout}"
191 lttng_remove_trigger_ok
"A"
192 lttng_remove_trigger_ok
"B"
193 lttng_remove_trigger_ok
"C"
194 lttng_remove_trigger_ok
"D"
195 lttng_remove_trigger_ok
"E"
196 lttng_remove_trigger_ok
"F"
197 lttng_remove_trigger_ok
"G"
198 lttng_remove_trigger_ok
"H"
199 lttng_remove_trigger_ok
"I"
202 test_on_event_probe
()
204 local channel_enable_addr
205 local channel_disable_addr
207 diag
"Listing on-event kernel probe"
209 channel_enable_addr
=$
(grep ' t lttng_channel_enable\s\[lttng_tracer\]$' /proc
/kallsyms | cut
-f 1 -d ' ')
210 channel_disable_addr
=$
(grep ' t lttng_channel_disable\s\[lttng_tracer\]$' /proc
/kallsyms | cut
-f 1 -d ' ')
212 # We need to find a valid offset.
215 if [[ 0x
$channel_enable_addr -lt 0x
$channel_disable_addr ]]; then
216 base_symbol
="lttng_channel_enable"
217 offset
=$
(( 0x
$channel_disable_addr - 0x
$channel_enable_addr ))
219 base_symbol
="lttng_channel_disable"
220 offset
=$
(( 0x
$channel_enable_addr - 0x
$channel_disable_addr ))
223 offset_hex
="0x$(printf '%x' $offset)"
225 lttng_add_trigger_ok
"T0" --condition event-rule-matches
-k --probe=lttng_channel_enable my_channel_enable
--action notify
226 lttng_add_trigger_ok
"T1" --condition event-rule-matches
-k --probe="${base_symbol}+${offset_hex}" my_channel_enable
--action notify
227 lttng_add_trigger_ok
"T2" --condition event-rule-matches
-k --probe="0x${channel_enable_addr}" my_channel_enable
--action notify
229 cat > "${tmp_expected_stdout}" <<- EOF
232 condition: event rule hit
233 rule: my_channel_enable (type: probe, location: lttng_channel_enable)
240 condition: event rule hit
241 rule: my_channel_enable (type: probe, location: ${base_symbol}+${offset_hex})
248 condition: event rule hit
249 rule: my_channel_enable (type: probe, location: 0x${channel_enable_addr})
256 list_triggers_matches_ok
"event-rule-matches, probe event rule" "${tmp_expected_stdout}"
258 lttng_remove_trigger_ok
"T0"
259 lttng_remove_trigger_ok
"T1"
260 lttng_remove_trigger_ok
"T2"
263 test_on_event_userspace_probe_elf
()
265 local elf_function_name
="test_function"
267 diag
"Listing on-event userspace-probe elf"
269 lttng_add_trigger_ok
"T0" --condition event-rule-matches
-k --userspace-probe=${uprobe_elf_binary}:test_function ma-probe-elf
--action notify
271 cat > "${tmp_expected_stdout}" <<- EOF
274 condition: event rule hit
275 rule: ma-probe-elf (type: userspace probe, location type: ELF, location: ${uprobe_elf_binary}:${elf_function_name})
282 list_triggers_matches_ok
"event-rule-matches, userspace-probe event rule" "${tmp_expected_stdout}"
284 lttng_remove_trigger_ok
"T0"
287 test_on_event_userspace_probe_sdt
()
289 local sdt_provider_name
="foobar"
290 local sdt_probe_name
="tp1"
292 diag
"on-event userspace-probe sdt"
294 lttng_add_trigger_ok
"T0" --condition on-event
-k --userspace-probe=sdt
:${uprobe_sdt_binary}:${sdt_provider_name}:${sdt_probe_name} ma-probe-sdt
--action notify
296 cat > "${tmp_expected_stdout}" <<- EOF
299 condition: event rule hit
300 rule: ma-probe-sdt (type: userspace probe, location type: SDT, location: ${uprobe_sdt_binary}:${sdt_provider_name}:${sdt_probe_name})
307 list_triggers_matches_ok
"on-event, userspace-probe event rule SDT" "${tmp_expected_stdout}"
309 lttng_remove_trigger_ok
"T0"
312 test_on_event_syscall
()
314 diag
"Listing on-event syscall"
316 lttng_add_trigger_ok
"T0" --condition event-rule-matches
-k --syscall open
--action notify
317 lttng_add_trigger_ok
"T1" --condition event-rule-matches
-k --syscall ptrace
--filter 'a > 2' --action notify
319 cat > "${tmp_expected_stdout}" <<- EOF
322 condition: event rule hit
323 rule: open (type: syscall)
330 condition: event rule hit
331 rule: ptrace (type: syscall, filter: a > 2)
338 list_triggers_matches_ok
"event-rule-matches, syscall event rule" "${tmp_expected_stdout}"
340 lttng_remove_trigger_ok
"T0"
341 lttng_remove_trigger_ok
"T1"
344 test_snapshot_action
()
346 diag
"Listing snapshot actions"
348 lttng_add_trigger_ok
"T0" --condition event-rule-matches
-u some-event
--action snapshot-session ze-session
349 lttng_add_trigger_ok
"T1" --condition event-rule-matches
-u some-event
--action snapshot-session ze-session
--path /some
/path
350 lttng_add_trigger_ok
"T2" --condition event-rule-matches
-u some-event
--action snapshot-session ze-session
--url file:///some
/other
/path
351 lttng_add_trigger_ok
"T3" --condition event-rule-matches
-u some-event
--action snapshot-session ze-session
--url net
://1.2.3.4
352 lttng_add_trigger_ok
"T4" --condition event-rule-matches
-u some-event
--action snapshot-session ze-session
--url net
://1.2.3.4:1234:1235
353 lttng_add_trigger_ok
"T5" --condition event-rule-matches
-u some-event
--action snapshot-session ze-session
--ctrl-url=tcp
://1.2.3.4:1111 --data-url=tcp
://1.2.3.4:1112
354 lttng_add_trigger_ok
"T6" --condition event-rule-matches
-u some-event
--action snapshot-session ze-session
--path /some
/path
--max-size=1234
355 lttng_add_trigger_ok
"T7" --condition event-rule-matches
-u some-event
--action snapshot-session ze-session
--path /some
/path
--name=meh
356 lttng_add_trigger_ok
"T8" --condition event-rule-matches
-u some-event
--action snapshot-session ze-session
--rate-policy=every
:10
357 lttng_add_trigger_ok
"T9" --condition event-rule-matches
-u some-event
--action snapshot-session ze-session
--rate-policy=once-after
:10
359 cat > "${tmp_expected_stdout}" <<- EOF
362 condition: event rule hit
363 rule: some-event (type: tracepoint, domain: ust)
365 snapshot session \`ze-session\`
370 condition: event rule hit
371 rule: some-event (type: tracepoint, domain: ust)
373 snapshot session \`ze-session\`, path: /some/path
378 condition: event rule hit
379 rule: some-event (type: tracepoint, domain: ust)
381 snapshot session \`ze-session\`, path: /some/other/path
386 condition: event rule hit
387 rule: some-event (type: tracepoint, domain: ust)
389 snapshot session \`ze-session\`, url: net://1.2.3.4
394 condition: event rule hit
395 rule: some-event (type: tracepoint, domain: ust)
397 snapshot session \`ze-session\`, url: net://1.2.3.4:1234:1235
402 condition: event rule hit
403 rule: some-event (type: tracepoint, domain: ust)
405 snapshot session \`ze-session\`, control url: tcp://1.2.3.4:1111, data url: tcp://1.2.3.4:1112
410 condition: event rule hit
411 rule: some-event (type: tracepoint, domain: ust)
413 snapshot session \`ze-session\`, path: /some/path, max size: 1234
418 condition: event rule hit
419 rule: some-event (type: tracepoint, domain: ust)
421 snapshot session \`ze-session\`, path: /some/path, name: meh
426 condition: event rule hit
427 rule: some-event (type: tracepoint, domain: ust)
429 snapshot session \`ze-session\`, rate policy: after every 10 occurrences
434 condition: event rule hit
435 rule: some-event (type: tracepoint, domain: ust)
437 snapshot session \`ze-session\`, rate policy: once after 10 occurrences
442 list_triggers_matches_ok
"snapshot action" "${tmp_expected_stdout}"
444 lttng_remove_trigger_ok
"T0"
445 lttng_remove_trigger_ok
"T1"
446 lttng_remove_trigger_ok
"T2"
447 lttng_remove_trigger_ok
"T3"
448 lttng_remove_trigger_ok
"T4"
449 lttng_remove_trigger_ok
"T5"
450 lttng_remove_trigger_ok
"T6"
451 lttng_remove_trigger_ok
"T7"
452 lttng_remove_trigger_ok
"T8"
453 lttng_remove_trigger_ok
"T9"
456 test_notify_action
()
458 lttng_add_trigger_ok
"T0" --condition event-rule-matches
-u some-event
--action notify
--rate-policy=once-after
:5
459 lttng_add_trigger_ok
"T1" --condition event-rule-matches
-u some-event
--action notify
--rate-policy=every
:10
461 cat > "${tmp_expected_stdout}" <<- EOF
464 condition: event rule hit
465 rule: some-event (type: tracepoint, domain: ust)
467 notify, rate policy: once after 5 occurrences
472 condition: event rule hit
473 rule: some-event (type: tracepoint, domain: ust)
475 notify, rate policy: after every 10 occurrences
480 list_triggers_matches_ok
"snapshot action" "${tmp_expected_stdout}"
482 lttng_remove_trigger_ok
"T0"
483 lttng_remove_trigger_ok
"T1"
486 plan_tests
$NUM_TESTS
488 # shellcheck disable=SC2119
489 start_lttng_sessiond_notap
491 test_top_level_options
492 test_on_event_tracepoint
493 skip
$ist_root "non-root user: skipping kprobe tests" 9 || test_on_event_probe
494 skip
$ist_root "non-root user: skipping userspace probe elf tests" 5 || test_on_event_userspace_probe_elf
495 skip $
(($ist_root && $hast_sdt_binary)) "skipping userspace probe SDT tests" 5 || test_on_event_userspace_probe_sdt
496 skip
$ist_root "non-root user: skipping syscall tests" 7 || test_on_event_syscall
500 stop_lttng_sessiond_notap
503 rm -f "${tmp_stdout}"
504 rm -f "${tmp_stderr}"
505 rm -f "${tmp_expected_stdout}"