rte_watchdog.h

Go to the documentation of this file.

 
#ifndef RTE_WATCHDOG_H
#define RTE_WATCHDOG_H
 
#include "rte/utils/status/rte_status.h"
#include "rte/utils/types/rte_types.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
/* ============================================================================
 * Types & Constants
 * ========================================================================== */

typedef struct rte_watchdog_s *rte_watchdog_t;

typedef enum {
    RTE_WATCHDOG_SYSTEM,      
    RTE_WATCHDOG_TASK,        
    RTE_WATCHDOG_CHANNEL,     
    RTE_WATCHDOG_CHECKPOINT   
} rte_watchdog_type_t;

typedef enum {
    RTE_WATCHDOG_ACTION_LOG,           
    RTE_WATCHDOG_ACTION_SAFESTATE,     
    RTE_WATCHDOG_ACTION_REBOOT,        
    RTE_WATCHDOG_ACTION_FAILOVER,      
    RTE_WATCHDOG_ACTION_CUSTOM         
} rte_watchdog_action_t;

typedef struct {
    rte_watchdog_type_t type;          
    const char *name;                   
    rte_duration_ms_t timeout_ms;      
    rte_watchdog_action_t action;      
    void (*custom_action)(void *ctx);   
    void *context;                      
} rte_watchdog_config_t;

typedef struct {
    uint8_t active;                     
    uint32_t kicks;                     
    uint32_t fires;                     
    uint32_t recoveries;                
    rte_duration_ms_t time_since_last_kick; 
    rte_duration_ms_t time_until_fire;      
} rte_watchdog_status_t;
 
/* ============================================================================
 * API: Core Watchdog Operations
 * ========================================================================== */

rte_status_t rte_watchdog_create(rte_watchdog_t *handle_out,
                                    const rte_watchdog_config_t *config);

rte_status_t rte_watchdog_start(rte_watchdog_t watchdog);

rte_status_t rte_watchdog_stop(rte_watchdog_t watchdog);

rte_status_t rte_watchdog_kick(rte_watchdog_t watchdog);

rte_status_t rte_watchdog_get_status(rte_watchdog_t watchdog,
                                        rte_watchdog_status_t *status_out);

rte_status_t rte_watchdog_destroy(rte_watchdog_t watchdog);
 
/* ============================================================================
 * API: Watchdog Manager (Global)
 * ========================================================================== */

rte_status_t rte_watchdog_manager_initialize(void);

rte_status_t rte_watchdog_manager_shutdown(void);
 
/* ============================================================================
 * Watchdog Timeout Callback (Invoked by Framework)
 * ========================================================================== */

void rte_watchdog_timeout_handler(uint32_t watchdog_id);

void rte_watchdog_timer_tick(void);
 
#ifdef __cplusplus
}
#endif
 
#endif /* RTE_WATCHDOG_H */
 /* WATCHDOG */