root/drivers/net/ethernet/mellanox/mlx5/core/lib/devcom.h
/* SPDX-License-Identifier: GPL-2.0 OR Linux-OpenIB */
/* Copyright (c) 2018 Mellanox Technologies */

#ifndef __LIB_MLX5_DEVCOM_H__
#define __LIB_MLX5_DEVCOM_H__

#include <linux/mlx5/driver.h>

enum mlx5_devom_match_flags {
        MLX5_DEVCOM_MATCH_FLAGS_NS = BIT(0),
};

#define MLX5_DEVCOM_MATCH_KEY_MAX 32
union mlx5_devcom_match_key {
        u64 val;
        u8 buf[MLX5_DEVCOM_MATCH_KEY_MAX];
};

struct mlx5_devcom_match_attr {
        u32 flags;
        union mlx5_devcom_match_key key;
        struct net *net;
};

enum mlx5_devcom_component {
        MLX5_DEVCOM_ESW_OFFLOADS,
        MLX5_DEVCOM_MPV,
        MLX5_DEVCOM_HCA_PORTS,
        MLX5_DEVCOM_SD_GROUP,
        MLX5_DEVCOM_SHARED_CLOCK,
        MLX5_DEVCOM_NUM_COMPONENTS,
};

typedef int (*mlx5_devcom_event_handler_t)(int event,
                                           void *my_data,
                                           void *event_data);

struct mlx5_devcom_dev *mlx5_devcom_register_device(struct mlx5_core_dev *dev);
void mlx5_devcom_unregister_device(struct mlx5_devcom_dev *devc);

struct mlx5_devcom_comp_dev *
mlx5_devcom_register_component(struct mlx5_devcom_dev *devc,
                               enum mlx5_devcom_component id,
                               const struct mlx5_devcom_match_attr *attr,
                               mlx5_devcom_event_handler_t handler,
                               void *data);
void mlx5_devcom_unregister_component(struct mlx5_devcom_comp_dev *devcom);

int mlx5_devcom_send_event(struct mlx5_devcom_comp_dev *devcom,
                           int event, int rollback_event,
                           void *event_data);
int mlx5_devcom_comp_get_size(struct mlx5_devcom_comp_dev *devcom);

void mlx5_devcom_comp_set_ready(struct mlx5_devcom_comp_dev *devcom, bool ready);
bool mlx5_devcom_comp_is_ready(struct mlx5_devcom_comp_dev *devcom);

bool mlx5_devcom_for_each_peer_begin(struct mlx5_devcom_comp_dev *devcom);
void mlx5_devcom_for_each_peer_end(struct mlx5_devcom_comp_dev *devcom);
void *mlx5_devcom_get_next_peer_data(struct mlx5_devcom_comp_dev *devcom,
                                     struct mlx5_devcom_comp_dev **pos);

#define mlx5_devcom_for_each_peer_entry(devcom, data, pos)                    \
        for (pos = NULL, data = mlx5_devcom_get_next_peer_data(devcom, &pos); \
             data;                                                            \
             data = mlx5_devcom_get_next_peer_data(devcom, &pos))

void *mlx5_devcom_get_next_peer_data_rcu(struct mlx5_devcom_comp_dev *devcom,
                                         struct mlx5_devcom_comp_dev **pos);

#define mlx5_devcom_for_each_peer_entry_rcu(devcom, data, pos)                    \
        for (pos = NULL, data = mlx5_devcom_get_next_peer_data_rcu(devcom, &pos); \
             data;                                                                \
             data = mlx5_devcom_get_next_peer_data_rcu(devcom, &pos))

void mlx5_devcom_comp_lock(struct mlx5_devcom_comp_dev *devcom);
void mlx5_devcom_comp_unlock(struct mlx5_devcom_comp_dev *devcom);
int mlx5_devcom_comp_trylock(struct mlx5_devcom_comp_dev *devcom);

#endif /* __LIB_MLX5_DEVCOM_H__ */