-#ifndef _LTTNG_UST_RCULFHASH_H
-#define _LTTNG_UST_RCULFHASH_H
-
/*
- * urcu/rculfhash.h
- *
- * Userspace RCU library - Lock-Free RCU Hash Table
- *
- * Copyright 2011 - Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
- * Copyright 2011 - Lai Jiangshan <laijs@cn.fujitsu.com>
+ * SPDX-License-Identifier: LGPL-2.1-or-later
*
- * This library is free software; you can redistribute it and/or
- * modify it under the terms of the GNU Lesser General Public
- * License as published by the Free Software Foundation; either
- * version 2.1 of the License, or (at your option) any later version.
+ * Copyright 2011 Mathieu Desnoyers <mathieu.desnoyers@efficios.com>
+ * Copyright 2011 Lai Jiangshan <laijs@cn.fujitsu.com>
*
- * This library is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- * Lesser General Public License for more details.
- *
- * You should have received a copy of the GNU Lesser General Public
- * License along with this library; if not, write to the Free Software
- * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+ * Userspace RCU library - Lock-Free RCU Hash Table
*/
+#ifndef _LTTNG_UST_RCULFHASH_H
+#define _LTTNG_UST_RCULFHASH_H
+
#include <stdint.h>
#include <pthread.h>
#include <urcu/compiler.h>
+#include "helper.h"
#ifdef __cplusplus
extern "C" {
unsigned long index);
};
+LTTNG_HIDDEN
extern const struct lttng_ust_lfht_mm_type lttng_ust_lfht_mm_order;
+LTTNG_HIDDEN
extern const struct lttng_ust_lfht_mm_type lttng_ust_lfht_mm_chunk;
+LTTNG_HIDDEN
extern const struct lttng_ust_lfht_mm_type lttng_ust_lfht_mm_mmap;
/*
* Return NULL on error.
* Note: the RCU flavor must be already included before the hash table header.
*/
-extern
-struct lttng_ust_lfht *lttng_ust_lfht_new(unsigned long init_size,
+LTTNG_HIDDEN
+extern struct lttng_ust_lfht *lttng_ust_lfht_new(unsigned long init_size,
unsigned long min_nr_alloc_buckets,
unsigned long max_nr_buckets,
int flags,
* thread to handle resize operations, which removes RCU requirements on
* lttng_ust_lfht_destroy.
*/
-extern
-int lttng_ust_lfht_destroy(struct lttng_ust_lfht *ht);
+LTTNG_HIDDEN
+extern int lttng_ust_lfht_destroy(struct lttng_ust_lfht *ht);
/*
* lttng_ust_lfht_count_nodes - count the number of nodes in the hash table.
* Call with rcu_read_lock held.
* Threads calling this API need to be registered RCU read-side threads.
*/
-extern
-void lttng_ust_lfht_count_nodes(struct lttng_ust_lfht *ht,
+LTTNG_HIDDEN
+extern void lttng_ust_lfht_count_nodes(struct lttng_ust_lfht *ht,
long *split_count_before,
unsigned long *count,
long *split_count_after);
* Threads calling this API need to be registered RCU read-side threads.
* This function acts as a rcu_dereference() to read the node pointer.
*/
-extern
-void lttng_ust_lfht_lookup(struct lttng_ust_lfht *ht, unsigned long hash,
+LTTNG_HIDDEN
+extern void lttng_ust_lfht_lookup(struct lttng_ust_lfht *ht, unsigned long hash,
lttng_ust_lfht_match_fct match, const void *key,
struct lttng_ust_lfht_iter *iter);
* Threads calling this API need to be registered RCU read-side threads.
* This function acts as a rcu_dereference() to read the node pointer.
*/
-extern
-void lttng_ust_lfht_next_duplicate(struct lttng_ust_lfht *ht,
+LTTNG_HIDDEN
+extern void lttng_ust_lfht_next_duplicate(struct lttng_ust_lfht *ht,
lttng_ust_lfht_match_fct match, const void *key,
struct lttng_ust_lfht_iter *iter);
* Threads calling this API need to be registered RCU read-side threads.
* This function acts as a rcu_dereference() to read the node pointer.
*/
-extern
-void lttng_ust_lfht_first(struct lttng_ust_lfht *ht, struct lttng_ust_lfht_iter *iter);
+LTTNG_HIDDEN
+extern void lttng_ust_lfht_first(struct lttng_ust_lfht *ht, struct lttng_ust_lfht_iter *iter);
/*
* lttng_ust_lfht_next - get the next node in the table.
* Threads calling this API need to be registered RCU read-side threads.
* This function acts as a rcu_dereference() to read the node pointer.
*/
-extern
-void lttng_ust_lfht_next(struct lttng_ust_lfht *ht, struct lttng_ust_lfht_iter *iter);
+LTTNG_HIDDEN
+extern void lttng_ust_lfht_next(struct lttng_ust_lfht *ht, struct lttng_ust_lfht_iter *iter);
/*
* lttng_ust_lfht_add - add a node to the hash table.
* This function issues a full memory barrier before and after its
* atomic commit.
*/
-extern
-void lttng_ust_lfht_add(struct lttng_ust_lfht *ht, unsigned long hash,
+LTTNG_HIDDEN
+extern void lttng_ust_lfht_add(struct lttng_ust_lfht *ht, unsigned long hash,
struct lttng_ust_lfht_node *node);
/*
* node pointer. The failure case does not guarantee any other memory
* barrier.
*/
-extern
-struct lttng_ust_lfht_node *lttng_ust_lfht_add_unique(struct lttng_ust_lfht *ht,
+LTTNG_HIDDEN
+extern struct lttng_ust_lfht_node *lttng_ust_lfht_add_unique(struct lttng_ust_lfht *ht,
unsigned long hash,
lttng_ust_lfht_match_fct match,
const void *key,
* This function issues a full memory barrier before and after its
* atomic commit.
*/
-extern
-struct lttng_ust_lfht_node *lttng_ust_lfht_add_replace(struct lttng_ust_lfht *ht,
+LTTNG_HIDDEN
+extern struct lttng_ust_lfht_node *lttng_ust_lfht_add_replace(struct lttng_ust_lfht *ht,
unsigned long hash,
lttng_ust_lfht_match_fct match,
const void *key,
* after its atomic commit. Upon failure, this function does not issue
* any memory barrier.
*/
-extern
-int lttng_ust_lfht_replace(struct lttng_ust_lfht *ht,
+LTTNG_HIDDEN
+extern int lttng_ust_lfht_replace(struct lttng_ust_lfht *ht,
struct lttng_ust_lfht_iter *old_iter,
unsigned long hash,
lttng_ust_lfht_match_fct match,
* after its atomic commit. Upon failure, this function does not issue
* any memory barrier.
*/
-extern
-int lttng_ust_lfht_del(struct lttng_ust_lfht *ht, struct lttng_ust_lfht_node *node);
+LTTNG_HIDDEN
+extern int lttng_ust_lfht_del(struct lttng_ust_lfht *ht, struct lttng_ust_lfht_node *node);
/*
* lttng_ust_lfht_is_node_deleted - query whether a node is removed from hash table.
* Threads calling this API need to be registered RCU read-side threads.
* This function does not issue any memory barrier.
*/
-extern
-int lttng_ust_lfht_is_node_deleted(const struct lttng_ust_lfht_node *node);
+LTTNG_HIDDEN
+extern int lttng_ust_lfht_is_node_deleted(const struct lttng_ust_lfht_node *node);
/*
* lttng_ust_lfht_resize - Force a hash table resize
* lttng_ust_lfht_resize should *not* be called from a RCU read-side critical
* section.
*/
-extern
-void lttng_ust_lfht_resize(struct lttng_ust_lfht *ht, unsigned long new_size);
+LTTNG_HIDDEN
+extern void lttng_ust_lfht_resize(struct lttng_ust_lfht *ht, unsigned long new_size);
/*
* Note: it is safe to perform element removal (del), replacement, or
projects / lttng-ust.git / blobdiff