rtrlib/rtr_mgr.h

/*
 * This file is part of RTRlib.
 *
 * This file is subject to the terms and conditions of the MIT license.
 * See the file LICENSE in the top level directory for more details.
 *
 * Website: http://rtrlib.realmv6.org/
 */

#ifndef RTR_MGR
#define RTR_MGR
#include <stdint.h>
#include <pthread.h>

#include "rtrlib/pfx/pfx.h"
#include "rtrlib/spki/spkitable.h"

enum rtr_mgr_status {
    RTR_MGR_CLOSED,
    RTR_MGR_CONNECTING,
    RTR_MGR_ESTABLISHED,
    RTR_MGR_ERROR,
};

struct rtr_mgr_group {
    struct rtr_socket **sockets;
    unsigned int sockets_len;
    uint8_t preference;
    enum rtr_mgr_status status;
};

typedef void (*rtr_mgr_status_fp)(const struct rtr_mgr_group *,
                  enum rtr_mgr_status,
                  const struct rtr_socket *,
                  void *);

struct tommy_list_wrapper;

//TODO Add refresh, expire, and retry intervals to config for easier access.
struct rtr_mgr_config {
    struct tommy_list_wrapper *groups;
    unsigned int len;
    pthread_mutex_t mutex;
    rtr_mgr_status_fp status_fp;
    void *status_fp_data;
    struct pfx_table *pfx_table;
    struct spki_table *spki_table;
};

int rtr_mgr_init(struct rtr_mgr_config **config_out,
         struct rtr_mgr_group groups[],
         const unsigned int groups_len,
         const unsigned int refresh_interval,
         const unsigned int expire_interval,
         const unsigned int retry_interval,
         const pfx_update_fp update_fp,
         const spki_update_fp spki_update_fp,
         const rtr_mgr_status_fp status_fp,
         void *status_fp_data);

int rtr_mgr_add_group(struct rtr_mgr_config *config,
              const struct rtr_mgr_group *group);
int rtr_mgr_remove_group(struct rtr_mgr_config *config,
             unsigned int preference);
void rtr_mgr_free(struct rtr_mgr_config *config);

int rtr_mgr_start(struct rtr_mgr_config *config);

void rtr_mgr_stop(struct rtr_mgr_config *config);

bool rtr_mgr_conf_in_sync(struct rtr_mgr_config *config);

int rtr_mgr_validate(struct rtr_mgr_config *config,
             const uint32_t asn,
             const struct lrtr_ip_addr *prefix,
             const uint8_t mask_len,
             enum pfxv_state *result);

int rtr_mgr_get_spki(struct rtr_mgr_config *config,
             const uint32_t asn,
             uint8_t *ski,
             struct spki_record **result,
             unsigned int *result_count);

const char *rtr_mgr_status_to_str(enum rtr_mgr_status status);

void rtr_mgr_for_each_ipv4_record(struct rtr_mgr_config *config,
                  pfx_for_each_fp fp,
                  void *data);

void rtr_mgr_for_each_ipv6_record(struct rtr_mgr_config *config,
                  pfx_for_each_fp fp,
                  void *data);

struct rtr_mgr_group *rtr_mgr_get_first_group(struct rtr_mgr_config *config);

int rtr_mgr_for_each_group(struct rtr_mgr_config *config,
               void (*fp)(const struct rtr_mgr_group *group,
                      void *data),
               void *data);
#endif
/* @} */

---