ocfs2/userdlm: Add tracing in userdlm
[linux-2.6/linux-acpi-2.6/ibm-acpi-2.6.git] / fs / ocfs2 / dlmfs / userdlm.c
blob0499e3fb7bdbdb6b0087ec233167252e6162aeda
1 /* -*- mode: c; c-basic-offset: 8; -*-
2 * vim: noexpandtab sw=8 ts=8 sts=0:
4 * userdlm.c
6 * Code which implements the kernel side of a minimal userspace
7 * interface to our DLM.
9 * Many of the functions here are pared down versions of dlmglue.c
10 * functions.
12 * Copyright (C) 2003, 2004 Oracle. All rights reserved.
14 * This program is free software; you can redistribute it and/or
15 * modify it under the terms of the GNU General Public
16 * License as published by the Free Software Foundation; either
17 * version 2 of the License, or (at your option) any later version.
19 * This program is distributed in the hope that it will be useful,
20 * but WITHOUT ANY WARRANTY; without even the implied warranty of
21 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
22 * General Public License for more details.
24 * You should have received a copy of the GNU General Public
25 * License along with this program; if not, write to the
26 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
27 * Boston, MA 021110-1307, USA.
30 #include <linux/signal.h>
32 #include <linux/module.h>
33 #include <linux/fs.h>
34 #include <linux/types.h>
35 #include <linux/crc32.h>
37 #include "ocfs2_lockingver.h"
38 #include "stackglue.h"
39 #include "userdlm.h"
41 #define MLOG_MASK_PREFIX ML_DLMFS
42 #include "cluster/masklog.h"
45 static inline struct user_lock_res *user_lksb_to_lock_res(struct ocfs2_dlm_lksb *lksb)
47 return container_of(lksb, struct user_lock_res, l_lksb);
50 static inline int user_check_wait_flag(struct user_lock_res *lockres,
51 int flag)
53 int ret;
55 spin_lock(&lockres->l_lock);
56 ret = lockres->l_flags & flag;
57 spin_unlock(&lockres->l_lock);
59 return ret;
62 static inline void user_wait_on_busy_lock(struct user_lock_res *lockres)
65 wait_event(lockres->l_event,
66 !user_check_wait_flag(lockres, USER_LOCK_BUSY));
69 static inline void user_wait_on_blocked_lock(struct user_lock_res *lockres)
72 wait_event(lockres->l_event,
73 !user_check_wait_flag(lockres, USER_LOCK_BLOCKED));
76 /* I heart container_of... */
77 static inline struct ocfs2_cluster_connection *
78 cluster_connection_from_user_lockres(struct user_lock_res *lockres)
80 struct dlmfs_inode_private *ip;
82 ip = container_of(lockres,
83 struct dlmfs_inode_private,
84 ip_lockres);
85 return ip->ip_conn;
88 static struct inode *
89 user_dlm_inode_from_user_lockres(struct user_lock_res *lockres)
91 struct dlmfs_inode_private *ip;
93 ip = container_of(lockres,
94 struct dlmfs_inode_private,
95 ip_lockres);
96 return &ip->ip_vfs_inode;
99 static inline void user_recover_from_dlm_error(struct user_lock_res *lockres)
101 spin_lock(&lockres->l_lock);
102 lockres->l_flags &= ~USER_LOCK_BUSY;
103 spin_unlock(&lockres->l_lock);
106 #define user_log_dlm_error(_func, _stat, _lockres) do { \
107 mlog(ML_ERROR, "Dlm error %d while calling %s on " \
108 "resource %.*s\n", _stat, _func, \
109 _lockres->l_namelen, _lockres->l_name); \
110 } while (0)
112 /* WARNING: This function lives in a world where the only three lock
113 * levels are EX, PR, and NL. It *will* have to be adjusted when more
114 * lock types are added. */
115 static inline int user_highest_compat_lock_level(int level)
117 int new_level = DLM_LOCK_EX;
119 if (level == DLM_LOCK_EX)
120 new_level = DLM_LOCK_NL;
121 else if (level == DLM_LOCK_PR)
122 new_level = DLM_LOCK_PR;
123 return new_level;
126 static void user_ast(struct ocfs2_dlm_lksb *lksb)
128 struct user_lock_res *lockres = user_lksb_to_lock_res(lksb);
129 int status;
131 mlog(ML_BASTS, "AST fired for lockres %.*s, level %d => %d\n",
132 lockres->l_namelen, lockres->l_name, lockres->l_level,
133 lockres->l_requested);
135 spin_lock(&lockres->l_lock);
137 status = ocfs2_dlm_lock_status(&lockres->l_lksb);
138 if (status) {
139 mlog(ML_ERROR, "lksb status value of %u on lockres %.*s\n",
140 status, lockres->l_namelen, lockres->l_name);
141 spin_unlock(&lockres->l_lock);
142 return;
145 mlog_bug_on_msg(lockres->l_requested == DLM_LOCK_IV,
146 "Lockres %.*s, requested ivmode. flags 0x%x\n",
147 lockres->l_namelen, lockres->l_name, lockres->l_flags);
149 /* we're downconverting. */
150 if (lockres->l_requested < lockres->l_level) {
151 if (lockres->l_requested <=
152 user_highest_compat_lock_level(lockres->l_blocking)) {
153 lockres->l_blocking = DLM_LOCK_NL;
154 lockres->l_flags &= ~USER_LOCK_BLOCKED;
158 lockres->l_level = lockres->l_requested;
159 lockres->l_requested = DLM_LOCK_IV;
160 lockres->l_flags |= USER_LOCK_ATTACHED;
161 lockres->l_flags &= ~USER_LOCK_BUSY;
163 spin_unlock(&lockres->l_lock);
165 wake_up(&lockres->l_event);
168 static inline void user_dlm_grab_inode_ref(struct user_lock_res *lockres)
170 struct inode *inode;
171 inode = user_dlm_inode_from_user_lockres(lockres);
172 if (!igrab(inode))
173 BUG();
176 static void user_dlm_unblock_lock(struct work_struct *work);
178 static void __user_dlm_queue_lockres(struct user_lock_res *lockres)
180 if (!(lockres->l_flags & USER_LOCK_QUEUED)) {
181 user_dlm_grab_inode_ref(lockres);
183 INIT_WORK(&lockres->l_work, user_dlm_unblock_lock);
185 queue_work(user_dlm_worker, &lockres->l_work);
186 lockres->l_flags |= USER_LOCK_QUEUED;
190 static void __user_dlm_cond_queue_lockres(struct user_lock_res *lockres)
192 int queue = 0;
194 if (!(lockres->l_flags & USER_LOCK_BLOCKED))
195 return;
197 switch (lockres->l_blocking) {
198 case DLM_LOCK_EX:
199 if (!lockres->l_ex_holders && !lockres->l_ro_holders)
200 queue = 1;
201 break;
202 case DLM_LOCK_PR:
203 if (!lockres->l_ex_holders)
204 queue = 1;
205 break;
206 default:
207 BUG();
210 if (queue)
211 __user_dlm_queue_lockres(lockres);
214 static void user_bast(struct ocfs2_dlm_lksb *lksb, int level)
216 struct user_lock_res *lockres = user_lksb_to_lock_res(lksb);
218 mlog(ML_BASTS, "BAST fired for lockres %.*s, blocking %d, level %d\n",
219 lockres->l_namelen, lockres->l_name, level, lockres->l_level);
221 spin_lock(&lockres->l_lock);
222 lockres->l_flags |= USER_LOCK_BLOCKED;
223 if (level > lockres->l_blocking)
224 lockres->l_blocking = level;
226 __user_dlm_queue_lockres(lockres);
227 spin_unlock(&lockres->l_lock);
229 wake_up(&lockres->l_event);
232 static void user_unlock_ast(struct ocfs2_dlm_lksb *lksb, int status)
234 struct user_lock_res *lockres = user_lksb_to_lock_res(lksb);
236 mlog(ML_BASTS, "UNLOCK AST fired for lockres %.*s, flags 0x%x\n",
237 lockres->l_namelen, lockres->l_name, lockres->l_flags);
239 if (status)
240 mlog(ML_ERROR, "dlm returns status %d\n", status);
242 spin_lock(&lockres->l_lock);
243 /* The teardown flag gets set early during the unlock process,
244 * so test the cancel flag to make sure that this ast isn't
245 * for a concurrent cancel. */
246 if (lockres->l_flags & USER_LOCK_IN_TEARDOWN
247 && !(lockres->l_flags & USER_LOCK_IN_CANCEL)) {
248 lockres->l_level = DLM_LOCK_IV;
249 } else if (status == DLM_CANCELGRANT) {
250 /* We tried to cancel a convert request, but it was
251 * already granted. Don't clear the busy flag - the
252 * ast should've done this already. */
253 BUG_ON(!(lockres->l_flags & USER_LOCK_IN_CANCEL));
254 lockres->l_flags &= ~USER_LOCK_IN_CANCEL;
255 goto out_noclear;
256 } else {
257 BUG_ON(!(lockres->l_flags & USER_LOCK_IN_CANCEL));
258 /* Cancel succeeded, we want to re-queue */
259 lockres->l_requested = DLM_LOCK_IV; /* cancel an
260 * upconvert
261 * request. */
262 lockres->l_flags &= ~USER_LOCK_IN_CANCEL;
263 /* we want the unblock thread to look at it again
264 * now. */
265 if (lockres->l_flags & USER_LOCK_BLOCKED)
266 __user_dlm_queue_lockres(lockres);
269 lockres->l_flags &= ~USER_LOCK_BUSY;
270 out_noclear:
271 spin_unlock(&lockres->l_lock);
273 wake_up(&lockres->l_event);
277 * This is the userdlmfs locking protocol version.
279 * See fs/ocfs2/dlmglue.c for more details on locking versions.
281 static struct ocfs2_locking_protocol user_dlm_lproto = {
282 .lp_max_version = {
283 .pv_major = OCFS2_LOCKING_PROTOCOL_MAJOR,
284 .pv_minor = OCFS2_LOCKING_PROTOCOL_MINOR,
286 .lp_lock_ast = user_ast,
287 .lp_blocking_ast = user_bast,
288 .lp_unlock_ast = user_unlock_ast,
291 static inline void user_dlm_drop_inode_ref(struct user_lock_res *lockres)
293 struct inode *inode;
294 inode = user_dlm_inode_from_user_lockres(lockres);
295 iput(inode);
298 static void user_dlm_unblock_lock(struct work_struct *work)
300 int new_level, status;
301 struct user_lock_res *lockres =
302 container_of(work, struct user_lock_res, l_work);
303 struct ocfs2_cluster_connection *conn =
304 cluster_connection_from_user_lockres(lockres);
306 mlog(0, "lockres %.*s\n", lockres->l_namelen, lockres->l_name);
308 spin_lock(&lockres->l_lock);
310 mlog_bug_on_msg(!(lockres->l_flags & USER_LOCK_QUEUED),
311 "Lockres %.*s, flags 0x%x\n",
312 lockres->l_namelen, lockres->l_name, lockres->l_flags);
314 /* notice that we don't clear USER_LOCK_BLOCKED here. If it's
315 * set, we want user_ast clear it. */
316 lockres->l_flags &= ~USER_LOCK_QUEUED;
318 /* It's valid to get here and no longer be blocked - if we get
319 * several basts in a row, we might be queued by the first
320 * one, the unblock thread might run and clear the queued
321 * flag, and finally we might get another bast which re-queues
322 * us before our ast for the downconvert is called. */
323 if (!(lockres->l_flags & USER_LOCK_BLOCKED)) {
324 mlog(ML_BASTS, "lockres %.*s USER_LOCK_BLOCKED\n",
325 lockres->l_namelen, lockres->l_name);
326 spin_unlock(&lockres->l_lock);
327 goto drop_ref;
330 if (lockres->l_flags & USER_LOCK_IN_TEARDOWN) {
331 mlog(ML_BASTS, "lockres %.*s USER_LOCK_IN_TEARDOWN\n",
332 lockres->l_namelen, lockres->l_name);
333 spin_unlock(&lockres->l_lock);
334 goto drop_ref;
337 if (lockres->l_flags & USER_LOCK_BUSY) {
338 if (lockres->l_flags & USER_LOCK_IN_CANCEL) {
339 mlog(ML_BASTS, "lockres %.*s USER_LOCK_IN_CANCEL\n",
340 lockres->l_namelen, lockres->l_name);
341 spin_unlock(&lockres->l_lock);
342 goto drop_ref;
345 lockres->l_flags |= USER_LOCK_IN_CANCEL;
346 spin_unlock(&lockres->l_lock);
348 status = ocfs2_dlm_unlock(conn, &lockres->l_lksb,
349 DLM_LKF_CANCEL);
350 if (status)
351 user_log_dlm_error("ocfs2_dlm_unlock", status, lockres);
352 goto drop_ref;
355 /* If there are still incompat holders, we can exit safely
356 * without worrying about re-queueing this lock as that will
357 * happen on the last call to user_cluster_unlock. */
358 if ((lockres->l_blocking == DLM_LOCK_EX)
359 && (lockres->l_ex_holders || lockres->l_ro_holders)) {
360 spin_unlock(&lockres->l_lock);
361 mlog(ML_BASTS, "lockres %.*s, EX/PR Holders %u,%u\n",
362 lockres->l_namelen, lockres->l_name,
363 lockres->l_ex_holders, lockres->l_ro_holders);
364 goto drop_ref;
367 if ((lockres->l_blocking == DLM_LOCK_PR)
368 && lockres->l_ex_holders) {
369 spin_unlock(&lockres->l_lock);
370 mlog(ML_BASTS, "lockres %.*s, EX Holders %u\n",
371 lockres->l_namelen, lockres->l_name,
372 lockres->l_ex_holders);
373 goto drop_ref;
376 /* yay, we can downconvert now. */
377 new_level = user_highest_compat_lock_level(lockres->l_blocking);
378 lockres->l_requested = new_level;
379 lockres->l_flags |= USER_LOCK_BUSY;
380 mlog(ML_BASTS, "lockres %.*s, downconvert %d => %d\n",
381 lockres->l_namelen, lockres->l_name, lockres->l_level, new_level);
382 spin_unlock(&lockres->l_lock);
384 /* need lock downconvert request now... */
385 status = ocfs2_dlm_lock(conn, new_level, &lockres->l_lksb,
386 DLM_LKF_CONVERT|DLM_LKF_VALBLK,
387 lockres->l_name,
388 lockres->l_namelen);
389 if (status) {
390 user_log_dlm_error("ocfs2_dlm_lock", status, lockres);
391 user_recover_from_dlm_error(lockres);
394 drop_ref:
395 user_dlm_drop_inode_ref(lockres);
398 static inline void user_dlm_inc_holders(struct user_lock_res *lockres,
399 int level)
401 switch(level) {
402 case DLM_LOCK_EX:
403 lockres->l_ex_holders++;
404 break;
405 case DLM_LOCK_PR:
406 lockres->l_ro_holders++;
407 break;
408 default:
409 BUG();
413 /* predict what lock level we'll be dropping down to on behalf
414 * of another node, and return true if the currently wanted
415 * level will be compatible with it. */
416 static inline int
417 user_may_continue_on_blocked_lock(struct user_lock_res *lockres,
418 int wanted)
420 BUG_ON(!(lockres->l_flags & USER_LOCK_BLOCKED));
422 return wanted <= user_highest_compat_lock_level(lockres->l_blocking);
425 int user_dlm_cluster_lock(struct user_lock_res *lockres,
426 int level,
427 int lkm_flags)
429 int status, local_flags;
430 struct ocfs2_cluster_connection *conn =
431 cluster_connection_from_user_lockres(lockres);
433 if (level != DLM_LOCK_EX &&
434 level != DLM_LOCK_PR) {
435 mlog(ML_ERROR, "lockres %.*s: invalid request!\n",
436 lockres->l_namelen, lockres->l_name);
437 status = -EINVAL;
438 goto bail;
441 mlog(ML_BASTS, "lockres %.*s, level %d, flags = 0x%x\n",
442 lockres->l_namelen, lockres->l_name, level, lkm_flags);
444 again:
445 if (signal_pending(current)) {
446 status = -ERESTARTSYS;
447 goto bail;
450 spin_lock(&lockres->l_lock);
452 /* We only compare against the currently granted level
453 * here. If the lock is blocked waiting on a downconvert,
454 * we'll get caught below. */
455 if ((lockres->l_flags & USER_LOCK_BUSY) &&
456 (level > lockres->l_level)) {
457 /* is someone sitting in dlm_lock? If so, wait on
458 * them. */
459 spin_unlock(&lockres->l_lock);
461 user_wait_on_busy_lock(lockres);
462 goto again;
465 if ((lockres->l_flags & USER_LOCK_BLOCKED) &&
466 (!user_may_continue_on_blocked_lock(lockres, level))) {
467 /* is the lock is currently blocked on behalf of
468 * another node */
469 spin_unlock(&lockres->l_lock);
471 user_wait_on_blocked_lock(lockres);
472 goto again;
475 if (level > lockres->l_level) {
476 local_flags = lkm_flags | DLM_LKF_VALBLK;
477 if (lockres->l_level != DLM_LOCK_IV)
478 local_flags |= DLM_LKF_CONVERT;
480 lockres->l_requested = level;
481 lockres->l_flags |= USER_LOCK_BUSY;
482 spin_unlock(&lockres->l_lock);
484 BUG_ON(level == DLM_LOCK_IV);
485 BUG_ON(level == DLM_LOCK_NL);
487 /* call dlm_lock to upgrade lock now */
488 status = ocfs2_dlm_lock(conn, level, &lockres->l_lksb,
489 local_flags, lockres->l_name,
490 lockres->l_namelen);
491 if (status) {
492 if ((lkm_flags & DLM_LKF_NOQUEUE) &&
493 (status != -EAGAIN))
494 user_log_dlm_error("ocfs2_dlm_lock",
495 status, lockres);
496 user_recover_from_dlm_error(lockres);
497 goto bail;
500 user_wait_on_busy_lock(lockres);
501 goto again;
504 user_dlm_inc_holders(lockres, level);
505 spin_unlock(&lockres->l_lock);
507 status = 0;
508 bail:
509 return status;
512 static inline void user_dlm_dec_holders(struct user_lock_res *lockres,
513 int level)
515 switch(level) {
516 case DLM_LOCK_EX:
517 BUG_ON(!lockres->l_ex_holders);
518 lockres->l_ex_holders--;
519 break;
520 case DLM_LOCK_PR:
521 BUG_ON(!lockres->l_ro_holders);
522 lockres->l_ro_holders--;
523 break;
524 default:
525 BUG();
529 void user_dlm_cluster_unlock(struct user_lock_res *lockres,
530 int level)
532 if (level != DLM_LOCK_EX &&
533 level != DLM_LOCK_PR) {
534 mlog(ML_ERROR, "lockres %.*s: invalid request!\n",
535 lockres->l_namelen, lockres->l_name);
536 return;
539 spin_lock(&lockres->l_lock);
540 user_dlm_dec_holders(lockres, level);
541 __user_dlm_cond_queue_lockres(lockres);
542 spin_unlock(&lockres->l_lock);
545 void user_dlm_write_lvb(struct inode *inode,
546 const char *val,
547 unsigned int len)
549 struct user_lock_res *lockres = &DLMFS_I(inode)->ip_lockres;
550 char *lvb;
552 BUG_ON(len > DLM_LVB_LEN);
554 spin_lock(&lockres->l_lock);
556 BUG_ON(lockres->l_level < DLM_LOCK_EX);
557 lvb = ocfs2_dlm_lvb(&lockres->l_lksb);
558 memcpy(lvb, val, len);
560 spin_unlock(&lockres->l_lock);
563 ssize_t user_dlm_read_lvb(struct inode *inode,
564 char *val,
565 unsigned int len)
567 struct user_lock_res *lockres = &DLMFS_I(inode)->ip_lockres;
568 char *lvb;
569 ssize_t ret = len;
571 BUG_ON(len > DLM_LVB_LEN);
573 spin_lock(&lockres->l_lock);
575 BUG_ON(lockres->l_level < DLM_LOCK_PR);
576 if (ocfs2_dlm_lvb_valid(&lockres->l_lksb)) {
577 lvb = ocfs2_dlm_lvb(&lockres->l_lksb);
578 memcpy(val, lvb, len);
579 } else
580 ret = 0;
582 spin_unlock(&lockres->l_lock);
583 return ret;
586 void user_dlm_lock_res_init(struct user_lock_res *lockres,
587 struct dentry *dentry)
589 memset(lockres, 0, sizeof(*lockres));
591 spin_lock_init(&lockres->l_lock);
592 init_waitqueue_head(&lockres->l_event);
593 lockres->l_level = DLM_LOCK_IV;
594 lockres->l_requested = DLM_LOCK_IV;
595 lockres->l_blocking = DLM_LOCK_IV;
597 /* should have been checked before getting here. */
598 BUG_ON(dentry->d_name.len >= USER_DLM_LOCK_ID_MAX_LEN);
600 memcpy(lockres->l_name,
601 dentry->d_name.name,
602 dentry->d_name.len);
603 lockres->l_namelen = dentry->d_name.len;
606 int user_dlm_destroy_lock(struct user_lock_res *lockres)
608 int status = -EBUSY;
609 struct ocfs2_cluster_connection *conn =
610 cluster_connection_from_user_lockres(lockres);
612 mlog(ML_BASTS, "lockres %.*s\n", lockres->l_namelen, lockres->l_name);
614 spin_lock(&lockres->l_lock);
615 if (lockres->l_flags & USER_LOCK_IN_TEARDOWN) {
616 spin_unlock(&lockres->l_lock);
617 return 0;
620 lockres->l_flags |= USER_LOCK_IN_TEARDOWN;
622 while (lockres->l_flags & USER_LOCK_BUSY) {
623 spin_unlock(&lockres->l_lock);
625 user_wait_on_busy_lock(lockres);
627 spin_lock(&lockres->l_lock);
630 if (lockres->l_ro_holders || lockres->l_ex_holders) {
631 spin_unlock(&lockres->l_lock);
632 goto bail;
635 status = 0;
636 if (!(lockres->l_flags & USER_LOCK_ATTACHED)) {
637 spin_unlock(&lockres->l_lock);
638 goto bail;
641 lockres->l_flags &= ~USER_LOCK_ATTACHED;
642 lockres->l_flags |= USER_LOCK_BUSY;
643 spin_unlock(&lockres->l_lock);
645 status = ocfs2_dlm_unlock(conn, &lockres->l_lksb, DLM_LKF_VALBLK);
646 if (status) {
647 user_log_dlm_error("ocfs2_dlm_unlock", status, lockres);
648 goto bail;
651 user_wait_on_busy_lock(lockres);
653 status = 0;
654 bail:
655 return status;
658 static void user_dlm_recovery_handler_noop(int node_num,
659 void *recovery_data)
661 /* We ignore recovery events */
662 return;
665 void user_dlm_set_locking_protocol(void)
667 ocfs2_stack_glue_set_max_proto_version(&user_dlm_lproto.lp_max_version);
670 struct ocfs2_cluster_connection *user_dlm_register(struct qstr *name)
672 int rc;
673 struct ocfs2_cluster_connection *conn;
675 rc = ocfs2_cluster_connect_agnostic(name->name, name->len,
676 &user_dlm_lproto,
677 user_dlm_recovery_handler_noop,
678 NULL, &conn);
679 if (rc)
680 mlog_errno(rc);
682 return rc ? ERR_PTR(rc) : conn;
685 void user_dlm_unregister(struct ocfs2_cluster_connection *conn)
687 ocfs2_cluster_disconnect(conn, 0);