package integrationtests

import "testing"

// posixTimerTraceArgs restricts tracing to the POSIX timer-family syscalls so
// the test output is dominated by the lifecycle calls the workload issues.
// Note: timerfd_create is intentionally NOT in this list — it belongs to the
// IPC/eventfd family and returns an fd, whereas timer_create returns a timer_t
// through an output pointer (a null_event in the tracer).
var posixTimerTraceArgs = []string{
	"-trace-syscalls",
	"timer_create,timer_settime,timer_gettime,timer_getoverrun,timer_delete,timerfd_create",
}

// intervalTimerTraceArgs restricts tracing to the classic interval-timer
// syscalls setitimer/getitimer, which the interval-timer-noop workload issues.
// Both are KindNull (null_event) on enter with an UNCLASSIFIED ret on exit, so
// the test asserts only enter-presence (no path/fd/return to inspect).
var intervalTimerTraceArgs = []string{
	"-trace-syscalls",
	"setitimer,getitimer",
}

// TestPosixTimerLifecycle verifies the POSIX per-process timer family is traced
// end-to-end. The workload runs timer_create -> timer_settime -> timer_gettime
// -> timer_getoverrun -> timer_delete; each must appear as an enter event.
func TestPosixTimerLifecycle(t *testing.T) {
	h := newTestHarness(t)
	result, pid, err := h.RunWithIorArgs("posix-timer-lifecycle", defaultDuration, posixTimerTraceArgs)
	if err != nil {
		t.Fatalf("run scenario posix-timer-lifecycle: %v", err)
	}

	AssertNoUnexpectedPID(t, result, pid)
	AssertNoUnexpectedComm(t, result, "ioworkload")
	AssertEventsPresent(t, result, []ExpectedEvent{
		{Tracepoint: "enter_timer_create", Comm: "ioworkload", MinCount: 1},
		{Tracepoint: "enter_timer_settime", Comm: "ioworkload", MinCount: 1},
		{Tracepoint: "enter_timer_gettime", Comm: "ioworkload", MinCount: 1},
		{Tracepoint: "enter_timer_getoverrun", Comm: "ioworkload", MinCount: 1},
		{Tracepoint: "enter_timer_delete", Comm: "ioworkload", MinCount: 1},
	})

	// timer_create is a null_event: it must NOT capture an fd-style path the way
	// the fd-returning siblings do. In particular it must not be confused with
	// timerfd_create, whose records carry a "timerfd:" descriptor path. Guard
	// against that regression: no timer_create record should have a timerfd path.
	if got := totalTracepointPathCount(result, "enter_timer_create", "timerfd:"); got != 0 {
		t.Fatalf("enter_timer_create records with a timerfd: descriptor path = %d, want 0; "+
			"timer_create returns a timer_t, not an fd, and must not be classified like timerfd_create", got)
	}
}

// TestIntervalTimerNoop verifies the classic interval-timer family (setitimer /
// getitimer) is traced end-to-end. The interval-timer-noop workload issues a
// setitimer(ITIMER_REAL, &{0,0,0,0}, NULL) — an all-zero itimerval that arms
// nothing, so NO SIGALRM is ever scheduled — followed by a getitimer read.
// Both are KindNull on enter, so we assert enter-presence for each.
func TestIntervalTimerNoop(t *testing.T) {
	h := newTestHarness(t)
	result, pid, err := h.RunWithIorArgs("interval-timer-noop", defaultDuration, intervalTimerTraceArgs)
	if err != nil {
		t.Fatalf("run scenario interval-timer-noop: %v", err)
	}

	AssertNoUnexpectedPID(t, result, pid)
	AssertNoUnexpectedComm(t, result, "ioworkload")
	AssertEventsPresent(t, result, []ExpectedEvent{
		{Tracepoint: "enter_setitimer", Comm: "ioworkload", MinCount: 1},
		{Tracepoint: "enter_getitimer", Comm: "ioworkload", MinCount: 1},
	})
}