| /* SPDX-License-Identifier: GPL-2.0 OR Linux-OpenIB */ |
| /* Copyright (c) 2019 Mellanox Technologies */ |
| |
| #ifndef __MLX5_MAPPING_H__ |
| #define __MLX5_MAPPING_H__ |
| |
| struct mapping_ctx; |
| |
| int mapping_add(struct mapping_ctx *ctx, void *data, u32 *id); |
| int mapping_remove(struct mapping_ctx *ctx, u32 id); |
| int mapping_find(struct mapping_ctx *ctx, u32 id, void *data); |
| |
| /* mapping uses an xarray to map data to ids in add(), and for find(). |
| * For locking, it uses a internal xarray spin lock for add()/remove(), |
| * find() uses rcu_read_lock(). |
| * Choosing delayed_removal postpones the removal of a previously mapped |
| * id by MAPPING_GRACE_PERIOD milliseconds. |
| * This is to avoid races against hardware, where we mark the packet in |
| * hardware with a previous id, and quick remove() and add() reusing the same |
| * previous id. Then find() will get the new mapping instead of the old |
| * which was used to mark the packet. |
| */ |
| struct mapping_ctx *mapping_create(size_t data_size, u32 max_id, |
| bool delayed_removal); |
| void mapping_destroy(struct mapping_ctx *ctx); |
| |
| /* adds mapping with an id or get an existing mapping with the same id |
| */ |
| struct mapping_ctx * |
| mapping_create_for_id(u64 id, u8 type, size_t data_size, u32 max_id, bool delayed_removal); |
| |
| #endif /* __MLX5_MAPPING_H__ */ |
