// SPDX-License-Identifier: Apache-2.0 #include #include #include #include #include #include #include #include #include #include constexpr auto* TAG = "app_posix_loader"; namespace { /** load()-allocated state, passed back through run()/unload(). */ struct PosixAppRuntime { void* handle = nullptr; }; bool is_regular_file(const std::string& path) { struct stat path_stat {}; return ::stat(path.c_str(), &path_stat) == 0 && S_ISREG(path_stat.st_mode); } #ifndef __APPLE__ constexpr ElfRequirements EXECUTABLE_REQUIREMENTS = { .elf_class = ELF_CLASS_64, .data = ELF_DATA_2LSB, .type = ELF_TYPE_DYN, #if defined(__x86_64__) .machine = ELF_MACHINE_X86_64, #elif defined(__aarch64__) .machine = ELF_MACHINE_AARCH64, #else #error "Unsupported POSIX architecture for ELF machine check" #endif }; #endif // Validates an already-resolved binary path (see resolve_app_path()) before it's handed to // dlopen(): the extension check is a cheap string comparison, so the file is only opened as a // last resort. bool is_executable_file(const std::string& resolved_path) { if (!resolved_path.ends_with(".so")) { return false; } #ifdef __APPLE__ // The simulator's app binaries are Mach-O on macOS, not ELF, so there is no header to check. return is_regular_file(resolved_path); #else return elf_check_file(resolved_path.c_str(), &EXECUTABLE_REQUIREMENTS); #endif } // location.location can be either an app's install directory or the .so file directly, mirroring // app_esp32_loader_service.cpp's resolve_elf_path(). A "packaged" app's install directory always // holds its single binary at the fixed path {dir}/bin/posix-{TACTILITY_POSIX_ARCH}/app.so - a // "terminal" app has no such file (its several binaries keep their own names), so this correctly // leaves it unresolvable - terminal apps aren't run through AppLoaderApi (see app/install.h). error_t resolve_app_path(const std::string& path, std::string& resolvedPath) { if (path.ends_with(".so")) { resolvedPath = path; return ERROR_NONE; } std::string candidate = path + "/bin/posix-" TACTILITY_POSIX_ARCH "/app.so"; if (!is_regular_file(candidate)) { return ERROR_NOT_FOUND; } resolvedPath = candidate; return ERROR_NONE; } error_t api_load(AppLocation location, AppRuntime* out_runtime) { if (location.type != APP_LOCATION_PATH) { LOG_E(TAG, "Unsupported location type"); return ERROR_NOT_SUPPORTED; } std::string app_path; auto error = resolve_app_path(static_cast(location.location), app_path); if (error != ERROR_NONE) { LOG_E(TAG, "Failed to resolve app path: %s", location.location); return error; } if (!is_executable_file(app_path)) { LOG_E(TAG, "Not executable: %s", app_path.c_str()); return ERROR_NOT_ALLOWED; } LOG_I(TAG, "Loading %s", app_path.c_str()); void* handle = dlopen(app_path.c_str(), RTLD_NOW | RTLD_LOCAL); if (handle == nullptr) { LOG_E(TAG, "dlopen(%s) failed: %s", app_path.c_str(), dlerror()); return ERROR_NOT_FOUND; } auto* runtime = new (std::nothrow) PosixAppRuntime { .handle = handle }; if (runtime == nullptr) { LOG_E(TAG, "Out of memory"); dlclose(handle); return ERROR_OUT_OF_MEMORY; } *out_runtime = runtime; return ERROR_NONE; } int32_t api_run(AppRuntime runtime_ptr, uint32_t /*app_instance_id*/, int argc, char* argv[]) { auto* runtime = static_cast(runtime_ptr); // Clear any pending error, per dlsym(3)'s own recommended idiom for telling a NULL symbol address apart from a real lookup failure dlerror(); void* symbol = dlsym(runtime->handle, "main"); const char* lookup_error = dlerror(); if (symbol == nullptr || lookup_error != nullptr) { LOG_E(TAG, "dlsym(\"main\") failed: %s", lookup_error != nullptr ? lookup_error : "not found"); return -1; } auto* main_fn = reinterpret_cast(symbol); return main_fn(argc, argv); } void api_unload(AppRuntime runtime_ptr) { auto* runtime = static_cast(runtime_ptr); dlclose(runtime->handle); delete runtime; } bool api_is_executable(AppLocation location) { if (location.type != APP_LOCATION_PATH) { return false; } std::string app_path; if (resolve_app_path(static_cast(location.location), app_path) != ERROR_NONE) { return false; } return is_executable_file(app_path); } AppLoaderApi loader_api = { .load = api_load, .run = api_run, .unload = api_unload, .is_executable = api_is_executable, }; void* create_service(const ServiceManifest*) { return &loader_api; } void destroy_service(const ServiceManifest*, void*) { } } // namespace ServiceManifest loader_service_manifest = { .id = APP_LOADER_PATH_SERVICE_ID, .create_service = create_service, .destroy_service = destroy_service, .on_start = nullptr, .on_stop = nullptr, };