Home /Modules/http-3.0/station_classifier.h

station_classifier.h

http-3.0/station/station_classifier.h · 46 line(s) · c

/* ==========================================================================
 * station_classifier.h -- shared Station judgment (spec J-STA-0001 §4/§5).
 *
 * The SAME classifier runs in the kernel Netfilter hook and in userland, so a
 * Router's judgment is identical wherever the Station executes. It is pure:
 * given one signal, it yields the condition, premise, and hop verb. It uses
 * only <station_abi.h> types and no libc/kernel-only calls, so it compiles in
 * both __KERNEL__ and userland translation units.
 * ========================================================================== */
#ifndef SLEELA_STATION_CLASSIFIER_H
#define SLEELA_STATION_CLASSIFIER_H

#include "station_abi.h"

#ifdef __cplusplus
extern "C" {
#endif

/* Result of classifying one signal (before it is folded into session state). */
typedef struct {
    sl_condition_t condition;
    sl_premise_t   premise;   /* premise this signal selects, given current    */
    sl_hop_verb_t  hop_verb;
    int            valid;     /* 0 if the signal is not a well-formed premise  */
} sl_classification_t;

/* Map the raw hop delta to a verb (clamps to CANCEL/HOLD/ADVANCE). */
sl_hop_verb_t sl_classify_hop(int8_t hop_delta);

/* Classify the condition from the flag combination + urg magnitude (§5). */
sl_condition_t sl_classify_condition(uint8_t tcp_flags, uint8_t urg_units);

/*
 * Full classification of one signal, given the premise currently open for the
 * signaling party (or SL_PREMISE_START-1 == -1 sentinel meaning "none open").
 * `current_open` should be -1 when the party has no premise open yet, else the
 * last premise value. Returns condition/premise/hop_verb and validity.
 */
sl_classification_t sl_classify_signal(const sl_signal_t *sig, int current_open_premise);

#ifdef __cplusplus
}
#endif

#endif /* SLEELA_STATION_CLASSIFIER_H */