2 * linux/fs/lockd/clntproc.c
4 * RPC procedures for the client side NLM implementation
6 * Copyright (C) 1996, Olaf Kirch <okir@monad.swb.de>
9 #include <linux/module.h>
10 #include <linux/types.h>
11 #include <linux/errno.h>
13 #include <linux/nfs_fs.h>
14 #include <linux/utsname.h>
15 #include <linux/freezer.h>
16 #include <linux/sunrpc/clnt.h>
17 #include <linux/sunrpc/svc.h>
18 #include <linux/lockd/lockd.h>
19 #include <linux/lockd/sm_inter.h>
21 #define NLMDBG_FACILITY NLMDBG_CLIENT
22 #define NLMCLNT_GRACE_WAIT (5*HZ)
23 #define NLMCLNT_POLL_TIMEOUT (30*HZ)
24 #define NLMCLNT_MAX_RETRIES 3
26 static int nlmclnt_test(struct nlm_rqst *, struct file_lock *);
27 static int nlmclnt_lock(struct nlm_rqst *, struct file_lock *);
28 static int nlmclnt_unlock(struct nlm_rqst *, struct file_lock *);
29 static int nlm_stat_to_errno(__be32 stat);
30 static void nlmclnt_locks_init_private(struct file_lock *fl, struct nlm_host *host);
31 static int nlmclnt_cancel(struct nlm_host *, int , struct file_lock *);
33 static const struct rpc_call_ops nlmclnt_unlock_ops;
34 static const struct rpc_call_ops nlmclnt_cancel_ops;
37 * Cookie counter for NLM requests
39 static atomic_t nlm_cookie = ATOMIC_INIT(0x1234);
41 void nlmclnt_next_cookie(struct nlm_cookie *c)
43 u32 cookie = atomic_inc_return(&nlm_cookie);
45 memcpy(c->data, &cookie, 4);
49 static struct nlm_lockowner *nlm_get_lockowner(struct nlm_lockowner *lockowner)
51 atomic_inc(&lockowner->count);
55 static void nlm_put_lockowner(struct nlm_lockowner *lockowner)
57 if (!atomic_dec_and_lock(&lockowner->count, &lockowner->host->h_lock))
59 list_del(&lockowner->list);
60 spin_unlock(&lockowner->host->h_lock);
61 nlm_release_host(lockowner->host);
65 static inline int nlm_pidbusy(struct nlm_host *host, uint32_t pid)
67 struct nlm_lockowner *lockowner;
68 list_for_each_entry(lockowner, &host->h_lockowners, list) {
69 if (lockowner->pid == pid)
75 static inline uint32_t __nlm_alloc_pid(struct nlm_host *host)
79 res = host->h_pidcount++;
80 } while (nlm_pidbusy(host, res) < 0);
84 static struct nlm_lockowner *__nlm_find_lockowner(struct nlm_host *host, fl_owner_t owner)
86 struct nlm_lockowner *lockowner;
87 list_for_each_entry(lockowner, &host->h_lockowners, list) {
88 if (lockowner->owner != owner)
90 return nlm_get_lockowner(lockowner);
95 static struct nlm_lockowner *nlm_find_lockowner(struct nlm_host *host, fl_owner_t owner)
97 struct nlm_lockowner *res, *new = NULL;
99 spin_lock(&host->h_lock);
100 res = __nlm_find_lockowner(host, owner);
102 spin_unlock(&host->h_lock);
103 new = kmalloc(sizeof(*new), GFP_KERNEL);
104 spin_lock(&host->h_lock);
105 res = __nlm_find_lockowner(host, owner);
106 if (res == NULL && new != NULL) {
108 atomic_set(&new->count, 1);
110 new->pid = __nlm_alloc_pid(host);
111 new->host = nlm_get_host(host);
112 list_add(&new->list, &host->h_lockowners);
116 spin_unlock(&host->h_lock);
122 * Initialize arguments for TEST/LOCK/UNLOCK/CANCEL calls
124 static void nlmclnt_setlockargs(struct nlm_rqst *req, struct file_lock *fl)
126 struct nlm_args *argp = &req->a_args;
127 struct nlm_lock *lock = &argp->lock;
129 nlmclnt_next_cookie(&argp->cookie);
130 argp->state = nsm_local_state;
131 memcpy(&lock->fh, NFS_FH(fl->fl_file->f_path.dentry->d_inode), sizeof(struct nfs_fh));
132 lock->caller = utsname()->nodename;
133 lock->oh.data = req->a_owner;
134 lock->oh.len = snprintf(req->a_owner, sizeof(req->a_owner), "%u@%s",
135 (unsigned int)fl->fl_u.nfs_fl.owner->pid,
136 utsname()->nodename);
137 lock->svid = fl->fl_u.nfs_fl.owner->pid;
138 lock->fl.fl_start = fl->fl_start;
139 lock->fl.fl_end = fl->fl_end;
140 lock->fl.fl_type = fl->fl_type;
143 static void nlmclnt_release_lockargs(struct nlm_rqst *req)
145 BUG_ON(req->a_args.lock.fl.fl_ops != NULL);
149 * nlmclnt_proc - Perform a single client-side lock request
150 * @host: address of a valid nlm_host context representing the NLM server
151 * @cmd: fcntl-style file lock operation to perform
152 * @fl: address of arguments for the lock operation
155 int nlmclnt_proc(struct nlm_host *host, int cmd, struct file_lock *fl)
157 struct nlm_rqst *call;
161 call = nlm_alloc_call(host);
165 nlmclnt_locks_init_private(fl, host);
166 /* Set up the argument struct */
167 nlmclnt_setlockargs(call, fl);
169 if (IS_SETLK(cmd) || IS_SETLKW(cmd)) {
170 if (fl->fl_type != F_UNLCK) {
171 call->a_args.block = IS_SETLKW(cmd) ? 1 : 0;
172 status = nlmclnt_lock(call, fl);
174 status = nlmclnt_unlock(call, fl);
175 } else if (IS_GETLK(cmd))
176 status = nlmclnt_test(call, fl);
180 fl->fl_ops->fl_release_private(fl);
183 dprintk("lockd: clnt proc returns %d\n", status);
186 EXPORT_SYMBOL_GPL(nlmclnt_proc);
189 * Allocate an NLM RPC call struct
191 * Note: the caller must hold a reference to host. In case of failure,
192 * this reference will be released.
194 struct nlm_rqst *nlm_alloc_call(struct nlm_host *host)
196 struct nlm_rqst *call;
199 call = kzalloc(sizeof(*call), GFP_KERNEL);
201 atomic_set(&call->a_count, 1);
202 locks_init_lock(&call->a_args.lock.fl);
203 locks_init_lock(&call->a_res.lock.fl);
209 printk("nlm_alloc_call: failed, waiting for memory\n");
210 schedule_timeout_interruptible(5*HZ);
212 nlm_release_host(host);
216 void nlm_release_call(struct nlm_rqst *call)
218 if (!atomic_dec_and_test(&call->a_count))
220 nlm_release_host(call->a_host);
221 nlmclnt_release_lockargs(call);
225 static void nlmclnt_rpc_release(void *data)
227 nlm_release_call(data);
230 static int nlm_wait_on_grace(wait_queue_head_t *queue)
235 prepare_to_wait(queue, &wait, TASK_INTERRUPTIBLE);
237 schedule_timeout(NLMCLNT_GRACE_WAIT);
242 finish_wait(queue, &wait);
250 nlmclnt_call(struct rpc_cred *cred, struct nlm_rqst *req, u32 proc)
252 struct nlm_host *host = req->a_host;
253 struct rpc_clnt *clnt;
254 struct nlm_args *argp = &req->a_args;
255 struct nlm_res *resp = &req->a_res;
256 struct rpc_message msg = {
263 dprintk("lockd: call procedure %d on %s\n",
264 (int)proc, host->h_name);
267 if (host->h_reclaiming && !argp->reclaim)
268 goto in_grace_period;
270 /* If we have no RPC client yet, create one. */
271 if ((clnt = nlm_bind_host(host)) == NULL)
273 msg.rpc_proc = &clnt->cl_procinfo[proc];
275 /* Perform the RPC call. If an error occurs, try again */
276 if ((status = rpc_call_sync(clnt, &msg, 0)) < 0) {
277 dprintk("lockd: rpc_call returned error %d\n", -status);
279 case -EPROTONOSUPPORT:
285 nlm_rebind_host(host);
289 return signalled () ? -EINTR : status;
295 if (resp->status == nlm_lck_denied_grace_period) {
296 dprintk("lockd: server in grace period\n");
299 "lockd: spurious grace period reject?!\n");
303 if (!argp->reclaim) {
304 /* We appear to be out of the grace period */
305 wake_up_all(&host->h_gracewait);
307 dprintk("lockd: server returns status %d\n", resp->status);
308 return 0; /* Okay, call complete */
313 * The server has rebooted and appears to be in the grace
314 * period during which locks are only allowed to be
316 * We can only back off and try again later.
318 status = nlm_wait_on_grace(&host->h_gracewait);
319 } while (status == 0);
325 * Generic NLM call, async version.
327 static struct rpc_task *__nlm_async_call(struct nlm_rqst *req, u32 proc, struct rpc_message *msg, const struct rpc_call_ops *tk_ops)
329 struct nlm_host *host = req->a_host;
330 struct rpc_clnt *clnt;
331 struct rpc_task_setup task_setup_data = {
333 .callback_ops = tk_ops,
334 .callback_data = req,
335 .flags = RPC_TASK_ASYNC,
338 dprintk("lockd: call procedure %d on %s (async)\n",
339 (int)proc, host->h_name);
341 /* If we have no RPC client yet, create one. */
342 clnt = nlm_bind_host(host);
345 msg->rpc_proc = &clnt->cl_procinfo[proc];
346 task_setup_data.rpc_client = clnt;
348 /* bootstrap and kick off the async RPC call */
349 return rpc_run_task(&task_setup_data);
351 tk_ops->rpc_release(req);
352 return ERR_PTR(-ENOLCK);
355 static int nlm_do_async_call(struct nlm_rqst *req, u32 proc, struct rpc_message *msg, const struct rpc_call_ops *tk_ops)
357 struct rpc_task *task;
359 task = __nlm_async_call(req, proc, msg, tk_ops);
361 return PTR_ERR(task);
367 * NLM asynchronous call.
369 int nlm_async_call(struct nlm_rqst *req, u32 proc, const struct rpc_call_ops *tk_ops)
371 struct rpc_message msg = {
372 .rpc_argp = &req->a_args,
373 .rpc_resp = &req->a_res,
375 return nlm_do_async_call(req, proc, &msg, tk_ops);
378 int nlm_async_reply(struct nlm_rqst *req, u32 proc, const struct rpc_call_ops *tk_ops)
380 struct rpc_message msg = {
381 .rpc_argp = &req->a_res,
383 return nlm_do_async_call(req, proc, &msg, tk_ops);
387 * NLM client asynchronous call.
389 * Note that although the calls are asynchronous, and are therefore
390 * guaranteed to complete, we still always attempt to wait for
391 * completion in order to be able to correctly track the lock
394 static int nlmclnt_async_call(struct rpc_cred *cred, struct nlm_rqst *req, u32 proc, const struct rpc_call_ops *tk_ops)
396 struct rpc_message msg = {
397 .rpc_argp = &req->a_args,
398 .rpc_resp = &req->a_res,
401 struct rpc_task *task;
404 task = __nlm_async_call(req, proc, &msg, tk_ops);
406 return PTR_ERR(task);
407 err = rpc_wait_for_completion_task(task);
413 * TEST for the presence of a conflicting lock
416 nlmclnt_test(struct nlm_rqst *req, struct file_lock *fl)
420 status = nlmclnt_call(nfs_file_cred(fl->fl_file), req, NLMPROC_TEST);
424 switch (req->a_res.status) {
426 fl->fl_type = F_UNLCK;
430 * Report the conflicting lock back to the application.
432 fl->fl_start = req->a_res.lock.fl.fl_start;
433 fl->fl_end = req->a_res.lock.fl.fl_start;
434 fl->fl_type = req->a_res.lock.fl.fl_type;
438 status = nlm_stat_to_errno(req->a_res.status);
441 nlm_release_call(req);
445 static void nlmclnt_locks_copy_lock(struct file_lock *new, struct file_lock *fl)
447 new->fl_u.nfs_fl.state = fl->fl_u.nfs_fl.state;
448 new->fl_u.nfs_fl.owner = nlm_get_lockowner(fl->fl_u.nfs_fl.owner);
449 list_add_tail(&new->fl_u.nfs_fl.list, &fl->fl_u.nfs_fl.owner->host->h_granted);
452 static void nlmclnt_locks_release_private(struct file_lock *fl)
454 list_del(&fl->fl_u.nfs_fl.list);
455 nlm_put_lockowner(fl->fl_u.nfs_fl.owner);
458 static struct file_lock_operations nlmclnt_lock_ops = {
459 .fl_copy_lock = nlmclnt_locks_copy_lock,
460 .fl_release_private = nlmclnt_locks_release_private,
463 static void nlmclnt_locks_init_private(struct file_lock *fl, struct nlm_host *host)
465 BUG_ON(fl->fl_ops != NULL);
466 fl->fl_u.nfs_fl.state = 0;
467 fl->fl_u.nfs_fl.owner = nlm_find_lockowner(host, fl->fl_owner);
468 INIT_LIST_HEAD(&fl->fl_u.nfs_fl.list);
469 fl->fl_ops = &nlmclnt_lock_ops;
472 static int do_vfs_lock(struct file_lock *fl)
475 switch (fl->fl_flags & (FL_POSIX|FL_FLOCK)) {
477 res = posix_lock_file_wait(fl->fl_file, fl);
480 res = flock_lock_file_wait(fl->fl_file, fl);
489 * LOCK: Try to create a lock
491 * Programmer Harassment Alert
493 * When given a blocking lock request in a sync RPC call, the HPUX lockd
494 * will faithfully return LCK_BLOCKED but never cares to notify us when
495 * the lock could be granted. This way, our local process could hang
496 * around forever waiting for the callback.
498 * Solution A: Implement busy-waiting
499 * Solution B: Use the async version of the call (NLM_LOCK_{MSG,RES})
501 * For now I am implementing solution A, because I hate the idea of
502 * re-implementing lockd for a third time in two months. The async
503 * calls shouldn't be too hard to do, however.
505 * This is one of the lovely things about standards in the NFS area:
506 * they're so soft and squishy you can't really blame HP for doing this.
509 nlmclnt_lock(struct nlm_rqst *req, struct file_lock *fl)
511 struct rpc_cred *cred = nfs_file_cred(fl->fl_file);
512 struct nlm_host *host = req->a_host;
513 struct nlm_res *resp = &req->a_res;
514 struct nlm_wait *block = NULL;
515 unsigned char fl_flags = fl->fl_flags;
516 unsigned char fl_type;
517 int status = -ENOLCK;
519 if (nsm_monitor(host) < 0) {
520 printk(KERN_NOTICE "lockd: failed to monitor %s\n",
524 fl->fl_flags |= FL_ACCESS;
525 status = do_vfs_lock(fl);
526 fl->fl_flags = fl_flags;
530 block = nlmclnt_prepare_block(host, fl);
533 * Initialise resp->status to a valid non-zero value,
534 * since 0 == nlm_lck_granted
536 resp->status = nlm_lck_blocked;
538 /* Reboot protection */
539 fl->fl_u.nfs_fl.state = host->h_state;
540 status = nlmclnt_call(cred, req, NLMPROC_LOCK);
543 /* Did a reclaimer thread notify us of a server reboot? */
544 if (resp->status == nlm_lck_denied_grace_period)
546 if (resp->status != nlm_lck_blocked)
548 /* Wait on an NLM blocking lock */
549 status = nlmclnt_block(block, req, NLMCLNT_POLL_TIMEOUT);
552 if (resp->status != nlm_lck_blocked)
556 /* if we were interrupted while blocking, then cancel the lock request
559 if (resp->status == nlm_lck_blocked) {
560 if (!req->a_args.block)
562 if (nlmclnt_cancel(host, req->a_args.block, fl) == 0)
566 if (resp->status == nlm_granted) {
567 down_read(&host->h_rwsem);
568 /* Check whether or not the server has rebooted */
569 if (fl->fl_u.nfs_fl.state != host->h_state) {
570 up_read(&host->h_rwsem);
573 /* Ensure the resulting lock will get added to granted list */
574 fl->fl_flags |= FL_SLEEP;
575 if (do_vfs_lock(fl) < 0)
576 printk(KERN_WARNING "%s: VFS is out of sync with lock manager!\n", __FUNCTION__);
577 up_read(&host->h_rwsem);
578 fl->fl_flags = fl_flags;
583 status = nlm_stat_to_errno(resp->status);
585 nlmclnt_finish_block(block);
587 nlm_release_call(req);
590 /* Fatal error: ensure that we remove the lock altogether */
591 dprintk("lockd: lock attempt ended in fatal error.\n"
592 " Attempting to unlock.\n");
593 nlmclnt_finish_block(block);
594 fl_type = fl->fl_type;
595 fl->fl_type = F_UNLCK;
596 down_read(&host->h_rwsem);
598 up_read(&host->h_rwsem);
599 fl->fl_type = fl_type;
600 fl->fl_flags = fl_flags;
601 nlmclnt_async_call(cred, req, NLMPROC_UNLOCK, &nlmclnt_unlock_ops);
606 * RECLAIM: Try to reclaim a lock
609 nlmclnt_reclaim(struct nlm_host *host, struct file_lock *fl)
611 struct nlm_rqst reqst, *req;
615 memset(req, 0, sizeof(*req));
616 locks_init_lock(&req->a_args.lock.fl);
617 locks_init_lock(&req->a_res.lock.fl);
621 /* Set up the argument struct */
622 nlmclnt_setlockargs(req, fl);
623 req->a_args.reclaim = 1;
625 status = nlmclnt_call(nfs_file_cred(fl->fl_file), req, NLMPROC_LOCK);
626 if (status >= 0 && req->a_res.status == nlm_granted)
629 printk(KERN_WARNING "lockd: failed to reclaim lock for pid %d "
630 "(errno %d, status %d)\n", fl->fl_pid,
631 status, ntohl(req->a_res.status));
634 * FIXME: This is a serious failure. We can
636 * a. Ignore the problem
637 * b. Send the owning process some signal (Linux doesn't have
638 * SIGLOST, though...)
639 * c. Retry the operation
641 * Until someone comes up with a simple implementation
642 * for b or c, I'll choose option a.
649 * UNLOCK: remove an existing lock
652 nlmclnt_unlock(struct nlm_rqst *req, struct file_lock *fl)
654 struct nlm_host *host = req->a_host;
655 struct nlm_res *resp = &req->a_res;
657 unsigned char fl_flags = fl->fl_flags;
660 * Note: the server is supposed to either grant us the unlock
661 * request, or to deny it with NLM_LCK_DENIED_GRACE_PERIOD. In either
662 * case, we want to unlock.
664 fl->fl_flags |= FL_EXISTS;
665 down_read(&host->h_rwsem);
666 status = do_vfs_lock(fl);
667 up_read(&host->h_rwsem);
668 fl->fl_flags = fl_flags;
669 if (status == -ENOENT) {
674 atomic_inc(&req->a_count);
675 status = nlmclnt_async_call(nfs_file_cred(fl->fl_file), req,
676 NLMPROC_UNLOCK, &nlmclnt_unlock_ops);
680 if (resp->status == nlm_granted)
683 if (resp->status != nlm_lck_denied_nolocks)
684 printk("lockd: unexpected unlock status: %d\n", resp->status);
685 /* What to do now? I'm out of my depth... */
688 nlm_release_call(req);
692 static void nlmclnt_unlock_callback(struct rpc_task *task, void *data)
694 struct nlm_rqst *req = data;
695 u32 status = ntohl(req->a_res.status);
697 if (RPC_ASSASSINATED(task))
700 if (task->tk_status < 0) {
701 dprintk("lockd: unlock failed (err = %d)\n", -task->tk_status);
704 if (status == NLM_LCK_DENIED_GRACE_PERIOD) {
705 rpc_delay(task, NLMCLNT_GRACE_WAIT);
708 if (status != NLM_LCK_GRANTED)
709 printk(KERN_WARNING "lockd: unexpected unlock status: %d\n", status);
713 nlm_rebind_host(req->a_host);
715 rpc_restart_call(task);
718 static const struct rpc_call_ops nlmclnt_unlock_ops = {
719 .rpc_call_done = nlmclnt_unlock_callback,
720 .rpc_release = nlmclnt_rpc_release,
724 * Cancel a blocked lock request.
725 * We always use an async RPC call for this in order not to hang a
726 * process that has been Ctrl-C'ed.
728 static int nlmclnt_cancel(struct nlm_host *host, int block, struct file_lock *fl)
730 struct nlm_rqst *req;
733 dprintk("lockd: blocking lock attempt was interrupted by a signal.\n"
734 " Attempting to cancel lock.\n");
736 req = nlm_alloc_call(nlm_get_host(host));
739 req->a_flags = RPC_TASK_ASYNC;
741 nlmclnt_setlockargs(req, fl);
742 req->a_args.block = block;
744 atomic_inc(&req->a_count);
745 status = nlmclnt_async_call(nfs_file_cred(fl->fl_file), req,
746 NLMPROC_CANCEL, &nlmclnt_cancel_ops);
747 if (status == 0 && req->a_res.status == nlm_lck_denied)
749 nlm_release_call(req);
753 static void nlmclnt_cancel_callback(struct rpc_task *task, void *data)
755 struct nlm_rqst *req = data;
756 u32 status = ntohl(req->a_res.status);
758 if (RPC_ASSASSINATED(task))
761 if (task->tk_status < 0) {
762 dprintk("lockd: CANCEL call error %d, retrying.\n",
767 dprintk("lockd: cancel status %u (task %u)\n",
768 status, task->tk_pid);
771 case NLM_LCK_GRANTED:
772 case NLM_LCK_DENIED_GRACE_PERIOD:
774 /* Everything's good */
776 case NLM_LCK_DENIED_NOLOCKS:
777 dprintk("lockd: CANCEL failed (server has no locks)\n");
780 printk(KERN_NOTICE "lockd: weird return %d for CANCEL call\n",
788 /* Don't ever retry more than 3 times */
789 if (req->a_retries++ >= NLMCLNT_MAX_RETRIES)
791 nlm_rebind_host(req->a_host);
792 rpc_restart_call(task);
793 rpc_delay(task, 30 * HZ);
796 static const struct rpc_call_ops nlmclnt_cancel_ops = {
797 .rpc_call_done = nlmclnt_cancel_callback,
798 .rpc_release = nlmclnt_rpc_release,
802 * Convert an NLM status code to a generic kernel errno
805 nlm_stat_to_errno(__be32 status)
807 switch(ntohl(status)) {
808 case NLM_LCK_GRANTED:
812 case NLM_LCK_DENIED_NOLOCKS:
813 case NLM_LCK_DENIED_GRACE_PERIOD:
815 case NLM_LCK_BLOCKED:
816 printk(KERN_NOTICE "lockd: unexpected status NLM_BLOCKED\n");
818 #ifdef CONFIG_LOCKD_V4
831 printk(KERN_NOTICE "lockd: unexpected server status %d\n", status);