Greg Kroah-Hartman | b244131 | 2017-11-01 15:07:57 +0100 | [diff] [blame] | 1 | // SPDX-License-Identifier: GPL-2.0 |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 2 | /* |
| 3 | * linux/fs/lockd/svcproc.c |
| 4 | * |
| 5 | * Lockd server procedures. We don't implement the NLM_*_RES |
| 6 | * procedures because we don't use the async procedures. |
| 7 | * |
| 8 | * Copyright (C) 1996, Olaf Kirch <okir@monad.swb.de> |
| 9 | */ |
| 10 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 11 | #include <linux/types.h> |
| 12 | #include <linux/time.h> |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 13 | #include <linux/lockd/lockd.h> |
| 14 | #include <linux/lockd/share.h> |
Stanislav Kinsbursky | 5ccb006 | 2012-07-25 16:57:22 +0400 | [diff] [blame] | 15 | #include <linux/sunrpc/svc_xprt.h> |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 16 | |
| 17 | #define NLMDBG_FACILITY NLMDBG_CLIENT |
| 18 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 19 | #ifdef CONFIG_LOCKD_V4 |
Al Viro | 52921e0 | 2006-10-19 23:28:46 -0700 | [diff] [blame] | 20 | static __be32 |
| 21 | cast_to_nlm(__be32 status, u32 vers) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 22 | { |
| 23 | /* Note: status is assumed to be in network byte order !!! */ |
| 24 | if (vers != 4){ |
| 25 | switch (status) { |
| 26 | case nlm_granted: |
| 27 | case nlm_lck_denied: |
| 28 | case nlm_lck_denied_nolocks: |
| 29 | case nlm_lck_blocked: |
| 30 | case nlm_lck_denied_grace_period: |
Marc Eshel | 5ea0d75 | 2006-11-28 16:27:06 -0500 | [diff] [blame] | 31 | case nlm_drop_reply: |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 32 | break; |
| 33 | case nlm4_deadlock: |
| 34 | status = nlm_lck_denied; |
| 35 | break; |
| 36 | default: |
| 37 | status = nlm_lck_denied_nolocks; |
| 38 | } |
| 39 | } |
| 40 | |
| 41 | return (status); |
| 42 | } |
| 43 | #define cast_status(status) (cast_to_nlm(status, rqstp->rq_vers)) |
| 44 | #else |
| 45 | #define cast_status(status) (status) |
| 46 | #endif |
| 47 | |
| 48 | /* |
| 49 | * Obtain client and file from arguments |
| 50 | */ |
Al Viro | 52921e0 | 2006-10-19 23:28:46 -0700 | [diff] [blame] | 51 | static __be32 |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 52 | nlmsvc_retrieve_args(struct svc_rqst *rqstp, struct nlm_args *argp, |
| 53 | struct nlm_host **hostp, struct nlm_file **filp) |
| 54 | { |
| 55 | struct nlm_host *host = NULL; |
| 56 | struct nlm_file *file = NULL; |
| 57 | struct nlm_lock *lock = &argp->lock; |
Al Viro | 52921e0 | 2006-10-19 23:28:46 -0700 | [diff] [blame] | 58 | __be32 error = 0; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 59 | |
| 60 | /* nfsd callbacks must have been installed for this procedure */ |
| 61 | if (!nlmsvc_ops) |
| 62 | return nlm_lck_denied_nolocks; |
| 63 | |
| 64 | /* Obtain host handle */ |
Olaf Kirch | db4e4c9 | 2006-10-04 02:15:52 -0700 | [diff] [blame] | 65 | if (!(host = nlmsvc_lookup_host(rqstp, lock->caller, lock->len)) |
Olaf Kirch | 977faf3 | 2006-10-04 02:15:51 -0700 | [diff] [blame] | 66 | || (argp->monitor && nsm_monitor(host) < 0)) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 67 | goto no_locks; |
| 68 | *hostp = host; |
| 69 | |
| 70 | /* Obtain file pointer. Not used by FREE_ALL call. */ |
| 71 | if (filp != NULL) { |
Trond Myklebust | cd0b16c | 2012-10-13 00:30:28 -0400 | [diff] [blame] | 72 | error = cast_status(nlm_lookup_file(rqstp, &file, &lock->fh)); |
| 73 | if (error != 0) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 74 | goto no_locks; |
| 75 | *filp = file; |
| 76 | |
| 77 | /* Set up the missing parts of the file_lock structure */ |
| 78 | lock->fl.fl_file = file->f_file; |
| 79 | lock->fl.fl_owner = (fl_owner_t) host; |
| 80 | lock->fl.fl_lmops = &nlmsvc_lock_operations; |
| 81 | } |
| 82 | |
| 83 | return 0; |
| 84 | |
| 85 | no_locks: |
Chuck Lever | 67216b9 | 2010-12-14 15:06:12 +0000 | [diff] [blame] | 86 | nlmsvc_release_host(host); |
NeilBrown | d343fce | 2006-10-17 00:10:18 -0700 | [diff] [blame] | 87 | if (error) |
| 88 | return error; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 89 | return nlm_lck_denied_nolocks; |
| 90 | } |
| 91 | |
| 92 | /* |
| 93 | * NULL: Test for presence of service |
| 94 | */ |
Al Viro | 7111c66 | 2006-10-19 23:28:45 -0700 | [diff] [blame] | 95 | static __be32 |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 96 | nlmsvc_proc_null(struct svc_rqst *rqstp) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 97 | { |
| 98 | dprintk("lockd: NULL called\n"); |
| 99 | return rpc_success; |
| 100 | } |
| 101 | |
| 102 | /* |
| 103 | * TEST: Check for conflicting lock |
| 104 | */ |
Al Viro | 7111c66 | 2006-10-19 23:28:45 -0700 | [diff] [blame] | 105 | static __be32 |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 106 | __nlmsvc_proc_test(struct svc_rqst *rqstp, struct nlm_res *resp) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 107 | { |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 108 | struct nlm_args *argp = rqstp->rq_argp; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 109 | struct nlm_host *host; |
| 110 | struct nlm_file *file; |
Harvey Harrison | 317602f | 2008-07-20 23:41:24 -0700 | [diff] [blame] | 111 | __be32 rc = rpc_success; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 112 | |
| 113 | dprintk("lockd: TEST called\n"); |
| 114 | resp->cookie = argp->cookie; |
| 115 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 116 | /* Obtain client and file */ |
| 117 | if ((resp->status = nlmsvc_retrieve_args(rqstp, argp, &host, &file))) |
NeilBrown | d343fce | 2006-10-17 00:10:18 -0700 | [diff] [blame] | 118 | return resp->status == nlm_drop_reply ? rpc_drop_reply :rpc_success; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 119 | |
| 120 | /* Now check for conflicting locks */ |
Jeff Layton | 8f920d5 | 2008-07-15 14:06:48 -0400 | [diff] [blame] | 121 | resp->status = cast_status(nlmsvc_testlock(rqstp, file, host, &argp->lock, &resp->lock, &resp->cookie)); |
Marc Eshel | 5ea0d75 | 2006-11-28 16:27:06 -0500 | [diff] [blame] | 122 | if (resp->status == nlm_drop_reply) |
Oleg Drokin | b7e6b86 | 2007-11-26 13:35:11 -0500 | [diff] [blame] | 123 | rc = rpc_drop_reply; |
| 124 | else |
| 125 | dprintk("lockd: TEST status %d vers %d\n", |
| 126 | ntohl(resp->status), rqstp->rq_vers); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 127 | |
Chuck Lever | 67216b9 | 2010-12-14 15:06:12 +0000 | [diff] [blame] | 128 | nlmsvc_release_host(host); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 129 | nlm_release_file(file); |
Oleg Drokin | b7e6b86 | 2007-11-26 13:35:11 -0500 | [diff] [blame] | 130 | return rc; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 131 | } |
| 132 | |
Al Viro | 7111c66 | 2006-10-19 23:28:45 -0700 | [diff] [blame] | 133 | static __be32 |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 134 | nlmsvc_proc_test(struct svc_rqst *rqstp) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 135 | { |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 136 | return __nlmsvc_proc_test(rqstp, rqstp->rq_resp); |
| 137 | } |
| 138 | |
| 139 | static __be32 |
| 140 | __nlmsvc_proc_lock(struct svc_rqst *rqstp, struct nlm_res *resp) |
| 141 | { |
| 142 | struct nlm_args *argp = rqstp->rq_argp; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 143 | struct nlm_host *host; |
| 144 | struct nlm_file *file; |
Harvey Harrison | 317602f | 2008-07-20 23:41:24 -0700 | [diff] [blame] | 145 | __be32 rc = rpc_success; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 146 | |
| 147 | dprintk("lockd: LOCK called\n"); |
| 148 | |
| 149 | resp->cookie = argp->cookie; |
| 150 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 151 | /* Obtain client and file */ |
| 152 | if ((resp->status = nlmsvc_retrieve_args(rqstp, argp, &host, &file))) |
NeilBrown | d343fce | 2006-10-17 00:10:18 -0700 | [diff] [blame] | 153 | return resp->status == nlm_drop_reply ? rpc_drop_reply :rpc_success; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 154 | |
| 155 | #if 0 |
| 156 | /* If supplied state doesn't match current state, we assume it's |
| 157 | * an old request that time-warped somehow. Any error return would |
| 158 | * do in this case because it's irrelevant anyway. |
| 159 | * |
| 160 | * NB: We don't retrieve the remote host's state yet. |
| 161 | */ |
| 162 | if (host->h_nsmstate && host->h_nsmstate != argp->state) { |
| 163 | resp->status = nlm_lck_denied_nolocks; |
| 164 | } else |
| 165 | #endif |
| 166 | |
| 167 | /* Now try to lock the file */ |
Jeff Layton | 6cde4de | 2008-07-15 14:26:17 -0400 | [diff] [blame] | 168 | resp->status = cast_status(nlmsvc_lock(rqstp, file, host, &argp->lock, |
J. Bruce Fields | b2b5028 | 2008-02-06 13:59:23 -0500 | [diff] [blame] | 169 | argp->block, &argp->cookie, |
| 170 | argp->reclaim)); |
Marc Eshel | 1a8322b | 2006-11-28 16:27:06 -0500 | [diff] [blame] | 171 | if (resp->status == nlm_drop_reply) |
Oleg Drokin | b7e6b86 | 2007-11-26 13:35:11 -0500 | [diff] [blame] | 172 | rc = rpc_drop_reply; |
| 173 | else |
| 174 | dprintk("lockd: LOCK status %d\n", ntohl(resp->status)); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 175 | |
Chuck Lever | 67216b9 | 2010-12-14 15:06:12 +0000 | [diff] [blame] | 176 | nlmsvc_release_host(host); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 177 | nlm_release_file(file); |
Oleg Drokin | b7e6b86 | 2007-11-26 13:35:11 -0500 | [diff] [blame] | 178 | return rc; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 179 | } |
| 180 | |
Al Viro | 7111c66 | 2006-10-19 23:28:45 -0700 | [diff] [blame] | 181 | static __be32 |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 182 | nlmsvc_proc_lock(struct svc_rqst *rqstp) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 183 | { |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 184 | return __nlmsvc_proc_lock(rqstp, rqstp->rq_resp); |
| 185 | } |
| 186 | |
| 187 | static __be32 |
| 188 | __nlmsvc_proc_cancel(struct svc_rqst *rqstp, struct nlm_res *resp) |
| 189 | { |
| 190 | struct nlm_args *argp = rqstp->rq_argp; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 191 | struct nlm_host *host; |
| 192 | struct nlm_file *file; |
Stanislav Kinsbursky | 5ccb006 | 2012-07-25 16:57:22 +0400 | [diff] [blame] | 193 | struct net *net = SVC_NET(rqstp); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 194 | |
| 195 | dprintk("lockd: CANCEL called\n"); |
| 196 | |
| 197 | resp->cookie = argp->cookie; |
| 198 | |
| 199 | /* Don't accept requests during grace period */ |
Stanislav Kinsbursky | 5ccb006 | 2012-07-25 16:57:22 +0400 | [diff] [blame] | 200 | if (locks_in_grace(net)) { |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 201 | resp->status = nlm_lck_denied_grace_period; |
| 202 | return rpc_success; |
| 203 | } |
| 204 | |
| 205 | /* Obtain client and file */ |
| 206 | if ((resp->status = nlmsvc_retrieve_args(rqstp, argp, &host, &file))) |
NeilBrown | d343fce | 2006-10-17 00:10:18 -0700 | [diff] [blame] | 207 | return resp->status == nlm_drop_reply ? rpc_drop_reply :rpc_success; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 208 | |
| 209 | /* Try to cancel request. */ |
Stanislav Kinsbursky | 5ccb006 | 2012-07-25 16:57:22 +0400 | [diff] [blame] | 210 | resp->status = cast_status(nlmsvc_cancel_blocked(net, file, &argp->lock)); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 211 | |
| 212 | dprintk("lockd: CANCEL status %d\n", ntohl(resp->status)); |
Chuck Lever | 67216b9 | 2010-12-14 15:06:12 +0000 | [diff] [blame] | 213 | nlmsvc_release_host(host); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 214 | nlm_release_file(file); |
| 215 | return rpc_success; |
| 216 | } |
| 217 | |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 218 | static __be32 |
| 219 | nlmsvc_proc_cancel(struct svc_rqst *rqstp) |
| 220 | { |
| 221 | return __nlmsvc_proc_cancel(rqstp, rqstp->rq_resp); |
| 222 | } |
| 223 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 224 | /* |
| 225 | * UNLOCK: release a lock |
| 226 | */ |
Al Viro | 7111c66 | 2006-10-19 23:28:45 -0700 | [diff] [blame] | 227 | static __be32 |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 228 | __nlmsvc_proc_unlock(struct svc_rqst *rqstp, struct nlm_res *resp) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 229 | { |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 230 | struct nlm_args *argp = rqstp->rq_argp; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 231 | struct nlm_host *host; |
| 232 | struct nlm_file *file; |
Stanislav Kinsbursky | 5ccb006 | 2012-07-25 16:57:22 +0400 | [diff] [blame] | 233 | struct net *net = SVC_NET(rqstp); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 234 | |
| 235 | dprintk("lockd: UNLOCK called\n"); |
| 236 | |
| 237 | resp->cookie = argp->cookie; |
| 238 | |
| 239 | /* Don't accept new lock requests during grace period */ |
Stanislav Kinsbursky | 5ccb006 | 2012-07-25 16:57:22 +0400 | [diff] [blame] | 240 | if (locks_in_grace(net)) { |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 241 | resp->status = nlm_lck_denied_grace_period; |
| 242 | return rpc_success; |
| 243 | } |
| 244 | |
| 245 | /* Obtain client and file */ |
| 246 | if ((resp->status = nlmsvc_retrieve_args(rqstp, argp, &host, &file))) |
NeilBrown | d343fce | 2006-10-17 00:10:18 -0700 | [diff] [blame] | 247 | return resp->status == nlm_drop_reply ? rpc_drop_reply :rpc_success; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 248 | |
| 249 | /* Now try to remove the lock */ |
Stanislav Kinsbursky | 5ccb006 | 2012-07-25 16:57:22 +0400 | [diff] [blame] | 250 | resp->status = cast_status(nlmsvc_unlock(net, file, &argp->lock)); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 251 | |
| 252 | dprintk("lockd: UNLOCK status %d\n", ntohl(resp->status)); |
Chuck Lever | 67216b9 | 2010-12-14 15:06:12 +0000 | [diff] [blame] | 253 | nlmsvc_release_host(host); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 254 | nlm_release_file(file); |
| 255 | return rpc_success; |
| 256 | } |
| 257 | |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 258 | static __be32 |
| 259 | nlmsvc_proc_unlock(struct svc_rqst *rqstp) |
| 260 | { |
| 261 | return __nlmsvc_proc_unlock(rqstp, rqstp->rq_resp); |
| 262 | } |
| 263 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 264 | /* |
| 265 | * GRANTED: A server calls us to tell that a process' lock request |
| 266 | * was granted |
| 267 | */ |
Al Viro | 7111c66 | 2006-10-19 23:28:45 -0700 | [diff] [blame] | 268 | static __be32 |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 269 | __nlmsvc_proc_granted(struct svc_rqst *rqstp, struct nlm_res *resp) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 270 | { |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 271 | struct nlm_args *argp = rqstp->rq_argp; |
| 272 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 273 | resp->cookie = argp->cookie; |
| 274 | |
| 275 | dprintk("lockd: GRANTED called\n"); |
Chuck Lever | dcff09f | 2008-10-03 12:50:36 -0400 | [diff] [blame] | 276 | resp->status = nlmclnt_grant(svc_addr(rqstp), &argp->lock); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 277 | dprintk("lockd: GRANTED status %d\n", ntohl(resp->status)); |
| 278 | return rpc_success; |
| 279 | } |
| 280 | |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 281 | static __be32 |
| 282 | nlmsvc_proc_granted(struct svc_rqst *rqstp) |
| 283 | { |
| 284 | return __nlmsvc_proc_granted(rqstp, rqstp->rq_resp); |
| 285 | } |
| 286 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 287 | /* |
Trond Myklebust | d471662 | 2006-03-20 13:44:45 -0500 | [diff] [blame] | 288 | * This is the generic lockd callback for async RPC calls |
| 289 | */ |
| 290 | static void nlmsvc_callback_exit(struct rpc_task *task, void *data) |
| 291 | { |
Chuck Lever | c041b5f | 2006-12-05 16:36:03 -0500 | [diff] [blame] | 292 | dprintk("lockd: %5u callback returned %d\n", task->tk_pid, |
Trond Myklebust | d471662 | 2006-03-20 13:44:45 -0500 | [diff] [blame] | 293 | -task->tk_status); |
| 294 | } |
| 295 | |
Chuck Lever | 7db836d | 2010-12-14 15:05:42 +0000 | [diff] [blame] | 296 | void nlmsvc_release_call(struct nlm_rqst *call) |
| 297 | { |
| 298 | if (!atomic_dec_and_test(&call->a_count)) |
| 299 | return; |
Chuck Lever | 67216b9 | 2010-12-14 15:06:12 +0000 | [diff] [blame] | 300 | nlmsvc_release_host(call->a_host); |
Chuck Lever | 7db836d | 2010-12-14 15:05:42 +0000 | [diff] [blame] | 301 | kfree(call); |
| 302 | } |
| 303 | |
Trond Myklebust | d471662 | 2006-03-20 13:44:45 -0500 | [diff] [blame] | 304 | static void nlmsvc_callback_release(void *data) |
| 305 | { |
Chuck Lever | 7db836d | 2010-12-14 15:05:42 +0000 | [diff] [blame] | 306 | nlmsvc_release_call(data); |
Trond Myklebust | d471662 | 2006-03-20 13:44:45 -0500 | [diff] [blame] | 307 | } |
| 308 | |
| 309 | static const struct rpc_call_ops nlmsvc_callback_ops = { |
| 310 | .rpc_call_done = nlmsvc_callback_exit, |
| 311 | .rpc_release = nlmsvc_callback_release, |
| 312 | }; |
| 313 | |
| 314 | /* |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 315 | * `Async' versions of the above service routines. They aren't really, |
| 316 | * because we send the callback before the reply proper. I hope this |
| 317 | * doesn't break any clients. |
| 318 | */ |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 319 | static __be32 nlmsvc_callback(struct svc_rqst *rqstp, u32 proc, |
| 320 | __be32 (*func)(struct svc_rqst *, struct nlm_res *)) |
Trond Myklebust | d471662 | 2006-03-20 13:44:45 -0500 | [diff] [blame] | 321 | { |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 322 | struct nlm_args *argp = rqstp->rq_argp; |
Trond Myklebust | d471662 | 2006-03-20 13:44:45 -0500 | [diff] [blame] | 323 | struct nlm_host *host; |
| 324 | struct nlm_rqst *call; |
Al Viro | 7111c66 | 2006-10-19 23:28:45 -0700 | [diff] [blame] | 325 | __be32 stat; |
Trond Myklebust | d471662 | 2006-03-20 13:44:45 -0500 | [diff] [blame] | 326 | |
Olaf Kirch | db4e4c9 | 2006-10-04 02:15:52 -0700 | [diff] [blame] | 327 | host = nlmsvc_lookup_host(rqstp, |
| 328 | argp->lock.caller, |
| 329 | argp->lock.len); |
Trond Myklebust | d471662 | 2006-03-20 13:44:45 -0500 | [diff] [blame] | 330 | if (host == NULL) |
| 331 | return rpc_system_err; |
| 332 | |
| 333 | call = nlm_alloc_call(host); |
Al Viro | 446945a | 2012-07-26 00:39:50 +0400 | [diff] [blame] | 334 | nlmsvc_release_host(host); |
Trond Myklebust | d471662 | 2006-03-20 13:44:45 -0500 | [diff] [blame] | 335 | if (call == NULL) |
| 336 | return rpc_system_err; |
| 337 | |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 338 | stat = func(rqstp, &call->a_res); |
Trond Myklebust | d471662 | 2006-03-20 13:44:45 -0500 | [diff] [blame] | 339 | if (stat != 0) { |
Chuck Lever | 7db836d | 2010-12-14 15:05:42 +0000 | [diff] [blame] | 340 | nlmsvc_release_call(call); |
Trond Myklebust | d471662 | 2006-03-20 13:44:45 -0500 | [diff] [blame] | 341 | return stat; |
| 342 | } |
| 343 | |
| 344 | call->a_flags = RPC_TASK_ASYNC; |
| 345 | if (nlm_async_reply(call, proc, &nlmsvc_callback_ops) < 0) |
| 346 | return rpc_system_err; |
| 347 | return rpc_success; |
| 348 | } |
| 349 | |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 350 | static __be32 nlmsvc_proc_test_msg(struct svc_rqst *rqstp) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 351 | { |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 352 | dprintk("lockd: TEST_MSG called\n"); |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 353 | return nlmsvc_callback(rqstp, NLMPROC_TEST_RES, __nlmsvc_proc_test); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 354 | } |
| 355 | |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 356 | static __be32 nlmsvc_proc_lock_msg(struct svc_rqst *rqstp) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 357 | { |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 358 | dprintk("lockd: LOCK_MSG called\n"); |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 359 | return nlmsvc_callback(rqstp, NLMPROC_LOCK_RES, __nlmsvc_proc_lock); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 360 | } |
| 361 | |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 362 | static __be32 nlmsvc_proc_cancel_msg(struct svc_rqst *rqstp) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 363 | { |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 364 | dprintk("lockd: CANCEL_MSG called\n"); |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 365 | return nlmsvc_callback(rqstp, NLMPROC_CANCEL_RES, __nlmsvc_proc_cancel); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 366 | } |
| 367 | |
Al Viro | 7111c66 | 2006-10-19 23:28:45 -0700 | [diff] [blame] | 368 | static __be32 |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 369 | nlmsvc_proc_unlock_msg(struct svc_rqst *rqstp) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 370 | { |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 371 | dprintk("lockd: UNLOCK_MSG called\n"); |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 372 | return nlmsvc_callback(rqstp, NLMPROC_UNLOCK_RES, __nlmsvc_proc_unlock); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 373 | } |
| 374 | |
Al Viro | 7111c66 | 2006-10-19 23:28:45 -0700 | [diff] [blame] | 375 | static __be32 |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 376 | nlmsvc_proc_granted_msg(struct svc_rqst *rqstp) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 377 | { |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 378 | dprintk("lockd: GRANTED_MSG called\n"); |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 379 | return nlmsvc_callback(rqstp, NLMPROC_GRANTED_RES, __nlmsvc_proc_granted); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 380 | } |
| 381 | |
| 382 | /* |
| 383 | * SHARE: create a DOS share or alter existing share. |
| 384 | */ |
Al Viro | 7111c66 | 2006-10-19 23:28:45 -0700 | [diff] [blame] | 385 | static __be32 |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 386 | nlmsvc_proc_share(struct svc_rqst *rqstp) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 387 | { |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 388 | struct nlm_args *argp = rqstp->rq_argp; |
| 389 | struct nlm_res *resp = rqstp->rq_resp; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 390 | struct nlm_host *host; |
| 391 | struct nlm_file *file; |
| 392 | |
| 393 | dprintk("lockd: SHARE called\n"); |
| 394 | |
| 395 | resp->cookie = argp->cookie; |
| 396 | |
| 397 | /* Don't accept new lock requests during grace period */ |
Stanislav Kinsbursky | 5ccb006 | 2012-07-25 16:57:22 +0400 | [diff] [blame] | 398 | if (locks_in_grace(SVC_NET(rqstp)) && !argp->reclaim) { |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 399 | resp->status = nlm_lck_denied_grace_period; |
| 400 | return rpc_success; |
| 401 | } |
| 402 | |
| 403 | /* Obtain client and file */ |
| 404 | if ((resp->status = nlmsvc_retrieve_args(rqstp, argp, &host, &file))) |
NeilBrown | d343fce | 2006-10-17 00:10:18 -0700 | [diff] [blame] | 405 | return resp->status == nlm_drop_reply ? rpc_drop_reply :rpc_success; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 406 | |
| 407 | /* Now try to create the share */ |
| 408 | resp->status = cast_status(nlmsvc_share_file(host, file, argp)); |
| 409 | |
| 410 | dprintk("lockd: SHARE status %d\n", ntohl(resp->status)); |
Chuck Lever | 67216b9 | 2010-12-14 15:06:12 +0000 | [diff] [blame] | 411 | nlmsvc_release_host(host); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 412 | nlm_release_file(file); |
| 413 | return rpc_success; |
| 414 | } |
| 415 | |
| 416 | /* |
| 417 | * UNSHARE: Release a DOS share. |
| 418 | */ |
Al Viro | 7111c66 | 2006-10-19 23:28:45 -0700 | [diff] [blame] | 419 | static __be32 |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 420 | nlmsvc_proc_unshare(struct svc_rqst *rqstp) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 421 | { |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 422 | struct nlm_args *argp = rqstp->rq_argp; |
| 423 | struct nlm_res *resp = rqstp->rq_resp; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 424 | struct nlm_host *host; |
| 425 | struct nlm_file *file; |
| 426 | |
| 427 | dprintk("lockd: UNSHARE called\n"); |
| 428 | |
| 429 | resp->cookie = argp->cookie; |
| 430 | |
| 431 | /* Don't accept requests during grace period */ |
Stanislav Kinsbursky | 5ccb006 | 2012-07-25 16:57:22 +0400 | [diff] [blame] | 432 | if (locks_in_grace(SVC_NET(rqstp))) { |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 433 | resp->status = nlm_lck_denied_grace_period; |
| 434 | return rpc_success; |
| 435 | } |
| 436 | |
| 437 | /* Obtain client and file */ |
| 438 | if ((resp->status = nlmsvc_retrieve_args(rqstp, argp, &host, &file))) |
NeilBrown | d343fce | 2006-10-17 00:10:18 -0700 | [diff] [blame] | 439 | return resp->status == nlm_drop_reply ? rpc_drop_reply :rpc_success; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 440 | |
| 441 | /* Now try to unshare the file */ |
| 442 | resp->status = cast_status(nlmsvc_unshare_file(host, file, argp)); |
| 443 | |
| 444 | dprintk("lockd: UNSHARE status %d\n", ntohl(resp->status)); |
Chuck Lever | 67216b9 | 2010-12-14 15:06:12 +0000 | [diff] [blame] | 445 | nlmsvc_release_host(host); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 446 | nlm_release_file(file); |
| 447 | return rpc_success; |
| 448 | } |
| 449 | |
| 450 | /* |
| 451 | * NM_LOCK: Create an unmonitored lock |
| 452 | */ |
Al Viro | 7111c66 | 2006-10-19 23:28:45 -0700 | [diff] [blame] | 453 | static __be32 |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 454 | nlmsvc_proc_nm_lock(struct svc_rqst *rqstp) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 455 | { |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 456 | struct nlm_args *argp = rqstp->rq_argp; |
| 457 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 458 | dprintk("lockd: NM_LOCK called\n"); |
| 459 | |
| 460 | argp->monitor = 0; /* just clean the monitor flag */ |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 461 | return nlmsvc_proc_lock(rqstp); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 462 | } |
| 463 | |
| 464 | /* |
| 465 | * FREE_ALL: Release all locks and shares held by client |
| 466 | */ |
Al Viro | 7111c66 | 2006-10-19 23:28:45 -0700 | [diff] [blame] | 467 | static __be32 |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 468 | nlmsvc_proc_free_all(struct svc_rqst *rqstp) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 469 | { |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 470 | struct nlm_args *argp = rqstp->rq_argp; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 471 | struct nlm_host *host; |
| 472 | |
| 473 | /* Obtain client */ |
| 474 | if (nlmsvc_retrieve_args(rqstp, argp, &host, NULL)) |
| 475 | return rpc_success; |
| 476 | |
| 477 | nlmsvc_free_host_resources(host); |
Chuck Lever | 67216b9 | 2010-12-14 15:06:12 +0000 | [diff] [blame] | 478 | nlmsvc_release_host(host); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 479 | return rpc_success; |
| 480 | } |
| 481 | |
| 482 | /* |
| 483 | * SM_NOTIFY: private callback from statd (not part of official NLM proto) |
| 484 | */ |
Al Viro | 7111c66 | 2006-10-19 23:28:45 -0700 | [diff] [blame] | 485 | static __be32 |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 486 | nlmsvc_proc_sm_notify(struct svc_rqst *rqstp) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 487 | { |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 488 | struct nlm_reboot *argp = rqstp->rq_argp; |
| 489 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 490 | dprintk("lockd: SM_NOTIFY called\n"); |
Chuck Lever | b85e467 | 2008-10-03 12:50:44 -0400 | [diff] [blame] | 491 | |
| 492 | if (!nlm_privileged_requester(rqstp)) { |
Chuck Lever | ad06e4b | 2007-02-12 00:53:32 -0800 | [diff] [blame] | 493 | char buf[RPC_MAX_ADDRBUFLEN]; |
| 494 | printk(KERN_WARNING "lockd: rejected NSM callback from %s\n", |
| 495 | svc_print_addr(rqstp, buf, sizeof(buf))); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 496 | return rpc_system_err; |
| 497 | } |
| 498 | |
Andrey Ryabinin | 0ad9547 | 2015-09-23 15:49:29 +0300 | [diff] [blame] | 499 | nlm_host_rebooted(SVC_NET(rqstp), argp); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 500 | return rpc_success; |
| 501 | } |
| 502 | |
| 503 | /* |
| 504 | * client sent a GRANTED_RES, let's remove the associated block |
| 505 | */ |
Al Viro | 7111c66 | 2006-10-19 23:28:45 -0700 | [diff] [blame] | 506 | static __be32 |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 507 | nlmsvc_proc_granted_res(struct svc_rqst *rqstp) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 508 | { |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 509 | struct nlm_res *argp = rqstp->rq_argp; |
| 510 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 511 | if (!nlmsvc_ops) |
| 512 | return rpc_success; |
| 513 | |
| 514 | dprintk("lockd: GRANTED_RES called\n"); |
| 515 | |
Olaf Kirch | 39be450 | 2006-10-04 02:16:03 -0700 | [diff] [blame] | 516 | nlmsvc_grant_reply(&argp->cookie, argp->status); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 517 | return rpc_success; |
| 518 | } |
| 519 | |
| 520 | /* |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 521 | * NLM Server procedures. |
| 522 | */ |
| 523 | |
| 524 | #define nlmsvc_encode_norep nlmsvc_encode_void |
| 525 | #define nlmsvc_decode_norep nlmsvc_decode_void |
| 526 | #define nlmsvc_decode_testres nlmsvc_decode_void |
| 527 | #define nlmsvc_decode_lockres nlmsvc_decode_void |
| 528 | #define nlmsvc_decode_unlockres nlmsvc_decode_void |
| 529 | #define nlmsvc_decode_cancelres nlmsvc_decode_void |
| 530 | #define nlmsvc_decode_grantedres nlmsvc_decode_void |
| 531 | |
| 532 | #define nlmsvc_proc_none nlmsvc_proc_null |
| 533 | #define nlmsvc_proc_test_res nlmsvc_proc_null |
| 534 | #define nlmsvc_proc_lock_res nlmsvc_proc_null |
| 535 | #define nlmsvc_proc_cancel_res nlmsvc_proc_null |
| 536 | #define nlmsvc_proc_unlock_res nlmsvc_proc_null |
| 537 | |
| 538 | struct nlm_void { int dummy; }; |
| 539 | |
| 540 | #define PROC(name, xargt, xrest, argt, rest, respsize) \ |
Christoph Hellwig | a6beb73 | 2017-05-08 17:35:49 +0200 | [diff] [blame] | 541 | { .pc_func = nlmsvc_proc_##name, \ |
Christoph Hellwig | 026fec7 | 2017-05-08 19:01:48 +0200 | [diff] [blame] | 542 | .pc_decode = nlmsvc_decode_##xargt, \ |
Christoph Hellwig | 63f8de3 | 2017-05-08 19:42:02 +0200 | [diff] [blame] | 543 | .pc_encode = nlmsvc_encode_##xrest, \ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 544 | .pc_release = NULL, \ |
| 545 | .pc_argsize = sizeof(struct nlm_##argt), \ |
| 546 | .pc_ressize = sizeof(struct nlm_##rest), \ |
| 547 | .pc_xdrressize = respsize, \ |
| 548 | } |
| 549 | |
| 550 | #define Ck (1+XDR_QUADLEN(NLM_MAXCOOKIELEN)) /* cookie */ |
| 551 | #define St 1 /* status */ |
| 552 | #define No (1+1024/4) /* Net Obj */ |
| 553 | #define Rg 2 /* range - offset + size */ |
| 554 | |
Christoph Hellwig | 860bda2 | 2017-05-12 16:11:49 +0200 | [diff] [blame] | 555 | const struct svc_procedure nlmsvc_procedures[] = { |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 556 | PROC(null, void, void, void, void, 1), |
| 557 | PROC(test, testargs, testres, args, res, Ck+St+2+No+Rg), |
| 558 | PROC(lock, lockargs, res, args, res, Ck+St), |
| 559 | PROC(cancel, cancargs, res, args, res, Ck+St), |
| 560 | PROC(unlock, unlockargs, res, args, res, Ck+St), |
| 561 | PROC(granted, testargs, res, args, res, Ck+St), |
| 562 | PROC(test_msg, testargs, norep, args, void, 1), |
| 563 | PROC(lock_msg, lockargs, norep, args, void, 1), |
| 564 | PROC(cancel_msg, cancargs, norep, args, void, 1), |
| 565 | PROC(unlock_msg, unlockargs, norep, args, void, 1), |
| 566 | PROC(granted_msg, testargs, norep, args, void, 1), |
| 567 | PROC(test_res, testres, norep, res, void, 1), |
| 568 | PROC(lock_res, lockres, norep, res, void, 1), |
| 569 | PROC(cancel_res, cancelres, norep, res, void, 1), |
| 570 | PROC(unlock_res, unlockres, norep, res, void, 1), |
| 571 | PROC(granted_res, res, norep, res, void, 1), |
| 572 | /* statd callback */ |
| 573 | PROC(sm_notify, reboot, void, reboot, void, 1), |
| 574 | PROC(none, void, void, void, void, 1), |
| 575 | PROC(none, void, void, void, void, 1), |
| 576 | PROC(none, void, void, void, void, 1), |
| 577 | PROC(share, shareargs, shareres, args, res, Ck+St+1), |
| 578 | PROC(unshare, shareargs, shareres, args, res, Ck+St+1), |
| 579 | PROC(nm_lock, lockargs, res, args, res, Ck+St), |
| 580 | PROC(free_all, notify, void, args, void, 0), |
| 581 | |
| 582 | }; |