# The MIT License (MIT)
#
# Copyright (C) 2026 Scott Duensing
#
# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documentation files (the "Software"), to
# deal in the Software without restriction, including without limitation the
# rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
# sell copies of the Software, and to permit persons to whom the Software is
# furnished to do so, subject to the following conditions:
#
# The above copyright notice and this permission notice shall be included in
# all copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
# IN THE SOFTWARE.

# T10 -- libtasks on x86_64 and the DVX shell app loader driven by dvxtest.
#
#   make -C src/test/shell          # build + run both binaries (SAN=1)
#   make -C src/test/shell SAN=0

include ../dvxtest/dvxtest.mk

.DEFAULT_GOAL := all

SHELLDIR    = $(DVXTEST_ROOT)/src/libs/kpunch/dvxshell
APPSDIR     = $(DVXTEST_ROOT)/src/apps/kpunch
APPS_SO_DIR = $(DVXTEST_OBJDIR)/apps
BINDIR      = $(DVXTEST_BINDIR)/shell
TASKS_LIB   = $(DVXTEST_OBJDIR)/libtasks.a
TASKS_TEST  = $(BINDIR)/tasksTest
SHELL_TEST  = $(BINDIR)/shellTest
APPS_TEST   = $(BINDIR)/appsTest
SHMAIN_TEST = $(BINDIR)/shellMainTest
FIXDIR      = $(BINDIR)/fixtures
FIX_SRCS    = $(wildcard fixtures/fix*.c)
FIX_SOS     = $(patsubst fixtures/%.c,$(FIXDIR)/%.so,$(FIX_SRCS))
FIX_HLP     = $(FIXDIR)/fixture.hlp
HLPC        = $(DVXTEST_ROOT)/bin/host/dvxhlpc
HELP_FIX    = $(DVXTEST_ROOT)/src/test/tools/fixtures/help
SHELL_SRCS  = $(SHELLDIR)/shellApp.c $(SHELLDIR)/shellMain.c $(SHELLDIR)/shellInfo.c
SHELL_OBJS  = $(patsubst $(SHELLDIR)/%.c,$(BINDIR)/%.o,$(SHELL_SRCS))

# The frame-pointer check in tasksTest reads __builtin_frame_address.
CFLAGS      = $(DVXTEST_CFLAGS) -fno-omit-frame-pointer -I$(SHELLDIR) -DDVXTEST_APPS_DIR='"$(APPS_SO_DIR)"' -DDVXTEST_FIXTURES_DIR='"$(FIXDIR)"'

.PHONY: all libs run clean

all: run

libs: dvxtest-libs
	$(MAKE) -C $(DVXTEST_LIBTASKS) host SAN=$(SAN)
	$(MAKE) -C $(APPSDIR) host SAN=$(SAN)

$(BINDIR)/%.o: $(SHELLDIR)/%.c $(SHELLDIR)/shellApp.h $(SHELLDIR)/shellInf.h | libs
	@mkdir -p $(BINDIR)
	$(HOSTCC) $(CFLAGS) -c -o $@ $<

$(TASKS_TEST): tasksTest.c | libs
	@mkdir -p $(BINDIR)
	$(HOSTCC) $(CFLAGS) -o $@ tasksTest.c $(DVXTEST_LDFLAGS) -Wl,--whole-archive $(TASKS_LIB) $(DVXTEST_LIB) -Wl,--no-whole-archive $(DVXTEST_OBJDIR)/libdvx.a -ldl -lm

$(SHELL_TEST): shellTest.c $(SHELL_OBJS) | libs
	@mkdir -p $(BINDIR)
	$(HOSTCC) $(CFLAGS) -o $@ shellTest.c $(SHELL_OBJS) $(DVXTEST_LDFLAGS) -Wl,--whole-archive $(DVXTEST_OBJDIR)/libdvx.a $(TASKS_LIB) $(DVXTEST_LIB) -Wl,--no-whole-archive -ldl -lm

$(APPS_TEST): appsTest.c $(SHELL_OBJS) | libs
	@mkdir -p $(BINDIR)
	$(HOSTCC) $(CFLAGS) -o $@ appsTest.c $(SHELL_OBJS) $(DVXTEST_LDFLAGS) -Wl,--whole-archive $(DVXTEST_OBJDIR)/libdvx.a $(TASKS_LIB) $(DVXTEST_LIB) -Wl,--no-whole-archive -ldl -lm

$(SHMAIN_TEST): shellMainTest.c $(SHELL_OBJS) | libs
	@mkdir -p $(BINDIR)
	$(HOSTCC) $(CFLAGS) -o $@ shellMainTest.c $(SHELL_OBJS) $(DVXTEST_LDFLAGS) -Wl,--whole-archive $(DVXTEST_OBJDIR)/libdvx.a $(TASKS_LIB) $(DVXTEST_LIB) -Wl,--no-whole-archive -ldl -lm

$(FIXDIR)/%.so: fixtures/%.c | libs
	@mkdir -p $(FIXDIR)
	$(HOSTCC) $(CFLAGS) -fPIC -shared -o $@ $<

# The dvxhelp fixture: the tools suite's every-directive help source,
# compiled with the host dvxhlpc (built COV=0 so a coverage run of this
# suite never redirects the tool into obj/hostcov).
$(FIX_HLP): $(HELP_FIX)/main.dhs $(HELP_FIX)/inc.dhs $(HELP_FIX)/extra.dhs
	@mkdir -p $(FIXDIR)
	$(MAKE) -C $(DVXTEST_ROOT)/src/tools host COV=0
	cd $(HELP_FIX) && $(HLPC) -o $(FIX_HLP) --quiet -i . main.dhs @inputs.txt

run: $(TASKS_TEST) $(SHELL_TEST) $(APPS_TEST) $(SHMAIN_TEST) $(FIX_SOS) $(FIX_HLP)
	cd $(BINDIR) && ASAN_OPTIONS=detect_leaks=1 ./tasksTest
	# Every app plugin exports the same appDescriptor symbol by design (one
	# per loaded module), which ASan's ODR checker flags under RTLD_GLOBAL.
	cd $(BINDIR) && ASAN_OPTIONS=detect_leaks=1:detect_odr_violation=0 ./shellTest
	# allocator_may_return_null: the huge-stack fixture provokes a real
	# malloc failure that tsCreate must survive.
	cd $(BINDIR) && ASAN_OPTIONS=detect_leaks=1:detect_odr_violation=0:allocator_may_return_null=1:max_allocation_size_mb=1536 ./appsTest
	# handle_segv=0: the crash fixture's SIGSEGV must reach the shell's own
	# crash handler, not ASan's.
	cd $(BINDIR) && ASAN_OPTIONS=detect_leaks=1:detect_odr_violation=0:allocator_may_return_null=1:handle_segv=0 ./shellMainTest

clean:
	rm -rf $(BINDIR)
