-/* -*- mode: c; c-basic-offset: 8; indent-tabs-mode: nil; -*-
- * vim:expandtab:shiftwidth=8:tabstop=8:
+/*
+ * GPL HEADER START
*
- * Copyright (c) 2002, 2003 Cluster File Systems, Inc.
- * Author: Peter Braam <braam@clusterfs.com>
- * Author: Phil Schwan <phil@clusterfs.com>
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
- * This file is part of Lustre, http://www.lustre.org.
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License version 2 only,
+ * as published by the Free Software Foundation.
*
- * Lustre is free software; you can redistribute it and/or
- * modify it under the terms of version 2 of the GNU General Public
- * License as published by the Free Software Foundation.
+ * This program 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
+ * General Public License version 2 for more details (a copy is included
+ * in the LICENSE file that accompanied this code).
*
- * Lustre 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 General Public License for more details.
+ * You should have received a copy of the GNU General Public License
+ * version 2 along with this program; If not, see
+ * http://www.gnu.org/licenses/gpl-2.0.html
*
- * You should have received a copy of the GNU General Public License
- * along with Lustre; if not, write to the Free Software
- * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ * GPL HEADER END
+ */
+/*
+ * Copyright (c) 2003, 2010, Oracle and/or its affiliates. All rights reserved.
+ * Use is subject to license terms.
+ *
+ * Copyright (c) 2011, 2017, Intel Corporation.
+ */
+/*
+ * This file is part of Lustre, http://www.lustre.org/
+ * Lustre is a trademark of Sun Microsystems, Inc.
+ *
+ * lustre/ldlm/ldlm_plain.c
+ *
+ * Author: Peter Braam <braam@clusterfs.com>
+ * Author: Phil Schwan <phil@clusterfs.com>
+ */
+
+/**
+ * This file contains implementation of PLAIN lock type.
+ *
+ * PLAIN locks are the simplest form of LDLM locking, and are used when
+ * there only needs to be a single lock on a resource. This avoids some
+ * of the complexity of EXTENT and IBITS lock types, but doesn't allow
+ * different "parts" of a resource to be locked concurrently. Example
+ * use cases for PLAIN locks include locking of MGS configuration logs
+ * and (as of Lustre 2.4) quota records.
*/
#define DEBUG_SUBSYSTEM S_LDLM
-#ifdef __KERNEL__
-#include <linux/lustre_dlm.h>
-#include <linux/obd_support.h>
-#include <linux/lustre_lib.h>
-#else
-#include <liblustre.h>
-#endif
-
-static int
-ldlm_plain_compat_queue(struct list_head *queue, struct ldlm_lock *new,
- int send_cbs, int first_enq)
+#include <lustre_dlm.h>
+#include <obd_support.h>
+#include <lustre_lib.h>
+
+#include "ldlm_internal.h"
+
+#ifdef HAVE_SERVER_SUPPORT
+/**
+ * Determine if the lock is compatible with all locks on the queue.
+ *
+ * If \a work_list is provided, conflicting locks are linked there.
+ * If \a work_list is not provided, we exit this function on first conflict.
+ *
+ * \retval 0 if there are conflicting locks in the \a queue
+ * \retval 1 if the lock is compatible to all locks in \a queue
+ */
+static inline int
+ldlm_plain_compat_queue(struct list_head *queue, struct ldlm_lock *req,
+ struct list_head *work_list)
+{
+ enum ldlm_mode req_mode = req->l_req_mode;
+ struct ldlm_lock *lock, *next_lock;
+ int compat = 1;
+
+ ENTRY;
+ lockmode_verify(req_mode);
+
+ list_for_each_entry_safe(lock, next_lock, queue, l_res_link) {
+
+ /*
+ * We stop walking the queue if we hit ourselves so we don't
+ * take conflicting locks enqueued after us into account,
+ * or we'd wait forever.
+ */
+ if (req == lock)
+ RETURN(compat);
+
+ /* Advance loop cursor to last lock of mode group. */
+ next_lock = list_entry(list_entry(lock->l_sl_mode.prev,
+ struct ldlm_lock,
+ l_sl_mode)->l_res_link.next,
+ struct ldlm_lock, l_res_link);
+
+ if (lockmode_compat(lock->l_req_mode, req_mode))
+ continue;
+
+ if (!work_list)
+ RETURN(0);
+
+ compat = 0;
+
+ /*
+ * Add locks of the mode group to \a work_list as
+ * blocking locks for \a req.
+ */
+ if (lock->l_blocking_ast)
+ ldlm_add_ast_work_item(lock, req, work_list);
+
+ {
+ struct list_head *head;
+
+ head = &lock->l_sl_mode;
+ list_for_each_entry(lock, head, l_sl_mode)
+ if (lock->l_blocking_ast)
+ ldlm_add_ast_work_item(lock, req,
+ work_list);
+ }
+ }
+
+ RETURN(compat);
+}
+
+/**
+ * Process a granting attempt for plain lock.
+ * Must be called with ns lock held.
+ *
+ * This function looks for any conflicts for \a lock in the granted or
+ * waiting queues. The lock is granted if no conflicts are found in
+ * either queue.
+ */
+int ldlm_process_plain_lock(struct ldlm_lock *lock, __u64 *flags,
+ enum ldlm_process_intention intention,
+ enum ldlm_error *err, struct list_head *work_list)
+{
+ struct ldlm_resource *res = lock->l_resource;
+ struct list_head *grant_work = intention == LDLM_PROCESS_ENQUEUE ?
+ NULL : work_list;
+ int rc;
+
+ ENTRY;
+ LASSERT(!ldlm_is_granted(lock));
+ check_res_locked(res);
+ *err = ELDLM_OK;
+
+ if (intention == LDLM_PROCESS_RESCAN) {
+ LASSERT(work_list != NULL);
+ rc = ldlm_plain_compat_queue(&res->lr_granted, lock, NULL);
+ if (!rc)
+ RETURN(LDLM_ITER_STOP);
+ rc = ldlm_plain_compat_queue(&res->lr_waiting, lock, NULL);
+ if (!rc)
+ RETURN(LDLM_ITER_STOP);
+
+ ldlm_resource_unlink_lock(lock);
+ ldlm_grant_lock(lock, grant_work);
+ RETURN(LDLM_ITER_CONTINUE);
+ }
+
+ rc = ldlm_plain_compat_queue(&res->lr_granted, lock, work_list);
+ rc += ldlm_plain_compat_queue(&res->lr_waiting, lock, work_list);
+
+ if (rc == 2) {
+ ldlm_resource_unlink_lock(lock);
+ ldlm_grant_lock(lock, grant_work);
+ }
+
+ RETURN(LDLM_ITER_CONTINUE);
+}
+#endif /* HAVE_SERVER_SUPPORT */
+
+void ldlm_plain_policy_wire_to_local(const union ldlm_wire_policy_data *wpolicy,
+ union ldlm_policy_data *lpolicy)
{
- struct list_head *tmp, *pos;
- ldlm_mode_t mode = new->l_req_mode;
- int compat = 1;
- ENTRY;
-
- list_for_each_safe(tmp, pos, queue) {
- struct ldlm_lock *old;
-
- old = list_entry(tmp, struct ldlm_lock, l_res_link);
- if (old == new)
- continue;
-
- if (lockmode_compat(old->l_req_mode, mode) &&
- lockmode_compat(old->l_granted_mode, mode)) {
- CDEBUG(D_OTHER, "lock modes are compatible, next.\n");
- continue;
- }
-
- compat = 0;
-
- /* if we're reprocessing the lock then the blocking ASTs
- * have already been sent. No need to continue. */
- if (!first_enq)
- break;
-
- if (send_cbs && (old->l_blocking_ast != NULL)) {
- CDEBUG(D_DLMTRACE, "lock %p incompatible; "
- "sending blocking AST.\n", old);
- ldlm_add_ast_work_item(old, new, NULL, 0);
- } else if (!(old->l_flags & LDLM_FL_LOCAL)) {
- CDEBUG(D_DLMTRACE, "lock %p incompatible; "
- "setting blocking AST.\n", old);
- old->l_flags |= LDLM_FL_AST_SENT;
- } else {
- CDEBUG(D_DLMTRACE, "local lock %p incompatible.\n",
- old);
- }
- }
-
- RETURN(compat);
+ /* No policy for plain locks */
}
-int
-ldlm_plain_enqueue(struct ldlm_lock **lockp, void *cookie, int *flags,
- int first_enq, ldlm_error_t *err)
+void ldlm_plain_policy_local_to_wire(const union ldlm_policy_data *lpolicy,
+ union ldlm_wire_policy_data *wpolicy)
{
- struct ldlm_lock *lock = *lockp;
- struct ldlm_resource *res = lock->l_resource;
- int convert_compat = 1;
- int waiting_compat = 1;
- int granted_compat = 1;
- ENTRY;
-
- /* FIXME: We may want to optimize by checking lr_most_restr */
-
- /* On the first enqueue of this lock scan all of the queues
- * to set the LDLM_FL_AST_SENT flag in conflicting locks.
- * When the completion AST on the client side runs and sees
- * this flag is will set the LDLM_FL_CB_PENDING flag in the
- * lock so the client will know to cancel the lock as soon
- * as possible. This saves us from sending a blocking AST
- * in addition to the completion AST.
- *
- * If it's NOT the first enqueue of this lock then it must be
- * the first eligible lock in the queues because of the way that
- * ldlm_reprocess_all() works. So we don't have to check the
- * converting or waiting queues. */
- if (first_enq) {
- if (!list_empty(&res->lr_converting)) {
- convert_compat = 0;
- ldlm_plain_compat_queue(&res->lr_converting,
- lock, 0, first_enq);
- }
- if (!list_empty(&res->lr_waiting)) {
- waiting_compat = 0;
- ldlm_plain_compat_queue(&res->lr_waiting,
- lock, 0, first_enq);
- }
- }
- granted_compat =
- ldlm_plain_compat_queue(&res->lr_granted, lock, 1, first_enq);
-
- if (!convert_compat) {
- *flags |= LDLM_FL_BLOCK_CONV;
- RETURN(LDLM_ITER_STOP);
- }
- if (!waiting_compat) {
- *flags |= LDLM_FL_BLOCK_WAIT;
- RETURN(LDLM_ITER_STOP);
- }
- if (!granted_compat) {
- *flags |= LDLM_FL_BLOCK_GRANTED;
- RETURN(LDLM_ITER_STOP);
- }
-
- list_del_init(&lock->l_res_link);
- ldlm_grant_lock(lock, NULL, 0);
-
- if (lock->l_flags & LDLM_FL_AST_SENT) {
- CDEBUG(D_DLMTRACE, "granted lock %p with AST set\n", lock);
- *flags |= (lock->l_flags & LDLM_FL_AST_SENT);
- }
-
- RETURN(LDLM_ITER_CONTINUE);
+ /* No policy for plain locks */
}