native_http_log.h

Go to the documentation of this file.

/**
 * @file
 * @brief Declares HTTP logging and response formatting helpers.
 */
 
#ifndef PHAROS_NATIVE_HTTP_LOG_H
#define PHAROS_NATIVE_HTTP_LOG_H
 
/** @name HTTP logging helpers
 * @{
 */
/**
 * @brief Resolves the MIME type that should be used for a file path.
 * @param path File path whose extension should be inspected.
 * @return Newly allocated MIME type string, or NULL on failure.
 */
char *mime_type_for_path(const char *path);
/**
 * @brief Compacts free-form text into a single-line log-safe representation.
 * @param value Source text to compact.
 * @return Newly allocated compacted text, or NULL on failure.
 */
char *compact_log_text_native(const char *value);
/**
 * @brief Extracts the best client IP address from request headers.
 * @param headers Normalized request headers.
 * @return Newly allocated client IP string, or NULL when no address can be derived.
 */
char *request_real_ip_native(const char *headers);
/**
 * @brief Returns request headers with an explicit client IP header applied.
 * @param headers Original normalized request headers.
 * @param client_ip Client IP value to ensure is represented.
 * @return Newly allocated header block, or NULL on failure.
 */
char *request_headers_with_client_ip_native(const char *headers, const char *client_ip);
/**
 * @brief Returns the canonical reason phrase for one HTTP status code.
 * @param status_code HTTP status code to translate.
 * @return Pointer to a static reason phrase string.
 */
const char *http_status_text_native(int status_code);
/**
 * @brief Extracts the HTTP status line from a raw HTTP response payload.
 * @param response Raw HTTP response text.
 * @return Newly allocated status line string, or NULL when it cannot be parsed.
 */
char *http_status_line_from_response_native(const char *response);
/**
 * @brief Extracts the numeric HTTP status code from a raw HTTP response payload.
 * @param response Raw HTTP response text.
 * @return Parsed status code, or 0 when it cannot be determined.
 */
int http_status_code_from_response_native(const char *response);
 
 
/** @} */
#endif