3 # Copyright (C) - 2012 David Goulet <dgoulet@efficios.com>
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 SESSIOND_BIN
="lttng-sessiond"
19 CONSUMERD_BIN
="lttng-consumerd"
20 RELAYD_BIN
="lttng-relayd"
22 BABELTRACE_BIN
="babeltrace"
23 OUTPUT_DEST
=/dev
/null
2>&1
25 # Minimal kernel version supported for session daemon tests
26 KERNEL_MAJOR_VERSION
=2
27 KERNEL_MINOR_VERSION
=6
28 KERNEL_PATCHLEVEL_VERSION
=27
30 # We set the default UST register timeout to "wait forever", so that
31 # basic tests don't have to worry about hitting timeouts on busy
32 # systems. Specialized tests should test those corner-cases.
33 export LTTNG_UST_REGISTER_TIMEOUT
=-1
35 source $TESTDIR/utils
/tap
/tap.sh
39 # Check if we are a terminal
41 echo -e "\e[1;32mOK\e[0m"
47 function print_fail
()
49 # Check if we are a terminal
51 echo -e "\e[1;31mFAIL\e[0m"
57 function print_test_banner
()
63 function validate_kernel_version
()
65 local kern_version
=($
(uname
-r |
awk -F.
'{ printf("%d.%d.%d\n",$1,$2,$3); }' |
tr '.' '\n'))
66 if [ ${kern_version[0]} -gt $KERNEL_MAJOR_VERSION ]; then
69 if [ ${kern_version[1]} -gt $KERNEL_MINOR_VERSION ]; then
72 if [ ${kern_version[2]} -ge $KERNEL_PATCHLEVEL_VERSION ]; then
78 # Generate a random string
79 # $1 = number of characters; defaults to 16
80 # $2 = include special characters; 1 = yes, 0 = no; defaults to yes
83 [ "$2" == "0" ] && CHAR
="[:alnum:]" || CHAR
="[:graph:]"
84 cat /dev
/urandom |
tr -cd "$CHAR" |
head -c ${1:-16}
88 function lttng_enable_kernel_event
94 if [ -z $event_name ]; then
95 # Enable all event if no event name specified
99 if [ -z $channel_name ]; then
100 # default channel if none specified
103 chan
="-c $channel_name"
106 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN enable-event
"$event_name" $chan -s $sess_name -k >$OUTPUT_DEST
107 ok $?
"Enable kernel event $event_name for session $sess_name"
110 function lttng_enable_kernel_syscall
()
112 local expected_to_fail
=$1
114 local syscall_name
=$3
115 local channel_name
=$4
117 if [ -z $syscall_name ]; then
118 # Enable all event if no syscall name specified
122 if [ -z $channel_name ]; then
123 # default channel if none specified
126 chan
="-c $channel_name"
129 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN enable-event
--syscall "$syscall_name" $chan -s $sess_name -k >$OUTPUT_DEST
131 if [[ $expected_to_fail -eq "1" ]]; then
133 ok $?
"Enable kernel syscall $syscall_name for session $sess_name on channel $channel_name fail as expected"
135 ok
$ret "Enable kernel syscall $syscall_name for session $sess_name on channel $channel_name"
139 function lttng_enable_kernel_syscall_ok
()
141 lttng_enable_kernel_syscall
0 ${*}
144 function lttng_enable_kernel_syscall_fail
()
146 lttng_enable_kernel_syscall
1 ${*}
149 function lttng_disable_kernel_syscall
()
151 local expected_to_fail
=$1
153 local syscall_name
=$3
154 local channel_name
=$4
156 if [ -z $syscall_name ]; then
157 # Enable all event if no syscall name specified
161 if [ -z $channel_name ]; then
162 # default channel if none specified
165 chan
="-c $channel_name"
168 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN disable-event
--syscall "$syscall_name" $chan -s $sess_name -k >$OUTPUT_DEST
171 if [[ $expected_to_fail -eq "1" ]]; then
173 ok $?
"Disable kernel syscall $syscall_name for session $sess_name on channel $channel_name fail as expected"
175 ok
$ret "Disable kernel syscall $syscall_name for session $sess_name on channel $channel_name"
179 function lttng_disable_kernel_syscall_ok
()
181 lttng_disable_kernel_syscall
0 ${*}
184 function lttng_disable_kernel_syscall_fail
()
186 lttng_disable_kernel_syscall
1 ${*}
189 function lttng_enable_kernel_channel
()
191 local expected_to_fail
=$1
193 local channel_name
=$3
195 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN enable-channel
-k $channel_name -s $sess_name >$OUTPUT_DEST
197 if [[ $expected_to_fail -eq "1" ]]; then
199 ok $?
"Expected failure on kernel channel creation $channel_name in $sess_name"
201 ok
$ret "Enable channel $channel_name for session $sess_name"
205 function lttng_enable_kernel_channel_ok
()
207 lttng_enable_kernel_channel
0 ${*}
210 function lttng_enable_kernel_channel_fail
()
212 lttng_enable_kernel_channel
1 ${*}
215 function lttng_disable_kernel_channel
()
217 local expected_to_fail
=$1
219 local channel_name
=$3
221 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN disable-channel
-k $channel_name -s $sess_name >$OUTPUT_DEST
223 if [[ $expected_to_fail -eq "1" ]]; then
225 ok $?
"Expected failure on kernel channel creation $channel_name in $sess_name"
227 ok
$ret "disable channel $channel_name for session $sess_name"
231 function lttng_disable_kernel_channel_ok
()
233 lttng_disable_kernel_channel
0 ${*}
236 function lttng_disable_kernel_channel_fail
()
238 lttng_disable_kernel_channel
1 ${*}
241 function start_lttng_relayd
245 DIR
=$
(readlink
-f $TESTDIR)
247 if [ -z $
(pidof lt-
$RELAYD_BIN) ]; then
248 $DIR/..
/src
/bin
/lttng-relayd
/$RELAYD_BIN -b $opt >$OUTPUT_DEST
249 #$DIR/../src/bin/lttng-relayd/$RELAYD_BIN $opt -vvv >>/tmp/relayd.log 2>&1 &
250 if [ $?
-eq 1 ]; then
251 fail
"Start lttng-relayd (opt: $opt)"
254 pass
"Start lttng-relayd (opt: $opt)"
257 pass
"Start lttng-relayd (opt: $opt)"
261 function stop_lttng_relayd_nocheck
263 PID_RELAYD
=`pidof lt-$RELAYD_BIN`
265 diag
"Killing lttng-relayd (pid: $PID_RELAYD)"
266 kill $PID_RELAYD >$OUTPUT_DEST
269 if [ $retval -eq 1 ]; then
271 while [ -n "$out" ]; do
272 out
=$
(pidof lt-
$RELAYD_BIN)
279 function stop_lttng_relayd
281 stop_lttng_relayd_nocheck
283 if [ $?
-eq 1 ]; then
284 fail
"Killed lttng-relayd (pid: $PID_RELAYD)"
287 pass
"Killed lttng-relayd (pid: $PID_RELAYD)"
292 #First argument: load path for automatic loading
293 function start_lttng_sessiond
()
297 if [ -n $TEST_NO_SESSIOND ] && [ "$TEST_NO_SESSIOND" == "1" ]; then
298 # Env variable requested no session daemon
302 validate_kernel_version
303 if [ $?
-ne 0 ]; then
304 fail
"Start session daemon"
305 BAIL_OUT
"*** Kernel too old for session daemon tests ***"
308 DIR
=$
(readlink
-f $TESTDIR)
309 : ${LTTNG_SESSION_CONFIG_XSD_PATH=${DIR}/../src/common/config/}
310 export LTTNG_SESSION_CONFIG_XSD_PATH
312 if [ -z $
(pidof lt-
$SESSIOND_BIN) ]; then
315 $DIR/..
/src
/bin
/lttng-sessiond
/$SESSIOND_BIN --load "$1" --background --consumerd32-path="$DIR/../src/bin/lttng-consumerd/lttng-consumerd" --consumerd64-path="$DIR/../src/bin/lttng-consumerd/lttng-consumerd"
317 $DIR/..
/src
/bin
/lttng-sessiond
/$SESSIOND_BIN --background --consumerd32-path="$DIR/../src/bin/lttng-consumerd/lttng-consumerd" --consumerd64-path="$DIR/../src/bin/lttng-consumerd/lttng-consumerd"
319 #$DIR/../src/bin/lttng-sessiond/$SESSIOND_BIN --background --consumerd32-path="$DIR/../src/bin/lttng-consumerd/lttng-consumerd" --consumerd64-path="$DIR/../src/bin/lttng-consumerd/lttng-consumerd" --verbose-consumer >>/tmp/sessiond.log 2>&1
321 ok
$status "Start session daemon"
325 function stop_lttng_sessiond
()
327 if [ -n $TEST_NO_SESSIOND ] && [ "$TEST_NO_SESSIOND" == "1" ]; then
328 # Env variable requested no session daemon
332 PID_SESSIOND
=`pidof lt-$SESSIOND_BIN`
334 kill $PID_SESSIOND >$OUTPUT_DEST
336 if [ $?
-eq 1 ]; then
337 fail
"Kill sessions daemon"
341 while [ -n "$out" ]; do
342 out
=$
(pidof lt-
$SESSIOND_BIN)
346 while [ -n "$out" ]; do
347 out
=$
(pidof
$CONSUMERD_BIN)
350 pass
"Kill session daemon"
354 function list_lttng_with_opts
()
357 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN list
$opts >$OUTPUT_DEST
358 ok $?
"Lttng-tool list command with option $opts"
361 function create_lttng_session_no_output
()
365 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN create
$sess_name --no-output >$OUTPUT_DEST
366 ok $?
"Create session $sess_name in no-output mode"
369 function create_lttng_session
()
373 local expected_to_fail
=$3
375 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN create
$sess_name -o $trace_path > $OUTPUT_DEST
377 if [[ $expected_to_fail ]]; then
379 ok $?
"Expected fail on session creation $sess_name in $trace_path"
381 ok
$ret "Create session $sess_name in $trace_path"
385 function enable_ust_lttng_channel
()
388 local channel_name
=$2
391 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN enable-channel
-u $channel_name -s $sess_name >$OUTPUT_DEST
393 if [[ $expect_fail ]]; then
395 ok $?
"Expected fail on ust channel creation $channel_name in $sess_name"
397 ok
$ret "Enable channel $channel_name for session $sess_name"
401 function disable_ust_lttng_channel
()
404 local channel_name
=$2
406 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN disable-channel
-u $channel_name -s $sess_name >$OUTPUT_DEST
407 ok $?
"Disable channel $channel_name for session $sess_name"
410 function enable_lttng_mmap_overwrite_kernel_channel
()
413 local channel_name
=$2
415 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN enable-channel
-s $sess_name $channel_name -k --output mmap
--overwrite >$OUTPUT_DEST
416 ok $?
"Enable channel $channel_name for session $sess_name"
419 function enable_lttng_mmap_overwrite_ust_channel
()
422 local channel_name
=$2
424 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN enable-channel
-s $sess_name $channel_name -u --output mmap
--overwrite >$OUTPUT_DEST
425 ok $?
"Enable channel $channel_name for session $sess_name"
428 function enable_ust_lttng_event
()
431 local event_name
="$2"
432 local channel_name
=$3
433 local expected_to_fail
=$4
435 if [ -z $channel_name ]; then
436 # default channel if none specified
439 chan
="-c $channel_name"
442 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN enable-event
"$event_name" $chan -s $sess_name -u >$OUTPUT_DEST
444 if [[ $expected_to_fail ]]; then
446 ok $?
"Enable ust event $event_name for session $session_name on channel $channel_name failed as expected"
448 ok
$ret "Enable event $event_name for session $sess_name"
452 function enable_jul_lttng_event
()
458 if [ -z $channel_name ]; then
459 # default channel if none specified
462 chan
="-c $channel_name"
465 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN enable-event
"$event_name" $chan -s $sess_name -j >$OUTPUT_DEST
466 ok $?
"Enable JUL event $event_name for session $sess_name"
469 function enable_jul_lttng_event_loglevel
()
472 local event_name
="$2"
474 local channel_name
=$4
476 if [ -z $channel_name ]; then
477 # default channel if none specified
480 chan
="-c $channel_name"
483 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN enable-event
--loglevel $loglevel "$event_name" $chan -s $sess_name -j >$OUTPUT_DEST
484 ok $?
"Enable JUL event $event_name for session $sess_name with loglevel $loglevel"
487 function enable_log4j_lttng_event
()
493 if [ -z $channel_name ]; then
494 # default channel if none specified
497 chan
="-c $channel_name"
500 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN enable-event
"$event_name" $chan -s $sess_name -l >$OUTPUT_DEST
501 ok $?
"Enable LOG4J event $event_name for session $sess_name"
504 function enable_log4j_lttng_event_loglevel
()
507 local event_name
="$2"
509 local channel_name
=$4
511 if [ -z $channel_name ]; then
512 # default channel if none specified
515 chan
="-c $channel_name"
518 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN enable-event
--loglevel $loglevel "$event_name" $chan -s $sess_name -l >$OUTPUT_DEST
519 ok $?
"Enable LOG4J event $event_name for session $sess_name with loglevel $loglevel"
522 function enable_ust_lttng_event_filter
()
525 local event_name
="$2"
528 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN enable-event
"$event_name" -s $sess_name -u --filter "$filter" >$OUTPUT_DEST
529 ok $?
"Enable event $event_name with filtering for session $sess_name"
532 function enable_ust_lttng_event_loglevel
()
535 local event_name
="$2"
538 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN enable-event
"$event_name" -s $sess_name -u --loglevel $loglevel >$OUTPUT_DEST
539 ok $?
"Enable event $event_name with loglevel $loglevel"
542 function enable_ust_lttng_event_loglevel_only
()
545 local event_name
="$2"
548 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN enable-event
"$event_name" -s $sess_name -u --loglevel-only $loglevel >$OUTPUT_DEST
549 ok $?
"Enable event $event_name with loglevel-only $loglevel"
552 function disable_ust_lttng_event
()
555 local event_name
="$2"
556 local channel_name
="$3"
558 if [ -z $channel_name ]; then
559 # default channel if none specified
562 chan
="-c $channel_name"
565 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN disable-event
"$event_name" -s $sess_name $chan -u >$OUTPUT_DEST
566 ok $?
"Disable event $event_name for session $sess_name"
569 function disable_jul_lttng_event
()
572 local event_name
="$2"
574 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN disable-event
"$event_name" -s $sess_name -j >/dev
/null
2>&1
575 ok $?
"Disable JUL event $event_name for session $sess_name"
578 function disable_log4j_lttng_event
()
581 local event_name
="$2"
583 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN disable-event
"$event_name" -s $sess_name -l >/dev
/null
2>&1
584 ok $?
"Disable LOG4J event $event_name for session $sess_name"
587 function start_lttng_tracing
()
590 local expected_to_fail
=$2
592 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN start
$sess_name >$OUTPUT_DEST
594 if [[ $expected_to_fail ]]; then
596 ok $?
"Expected fail on start tracing for session: $sess_name"
598 ok
$ret "Start tracing for session $sess_name"
602 function stop_lttng_tracing
()
605 local expected_to_fail
=$2
607 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN stop
$sess_name >$OUTPUT_DEST
609 if [[ $expected_to_fail ]]; then
611 ok $?
"Expected fail on stop tracing for session: $sess_name"
613 ok
$ret "Stop lttng tracing for session $sess_name"
617 function destroy_lttng_session
()
620 local expected_to_fail
=$2
622 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN destroy
$sess_name >$OUTPUT_DEST
624 if [[ $expected_to_fail ]]; then
626 ok $?
"Expected fail on session deletion $sess_name"
628 ok
$ret "Destroy session $sess_name"
632 function destroy_lttng_sessions
()
634 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN destroy
--all >$OUTPUT_DEST
635 ok $?
"Destroy all lttng sessions"
638 function lttng_snapshot_add_output
()
642 local expected_to_fail
=$3
644 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN snapshot add-output
-s $sess_name file://$trace_path >$OUTPUT_DEST
646 if [[ $expected_to_fail ]]; then
648 ok $?
"Failed to add a snapshot output file://$trace_path as expected"
650 ok
$ret "Added snapshot output file://$trace_path"
654 function lttng_snapshot_del_output
()
658 local expected_to_fail
=$3
660 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN snapshot del-output
-s $sess_name $id >$OUTPUT_DEST
662 if [[ $expected_to_fail ]]; then
664 ok $?
"Expect fail on deletion of snapshot output id $id"
666 ok
$ret "Deleted snapshot output id $id"
670 function lttng_snapshot_record
()
675 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN snapshot record
-s $sess_name >$OUTPUT_DEST
676 ok $?
"Snapshot recorded"
679 function lttng_snapshot_list
()
682 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN snapshot list-output
-s $sess_name >$OUTPUT_DEST
683 ok $?
"Snapshot list"
686 function lttng_save
()
691 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN save
$sess_name $opts >$OUTPUT_DEST
692 ok $?
"Session successfully saved"
695 function lttng_load
()
699 $TESTDIR/..
/src
/bin
/lttng
/$LTTNG_BIN load
$opts >$OUTPUT_DEST
700 ok $?
"Load command successful"
703 function trace_matches
()
709 which $BABELTRACE_BIN >/dev
/null
710 skip $?
-ne 0 "Babeltrace binary not found. Skipping trace matches"
712 local count
=$
($BABELTRACE_BIN $trace_path |
grep $event_name |
wc -l)
714 if [ "$count" -ne "$nr_iter" ]; then
716 diag
"$count events found in trace"
722 function trace_match_only
()
728 which $BABELTRACE_BIN >/dev
/null
729 skip $?
-ne 0 "Babeltrace binary not found. Skipping trace matches"
731 local count
=$
($BABELTRACE_BIN $trace_path |
grep $event_name |
wc -l)
732 local total
=$
($BABELTRACE_BIN $trace_path |
wc -l)
734 if [ "$nr_iter" -eq "$count" ] && [ "$total" -eq "$nr_iter" ]; then
735 pass
"Trace match with $total event $event_name"
738 diag
"$total event(s) found, expecting $nr_iter of event $event_name and only found $count"
742 function validate_trace
747 which $BABELTRACE_BIN >/dev
/null
748 if [ $?
-ne 0 ]; then
749 skip
0 "Babeltrace binary not found. Skipping trace validation"
754 for i
in $event_name; do
755 traced
=$
($BABELTRACE_BIN $trace_path 2>/dev
/null |
grep $i |
wc -l)
756 if [ "$traced" -ne 0 ]; then
757 pass
"Validate trace for event $i, $traced events"
759 fail
"Validate trace for event $i"
760 diag
"Found $traced occurences of $i"
768 function validate_trace_exp
()
773 which $BABELTRACE_BIN >/dev
/null
774 skip $?
-ne 0 "Babeltrace binary not found. Skipping trace validation"
776 traced
=$
($BABELTRACE_BIN $trace_path 2>/dev
/null |
grep ${event_exp} |
wc -l)
777 if [ "$traced" -ne 0 ]; then
778 pass
"Validate trace for expression '${event_exp}', $traced events"
780 fail
"Validate trace for expression '${event_exp}'"
781 diag
"Found $traced occurences of '${event_exp}'"
787 function validate_trace_only_exp
()
792 which $BABELTRACE_BIN >/dev
/null
793 skip $?
-ne 0 "Babeltrace binary not found. Skipping trace matches"
795 local count
=$
($BABELTRACE_BIN $trace_path |
grep ${event_exp} |
wc -l)
796 local total
=$
($BABELTRACE_BIN $trace_path |
wc -l)
798 if [ "$count" -ne 0 ] && [ "$total" -eq "$count" ]; then
799 pass
"Trace match with $total for expression '${event_exp}"
802 diag
"$total syscall event(s) found, only syscalls matching expression '${event_exp}' ($count occurrences) are expected"
808 function validate_trace_empty
()
812 which $BABELTRACE_BIN >/dev
/null
813 if [ $?
-ne 0 ]; then
814 skip
0 "Babeltrace binary not found. Skipping trace validation"
817 traced
=$
($BABELTRACE_BIN $trace_path 2>/dev
/null |
wc -l)
818 if [ "$traced" -eq 0 ]; then
819 pass
"Validate empty trace"
821 fail
"Validate empty trace"
822 diag
"Found $traced events in trace"