Blame opae-libs/plugins/xfpga/wsid_list.c

Packit 534379
// Copyright(c) 2017-2018, Intel Corporation
Packit 534379
//
Packit 534379
// Redistribution  and  use  in source  and  binary  forms,  with  or  without
Packit 534379
// modification, are permitted provided that the following conditions are met:
Packit 534379
//
Packit 534379
// * Redistributions of  source code  must retain the  above copyright notice,
Packit 534379
//   this list of conditions and the following disclaimer.
Packit 534379
// * Redistributions in binary form must reproduce the above copyright notice,
Packit 534379
//   this list of conditions and the following disclaimer in the documentation
Packit 534379
//   and/or other materials provided with the distribution.
Packit 534379
// * Neither the name  of Intel Corporation  nor the names of its contributors
Packit 534379
//   may be used to  endorse or promote  products derived  from this  software
Packit 534379
//   without specific prior written permission.
Packit 534379
//
Packit 534379
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
Packit 534379
// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING,  BUT NOT LIMITED TO,  THE
Packit 534379
// IMPLIED WARRANTIES OF  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
Packit 534379
// ARE DISCLAIMED.  IN NO EVENT  SHALL THE COPYRIGHT OWNER  OR CONTRIBUTORS BE
Packit 534379
// LIABLE  FOR  ANY  DIRECT,  INDIRECT,  INCIDENTAL,  SPECIAL,  EXEMPLARY,  OR
Packit 534379
// CONSEQUENTIAL  DAMAGES  (INCLUDING,  BUT  NOT LIMITED  TO,  PROCUREMENT  OF
Packit 534379
// SUBSTITUTE GOODS OR SERVICES;  LOSS OF USE,  DATA, OR PROFITS;  OR BUSINESS
Packit 534379
// INTERRUPTION)  HOWEVER CAUSED  AND ON ANY THEORY  OF LIABILITY,  WHETHER IN
Packit 534379
// CONTRACT,  STRICT LIABILITY,  OR TORT  (INCLUDING NEGLIGENCE  OR OTHERWISE)
Packit 534379
// ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,  EVEN IF ADVISED OF THE
Packit 534379
// POSSIBILITY OF SUCH DAMAGE.
Packit 534379
Packit 534379
#ifdef HAVE_CONFIG_H
Packit 534379
#include <config.h>
Packit 534379
#endif // HAVE_CONFIG_H
Packit 534379
Packit 534379
#include <stdio.h>
Packit 534379
#include <stdlib.h>
Packit 534379
#include <pthread.h>
Packit 534379
#include "wsid_list_int.h"
Packit 534379
Packit 534379
/*
Packit 534379
 * The code here assumes the caller handles any required mutexes.
Packit 534379
 * The logic here is not thread safe on its own.
Packit 534379
 */
Packit 534379
Packit 534379
/**
Packit 534379
 * @brief Initialize a wsid tracker hash table
Packit 534379
 * @param n_hash_buckets
Packit 534379
 *
Packit 534379
 * @return
Packit 534379
 */
Packit 534379
struct wsid_tracker *wsid_tracker_init(uint32_t n_hash_buckets)
Packit 534379
{
Packit 534379
	if (!n_hash_buckets || (n_hash_buckets > 16384))
Packit 534379
		return NULL;
Packit 534379
Packit 534379
	struct wsid_tracker *root = malloc(sizeof(struct wsid_tracker));
Packit 534379
	if (!root)
Packit 534379
		return NULL;
Packit 534379
Packit 534379
	root->n_hash_buckets = n_hash_buckets;
Packit 534379
	root->table = calloc(n_hash_buckets, sizeof(struct wsid_map *));
Packit 534379
	if (!root->table) {
Packit 534379
		free(root);
Packit 534379
		return NULL;
Packit 534379
	}
Packit 534379
Packit 534379
	return root;
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @brief Map WSID to hash bucket index
Packit 534379
 * @param root
Packit 534379
 * @param wsid
Packit 534379
 *
Packit 534379
 * @return bucket index
Packit 534379
 */
Packit 534379
static inline uint32_t wsid_hash(struct wsid_tracker *root, uint64_t wsid)
Packit 534379
{
Packit 534379
	uint64_t h = wsid % 17659;
Packit 534379
	return h % root->n_hash_buckets;
Packit 534379
}
Packit 534379
Packit 534379
Packit 534379
/**
Packit 534379
 * @brief Add entry to WSID tracker
Packit 534379
 *        Will allocate memory (which is freed by wsid_del() or
Packit 534379
 *        wsid_tracker_cleanup())
Packit 534379
 * @param root
Packit 534379
 * @param wsid
Packit 534379
 * @param addr
Packit 534379
 * @param phys
Packit 534379
 * @param len
Packit 534379
 * @param offset
Packit 534379
 *
Packit 534379
 * @return true if success, false otherwise
Packit 534379
 */
Packit 534379
bool wsid_add(struct wsid_tracker *root,
Packit 534379
	      uint64_t wsid,
Packit 534379
	      uint64_t addr,
Packit 534379
	      uint64_t phys,
Packit 534379
	      uint64_t len,
Packit 534379
	      uint64_t offset,
Packit 534379
	      uint64_t index,
Packit 534379
	      int flags)
Packit 534379
{
Packit 534379
	uint32_t idx = wsid_hash(root, wsid);
Packit 534379
	struct wsid_map *tmp = malloc(sizeof(struct wsid_map));
Packit 534379
Packit 534379
	if (!tmp)
Packit 534379
		return false;
Packit 534379
Packit 534379
	tmp->wsid   = wsid;
Packit 534379
	tmp->addr   = addr;
Packit 534379
	tmp->phys   = phys;
Packit 534379
	tmp->len    = len;
Packit 534379
	tmp->offset = offset;
Packit 534379
	tmp->index  = index;
Packit 534379
	tmp->flags  = flags;
Packit 534379
	tmp->next   = root->table[idx];
Packit 534379
Packit 534379
	root->table[idx] = tmp;
Packit 534379
	return true;
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @brief Remove entry from tracker
Packit 534379
 *
Packit 534379
 * @param root
Packit 534379
 * @param wsid
Packit 534379
 *
Packit 534379
 * @return true if success, false otherwise
Packit 534379
 */
Packit 534379
bool wsid_del(struct wsid_tracker *root, uint64_t wsid)
Packit 534379
{
Packit 534379
	uint32_t idx = wsid_hash(root, wsid);
Packit 534379
	struct wsid_map *tmp = root->table[idx];
Packit 534379
Packit 534379
	if (!tmp)
Packit 534379
		return false; /* empty list */
Packit 534379
Packit 534379
	if (tmp->wsid == wsid) { /* first entry */
Packit 534379
		root->table[idx] = root->table[idx]->next;
Packit 534379
		free(tmp);
Packit 534379
		return true;
Packit 534379
	}
Packit 534379
Packit 534379
	while (tmp->next && tmp->next->wsid != wsid) { /* find */
Packit 534379
		tmp = tmp->next;
Packit 534379
	}
Packit 534379
Packit 534379
	if (!tmp->next)
Packit 534379
		return false; /* not found */
Packit 534379
Packit 534379
	struct wsid_map *tmp2 = tmp->next;
Packit 534379
	tmp->next = tmp->next->next;
Packit 534379
	free(tmp2);
Packit 534379
Packit 534379
	return true;
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @brief Clean up remaining entries in linked list
Packit 534379
 *        Will delete all remaining entries
Packit 534379
 *
Packit 534379
 * @param root
Packit 534379
 */
Packit 534379
void wsid_tracker_cleanup(struct wsid_tracker *root,
Packit 534379
			  void (*clean)(struct wsid_map *))
Packit 534379
{
Packit 534379
	uint32_t idx;
Packit 534379
Packit 534379
	if (!root)
Packit 534379
		return;
Packit 534379
Packit 534379
	for (idx = 0; idx < root->n_hash_buckets; idx += 1) {
Packit 534379
		struct wsid_map *tmp = root->table[idx];
Packit 534379
Packit 534379
		while (tmp) {
Packit 534379
			struct wsid_map *tmp2 = tmp->next;
Packit 534379
			if (clean)
Packit 534379
				clean(tmp);
Packit 534379
			free(tmp);
Packit 534379
			tmp = tmp2;
Packit 534379
		}
Packit 534379
	}
Packit 534379
Packit 534379
	free(root->table);
Packit 534379
	free(root);
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @ brief Find entry in linked list
Packit 534379
 *
Packit 534379
 * @param root
Packit 534379
 * @param wsid
Packit 534379
 *
Packit 534379
 * @return
Packit 534379
 */
Packit 534379
struct wsid_map *wsid_find(struct wsid_tracker *root, uint64_t wsid)
Packit 534379
{
Packit 534379
	uint32_t idx = wsid_hash(root, wsid);
Packit 534379
	struct wsid_map *tmp = root->table[idx];
Packit 534379
Packit 534379
	while (tmp && tmp->wsid != wsid)
Packit 534379
		tmp = tmp->next;
Packit 534379
Packit 534379
	return tmp;
Packit 534379
}
Packit 534379
Packit 534379
/**
Packit 534379
 * @ brief Find entry in linked list
Packit 534379
 *
Packit 534379
 * @param root
Packit 534379
 * @param index
Packit 534379
 *
Packit 534379
 * @return
Packit 534379
 */
Packit 534379
struct wsid_map *wsid_find_by_index(struct wsid_tracker *root, uint32_t index)
Packit 534379
{
Packit 534379
    /*
Packit 534379
     * The hash table isn't set up for finding by index, but this search is
Packit 534379
     * used only for MMIO spaces, which should have a small number of entries.
Packit 534379
     */
Packit 534379
	uint32_t idx;
Packit 534379
	for (idx = 0; idx < root->n_hash_buckets; idx += 1) {
Packit 534379
		struct wsid_map *tmp = root->table[idx];
Packit 534379
Packit 534379
		while (tmp && tmp->index != index)
Packit 534379
			tmp = tmp->next;
Packit 534379
Packit 534379
		if (tmp)
Packit 534379
			return tmp;
Packit 534379
	}
Packit 534379
Packit 534379
	return NULL;
Packit 534379
}
Packit 534379