native_spawn_argv.h

Go to the documentation of this file.

/**
 * @file
 * @brief Declares argv construction helpers for spawned app requests.
 */
 
#ifndef PHAROS_NATIVE_SPAWN_ARGV_H
#define PHAROS_NATIVE_SPAWN_ARGV_H
 
#include "native_runtime_types.h"
 
#include <stddef.h>
 
#define PHAROS_APP_REQUEST_ARGV_CAPACITY 32
 
/**
 * @brief Builds the argv vector used to execute one compiled app request.
 * @param app Finalized app runtime that will handle the request.
 * @param request_method HTTP request method.
 * @param request_target HTTP request target.
 * @param request_cookie Cookie header value.
 * @param request_headers Normalized request headers.
 * @param request_content_type Request content type.
 * @param request_body Request body text when passed inline.
 * @param request_is_multipart Non-zero when the request uses multipart form data.
 * @param temp_body_path Optional temporary body file path for multipart requests.
 * @param argv_list Destination argv array to populate.
 * @param argv_capacity Capacity of argv_list in entries.
 * @param argc_out Destination for the populated argv length.
 * @return 0 on success, or a non-zero status code when the argv cannot be constructed.
 */
int build_native_app_request_argv(
  const AppRuntime *app,
  const char *request_method,
  const char *request_target,
  const char *request_cookie,
  const char *request_headers,
  const char *request_content_type,
  const char *request_body,
  int request_is_multipart,
  const char *temp_body_path,
  char *argv_list[],
  size_t argv_capacity,
  size_t *argc_out
);
 
#endif