2 * linux/fs/lockd/svclock.c
4 * Handling of server-side locks, mostly of the blocked variety.
5 * This is the ugliest part of lockd because we tread on very thin ice.
6 * GRANT and CANCEL calls may get stuck, meet in mid-flight, etc.
7 * IMNSHO introducing the grant callback into the NLM protocol was one
8 * of the worst ideas Sun ever had. Except maybe for the idea of doing
9 * NFS file locking at all.
11 * I'm trying hard to avoid race conditions by protecting most accesses
12 * to a file's list of blocked locks through a semaphore. The global
13 * list of blocked locks is not protected in this fashion however.
14 * Therefore, some functions (such as the RPC callback for the async grant
15 * call) move blocked locks towards the head of the list *while some other
16 * process might be traversing it*. This should not be a problem in
17 * practice, because this will only cause functions traversing the list
18 * to visit some blocks twice.
20 * Copyright (C) 1996, Olaf Kirch <okir@monad.swb.de>
23 #include <linux/types.h>
24 #include <linux/errno.h>
25 #include <linux/kernel.h>
26 #include <linux/sched.h>
27 #include <linux/smp_lock.h>
28 #include <linux/sunrpc/clnt.h>
29 #include <linux/sunrpc/svc.h>
30 #include <linux/lockd/nlm.h>
31 #include <linux/lockd/lockd.h>
33 #define NLMDBG_FACILITY NLMDBG_SVCLOCK
35 #ifdef CONFIG_LOCKD_V4
36 #define nlm_deadlock nlm4_deadlock
38 #define nlm_deadlock nlm_lck_denied
41 static void nlmsvc_release_block(struct nlm_block *block);
42 static void nlmsvc_insert_block(struct nlm_block *block, unsigned long);
43 static void nlmsvc_remove_block(struct nlm_block *block);
45 static int nlmsvc_setgrantargs(struct nlm_rqst *call, struct nlm_lock *lock);
46 static void nlmsvc_freegrantargs(struct nlm_rqst *call);
47 static const struct rpc_call_ops nlmsvc_grant_ops;
50 * The list of blocked locks to retry
52 static LIST_HEAD(nlm_blocked);
55 * Insert a blocked lock into the global list
58 nlmsvc_insert_block(struct nlm_block *block, unsigned long when)
61 struct list_head *pos;
63 dprintk("lockd: nlmsvc_insert_block(%p, %ld)\n", block, when);
64 if (list_empty(&block->b_list)) {
65 kref_get(&block->b_count);
67 list_del_init(&block->b_list);
71 if (when != NLM_NEVER) {
72 if ((when += jiffies) == NLM_NEVER)
74 list_for_each(pos, &nlm_blocked) {
75 b = list_entry(pos, struct nlm_block, b_list);
76 if (time_after(b->b_when,when) || b->b_when == NLM_NEVER)
79 /* On normal exit from the loop, pos == &nlm_blocked,
80 * so we will be adding to the end of the list - good
84 list_add_tail(&block->b_list, pos);
89 * Remove a block from the global list
92 nlmsvc_remove_block(struct nlm_block *block)
94 if (!list_empty(&block->b_list)) {
95 list_del_init(&block->b_list);
96 nlmsvc_release_block(block);
101 * Find a block for a given lock
103 static struct nlm_block *
104 nlmsvc_lookup_block(struct nlm_file *file, struct nlm_lock *lock)
106 struct nlm_block *block;
107 struct file_lock *fl;
109 dprintk("lockd: nlmsvc_lookup_block f=%p pd=%d %Ld-%Ld ty=%d\n",
110 file, lock->fl.fl_pid,
111 (long long)lock->fl.fl_start,
112 (long long)lock->fl.fl_end, lock->fl.fl_type);
113 list_for_each_entry(block, &nlm_blocked, b_list) {
114 fl = &block->b_call->a_args.lock.fl;
115 dprintk("lockd: check f=%p pd=%d %Ld-%Ld ty=%d cookie=%s\n",
116 block->b_file, fl->fl_pid,
117 (long long)fl->fl_start,
118 (long long)fl->fl_end, fl->fl_type,
119 nlmdbg_cookie2a(&block->b_call->a_args.cookie));
120 if (block->b_file == file && nlm_compare_locks(fl, &lock->fl)) {
121 kref_get(&block->b_count);
129 static inline int nlm_cookie_match(struct nlm_cookie *a, struct nlm_cookie *b)
133 if(memcmp(a->data,b->data,a->len))
139 * Find a block with a given NLM cookie.
141 static inline struct nlm_block *
142 nlmsvc_find_block(struct nlm_cookie *cookie, struct sockaddr_in *sin)
144 struct nlm_block *block;
146 list_for_each_entry(block, &nlm_blocked, b_list) {
147 if (nlm_cookie_match(&block->b_call->a_args.cookie,cookie)
148 && nlm_cmp_addr(sin, &block->b_host->h_addr))
155 kref_get(&block->b_count);
160 * Create a block and initialize it.
162 * Note: we explicitly set the cookie of the grant reply to that of
163 * the blocked lock request. The spec explicitly mentions that the client
164 * should _not_ rely on the callback containing the same cookie as the
165 * request, but (as I found out later) that's because some implementations
166 * do just this. Never mind the standards comittees, they support our
167 * logging industries.
169 static inline struct nlm_block *
170 nlmsvc_create_block(struct svc_rqst *rqstp, struct nlm_file *file,
171 struct nlm_lock *lock, struct nlm_cookie *cookie)
173 struct nlm_block *block;
174 struct nlm_host *host;
175 struct nlm_rqst *call = NULL;
177 /* Create host handle for callback */
178 host = nlmsvc_lookup_host(rqstp, lock->caller, lock->len);
182 call = nlm_alloc_call(host);
186 /* Allocate memory for block, and initialize arguments */
187 block = kzalloc(sizeof(*block), GFP_KERNEL);
190 kref_init(&block->b_count);
191 INIT_LIST_HEAD(&block->b_list);
192 INIT_LIST_HEAD(&block->b_flist);
194 if (!nlmsvc_setgrantargs(call, lock))
197 /* Set notifier function for VFS, and init args */
198 call->a_args.lock.fl.fl_flags |= FL_SLEEP;
199 call->a_args.lock.fl.fl_lmops = &nlmsvc_lock_operations;
200 call->a_args.cookie = *cookie; /* see above */
202 dprintk("lockd: created block %p...\n", block);
204 /* Create and initialize the block */
205 block->b_daemon = rqstp->rq_server;
206 block->b_host = host;
207 block->b_file = file;
210 /* Add to file's list of blocks */
211 list_add(&block->b_flist, &file->f_blocks);
213 /* Set up RPC arguments for callback */
214 block->b_call = call;
215 call->a_flags = RPC_TASK_ASYNC;
216 call->a_block = block;
223 nlm_release_call(call);
228 * Delete a block. If the lock was cancelled or the grant callback
229 * failed, unlock is set to 1.
230 * It is the caller's responsibility to check whether the file
231 * can be closed hereafter.
233 static int nlmsvc_unlink_block(struct nlm_block *block)
236 dprintk("lockd: unlinking block %p...\n", block);
238 /* Remove block from list */
239 status = posix_unblock_lock(block->b_file->f_file, &block->b_call->a_args.lock.fl);
240 nlmsvc_remove_block(block);
244 static void nlmsvc_free_block(struct kref *kref)
246 struct nlm_block *block = container_of(kref, struct nlm_block, b_count);
247 struct nlm_file *file = block->b_file;
249 dprintk("lockd: freeing block %p...\n", block);
251 /* Remove block from file's list of blocks */
253 list_del_init(&block->b_flist);
256 nlmsvc_freegrantargs(block->b_call);
257 nlm_release_call(block->b_call);
258 nlm_release_file(block->b_file);
262 static void nlmsvc_release_block(struct nlm_block *block)
265 kref_put(&block->b_count, nlmsvc_free_block);
269 * Loop over all blocks and delete blocks held by
272 void nlmsvc_traverse_blocks(struct nlm_host *host,
273 struct nlm_file *file,
274 nlm_host_match_fn_t match)
276 struct nlm_block *block, *next;
280 list_for_each_entry_safe(block, next, &file->f_blocks, b_flist) {
281 if (!match(block->b_host, host))
283 /* Do not destroy blocks that are not on
284 * the global retry list - why? */
285 if (list_empty(&block->b_list))
287 kref_get(&block->b_count);
289 nlmsvc_unlink_block(block);
290 nlmsvc_release_block(block);
297 * Initialize arguments for GRANTED call. The nlm_rqst structure
298 * has been cleared already.
300 static int nlmsvc_setgrantargs(struct nlm_rqst *call, struct nlm_lock *lock)
302 locks_copy_lock(&call->a_args.lock.fl, &lock->fl);
303 memcpy(&call->a_args.lock.fh, &lock->fh, sizeof(call->a_args.lock.fh));
304 call->a_args.lock.caller = utsname()->nodename;
305 call->a_args.lock.oh.len = lock->oh.len;
307 /* set default data area */
308 call->a_args.lock.oh.data = call->a_owner;
309 call->a_args.lock.svid = lock->fl.fl_pid;
311 if (lock->oh.len > NLMCLNT_OHSIZE) {
312 void *data = kmalloc(lock->oh.len, GFP_KERNEL);
315 call->a_args.lock.oh.data = (u8 *) data;
318 memcpy(call->a_args.lock.oh.data, lock->oh.data, lock->oh.len);
322 static void nlmsvc_freegrantargs(struct nlm_rqst *call)
324 if (call->a_args.lock.oh.data != call->a_owner)
325 kfree(call->a_args.lock.oh.data);
329 * Attempt to establish a lock, and if it can't be granted, block it
333 nlmsvc_lock(struct svc_rqst *rqstp, struct nlm_file *file,
334 struct nlm_lock *lock, int wait, struct nlm_cookie *cookie)
336 struct nlm_block *block, *newblock = NULL;
340 dprintk("lockd: nlmsvc_lock(%s/%ld, ty=%d, pi=%d, %Ld-%Ld, bl=%d)\n",
341 file->f_file->f_dentry->d_inode->i_sb->s_id,
342 file->f_file->f_dentry->d_inode->i_ino,
343 lock->fl.fl_type, lock->fl.fl_pid,
344 (long long)lock->fl.fl_start,
345 (long long)lock->fl.fl_end,
349 lock->fl.fl_flags &= ~FL_SLEEP;
351 /* Lock file against concurrent access */
353 /* Get existing block (in case client is busy-waiting) */
354 block = nlmsvc_lookup_block(file, lock);
356 if (newblock != NULL)
357 lock = &newblock->b_call->a_args.lock;
359 lock = &block->b_call->a_args.lock;
361 error = posix_lock_file(file->f_file, &lock->fl);
362 lock->fl.fl_flags &= ~FL_SLEEP;
364 dprintk("lockd: posix_lock_file returned %d\n", error);
375 default: /* includes ENOLCK */
376 ret = nlm_lck_denied_nolocks;
380 ret = nlm_lck_denied;
384 ret = nlm_lck_blocked;
388 /* If we don't have a block, create and initialize it. Then
389 * retry because we may have slept in kmalloc. */
390 /* We have to release f_sema as nlmsvc_create_block may try to
391 * to claim it while doing host garbage collection */
392 if (newblock == NULL) {
394 dprintk("lockd: blocking on this lock (allocating).\n");
395 if (!(newblock = nlmsvc_create_block(rqstp, file, lock, cookie)))
396 return nlm_lck_denied_nolocks;
400 /* Append to list of blocked */
401 nlmsvc_insert_block(newblock, NLM_NEVER);
404 nlmsvc_release_block(newblock);
405 nlmsvc_release_block(block);
406 dprintk("lockd: nlmsvc_lock returned %u\n", ret);
411 * Test for presence of a conflicting lock.
414 nlmsvc_testlock(struct nlm_file *file, struct nlm_lock *lock,
415 struct nlm_lock *conflock)
417 dprintk("lockd: nlmsvc_testlock(%s/%ld, ty=%d, %Ld-%Ld)\n",
418 file->f_file->f_dentry->d_inode->i_sb->s_id,
419 file->f_file->f_dentry->d_inode->i_ino,
421 (long long)lock->fl.fl_start,
422 (long long)lock->fl.fl_end);
424 if (posix_test_lock(file->f_file, &lock->fl, &conflock->fl)) {
425 dprintk("lockd: conflicting lock(ty=%d, %Ld-%Ld)\n",
426 conflock->fl.fl_type,
427 (long long)conflock->fl.fl_start,
428 (long long)conflock->fl.fl_end);
429 conflock->caller = "somehost"; /* FIXME */
430 conflock->len = strlen(conflock->caller);
431 conflock->oh.len = 0; /* don't return OH info */
432 conflock->svid = conflock->fl.fl_pid;
433 return nlm_lck_denied;
441 * This implies a CANCEL call: We send a GRANT_MSG, the client replies
442 * with a GRANT_RES call which gets lost, and calls UNLOCK immediately
443 * afterwards. In this case the block will still be there, and hence
447 nlmsvc_unlock(struct nlm_file *file, struct nlm_lock *lock)
451 dprintk("lockd: nlmsvc_unlock(%s/%ld, pi=%d, %Ld-%Ld)\n",
452 file->f_file->f_dentry->d_inode->i_sb->s_id,
453 file->f_file->f_dentry->d_inode->i_ino,
455 (long long)lock->fl.fl_start,
456 (long long)lock->fl.fl_end);
458 /* First, cancel any lock that might be there */
459 nlmsvc_cancel_blocked(file, lock);
461 lock->fl.fl_type = F_UNLCK;
462 error = posix_lock_file(file->f_file, &lock->fl);
464 return (error < 0)? nlm_lck_denied_nolocks : nlm_granted;
468 * Cancel a previously blocked request.
470 * A cancel request always overrides any grant that may currently
472 * The calling procedure must check whether the file can be closed.
475 nlmsvc_cancel_blocked(struct nlm_file *file, struct nlm_lock *lock)
477 struct nlm_block *block;
480 dprintk("lockd: nlmsvc_cancel(%s/%ld, pi=%d, %Ld-%Ld)\n",
481 file->f_file->f_dentry->d_inode->i_sb->s_id,
482 file->f_file->f_dentry->d_inode->i_ino,
484 (long long)lock->fl.fl_start,
485 (long long)lock->fl.fl_end);
488 block = nlmsvc_lookup_block(file, lock);
491 status = nlmsvc_unlink_block(block);
492 nlmsvc_release_block(block);
494 return status ? nlm_lck_denied : nlm_granted;
498 * Unblock a blocked lock request. This is a callback invoked from the
499 * VFS layer when a lock on which we blocked is removed.
501 * This function doesn't grant the blocked lock instantly, but rather moves
502 * the block to the head of nlm_blocked where it can be picked up by lockd.
505 nlmsvc_notify_blocked(struct file_lock *fl)
507 struct nlm_block *block;
509 dprintk("lockd: VFS unblock notification for block %p\n", fl);
510 list_for_each_entry(block, &nlm_blocked, b_list) {
511 if (nlm_compare_locks(&block->b_call->a_args.lock.fl, fl)) {
512 nlmsvc_insert_block(block, 0);
513 svc_wake_up(block->b_daemon);
518 printk(KERN_WARNING "lockd: notification for unknown block!\n");
521 static int nlmsvc_same_owner(struct file_lock *fl1, struct file_lock *fl2)
523 return fl1->fl_owner == fl2->fl_owner && fl1->fl_pid == fl2->fl_pid;
526 struct lock_manager_operations nlmsvc_lock_operations = {
527 .fl_compare_owner = nlmsvc_same_owner,
528 .fl_notify = nlmsvc_notify_blocked,
532 * Try to claim a lock that was previously blocked.
534 * Note that we use both the RPC_GRANTED_MSG call _and_ an async
535 * RPC thread when notifying the client. This seems like overkill...
537 * - we don't want to use a synchronous RPC thread, otherwise
538 * we might find ourselves hanging on a dead portmapper.
539 * - Some lockd implementations (e.g. HP) don't react to
540 * RPC_GRANTED calls; they seem to insist on RPC_GRANTED_MSG calls.
543 nlmsvc_grant_blocked(struct nlm_block *block)
545 struct nlm_file *file = block->b_file;
546 struct nlm_lock *lock = &block->b_call->a_args.lock;
549 dprintk("lockd: grant blocked lock %p\n", block);
551 /* Unlink block request from list */
552 nlmsvc_unlink_block(block);
554 /* If b_granted is true this means we've been here before.
555 * Just retry the grant callback, possibly refreshing the RPC
557 if (block->b_granted) {
558 nlm_rebind_host(block->b_host);
562 /* Try the lock operation again */
563 lock->fl.fl_flags |= FL_SLEEP;
564 error = posix_lock_file(file->f_file, &lock->fl);
565 lock->fl.fl_flags &= ~FL_SLEEP;
571 dprintk("lockd: lock still blocked\n");
572 nlmsvc_insert_block(block, NLM_NEVER);
575 printk(KERN_WARNING "lockd: unexpected error %d in %s!\n",
576 -error, __FUNCTION__);
577 nlmsvc_insert_block(block, 10 * HZ);
582 /* Lock was granted by VFS. */
583 dprintk("lockd: GRANTing blocked lock.\n");
584 block->b_granted = 1;
586 /* Schedule next grant callback in 30 seconds */
587 nlmsvc_insert_block(block, 30 * HZ);
589 /* Call the client */
590 kref_get(&block->b_count);
591 if (nlm_async_call(block->b_call, NLMPROC_GRANTED_MSG,
592 &nlmsvc_grant_ops) < 0)
593 nlmsvc_release_block(block);
597 * This is the callback from the RPC layer when the NLM_GRANTED_MSG
598 * RPC call has succeeded or timed out.
599 * Like all RPC callbacks, it is invoked by the rpciod process, so it
600 * better not sleep. Therefore, we put the blocked lock on the nlm_blocked
601 * chain once more in order to have it removed by lockd itself (which can
602 * then sleep on the file semaphore without disrupting e.g. the nfs client).
604 static void nlmsvc_grant_callback(struct rpc_task *task, void *data)
606 struct nlm_rqst *call = data;
607 struct nlm_block *block = call->a_block;
608 unsigned long timeout;
610 dprintk("lockd: GRANT_MSG RPC callback\n");
612 /* Technically, we should down the file semaphore here. Since we
613 * move the block towards the head of the queue only, no harm
614 * can be done, though. */
615 if (task->tk_status < 0) {
616 /* RPC error: Re-insert for retransmission */
619 /* Call was successful, now wait for client callback */
622 nlmsvc_insert_block(block, timeout);
623 svc_wake_up(block->b_daemon);
626 static void nlmsvc_grant_release(void *data)
628 struct nlm_rqst *call = data;
630 nlmsvc_release_block(call->a_block);
633 static const struct rpc_call_ops nlmsvc_grant_ops = {
634 .rpc_call_done = nlmsvc_grant_callback,
635 .rpc_release = nlmsvc_grant_release,
639 * We received a GRANT_RES callback. Try to find the corresponding
643 nlmsvc_grant_reply(struct svc_rqst *rqstp, struct nlm_cookie *cookie, u32 status)
645 struct nlm_block *block;
646 struct nlm_file *file;
648 dprintk("grant_reply: looking for cookie %x, host (%08x), s=%d \n",
649 *(unsigned int *)(cookie->data),
650 ntohl(rqstp->rq_addr.sin_addr.s_addr), status);
651 if (!(block = nlmsvc_find_block(cookie, &rqstp->rq_addr)))
653 file = block->b_file;
656 if (status == NLM_LCK_DENIED_GRACE_PERIOD) {
657 /* Try again in a couple of seconds */
658 nlmsvc_insert_block(block, 10 * HZ);
660 /* Lock is now held by client, or has been rejected.
661 * In both cases, the block should be removed. */
662 nlmsvc_unlink_block(block);
665 nlmsvc_release_block(block);
669 * Retry all blocked locks that have been notified. This is where lockd
670 * picks up locks that can be granted, or grant notifications that must
674 nlmsvc_retry_blocked(void)
676 unsigned long timeout = MAX_SCHEDULE_TIMEOUT;
677 struct nlm_block *block;
679 while (!list_empty(&nlm_blocked)) {
680 block = list_entry(nlm_blocked.next, struct nlm_block, b_list);
682 if (block->b_when == NLM_NEVER)
684 if (time_after(block->b_when,jiffies)) {
685 timeout = block->b_when - jiffies;
689 dprintk("nlmsvc_retry_blocked(%p, when=%ld)\n",
690 block, block->b_when);
691 kref_get(&block->b_count);
692 nlmsvc_grant_blocked(block);
693 nlmsvc_release_block(block);