1 /* SPDX-License-Identifier: GPL-2.0 OR Linux-OpenIB */
3 * Copyright (c) 2016 Mellanox Technologies Ltd. All rights reserved.
4 * Copyright (c) 2015 System Fabric Works, Inc. All rights reserved.
10 #define RXE_POOL_ALIGN (16)
11 #define RXE_POOL_CACHE_FLAGS (0)
14 RXE_POOL_ATOMIC = BIT(0),
15 RXE_POOL_INDEX = BIT(1),
16 RXE_POOL_KEY = BIT(2),
17 RXE_POOL_NO_ALLOC = BIT(4),
31 RXE_NUM_TYPES, /* keep me last */
34 struct rxe_pool_entry;
36 struct rxe_type_info {
39 void (*cleanup)(struct rxe_pool_entry *obj);
40 enum rxe_pool_flags flags;
47 extern struct rxe_type_info rxe_type_info[];
50 RXE_POOL_STATE_INVALID,
54 struct rxe_pool_entry {
55 struct rxe_pool *pool;
57 struct list_head list;
59 /* only used if indexed or keyed */
66 rwlock_t pool_lock; /* protects pool add/del/search */
69 void (*cleanup)(struct rxe_pool_entry *obj);
70 enum rxe_pool_state state;
71 enum rxe_pool_flags flags;
72 enum rxe_elem_type type;
74 unsigned int max_elem;
77 /* only used if indexed or keyed */
88 /* initialize a pool of objects with given limit on
89 * number of elements. gets parameters from rxe_type_info
90 * pool elements will be allocated out of a slab cache
92 int rxe_pool_init(struct rxe_dev *rxe, struct rxe_pool *pool,
93 enum rxe_elem_type type, u32 max_elem);
95 /* free resources from object pool */
96 void rxe_pool_cleanup(struct rxe_pool *pool);
98 /* allocate an object from pool */
99 void *rxe_alloc(struct rxe_pool *pool);
101 /* connect already allocated object to pool */
102 int rxe_add_to_pool(struct rxe_pool *pool, struct rxe_pool_entry *elem);
104 /* assign an index to an indexed object and insert object into
107 void rxe_add_index(void *elem);
109 /* drop an index and remove object from rb tree */
110 void rxe_drop_index(void *elem);
112 /* assign a key to a keyed object and insert object into
115 void rxe_add_key(void *elem, void *key);
117 /* remove elem from rb tree */
118 void rxe_drop_key(void *elem);
120 /* lookup an indexed object from index. takes a reference on object */
121 void *rxe_pool_get_index(struct rxe_pool *pool, u32 index);
123 /* lookup keyed object from key. takes a reference on the object */
124 void *rxe_pool_get_key(struct rxe_pool *pool, void *key);
126 /* cleanup an object when all references are dropped */
127 void rxe_elem_release(struct kref *kref);
129 /* take a reference on an object */
130 #define rxe_add_ref(elem) kref_get(&(elem)->pelem.ref_cnt)
132 /* drop a reference on an object */
133 #define rxe_drop_ref(elem) kref_put(&(elem)->pelem.ref_cnt, rxe_elem_release)
135 #endif /* RXE_POOL_H */