sledge-serverles-framwork/runtime/include/route_config.h

#pragma once

#include <stdint.h>
#include <stdio.h>
#include <stdlib.h>

#include "runtime.h"
#include "scheduler_options.h"

enum route_config_member
{
	route_config_member_route,
	route_config_member_path,
	route_config_member_admissions_percentile,
	route_config_member_expected_execution_us,
	route_config_member_relative_deadline_us,
	route_config_member_http_resp_size,
	route_config_member_http_resp_content_type,
	route_config_member_len
};

struct route_config {
	char    *route;
	char    *path;
	uint8_t  admissions_percentile;
	uint32_t expected_execution_us;
	uint32_t relative_deadline_us;
	uint32_t http_resp_size;
	char    *http_resp_content_type;
};

static inline void
route_config_deinit(struct route_config *config)
{
	free(config->path);
	free(config->route);
	free(config->http_resp_content_type);
}

static inline void
route_config_print(struct route_config *config)
{
	printf("[Route] Route: %s\n", config->route);
	printf("[Route] Path: %s\n", config->path);
	printf("[Route] Admissions Percentile: %hhu\n", config->admissions_percentile);
	printf("[Route] Expected Execution (us): %u\n", config->expected_execution_us);
	printf("[Route] Relative Deadline (us): %u\n", config->relative_deadline_us);
	printf("[Route] HTTP Response Size: %u\n", config->http_resp_size);
	printf("[Route] HTTP Response Content Type: %s\n", config->http_resp_content_type);
}

/**
 * Validates a route config generated by a parser
 * @param config
 * @param did_set boolean array of size route_config_member_len indicating if parser set the associated member
 */
static inline int
route_config_validate(struct route_config *config, bool *did_set)
{
	if (did_set[route_config_member_route] == false) {
		fprintf(stderr, "path field is required\n");
		return -1;
	}

	if (did_set[route_config_member_path] == false) {
		fprintf(stderr, "path field is required\n");
		return -1;
	}

	if (did_set[route_config_member_http_resp_content_type] == false) {
		debuglog("http_resp_content_type not set, defaulting to text/plain\n");
		config->http_resp_content_type = "text/plain";
		return -1;
	}

	if (scheduler == SCHEDULER_EDF) {
		if (did_set[route_config_member_relative_deadline_us] == false) {
			fprintf(stderr, "relative_deadline_us is required\n");
			return -1;
		}

		if (config->relative_deadline_us > (uint32_t)RUNTIME_RELATIVE_DEADLINE_US_MAX) {
			fprintf(stderr, "Relative-deadline-us must be between 0 and %u, was %u\n",
			        (uint32_t)RUNTIME_RELATIVE_DEADLINE_US_MAX, config->relative_deadline_us);
			return -1;
		}

#ifdef ADMISSIONS_CONTROL
		if (did_set[route_config_member_expected_execution_us] == false) {
			fprintf(stderr, "expected-execution-us is required\n");
			return -1;
		}

		if (did_set[route_config_member_admissions_percentile] == false) {
			fprintf(stderr, "admissions_percentile is required\n");
			return -1;
		}

		if (config->admissions_percentile > 99 || config->admissions_percentile < 50) {
			fprintf(stderr, "admissions-percentile must be > 50 and <= 99 but was %u\n",
			        route_config->admissions_percentile);
			return -1;
		}

		/* If the ratio is too big, admissions control is too coarse */
		uint32_t ratio = route_config->relative_deadline_us / route_config->expected_execution_us;
		if (ratio > ADMISSIONS_CONTROL_GRANULARITY) {
			fprintf(stderr,
			        "Ratio of Deadline to Execution time cannot exceed admissions control "
			        "granularity of "
			        "%d\n",
			        ADMISSIONS_CONTROL_GRANULARITY);
			return -1;
		}
#endif
	}

	return 0;
}