xref: /linux/fs/ocfs2/dlm/dlmdebug.c (revision f3d9478b2ce468c3115b02ecae7e975990697f15)
1 /* -*- mode: c; c-basic-offset: 8; -*-
2  * vim: noexpandtab sw=8 ts=8 sts=0:
3  *
4  * dlmdebug.c
5  *
6  * debug functionality for the dlm
7  *
8  * Copyright (C) 2004 Oracle.  All rights reserved.
9  *
10  * This program is free software; you can redistribute it and/or
11  * modify it under the terms of the GNU General Public
12  * License as published by the Free Software Foundation; either
13  * version 2 of the License, or (at your option) any later version.
14  *
15  * This program is distributed in the hope that it will be useful,
16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
18  * General Public License for more details.
19  *
20  * You should have received a copy of the GNU General Public
21  * License along with this program; if not, write to the
22  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
23  * Boston, MA 021110-1307, USA.
24  *
25  */
26 
27 #include <linux/types.h>
28 #include <linux/slab.h>
29 #include <linux/highmem.h>
30 #include <linux/utsname.h>
31 #include <linux/sysctl.h>
32 #include <linux/spinlock.h>
33 
34 #include "cluster/heartbeat.h"
35 #include "cluster/nodemanager.h"
36 #include "cluster/tcp.h"
37 
38 #include "dlmapi.h"
39 #include "dlmcommon.h"
40 #include "dlmdebug.h"
41 
42 #include "dlmdomain.h"
43 #include "dlmdebug.h"
44 
45 #define MLOG_MASK_PREFIX ML_DLM
46 #include "cluster/masklog.h"
47 
48 void dlm_print_one_lock_resource(struct dlm_lock_resource *res)
49 {
50 	mlog(ML_NOTICE, "lockres: %.*s, owner=%u, state=%u\n",
51 	       res->lockname.len, res->lockname.name,
52 	       res->owner, res->state);
53 	spin_lock(&res->spinlock);
54 	__dlm_print_one_lock_resource(res);
55 	spin_unlock(&res->spinlock);
56 }
57 
58 void __dlm_print_one_lock_resource(struct dlm_lock_resource *res)
59 {
60 	struct list_head *iter2;
61 	struct dlm_lock *lock;
62 
63 	assert_spin_locked(&res->spinlock);
64 
65 	mlog(ML_NOTICE, "lockres: %.*s, owner=%u, state=%u\n",
66 	       res->lockname.len, res->lockname.name,
67 	       res->owner, res->state);
68 	mlog(ML_NOTICE, "  last used: %lu, on purge list: %s\n",
69 	     res->last_used, list_empty(&res->purge) ? "no" : "yes");
70 	mlog(ML_NOTICE, "  granted queue: \n");
71 	list_for_each(iter2, &res->granted) {
72 		lock = list_entry(iter2, struct dlm_lock, list);
73 		spin_lock(&lock->spinlock);
74 		mlog(ML_NOTICE, "    type=%d, conv=%d, node=%u, "
75 		       "cookie=%u:%llu, ast=(empty=%c,pend=%c), bast=(empty=%c,pend=%c)\n",
76 		       lock->ml.type, lock->ml.convert_type, lock->ml.node,
77 		       dlm_get_lock_cookie_node(lock->ml.cookie),
78 		       dlm_get_lock_cookie_seq(lock->ml.cookie),
79 		       list_empty(&lock->ast_list) ? 'y' : 'n',
80 		       lock->ast_pending ? 'y' : 'n',
81 		       list_empty(&lock->bast_list) ? 'y' : 'n',
82 		       lock->bast_pending ? 'y' : 'n');
83 		spin_unlock(&lock->spinlock);
84 	}
85 	mlog(ML_NOTICE, "  converting queue: \n");
86 	list_for_each(iter2, &res->converting) {
87 		lock = list_entry(iter2, struct dlm_lock, list);
88 		spin_lock(&lock->spinlock);
89 		mlog(ML_NOTICE, "    type=%d, conv=%d, node=%u, "
90 		       "cookie=%u:%llu, ast=(empty=%c,pend=%c), bast=(empty=%c,pend=%c)\n",
91 		       lock->ml.type, lock->ml.convert_type, lock->ml.node,
92 		       dlm_get_lock_cookie_node(lock->ml.cookie),
93 		       dlm_get_lock_cookie_seq(lock->ml.cookie),
94 		       list_empty(&lock->ast_list) ? 'y' : 'n',
95 		       lock->ast_pending ? 'y' : 'n',
96 		       list_empty(&lock->bast_list) ? 'y' : 'n',
97 		       lock->bast_pending ? 'y' : 'n');
98 		spin_unlock(&lock->spinlock);
99 	}
100 	mlog(ML_NOTICE, "  blocked queue: \n");
101 	list_for_each(iter2, &res->blocked) {
102 		lock = list_entry(iter2, struct dlm_lock, list);
103 		spin_lock(&lock->spinlock);
104 		mlog(ML_NOTICE, "    type=%d, conv=%d, node=%u, "
105 		       "cookie=%u:%llu, ast=(empty=%c,pend=%c), bast=(empty=%c,pend=%c)\n",
106 		       lock->ml.type, lock->ml.convert_type, lock->ml.node,
107 		       dlm_get_lock_cookie_node(lock->ml.cookie),
108 		       dlm_get_lock_cookie_seq(lock->ml.cookie),
109 		       list_empty(&lock->ast_list) ? 'y' : 'n',
110 		       lock->ast_pending ? 'y' : 'n',
111 		       list_empty(&lock->bast_list) ? 'y' : 'n',
112 		       lock->bast_pending ? 'y' : 'n');
113 		spin_unlock(&lock->spinlock);
114 	}
115 }
116 
117 void dlm_print_one_lock(struct dlm_lock *lockid)
118 {
119 	dlm_print_one_lock_resource(lockid->lockres);
120 }
121 EXPORT_SYMBOL_GPL(dlm_print_one_lock);
122 
123 void dlm_dump_lock_resources(struct dlm_ctxt *dlm)
124 {
125 	struct dlm_lock_resource *res;
126 	struct hlist_node *iter;
127 	struct hlist_head *bucket;
128 	int i;
129 
130 	mlog(ML_NOTICE, "struct dlm_ctxt: %s, node=%u, key=%u\n",
131 		  dlm->name, dlm->node_num, dlm->key);
132 	if (!dlm || !dlm->name) {
133 		mlog(ML_ERROR, "dlm=%p\n", dlm);
134 		return;
135 	}
136 
137 	spin_lock(&dlm->spinlock);
138 	for (i=0; i<DLM_HASH_BUCKETS; i++) {
139 		bucket = &(dlm->lockres_hash[i]);
140 		hlist_for_each_entry(res, iter, bucket, hash_node)
141 			dlm_print_one_lock_resource(res);
142 	}
143 	spin_unlock(&dlm->spinlock);
144 }
145 
146 static const char *dlm_errnames[] = {
147 	[DLM_NORMAL] =			"DLM_NORMAL",
148 	[DLM_GRANTED] =			"DLM_GRANTED",
149 	[DLM_DENIED] =			"DLM_DENIED",
150 	[DLM_DENIED_NOLOCKS] =		"DLM_DENIED_NOLOCKS",
151 	[DLM_WORKING] =			"DLM_WORKING",
152 	[DLM_BLOCKED] =			"DLM_BLOCKED",
153 	[DLM_BLOCKED_ORPHAN] =		"DLM_BLOCKED_ORPHAN",
154 	[DLM_DENIED_GRACE_PERIOD] =	"DLM_DENIED_GRACE_PERIOD",
155 	[DLM_SYSERR] =			"DLM_SYSERR",
156 	[DLM_NOSUPPORT] =		"DLM_NOSUPPORT",
157 	[DLM_CANCELGRANT] =		"DLM_CANCELGRANT",
158 	[DLM_IVLOCKID] =		"DLM_IVLOCKID",
159 	[DLM_SYNC] =			"DLM_SYNC",
160 	[DLM_BADTYPE] =			"DLM_BADTYPE",
161 	[DLM_BADRESOURCE] =		"DLM_BADRESOURCE",
162 	[DLM_MAXHANDLES] =		"DLM_MAXHANDLES",
163 	[DLM_NOCLINFO] =		"DLM_NOCLINFO",
164 	[DLM_NOLOCKMGR] =		"DLM_NOLOCKMGR",
165 	[DLM_NOPURGED] =		"DLM_NOPURGED",
166 	[DLM_BADARGS] =			"DLM_BADARGS",
167 	[DLM_VOID] =			"DLM_VOID",
168 	[DLM_NOTQUEUED] =		"DLM_NOTQUEUED",
169 	[DLM_IVBUFLEN] =		"DLM_IVBUFLEN",
170 	[DLM_CVTUNGRANT] =		"DLM_CVTUNGRANT",
171 	[DLM_BADPARAM] =		"DLM_BADPARAM",
172 	[DLM_VALNOTVALID] =		"DLM_VALNOTVALID",
173 	[DLM_REJECTED] =		"DLM_REJECTED",
174 	[DLM_ABORT] =			"DLM_ABORT",
175 	[DLM_CANCEL] =			"DLM_CANCEL",
176 	[DLM_IVRESHANDLE] =		"DLM_IVRESHANDLE",
177 	[DLM_DEADLOCK] =		"DLM_DEADLOCK",
178 	[DLM_DENIED_NOASTS] =		"DLM_DENIED_NOASTS",
179 	[DLM_FORWARD] =			"DLM_FORWARD",
180 	[DLM_TIMEOUT] =			"DLM_TIMEOUT",
181 	[DLM_IVGROUPID] =		"DLM_IVGROUPID",
182 	[DLM_VERS_CONFLICT] =		"DLM_VERS_CONFLICT",
183 	[DLM_BAD_DEVICE_PATH] =		"DLM_BAD_DEVICE_PATH",
184 	[DLM_NO_DEVICE_PERMISSION] =	"DLM_NO_DEVICE_PERMISSION",
185 	[DLM_NO_CONTROL_DEVICE ] =	"DLM_NO_CONTROL_DEVICE ",
186 	[DLM_RECOVERING] =		"DLM_RECOVERING",
187 	[DLM_MIGRATING] =		"DLM_MIGRATING",
188 	[DLM_MAXSTATS] =		"DLM_MAXSTATS",
189 };
190 
191 static const char *dlm_errmsgs[] = {
192 	[DLM_NORMAL] = 			"request in progress",
193 	[DLM_GRANTED] = 		"request granted",
194 	[DLM_DENIED] = 			"request denied",
195 	[DLM_DENIED_NOLOCKS] = 		"request denied, out of system resources",
196 	[DLM_WORKING] = 		"async request in progress",
197 	[DLM_BLOCKED] = 		"lock request blocked",
198 	[DLM_BLOCKED_ORPHAN] = 		"lock request blocked by a orphan lock",
199 	[DLM_DENIED_GRACE_PERIOD] = 	"topological change in progress",
200 	[DLM_SYSERR] = 			"system error",
201 	[DLM_NOSUPPORT] = 		"unsupported",
202 	[DLM_CANCELGRANT] = 		"can't cancel convert: already granted",
203 	[DLM_IVLOCKID] = 		"bad lockid",
204 	[DLM_SYNC] = 			"synchronous request granted",
205 	[DLM_BADTYPE] = 		"bad resource type",
206 	[DLM_BADRESOURCE] = 		"bad resource handle",
207 	[DLM_MAXHANDLES] = 		"no more resource handles",
208 	[DLM_NOCLINFO] = 		"can't contact cluster manager",
209 	[DLM_NOLOCKMGR] = 		"can't contact lock manager",
210 	[DLM_NOPURGED] = 		"can't contact purge daemon",
211 	[DLM_BADARGS] = 		"bad api args",
212 	[DLM_VOID] = 			"no status",
213 	[DLM_NOTQUEUED] = 		"NOQUEUE was specified and request failed",
214 	[DLM_IVBUFLEN] = 		"invalid resource name length",
215 	[DLM_CVTUNGRANT] = 		"attempted to convert ungranted lock",
216 	[DLM_BADPARAM] = 		"invalid lock mode specified",
217 	[DLM_VALNOTVALID] = 		"value block has been invalidated",
218 	[DLM_REJECTED] = 		"request rejected, unrecognized client",
219 	[DLM_ABORT] = 			"blocked lock request cancelled",
220 	[DLM_CANCEL] = 			"conversion request cancelled",
221 	[DLM_IVRESHANDLE] = 		"invalid resource handle",
222 	[DLM_DEADLOCK] = 		"deadlock recovery refused this request",
223 	[DLM_DENIED_NOASTS] = 		"failed to allocate AST",
224 	[DLM_FORWARD] = 		"request must wait for primary's response",
225 	[DLM_TIMEOUT] = 		"timeout value for lock has expired",
226 	[DLM_IVGROUPID] = 		"invalid group specification",
227 	[DLM_VERS_CONFLICT] = 		"version conflicts prevent request handling",
228 	[DLM_BAD_DEVICE_PATH] = 	"Locks device does not exist or path wrong",
229 	[DLM_NO_DEVICE_PERMISSION] = 	"Client has insufficient perms for device",
230 	[DLM_NO_CONTROL_DEVICE] = 	"Cannot set options on opened device ",
231 	[DLM_RECOVERING] = 		"lock resource being recovered",
232 	[DLM_MIGRATING] = 		"lock resource being migrated",
233 	[DLM_MAXSTATS] = 		"invalid error number",
234 };
235 
236 const char *dlm_errmsg(enum dlm_status err)
237 {
238 	if (err >= DLM_MAXSTATS || err < 0)
239 		return dlm_errmsgs[DLM_MAXSTATS];
240 	return dlm_errmsgs[err];
241 }
242 EXPORT_SYMBOL_GPL(dlm_errmsg);
243 
244 const char *dlm_errname(enum dlm_status err)
245 {
246 	if (err >= DLM_MAXSTATS || err < 0)
247 		return dlm_errnames[DLM_MAXSTATS];
248 	return dlm_errnames[err];
249 }
250 EXPORT_SYMBOL_GPL(dlm_errname);
251