Lustre Repository Browser

Viewing: lib-me.c

// SPDX-License-Identifier: GPL-2.0

/* Copyright (c) 2003, 2010, Oracle and/or its affiliates. All rights reserved.
 * Use is subject to license terms.
 *
 * Copyright (c) 2012, 2013, Intel Corporation.
 */

/* This file is part of Lustre, http://www.lustre.org/
 *
 * Match Entry management routines
 */

#define DEBUG_SUBSYSTEM S_LNET

#include <linux/lnet/lib-lnet.h>

/**
 * LNetMEAttach() - Create and attach a match entry to the match list of @portal
 * @portal: The portal table index where the ME should be attached.
 * @match_id: Specifies the match criteria for the process ID of
 *            the requester. The constants LNET_PID_ANY and LNET_NID_ANY can be
 *            used to wildcard either of the identifiers in the
 *            struct lnet_process_id structure.
 * @match_bits: Specify the match criteria to apply to the match bits in the
 *              incoming request.
 * @ignore_bits: Specify the match criteria to ignore
 *              The ignore bits are used to mask out insignificant bits in the
 *              incoming match bits. The resulting bits are then compared to
 *              the ME's match bits to determine if the incoming request meets
 *              the match criteria.
 * @unlink: Indicates whether the ME should be unlinked when the memory
 *          descriptor associated with it is unlinked (Note that the check for
 *          unlinking a ME only occurs when the memory descriptor is unlinked.).
 *          Valid values are LNET_RETAIN and LNET_UNLINK.
 * @pos: Indicates whether the new ME should be prepended or
 *       appended to the match list. Allowed constants: LNET_INS_BEFORE,
 *       LNET_INS_AFTER.
 *
 * Create and attach a match entry to the match list of @portal. The new
 * ME is empty, i.e. not associated with a memory descriptor. LNetMDAttach()
 * can be used to attach a MD to an empty ME.
 *
 * Return:
 * * A handle to the newly created ME is returned on success
 * * %ERR_PTR(-EINVAL) If @portal is invalid.
 * * %ERR_PTR(-ENOMEM) If new ME object cannot be allocated.
 */
struct lnet_me *
LNetMEAttach(unsigned int portal,
	     struct lnet_processid *match_id,
	     __u64 match_bits, __u64 ignore_bits,
	     enum lnet_unlink unlink, enum lnet_ins_pos pos)
{
	struct lnet_match_table *mtable;
	struct lnet_me		*me;
	struct list_head	*head;

	LASSERT(the_lnet.ln_refcount > 0);

	if ((int)portal >= the_lnet.ln_nportals)
		return ERR_PTR(-EINVAL);

	mtable = lnet_mt_of_attach(portal, match_id,
				   match_bits, ignore_bits, pos);
	if (mtable == NULL) /* can't match portal type */
		return ERR_PTR(-EPERM);

	me = kmem_cache_zalloc(lnet_mes_cachep, GFP_NOFS);
	if (me == NULL) {
		CDEBUG(D_MALLOC, "failed to allocate 'me'\n");
		return ERR_PTR(-ENOMEM);
	}
	LIBCFS_ALLOC_POST(me, sizeof(*me), "slab-alloced");

	lnet_res_lock(mtable->mt_cpt);

	me->me_portal = portal;
	me->me_match_id = *match_id;
	me->me_match_bits = match_bits;
	me->me_ignore_bits = ignore_bits;
	me->me_unlink = unlink;
	me->me_md = NULL;

	me->me_cpt = mtable->mt_cpt;

	if (ignore_bits != 0)
		head = &mtable->mt_mhash[LNET_MT_HASH_IGNORE];
	else
		head = lnet_mt_match_head(mtable, match_id, match_bits);

	me->me_pos = head - &mtable->mt_mhash[0];
	if (pos == LNET_INS_AFTER || pos == LNET_INS_LOCAL)
		list_add_tail(&me->me_list, head);
	else
		list_add(&me->me_list, head);

	lnet_res_unlock(mtable->mt_cpt);
	return me;
}
EXPORT_SYMBOL(LNetMEAttach);

/* call with lnet_res_lock please */
void
lnet_me_unlink(struct lnet_me *me)
{
	list_del(&me->me_list);

	if (me->me_md != NULL) {
		struct lnet_libmd *md = me->me_md;

		/* detach MD from portal of this ME */
		lnet_ptl_detach_md(me, md);
		lnet_md_unlink(md);
	}

	LIBCFS_FREE_PRE(me, sizeof(*me), "slab-freed");
	kmem_cache_free(lnet_mes_cachep, me);
}

#if 0
static void
lib_me_dump(struct lnet_me *me)
{
	CWARN("Match Entry %p (%#llx)\n", me,
	      me->me_lh.lh_cookie);

	CWARN("\tMatch/Ignore\t= %016lx / %016lx\n",
	      me->me_match_bits, me->me_ignore_bits);

	CWARN("\tMD\t= %p\n", me->md);
	CWARN("\tprev\t= %p\n",
	      list_entry(me->me_list.prev, struct lnet_me, me_list));
	CWARN("\tnext\t= %p\n",
	      list_entry(me->me_list.next, struct lnet_me, me_list));
}
#endif