1 /* AFS file locking support
3 * Copyright (C) 2007 Red Hat, Inc. All Rights Reserved.
4 * Written by David Howells (dhowells@redhat.com)
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License
8 * as published by the Free Software Foundation; either version
9 * 2 of the License, or (at your option) any later version.
12 #include <linux/smp_lock.h>
15 #define AFS_LOCK_GRANTED 0
16 #define AFS_LOCK_PENDING 1
18 static void afs_fl_copy_lock(struct file_lock
*new, struct file_lock
*fl
);
19 static void afs_fl_release_private(struct file_lock
*fl
);
21 static struct workqueue_struct
*afs_lock_manager
;
22 static DEFINE_MUTEX(afs_lock_manager_mutex
);
24 static struct file_lock_operations afs_lock_ops
= {
25 .fl_copy_lock
= afs_fl_copy_lock
,
26 .fl_release_private
= afs_fl_release_private
,
30 * initialise the lock manager thread if it isn't already running
32 static int afs_init_lock_manager(void)
37 if (!afs_lock_manager
) {
38 mutex_lock(&afs_lock_manager_mutex
);
39 if (!afs_lock_manager
) {
41 create_singlethread_workqueue("kafs_lockd");
42 if (!afs_lock_manager
)
45 mutex_unlock(&afs_lock_manager_mutex
);
51 * destroy the lock manager thread if it's running
53 void __exit
afs_kill_lock_manager(void)
56 destroy_workqueue(afs_lock_manager
);
60 * if the callback is broken on this vnode, then the lock may now be available
62 void afs_lock_may_be_available(struct afs_vnode
*vnode
)
64 _enter("{%x:%u}", vnode
->fid
.vid
, vnode
->fid
.vnode
);
66 queue_delayed_work(afs_lock_manager
, &vnode
->lock_work
, 0);
70 * the lock will time out in 5 minutes unless we extend it, so schedule
71 * extension in a bit less than that time
73 static void afs_schedule_lock_extension(struct afs_vnode
*vnode
)
75 queue_delayed_work(afs_lock_manager
, &vnode
->lock_work
,
76 AFS_LOCKWAIT
* HZ
/ 2);
80 * grant one or more locks (readlocks are allowed to jump the queue if the
81 * first lock in the queue is itself a readlock)
82 * - the caller must hold the vnode lock
84 static void afs_grant_locks(struct afs_vnode
*vnode
, struct file_lock
*fl
)
86 struct file_lock
*p
, *_p
;
88 list_move_tail(&fl
->fl_u
.afs
.link
, &vnode
->granted_locks
);
89 if (fl
->fl_type
== F_RDLCK
) {
90 list_for_each_entry_safe(p
, _p
, &vnode
->pending_locks
,
92 if (p
->fl_type
== F_RDLCK
) {
93 p
->fl_u
.afs
.state
= AFS_LOCK_GRANTED
;
94 list_move_tail(&p
->fl_u
.afs
.link
,
95 &vnode
->granted_locks
);
103 * do work for a lock, including:
104 * - probing for a lock we're waiting on but didn't get immediately
105 * - extending a lock that's close to timing out
107 void afs_lock_work(struct work_struct
*work
)
109 struct afs_vnode
*vnode
=
110 container_of(work
, struct afs_vnode
, lock_work
.work
);
111 struct file_lock
*fl
;
112 afs_lock_type_t type
;
116 _enter("{%x:%u}", vnode
->fid
.vid
, vnode
->fid
.vnode
);
118 spin_lock(&vnode
->lock
);
120 if (test_bit(AFS_VNODE_UNLOCKING
, &vnode
->flags
)) {
122 spin_unlock(&vnode
->lock
);
124 /* attempt to release the server lock; if it fails, we just
125 * wait 5 minutes and it'll time out anyway */
126 ret
= afs_vnode_release_lock(vnode
, vnode
->unlock_key
);
128 printk(KERN_WARNING
"AFS:"
129 " Failed to release lock on {%x:%x} error %d\n",
130 vnode
->fid
.vid
, vnode
->fid
.vnode
, ret
);
132 spin_lock(&vnode
->lock
);
133 key_put(vnode
->unlock_key
);
134 vnode
->unlock_key
= NULL
;
135 clear_bit(AFS_VNODE_UNLOCKING
, &vnode
->flags
);
138 /* if we've got a lock, then it must be time to extend that lock as AFS
139 * locks time out after 5 minutes */
140 if (!list_empty(&vnode
->granted_locks
)) {
143 if (test_and_set_bit(AFS_VNODE_LOCKING
, &vnode
->flags
))
145 fl
= list_entry(vnode
->granted_locks
.next
,
146 struct file_lock
, fl_u
.afs
.link
);
147 key
= key_get(fl
->fl_file
->private_data
);
148 spin_unlock(&vnode
->lock
);
150 ret
= afs_vnode_extend_lock(vnode
, key
);
151 clear_bit(AFS_VNODE_LOCKING
, &vnode
->flags
);
155 afs_schedule_lock_extension(vnode
);
158 /* ummm... we failed to extend the lock - retry
159 * extension shortly */
160 printk(KERN_WARNING
"AFS:"
161 " Failed to extend lock on {%x:%x} error %d\n",
162 vnode
->fid
.vid
, vnode
->fid
.vnode
, ret
);
163 queue_delayed_work(afs_lock_manager
, &vnode
->lock_work
,
171 /* if we don't have a granted lock, then we must've been called back by
172 * the server, and so if might be possible to get a lock we're
173 * currently waiting for */
174 if (!list_empty(&vnode
->pending_locks
)) {
177 if (test_and_set_bit(AFS_VNODE_LOCKING
, &vnode
->flags
))
179 fl
= list_entry(vnode
->pending_locks
.next
,
180 struct file_lock
, fl_u
.afs
.link
);
181 key
= key_get(fl
->fl_file
->private_data
);
182 type
= (fl
->fl_type
== F_RDLCK
) ?
183 AFS_LOCK_READ
: AFS_LOCK_WRITE
;
184 spin_unlock(&vnode
->lock
);
186 ret
= afs_vnode_set_lock(vnode
, key
, type
);
187 clear_bit(AFS_VNODE_LOCKING
, &vnode
->flags
);
194 if (type
== AFS_LOCK_READ
)
195 set_bit(AFS_VNODE_READLOCKED
, &vnode
->flags
);
197 set_bit(AFS_VNODE_WRITELOCKED
, &vnode
->flags
);
198 ret
= AFS_LOCK_GRANTED
;
200 spin_lock(&vnode
->lock
);
201 /* the pending lock may have been withdrawn due to a
203 if (list_entry(vnode
->pending_locks
.next
,
204 struct file_lock
, fl_u
.afs
.link
) == fl
) {
205 fl
->fl_u
.afs
.state
= ret
;
206 if (ret
== AFS_LOCK_GRANTED
)
207 afs_grant_locks(vnode
, fl
);
209 list_del_init(&fl
->fl_u
.afs
.link
);
210 wake_up(&fl
->fl_wait
);
211 spin_unlock(&vnode
->lock
);
214 clear_bit(AFS_VNODE_READLOCKED
, &vnode
->flags
);
215 clear_bit(AFS_VNODE_WRITELOCKED
, &vnode
->flags
);
216 spin_unlock(&vnode
->lock
);
217 afs_vnode_release_lock(vnode
, key
);
218 if (!list_empty(&vnode
->pending_locks
))
219 afs_lock_may_be_available(vnode
);
228 /* looks like the lock request was withdrawn on a signal */
229 spin_unlock(&vnode
->lock
);
230 _leave(" [no locks]");
234 * pass responsibility for the unlocking of a vnode on the server to the
235 * manager thread, lest a pending signal in the calling thread interrupt
237 * - the caller must hold the vnode lock
239 static void afs_defer_unlock(struct afs_vnode
*vnode
, struct key
*key
)
241 cancel_delayed_work(&vnode
->lock_work
);
242 if (!test_and_clear_bit(AFS_VNODE_READLOCKED
, &vnode
->flags
) &&
243 !test_and_clear_bit(AFS_VNODE_WRITELOCKED
, &vnode
->flags
))
245 if (test_and_set_bit(AFS_VNODE_UNLOCKING
, &vnode
->flags
))
247 vnode
->unlock_key
= key_get(key
);
248 afs_lock_may_be_available(vnode
);
252 * request a lock on a file on the server
254 static int afs_do_setlk(struct file
*file
, struct file_lock
*fl
)
256 struct afs_vnode
*vnode
= AFS_FS_I(file
->f_mapping
->host
);
257 afs_lock_type_t type
;
258 struct key
*key
= file
->private_data
;
261 _enter("{%x:%u},%u", vnode
->fid
.vid
, vnode
->fid
.vnode
, fl
->fl_type
);
263 /* only whole-file locks are supported */
264 if (fl
->fl_start
!= 0 || fl
->fl_end
!= OFFSET_MAX
)
267 ret
= afs_init_lock_manager();
271 fl
->fl_ops
= &afs_lock_ops
;
272 INIT_LIST_HEAD(&fl
->fl_u
.afs
.link
);
273 fl
->fl_u
.afs
.state
= AFS_LOCK_PENDING
;
275 type
= (fl
->fl_type
== F_RDLCK
) ? AFS_LOCK_READ
: AFS_LOCK_WRITE
;
279 /* make sure we've got a callback on this file and that our view of the
280 * data version is up to date */
281 ret
= afs_vnode_fetch_status(vnode
, NULL
, key
);
285 if (vnode
->status
.lock_count
!= 0 && !(fl
->fl_flags
& FL_SLEEP
)) {
290 spin_lock(&vnode
->lock
);
292 /* if we've already got a readlock on the server then we can instantly
293 * grant another readlock, irrespective of whether there are any
294 * pending writelocks */
295 if (type
== AFS_LOCK_READ
&&
296 vnode
->flags
& (1 << AFS_VNODE_READLOCKED
)) {
297 _debug("instant readlock");
298 ASSERTCMP(vnode
->flags
&
299 ((1 << AFS_VNODE_LOCKING
) |
300 (1 << AFS_VNODE_WRITELOCKED
)), ==, 0);
301 ASSERT(!list_empty(&vnode
->granted_locks
));
302 goto sharing_existing_lock
;
305 /* if there's no-one else with a lock on this vnode, then we need to
306 * ask the server for a lock */
307 if (list_empty(&vnode
->pending_locks
) &&
308 list_empty(&vnode
->granted_locks
)) {
309 _debug("not locked");
310 ASSERTCMP(vnode
->flags
&
311 ((1 << AFS_VNODE_LOCKING
) |
312 (1 << AFS_VNODE_READLOCKED
) |
313 (1 << AFS_VNODE_WRITELOCKED
)), ==, 0);
314 list_add_tail(&fl
->fl_u
.afs
.link
, &vnode
->pending_locks
);
315 set_bit(AFS_VNODE_LOCKING
, &vnode
->flags
);
316 spin_unlock(&vnode
->lock
);
318 ret
= afs_vnode_set_lock(vnode
, key
, type
);
319 clear_bit(AFS_VNODE_LOCKING
, &vnode
->flags
);
323 goto acquired_server_lock
;
325 _debug("would block");
326 spin_lock(&vnode
->lock
);
327 ASSERT(list_empty(&vnode
->granted_locks
));
328 ASSERTCMP(vnode
->pending_locks
.next
, ==,
332 spin_lock(&vnode
->lock
);
333 list_del_init(&fl
->fl_u
.afs
.link
);
334 spin_unlock(&vnode
->lock
);
339 /* otherwise, we need to wait for a local lock to become available */
340 _debug("wait local");
341 list_add_tail(&fl
->fl_u
.afs
.link
, &vnode
->pending_locks
);
343 if (!(fl
->fl_flags
& FL_SLEEP
)) {
348 spin_unlock(&vnode
->lock
);
350 /* now we need to sleep and wait for the lock manager thread to get the
351 * lock from the server */
353 ret
= wait_event_interruptible(fl
->fl_wait
,
354 fl
->fl_u
.afs
.state
<= AFS_LOCK_GRANTED
);
355 if (fl
->fl_u
.afs
.state
<= AFS_LOCK_GRANTED
) {
356 ret
= fl
->fl_u
.afs
.state
;
359 spin_lock(&vnode
->lock
);
363 /* we were interrupted, but someone may still be in the throes of
364 * giving us the lock */
366 ASSERTCMP(ret
, ==, -ERESTARTSYS
);
368 spin_lock(&vnode
->lock
);
369 if (fl
->fl_u
.afs
.state
<= AFS_LOCK_GRANTED
) {
370 ret
= fl
->fl_u
.afs
.state
;
372 spin_unlock(&vnode
->lock
);
379 /* we aren't going to get the lock, either because we're unwilling to
380 * wait, or because some signal happened */
382 if (list_empty(&vnode
->granted_locks
) &&
383 vnode
->pending_locks
.next
== &fl
->fl_u
.afs
.link
) {
384 if (vnode
->pending_locks
.prev
!= &fl
->fl_u
.afs
.link
) {
385 /* kick the next pending lock into having a go */
386 list_del_init(&fl
->fl_u
.afs
.link
);
387 afs_lock_may_be_available(vnode
);
390 list_del_init(&fl
->fl_u
.afs
.link
);
392 spin_unlock(&vnode
->lock
);
395 acquired_server_lock
:
396 /* we've acquired a server lock, but it needs to be renewed after 5
398 spin_lock(&vnode
->lock
);
399 afs_schedule_lock_extension(vnode
);
400 if (type
== AFS_LOCK_READ
)
401 set_bit(AFS_VNODE_READLOCKED
, &vnode
->flags
);
403 set_bit(AFS_VNODE_WRITELOCKED
, &vnode
->flags
);
404 sharing_existing_lock
:
405 /* the lock has been granted as far as we're concerned... */
406 fl
->fl_u
.afs
.state
= AFS_LOCK_GRANTED
;
407 list_move_tail(&fl
->fl_u
.afs
.link
, &vnode
->granted_locks
);
409 /* ... but we do still need to get the VFS's blessing */
410 ASSERT(!(vnode
->flags
& (1 << AFS_VNODE_LOCKING
)));
411 ASSERT((vnode
->flags
& ((1 << AFS_VNODE_READLOCKED
) |
412 (1 << AFS_VNODE_WRITELOCKED
))) != 0);
413 ret
= posix_lock_file(file
, fl
, NULL
);
415 goto vfs_rejected_lock
;
416 spin_unlock(&vnode
->lock
);
418 /* again, make sure we've got a callback on this file and, again, make
419 * sure that our view of the data version is up to date (we ignore
420 * errors incurred here and deal with the consequences elsewhere) */
421 afs_vnode_fetch_status(vnode
, NULL
, key
);
425 _leave(" = %d", ret
);
429 /* the VFS rejected the lock we just obtained, so we have to discard
430 * what we just got */
431 _debug("vfs refused %d", ret
);
432 list_del_init(&fl
->fl_u
.afs
.link
);
433 if (list_empty(&vnode
->granted_locks
))
434 afs_defer_unlock(vnode
, key
);
435 spin_unlock(&vnode
->lock
);
440 * unlock on a file on the server
442 static int afs_do_unlk(struct file
*file
, struct file_lock
*fl
)
444 struct afs_vnode
*vnode
= AFS_FS_I(file
->f_mapping
->host
);
445 struct key
*key
= file
->private_data
;
448 _enter("{%x:%u},%u", vnode
->fid
.vid
, vnode
->fid
.vnode
, fl
->fl_type
);
450 /* only whole-file unlocks are supported */
451 if (fl
->fl_start
!= 0 || fl
->fl_end
!= OFFSET_MAX
)
454 fl
->fl_ops
= &afs_lock_ops
;
455 INIT_LIST_HEAD(&fl
->fl_u
.afs
.link
);
456 fl
->fl_u
.afs
.state
= AFS_LOCK_PENDING
;
458 spin_lock(&vnode
->lock
);
459 ret
= posix_lock_file(file
, fl
, NULL
);
461 spin_unlock(&vnode
->lock
);
462 _leave(" = %d [vfs]", ret
);
466 /* discard the server lock only if all granted locks are gone */
467 if (list_empty(&vnode
->granted_locks
))
468 afs_defer_unlock(vnode
, key
);
469 spin_unlock(&vnode
->lock
);
475 * return information about a lock we currently hold, if indeed we hold one
477 static int afs_do_getlk(struct file
*file
, struct file_lock
*fl
)
479 struct afs_vnode
*vnode
= AFS_FS_I(file
->f_mapping
->host
);
480 struct key
*key
= file
->private_data
;
485 fl
->fl_type
= F_UNLCK
;
487 mutex_lock(&vnode
->vfs_inode
.i_mutex
);
489 /* check local lock records first */
491 posix_test_lock(file
, fl
);
492 if (fl
->fl_type
== F_UNLCK
) {
493 /* no local locks; consult the server */
494 ret
= afs_vnode_fetch_status(vnode
, NULL
, key
);
497 lock_count
= vnode
->status
.lock_count
;
500 fl
->fl_type
= F_RDLCK
;
502 fl
->fl_type
= F_WRLCK
;
504 fl
->fl_end
= OFFSET_MAX
;
509 mutex_unlock(&vnode
->vfs_inode
.i_mutex
);
510 _leave(" = %d [%hd]", ret
, fl
->fl_type
);
515 * manage POSIX locks on a file
517 int afs_lock(struct file
*file
, int cmd
, struct file_lock
*fl
)
519 struct afs_vnode
*vnode
= AFS_FS_I(file
->f_dentry
->d_inode
);
521 _enter("{%x:%u},%d,{t=%x,fl=%x,r=%Ld:%Ld}",
522 vnode
->fid
.vid
, vnode
->fid
.vnode
, cmd
,
523 fl
->fl_type
, fl
->fl_flags
,
524 (long long) fl
->fl_start
, (long long) fl
->fl_end
);
526 /* AFS doesn't support mandatory locks */
527 if ((vnode
->vfs_inode
.i_mode
& (S_ISGID
| S_IXGRP
)) == S_ISGID
&&
528 fl
->fl_type
!= F_UNLCK
)
532 return afs_do_getlk(file
, fl
);
533 if (fl
->fl_type
== F_UNLCK
)
534 return afs_do_unlk(file
, fl
);
535 return afs_do_setlk(file
, fl
);
539 * manage FLOCK locks on a file
541 int afs_flock(struct file
*file
, int cmd
, struct file_lock
*fl
)
543 struct afs_vnode
*vnode
= AFS_FS_I(file
->f_dentry
->d_inode
);
545 _enter("{%x:%u},%d,{t=%x,fl=%x}",
546 vnode
->fid
.vid
, vnode
->fid
.vnode
, cmd
,
547 fl
->fl_type
, fl
->fl_flags
);
550 * No BSD flocks over NFS allowed.
551 * Note: we could try to fake a POSIX lock request here by
552 * using ((u32) filp | 0x80000000) or some such as the pid.
553 * Not sure whether that would be unique, though, or whether
554 * that would break in other places.
556 if (!(fl
->fl_flags
& FL_FLOCK
))
559 /* we're simulating flock() locks using posix locks on the server */
560 fl
->fl_owner
= (fl_owner_t
) file
;
562 fl
->fl_end
= OFFSET_MAX
;
564 if (fl
->fl_type
== F_UNLCK
)
565 return afs_do_unlk(file
, fl
);
566 return afs_do_setlk(file
, fl
);
570 * the POSIX lock management core VFS code copies the lock record and adds the
571 * copy into its own list, so we need to add that copy to the vnode's lock
572 * queue in the same place as the original (which will be deleted shortly
575 static void afs_fl_copy_lock(struct file_lock
*new, struct file_lock
*fl
)
579 list_add(&new->fl_u
.afs
.link
, &fl
->fl_u
.afs
.link
);
583 * need to remove this lock from the vnode queue when it's removed from the
586 static void afs_fl_release_private(struct file_lock
*fl
)
590 list_del_init(&fl
->fl_u
.afs
.link
);