1 // SPDX-License-Identifier: GPL-2.0-only
5 * We implement four types of file locks: BSD locks, posix locks, open
6 * file description locks, and leases. For details about BSD locks,
7 * see the flock(2) man page; for details about the other three, see
11 * Locking conflicts and dependencies:
12 * If multiple threads attempt to lock the same byte (or flock the same file)
13 * only one can be granted the lock, and other must wait their turn.
14 * The first lock has been "applied" or "granted", the others are "waiting"
15 * and are "blocked" by the "applied" lock..
17 * Waiting and applied locks are all kept in trees whose properties are:
19 * - the root of a tree may be an applied or waiting lock.
20 * - every other node in the tree is a waiting lock that
21 * conflicts with every ancestor of that node.
23 * Every such tree begins life as a waiting singleton which obviously
24 * satisfies the above properties.
26 * The only ways we modify trees preserve these properties:
28 * 1. We may add a new leaf node, but only after first verifying that it
29 * conflicts with all of its ancestors.
30 * 2. We may remove the root of a tree, creating a new singleton
31 * tree from the root and N new trees rooted in the immediate
33 * 3. If the root of a tree is not currently an applied lock, we may
34 * apply it (if possible).
35 * 4. We may upgrade the root of the tree (either extend its range,
36 * or upgrade its entire range from read to write).
38 * When an applied lock is modified in a way that reduces or downgrades any
39 * part of its range, we remove all its children (2 above). This particularly
40 * happens when a lock is unlocked.
42 * For each of those child trees we "wake up" the thread which is
43 * waiting for the lock so it can continue handling as follows: if the
44 * root of the tree applies, we do so (3). If it doesn't, it must
45 * conflict with some applied lock. We remove (wake up) all of its children
46 * (2), and add it is a new leaf to the tree rooted in the applied
47 * lock (1). We then repeat the process recursively with those
51 #include <linux/capability.h>
52 #include <linux/file.h>
53 #include <linux/fdtable.h>
54 #include <linux/filelock.h>
56 #include <linux/init.h>
57 #include <linux/security.h>
58 #include <linux/slab.h>
59 #include <linux/syscalls.h>
60 #include <linux/time.h>
61 #include <linux/rcupdate.h>
62 #include <linux/pid_namespace.h>
63 #include <linux/hashtable.h>
64 #include <linux/percpu.h>
65 #include <linux/sysctl.h>
67 #define CREATE_TRACE_POINTS
68 #include <trace/events/filelock.h>
70 #include <linux/uaccess.h>
72 static struct file_lock
*file_lock(struct file_lock_core
*flc
)
74 return container_of(flc
, struct file_lock
, c
);
77 static struct file_lease
*file_lease(struct file_lock_core
*flc
)
79 return container_of(flc
, struct file_lease
, c
);
82 static bool lease_breaking(struct file_lease
*fl
)
84 return fl
->c
.flc_flags
& (FL_UNLOCK_PENDING
| FL_DOWNGRADE_PENDING
);
87 static int target_leasetype(struct file_lease
*fl
)
89 if (fl
->c
.flc_flags
& FL_UNLOCK_PENDING
)
91 if (fl
->c
.flc_flags
& FL_DOWNGRADE_PENDING
)
93 return fl
->c
.flc_type
;
96 static int leases_enable
= 1;
97 static int lease_break_time
= 45;
100 static struct ctl_table locks_sysctls
[] = {
102 .procname
= "leases-enable",
103 .data
= &leases_enable
,
104 .maxlen
= sizeof(int),
106 .proc_handler
= proc_dointvec
,
110 .procname
= "lease-break-time",
111 .data
= &lease_break_time
,
112 .maxlen
= sizeof(int),
114 .proc_handler
= proc_dointvec
,
116 #endif /* CONFIG_MMU */
119 static int __init
init_fs_locks_sysctls(void)
121 register_sysctl_init("fs", locks_sysctls
);
124 early_initcall(init_fs_locks_sysctls
);
125 #endif /* CONFIG_SYSCTL */
128 * The global file_lock_list is only used for displaying /proc/locks, so we
129 * keep a list on each CPU, with each list protected by its own spinlock.
130 * Global serialization is done using file_rwsem.
132 * Note that alterations to the list also require that the relevant flc_lock is
135 struct file_lock_list_struct
{
137 struct hlist_head hlist
;
139 static DEFINE_PER_CPU(struct file_lock_list_struct
, file_lock_list
);
140 DEFINE_STATIC_PERCPU_RWSEM(file_rwsem
);
144 * The blocked_hash is used to find POSIX lock loops for deadlock detection.
145 * It is protected by blocked_lock_lock.
147 * We hash locks by lockowner in order to optimize searching for the lock a
148 * particular lockowner is waiting on.
150 * FIXME: make this value scale via some heuristic? We generally will want more
151 * buckets when we have more lockowners holding locks, but that's a little
152 * difficult to determine without knowing what the workload will look like.
154 #define BLOCKED_HASH_BITS 7
155 static DEFINE_HASHTABLE(blocked_hash
, BLOCKED_HASH_BITS
);
158 * This lock protects the blocked_hash. Generally, if you're accessing it, you
159 * want to be holding this lock.
161 * In addition, it also protects the fl->fl_blocked_requests list, and the
162 * fl->fl_blocker pointer for file_lock structures that are acting as lock
163 * requests (in contrast to those that are acting as records of acquired locks).
165 * Note that when we acquire this lock in order to change the above fields,
166 * we often hold the flc_lock as well. In certain cases, when reading the fields
167 * protected by this lock, we can skip acquiring it iff we already hold the
170 static DEFINE_SPINLOCK(blocked_lock_lock
);
172 static struct kmem_cache
*flctx_cache __ro_after_init
;
173 static struct kmem_cache
*filelock_cache __ro_after_init
;
174 static struct kmem_cache
*filelease_cache __ro_after_init
;
176 static struct file_lock_context
*
177 locks_get_lock_context(struct inode
*inode
, int type
)
179 struct file_lock_context
*ctx
;
181 /* paired with cmpxchg() below */
182 ctx
= locks_inode_context(inode
);
183 if (likely(ctx
) || type
== F_UNLCK
)
186 ctx
= kmem_cache_alloc(flctx_cache
, GFP_KERNEL
);
190 spin_lock_init(&ctx
->flc_lock
);
191 INIT_LIST_HEAD(&ctx
->flc_flock
);
192 INIT_LIST_HEAD(&ctx
->flc_posix
);
193 INIT_LIST_HEAD(&ctx
->flc_lease
);
196 * Assign the pointer if it's not already assigned. If it is, then
197 * free the context we just allocated.
199 if (cmpxchg(&inode
->i_flctx
, NULL
, ctx
)) {
200 kmem_cache_free(flctx_cache
, ctx
);
201 ctx
= locks_inode_context(inode
);
204 trace_locks_get_lock_context(inode
, type
, ctx
);
209 locks_dump_ctx_list(struct list_head
*list
, char *list_type
)
211 struct file_lock_core
*flc
;
213 list_for_each_entry(flc
, list
, flc_list
)
214 pr_warn("%s: fl_owner=%p fl_flags=0x%x fl_type=0x%x fl_pid=%u\n",
215 list_type
, flc
->flc_owner
, flc
->flc_flags
,
216 flc
->flc_type
, flc
->flc_pid
);
220 locks_check_ctx_lists(struct inode
*inode
)
222 struct file_lock_context
*ctx
= inode
->i_flctx
;
224 if (unlikely(!list_empty(&ctx
->flc_flock
) ||
225 !list_empty(&ctx
->flc_posix
) ||
226 !list_empty(&ctx
->flc_lease
))) {
227 pr_warn("Leaked locks on dev=0x%x:0x%x ino=0x%lx:\n",
228 MAJOR(inode
->i_sb
->s_dev
), MINOR(inode
->i_sb
->s_dev
),
230 locks_dump_ctx_list(&ctx
->flc_flock
, "FLOCK");
231 locks_dump_ctx_list(&ctx
->flc_posix
, "POSIX");
232 locks_dump_ctx_list(&ctx
->flc_lease
, "LEASE");
237 locks_check_ctx_file_list(struct file
*filp
, struct list_head
*list
, char *list_type
)
239 struct file_lock_core
*flc
;
240 struct inode
*inode
= file_inode(filp
);
242 list_for_each_entry(flc
, list
, flc_list
)
243 if (flc
->flc_file
== filp
)
244 pr_warn("Leaked %s lock on dev=0x%x:0x%x ino=0x%lx "
245 " fl_owner=%p fl_flags=0x%x fl_type=0x%x fl_pid=%u\n",
246 list_type
, MAJOR(inode
->i_sb
->s_dev
),
247 MINOR(inode
->i_sb
->s_dev
), inode
->i_ino
,
248 flc
->flc_owner
, flc
->flc_flags
,
249 flc
->flc_type
, flc
->flc_pid
);
253 locks_free_lock_context(struct inode
*inode
)
255 struct file_lock_context
*ctx
= locks_inode_context(inode
);
258 locks_check_ctx_lists(inode
);
259 kmem_cache_free(flctx_cache
, ctx
);
263 static void locks_init_lock_heads(struct file_lock_core
*flc
)
265 INIT_HLIST_NODE(&flc
->flc_link
);
266 INIT_LIST_HEAD(&flc
->flc_list
);
267 INIT_LIST_HEAD(&flc
->flc_blocked_requests
);
268 INIT_LIST_HEAD(&flc
->flc_blocked_member
);
269 init_waitqueue_head(&flc
->flc_wait
);
272 /* Allocate an empty lock structure. */
273 struct file_lock
*locks_alloc_lock(void)
275 struct file_lock
*fl
= kmem_cache_zalloc(filelock_cache
, GFP_KERNEL
);
278 locks_init_lock_heads(&fl
->c
);
282 EXPORT_SYMBOL_GPL(locks_alloc_lock
);
284 /* Allocate an empty lock structure. */
285 struct file_lease
*locks_alloc_lease(void)
287 struct file_lease
*fl
= kmem_cache_zalloc(filelease_cache
, GFP_KERNEL
);
290 locks_init_lock_heads(&fl
->c
);
294 EXPORT_SYMBOL_GPL(locks_alloc_lease
);
296 void locks_release_private(struct file_lock
*fl
)
298 struct file_lock_core
*flc
= &fl
->c
;
300 BUG_ON(waitqueue_active(&flc
->flc_wait
));
301 BUG_ON(!list_empty(&flc
->flc_list
));
302 BUG_ON(!list_empty(&flc
->flc_blocked_requests
));
303 BUG_ON(!list_empty(&flc
->flc_blocked_member
));
304 BUG_ON(!hlist_unhashed(&flc
->flc_link
));
307 if (fl
->fl_ops
->fl_release_private
)
308 fl
->fl_ops
->fl_release_private(fl
);
313 if (fl
->fl_lmops
->lm_put_owner
) {
314 fl
->fl_lmops
->lm_put_owner(flc
->flc_owner
);
315 flc
->flc_owner
= NULL
;
320 EXPORT_SYMBOL_GPL(locks_release_private
);
323 * locks_owner_has_blockers - Check for blocking lock requests
324 * @flctx: file lock context
328 * %true: @owner has at least one blocker
329 * %false: @owner has no blockers
331 bool locks_owner_has_blockers(struct file_lock_context
*flctx
, fl_owner_t owner
)
333 struct file_lock_core
*flc
;
335 spin_lock(&flctx
->flc_lock
);
336 list_for_each_entry(flc
, &flctx
->flc_posix
, flc_list
) {
337 if (flc
->flc_owner
!= owner
)
339 if (!list_empty(&flc
->flc_blocked_requests
)) {
340 spin_unlock(&flctx
->flc_lock
);
344 spin_unlock(&flctx
->flc_lock
);
347 EXPORT_SYMBOL_GPL(locks_owner_has_blockers
);
349 /* Free a lock which is not in use. */
350 void locks_free_lock(struct file_lock
*fl
)
352 locks_release_private(fl
);
353 kmem_cache_free(filelock_cache
, fl
);
355 EXPORT_SYMBOL(locks_free_lock
);
357 /* Free a lease which is not in use. */
358 void locks_free_lease(struct file_lease
*fl
)
360 kmem_cache_free(filelease_cache
, fl
);
362 EXPORT_SYMBOL(locks_free_lease
);
365 locks_dispose_list(struct list_head
*dispose
)
367 struct file_lock_core
*flc
;
369 while (!list_empty(dispose
)) {
370 flc
= list_first_entry(dispose
, struct file_lock_core
, flc_list
);
371 list_del_init(&flc
->flc_list
);
372 if (flc
->flc_flags
& (FL_LEASE
|FL_DELEG
|FL_LAYOUT
))
373 locks_free_lease(file_lease(flc
));
375 locks_free_lock(file_lock(flc
));
379 void locks_init_lock(struct file_lock
*fl
)
381 memset(fl
, 0, sizeof(struct file_lock
));
382 locks_init_lock_heads(&fl
->c
);
384 EXPORT_SYMBOL(locks_init_lock
);
386 void locks_init_lease(struct file_lease
*fl
)
388 memset(fl
, 0, sizeof(*fl
));
389 locks_init_lock_heads(&fl
->c
);
391 EXPORT_SYMBOL(locks_init_lease
);
394 * Initialize a new lock from an existing file_lock structure.
396 void locks_copy_conflock(struct file_lock
*new, struct file_lock
*fl
)
398 new->c
.flc_owner
= fl
->c
.flc_owner
;
399 new->c
.flc_pid
= fl
->c
.flc_pid
;
400 new->c
.flc_file
= NULL
;
401 new->c
.flc_flags
= fl
->c
.flc_flags
;
402 new->c
.flc_type
= fl
->c
.flc_type
;
403 new->fl_start
= fl
->fl_start
;
404 new->fl_end
= fl
->fl_end
;
405 new->fl_lmops
= fl
->fl_lmops
;
409 if (fl
->fl_lmops
->lm_get_owner
)
410 fl
->fl_lmops
->lm_get_owner(fl
->c
.flc_owner
);
413 EXPORT_SYMBOL(locks_copy_conflock
);
415 void locks_copy_lock(struct file_lock
*new, struct file_lock
*fl
)
417 /* "new" must be a freshly-initialized lock */
418 WARN_ON_ONCE(new->fl_ops
);
420 locks_copy_conflock(new, fl
);
422 new->c
.flc_file
= fl
->c
.flc_file
;
423 new->fl_ops
= fl
->fl_ops
;
426 if (fl
->fl_ops
->fl_copy_lock
)
427 fl
->fl_ops
->fl_copy_lock(new, fl
);
430 EXPORT_SYMBOL(locks_copy_lock
);
432 static void locks_move_blocks(struct file_lock
*new, struct file_lock
*fl
)
437 * As ctx->flc_lock is held, new requests cannot be added to
438 * ->flc_blocked_requests, so we don't need a lock to check if it
441 if (list_empty(&fl
->c
.flc_blocked_requests
))
443 spin_lock(&blocked_lock_lock
);
444 list_splice_init(&fl
->c
.flc_blocked_requests
,
445 &new->c
.flc_blocked_requests
);
446 list_for_each_entry(f
, &new->c
.flc_blocked_requests
,
447 c
.flc_blocked_member
)
448 f
->c
.flc_blocker
= &new->c
;
449 spin_unlock(&blocked_lock_lock
);
452 static inline int flock_translate_cmd(int cmd
) {
464 /* Fill in a file_lock structure with an appropriate FLOCK lock. */
465 static void flock_make_lock(struct file
*filp
, struct file_lock
*fl
, int type
)
469 fl
->c
.flc_file
= filp
;
470 fl
->c
.flc_owner
= filp
;
471 fl
->c
.flc_pid
= current
->tgid
;
472 fl
->c
.flc_flags
= FL_FLOCK
;
473 fl
->c
.flc_type
= type
;
474 fl
->fl_end
= OFFSET_MAX
;
477 static int assign_type(struct file_lock_core
*flc
, int type
)
483 flc
->flc_type
= type
;
491 static int flock64_to_posix_lock(struct file
*filp
, struct file_lock
*fl
,
494 switch (l
->l_whence
) {
499 fl
->fl_start
= filp
->f_pos
;
502 fl
->fl_start
= i_size_read(file_inode(filp
));
507 if (l
->l_start
> OFFSET_MAX
- fl
->fl_start
)
509 fl
->fl_start
+= l
->l_start
;
510 if (fl
->fl_start
< 0)
513 /* POSIX-1996 leaves the case l->l_len < 0 undefined;
514 POSIX-2001 defines it. */
516 if (l
->l_len
- 1 > OFFSET_MAX
- fl
->fl_start
)
518 fl
->fl_end
= fl
->fl_start
+ (l
->l_len
- 1);
520 } else if (l
->l_len
< 0) {
521 if (fl
->fl_start
+ l
->l_len
< 0)
523 fl
->fl_end
= fl
->fl_start
- 1;
524 fl
->fl_start
+= l
->l_len
;
526 fl
->fl_end
= OFFSET_MAX
;
528 fl
->c
.flc_owner
= current
->files
;
529 fl
->c
.flc_pid
= current
->tgid
;
530 fl
->c
.flc_file
= filp
;
531 fl
->c
.flc_flags
= FL_POSIX
;
535 return assign_type(&fl
->c
, l
->l_type
);
538 /* Verify a "struct flock" and copy it to a "struct file_lock" as a POSIX
541 static int flock_to_posix_lock(struct file
*filp
, struct file_lock
*fl
,
544 struct flock64 ll
= {
546 .l_whence
= l
->l_whence
,
547 .l_start
= l
->l_start
,
551 return flock64_to_posix_lock(filp
, fl
, &ll
);
554 /* default lease lock manager operations */
556 lease_break_callback(struct file_lease
*fl
)
558 kill_fasync(&fl
->fl_fasync
, SIGIO
, POLL_MSG
);
563 lease_setup(struct file_lease
*fl
, void **priv
)
565 struct file
*filp
= fl
->c
.flc_file
;
566 struct fasync_struct
*fa
= *priv
;
569 * fasync_insert_entry() returns the old entry if any. If there was no
570 * old entry, then it used "priv" and inserted it into the fasync list.
571 * Clear the pointer to indicate that it shouldn't be freed.
573 if (!fasync_insert_entry(fa
->fa_fd
, filp
, &fl
->fl_fasync
, fa
))
576 __f_setown(filp
, task_pid(current
), PIDTYPE_TGID
, 0);
579 static const struct lease_manager_operations lease_manager_ops
= {
580 .lm_break
= lease_break_callback
,
581 .lm_change
= lease_modify
,
582 .lm_setup
= lease_setup
,
586 * Initialize a lease, use the default lock manager operations
588 static int lease_init(struct file
*filp
, int type
, struct file_lease
*fl
)
590 if (assign_type(&fl
->c
, type
) != 0)
593 fl
->c
.flc_owner
= filp
;
594 fl
->c
.flc_pid
= current
->tgid
;
596 fl
->c
.flc_file
= filp
;
597 fl
->c
.flc_flags
= FL_LEASE
;
598 fl
->fl_lmops
= &lease_manager_ops
;
602 /* Allocate a file_lock initialised to this type of lease */
603 static struct file_lease
*lease_alloc(struct file
*filp
, int type
)
605 struct file_lease
*fl
= locks_alloc_lease();
609 return ERR_PTR(error
);
611 error
= lease_init(filp
, type
, fl
);
613 locks_free_lease(fl
);
614 return ERR_PTR(error
);
619 /* Check if two locks overlap each other.
621 static inline int locks_overlap(struct file_lock
*fl1
, struct file_lock
*fl2
)
623 return ((fl1
->fl_end
>= fl2
->fl_start
) &&
624 (fl2
->fl_end
>= fl1
->fl_start
));
628 * Check whether two locks have the same owner.
630 static int posix_same_owner(struct file_lock_core
*fl1
, struct file_lock_core
*fl2
)
632 return fl1
->flc_owner
== fl2
->flc_owner
;
635 /* Must be called with the flc_lock held! */
636 static void locks_insert_global_locks(struct file_lock_core
*flc
)
638 struct file_lock_list_struct
*fll
= this_cpu_ptr(&file_lock_list
);
640 percpu_rwsem_assert_held(&file_rwsem
);
642 spin_lock(&fll
->lock
);
643 flc
->flc_link_cpu
= smp_processor_id();
644 hlist_add_head(&flc
->flc_link
, &fll
->hlist
);
645 spin_unlock(&fll
->lock
);
648 /* Must be called with the flc_lock held! */
649 static void locks_delete_global_locks(struct file_lock_core
*flc
)
651 struct file_lock_list_struct
*fll
;
653 percpu_rwsem_assert_held(&file_rwsem
);
656 * Avoid taking lock if already unhashed. This is safe since this check
657 * is done while holding the flc_lock, and new insertions into the list
658 * also require that it be held.
660 if (hlist_unhashed(&flc
->flc_link
))
663 fll
= per_cpu_ptr(&file_lock_list
, flc
->flc_link_cpu
);
664 spin_lock(&fll
->lock
);
665 hlist_del_init(&flc
->flc_link
);
666 spin_unlock(&fll
->lock
);
670 posix_owner_key(struct file_lock_core
*flc
)
672 return (unsigned long) flc
->flc_owner
;
675 static void locks_insert_global_blocked(struct file_lock_core
*waiter
)
677 lockdep_assert_held(&blocked_lock_lock
);
679 hash_add(blocked_hash
, &waiter
->flc_link
, posix_owner_key(waiter
));
682 static void locks_delete_global_blocked(struct file_lock_core
*waiter
)
684 lockdep_assert_held(&blocked_lock_lock
);
686 hash_del(&waiter
->flc_link
);
689 /* Remove waiter from blocker's block list.
690 * When blocker ends up pointing to itself then the list is empty.
692 * Must be called with blocked_lock_lock held.
694 static void __locks_unlink_block(struct file_lock_core
*waiter
)
696 locks_delete_global_blocked(waiter
);
697 list_del_init(&waiter
->flc_blocked_member
);
700 static void __locks_wake_up_blocks(struct file_lock_core
*blocker
)
702 while (!list_empty(&blocker
->flc_blocked_requests
)) {
703 struct file_lock_core
*waiter
;
704 struct file_lock
*fl
;
706 waiter
= list_first_entry(&blocker
->flc_blocked_requests
,
707 struct file_lock_core
, flc_blocked_member
);
709 fl
= file_lock(waiter
);
710 __locks_unlink_block(waiter
);
711 if ((waiter
->flc_flags
& (FL_POSIX
| FL_FLOCK
)) &&
712 fl
->fl_lmops
&& fl
->fl_lmops
->lm_notify
)
713 fl
->fl_lmops
->lm_notify(fl
);
718 * The setting of flc_blocker to NULL marks the "done"
719 * point in deleting a block. Paired with acquire at the top
720 * of locks_delete_block().
722 smp_store_release(&waiter
->flc_blocker
, NULL
);
726 static int __locks_delete_block(struct file_lock_core
*waiter
)
728 int status
= -ENOENT
;
731 * If fl_blocker is NULL, it won't be set again as this thread "owns"
732 * the lock and is the only one that might try to claim the lock.
734 * We use acquire/release to manage fl_blocker so that we can
735 * optimize away taking the blocked_lock_lock in many cases.
737 * The smp_load_acquire guarantees two things:
739 * 1/ that fl_blocked_requests can be tested locklessly. If something
740 * was recently added to that list it must have been in a locked region
741 * *before* the locked region when fl_blocker was set to NULL.
743 * 2/ that no other thread is accessing 'waiter', so it is safe to free
744 * it. __locks_wake_up_blocks is careful not to touch waiter after
745 * fl_blocker is released.
747 * If a lockless check of fl_blocker shows it to be NULL, we know that
748 * no new locks can be inserted into its fl_blocked_requests list, and
749 * can avoid doing anything further if the list is empty.
751 if (!smp_load_acquire(&waiter
->flc_blocker
) &&
752 list_empty(&waiter
->flc_blocked_requests
))
755 spin_lock(&blocked_lock_lock
);
756 if (waiter
->flc_blocker
)
758 __locks_wake_up_blocks(waiter
);
759 __locks_unlink_block(waiter
);
762 * The setting of fl_blocker to NULL marks the "done" point in deleting
763 * a block. Paired with acquire at the top of this function.
765 smp_store_release(&waiter
->flc_blocker
, NULL
);
766 spin_unlock(&blocked_lock_lock
);
771 * locks_delete_block - stop waiting for a file lock
772 * @waiter: the lock which was waiting
774 * lockd/nfsd need to disconnect the lock while working on it.
776 int locks_delete_block(struct file_lock
*waiter
)
778 return __locks_delete_block(&waiter
->c
);
780 EXPORT_SYMBOL(locks_delete_block
);
782 /* Insert waiter into blocker's block list.
783 * We use a circular list so that processes can be easily woken up in
784 * the order they blocked. The documentation doesn't require this but
785 * it seems like the reasonable thing to do.
787 * Must be called with both the flc_lock and blocked_lock_lock held. The
788 * fl_blocked_requests list itself is protected by the blocked_lock_lock,
789 * but by ensuring that the flc_lock is also held on insertions we can avoid
790 * taking the blocked_lock_lock in some cases when we see that the
791 * fl_blocked_requests list is empty.
793 * Rather than just adding to the list, we check for conflicts with any existing
794 * waiters, and add beneath any waiter that blocks the new waiter.
795 * Thus wakeups don't happen until needed.
797 static void __locks_insert_block(struct file_lock_core
*blocker
,
798 struct file_lock_core
*waiter
,
799 bool conflict(struct file_lock_core
*,
800 struct file_lock_core
*))
802 struct file_lock_core
*flc
;
804 BUG_ON(!list_empty(&waiter
->flc_blocked_member
));
806 list_for_each_entry(flc
, &blocker
->flc_blocked_requests
, flc_blocked_member
)
807 if (conflict(flc
, waiter
)) {
811 waiter
->flc_blocker
= blocker
;
812 list_add_tail(&waiter
->flc_blocked_member
,
813 &blocker
->flc_blocked_requests
);
815 if ((blocker
->flc_flags
& (FL_POSIX
|FL_OFDLCK
)) == FL_POSIX
)
816 locks_insert_global_blocked(waiter
);
818 /* The requests in waiter->flc_blocked are known to conflict with
819 * waiter, but might not conflict with blocker, or the requests
820 * and lock which block it. So they all need to be woken.
822 __locks_wake_up_blocks(waiter
);
825 /* Must be called with flc_lock held. */
826 static void locks_insert_block(struct file_lock_core
*blocker
,
827 struct file_lock_core
*waiter
,
828 bool conflict(struct file_lock_core
*,
829 struct file_lock_core
*))
831 spin_lock(&blocked_lock_lock
);
832 __locks_insert_block(blocker
, waiter
, conflict
);
833 spin_unlock(&blocked_lock_lock
);
837 * Wake up processes blocked waiting for blocker.
839 * Must be called with the inode->flc_lock held!
841 static void locks_wake_up_blocks(struct file_lock_core
*blocker
)
844 * Avoid taking global lock if list is empty. This is safe since new
845 * blocked requests are only added to the list under the flc_lock, and
846 * the flc_lock is always held here. Note that removal from the
847 * fl_blocked_requests list does not require the flc_lock, so we must
848 * recheck list_empty() after acquiring the blocked_lock_lock.
850 if (list_empty(&blocker
->flc_blocked_requests
))
853 spin_lock(&blocked_lock_lock
);
854 __locks_wake_up_blocks(blocker
);
855 spin_unlock(&blocked_lock_lock
);
859 locks_insert_lock_ctx(struct file_lock_core
*fl
, struct list_head
*before
)
861 list_add_tail(&fl
->flc_list
, before
);
862 locks_insert_global_locks(fl
);
866 locks_unlink_lock_ctx(struct file_lock_core
*fl
)
868 locks_delete_global_locks(fl
);
869 list_del_init(&fl
->flc_list
);
870 locks_wake_up_blocks(fl
);
874 locks_delete_lock_ctx(struct file_lock_core
*fl
, struct list_head
*dispose
)
876 locks_unlink_lock_ctx(fl
);
878 list_add(&fl
->flc_list
, dispose
);
880 locks_free_lock(file_lock(fl
));
883 /* Determine if lock sys_fl blocks lock caller_fl. Common functionality
884 * checks for shared/exclusive status of overlapping locks.
886 static bool locks_conflict(struct file_lock_core
*caller_flc
,
887 struct file_lock_core
*sys_flc
)
889 if (sys_flc
->flc_type
== F_WRLCK
)
891 if (caller_flc
->flc_type
== F_WRLCK
)
896 /* Determine if lock sys_fl blocks lock caller_fl. POSIX specific
897 * checking before calling the locks_conflict().
899 static bool posix_locks_conflict(struct file_lock_core
*caller_flc
,
900 struct file_lock_core
*sys_flc
)
902 struct file_lock
*caller_fl
= file_lock(caller_flc
);
903 struct file_lock
*sys_fl
= file_lock(sys_flc
);
905 /* POSIX locks owned by the same process do not conflict with
908 if (posix_same_owner(caller_flc
, sys_flc
))
911 /* Check whether they overlap */
912 if (!locks_overlap(caller_fl
, sys_fl
))
915 return locks_conflict(caller_flc
, sys_flc
);
918 /* Determine if lock sys_fl blocks lock caller_fl. Used on xx_GETLK
919 * path so checks for additional GETLK-specific things like F_UNLCK.
921 static bool posix_test_locks_conflict(struct file_lock
*caller_fl
,
922 struct file_lock
*sys_fl
)
924 struct file_lock_core
*caller
= &caller_fl
->c
;
925 struct file_lock_core
*sys
= &sys_fl
->c
;
927 /* F_UNLCK checks any locks on the same fd. */
928 if (lock_is_unlock(caller_fl
)) {
929 if (!posix_same_owner(caller
, sys
))
931 return locks_overlap(caller_fl
, sys_fl
);
933 return posix_locks_conflict(caller
, sys
);
936 /* Determine if lock sys_fl blocks lock caller_fl. FLOCK specific
937 * checking before calling the locks_conflict().
939 static bool flock_locks_conflict(struct file_lock_core
*caller_flc
,
940 struct file_lock_core
*sys_flc
)
942 /* FLOCK locks referring to the same filp do not conflict with
945 if (caller_flc
->flc_file
== sys_flc
->flc_file
)
948 return locks_conflict(caller_flc
, sys_flc
);
952 posix_test_lock(struct file
*filp
, struct file_lock
*fl
)
954 struct file_lock
*cfl
;
955 struct file_lock_context
*ctx
;
956 struct inode
*inode
= file_inode(filp
);
960 ctx
= locks_inode_context(inode
);
961 if (!ctx
|| list_empty_careful(&ctx
->flc_posix
)) {
962 fl
->c
.flc_type
= F_UNLCK
;
967 spin_lock(&ctx
->flc_lock
);
968 list_for_each_entry(cfl
, &ctx
->flc_posix
, c
.flc_list
) {
969 if (!posix_test_locks_conflict(fl
, cfl
))
971 if (cfl
->fl_lmops
&& cfl
->fl_lmops
->lm_lock_expirable
972 && (*cfl
->fl_lmops
->lm_lock_expirable
)(cfl
)) {
973 owner
= cfl
->fl_lmops
->lm_mod_owner
;
974 func
= cfl
->fl_lmops
->lm_expire_lock
;
976 spin_unlock(&ctx
->flc_lock
);
981 locks_copy_conflock(fl
, cfl
);
984 fl
->c
.flc_type
= F_UNLCK
;
986 spin_unlock(&ctx
->flc_lock
);
989 EXPORT_SYMBOL(posix_test_lock
);
992 * Deadlock detection:
994 * We attempt to detect deadlocks that are due purely to posix file
997 * We assume that a task can be waiting for at most one lock at a time.
998 * So for any acquired lock, the process holding that lock may be
999 * waiting on at most one other lock. That lock in turns may be held by
1000 * someone waiting for at most one other lock. Given a requested lock
1001 * caller_fl which is about to wait for a conflicting lock block_fl, we
1002 * follow this chain of waiters to ensure we are not about to create a
1005 * Since we do this before we ever put a process to sleep on a lock, we
1006 * are ensured that there is never a cycle; that is what guarantees that
1007 * the while() loop in posix_locks_deadlock() eventually completes.
1009 * Note: the above assumption may not be true when handling lock
1010 * requests from a broken NFS client. It may also fail in the presence
1011 * of tasks (such as posix threads) sharing the same open file table.
1012 * To handle those cases, we just bail out after a few iterations.
1014 * For FL_OFDLCK locks, the owner is the filp, not the files_struct.
1015 * Because the owner is not even nominally tied to a thread of
1016 * execution, the deadlock detection below can't reasonably work well. Just
1017 * skip it for those.
1019 * In principle, we could do a more limited deadlock detection on FL_OFDLCK
1020 * locks that just checks for the case where two tasks are attempting to
1021 * upgrade from read to write locks on the same inode.
1024 #define MAX_DEADLK_ITERATIONS 10
1026 /* Find a lock that the owner of the given @blocker is blocking on. */
1027 static struct file_lock_core
*what_owner_is_waiting_for(struct file_lock_core
*blocker
)
1029 struct file_lock_core
*flc
;
1031 hash_for_each_possible(blocked_hash
, flc
, flc_link
, posix_owner_key(blocker
)) {
1032 if (posix_same_owner(flc
, blocker
)) {
1033 while (flc
->flc_blocker
)
1034 flc
= flc
->flc_blocker
;
1041 /* Must be called with the blocked_lock_lock held! */
1042 static bool posix_locks_deadlock(struct file_lock
*caller_fl
,
1043 struct file_lock
*block_fl
)
1045 struct file_lock_core
*caller
= &caller_fl
->c
;
1046 struct file_lock_core
*blocker
= &block_fl
->c
;
1049 lockdep_assert_held(&blocked_lock_lock
);
1052 * This deadlock detector can't reasonably detect deadlocks with
1053 * FL_OFDLCK locks, since they aren't owned by a process, per-se.
1055 if (caller
->flc_flags
& FL_OFDLCK
)
1058 while ((blocker
= what_owner_is_waiting_for(blocker
))) {
1059 if (i
++ > MAX_DEADLK_ITERATIONS
)
1061 if (posix_same_owner(caller
, blocker
))
1067 /* Try to create a FLOCK lock on filp. We always insert new FLOCK locks
1068 * after any leases, but before any posix locks.
1070 * Note that if called with an FL_EXISTS argument, the caller may determine
1071 * whether or not a lock was successfully freed by testing the return
1072 * value for -ENOENT.
1074 static int flock_lock_inode(struct inode
*inode
, struct file_lock
*request
)
1076 struct file_lock
*new_fl
= NULL
;
1077 struct file_lock
*fl
;
1078 struct file_lock_context
*ctx
;
1083 ctx
= locks_get_lock_context(inode
, request
->c
.flc_type
);
1085 if (request
->c
.flc_type
!= F_UNLCK
)
1087 return (request
->c
.flc_flags
& FL_EXISTS
) ? -ENOENT
: 0;
1090 if (!(request
->c
.flc_flags
& FL_ACCESS
) && (request
->c
.flc_type
!= F_UNLCK
)) {
1091 new_fl
= locks_alloc_lock();
1096 percpu_down_read(&file_rwsem
);
1097 spin_lock(&ctx
->flc_lock
);
1098 if (request
->c
.flc_flags
& FL_ACCESS
)
1101 list_for_each_entry(fl
, &ctx
->flc_flock
, c
.flc_list
) {
1102 if (request
->c
.flc_file
!= fl
->c
.flc_file
)
1104 if (request
->c
.flc_type
== fl
->c
.flc_type
)
1107 locks_delete_lock_ctx(&fl
->c
, &dispose
);
1111 if (lock_is_unlock(request
)) {
1112 if ((request
->c
.flc_flags
& FL_EXISTS
) && !found
)
1118 list_for_each_entry(fl
, &ctx
->flc_flock
, c
.flc_list
) {
1119 if (!flock_locks_conflict(&request
->c
, &fl
->c
))
1122 if (!(request
->c
.flc_flags
& FL_SLEEP
))
1124 error
= FILE_LOCK_DEFERRED
;
1125 locks_insert_block(&fl
->c
, &request
->c
, flock_locks_conflict
);
1128 if (request
->c
.flc_flags
& FL_ACCESS
)
1130 locks_copy_lock(new_fl
, request
);
1131 locks_move_blocks(new_fl
, request
);
1132 locks_insert_lock_ctx(&new_fl
->c
, &ctx
->flc_flock
);
1137 spin_unlock(&ctx
->flc_lock
);
1138 percpu_up_read(&file_rwsem
);
1140 locks_free_lock(new_fl
);
1141 locks_dispose_list(&dispose
);
1142 trace_flock_lock_inode(inode
, request
, error
);
1146 static int posix_lock_inode(struct inode
*inode
, struct file_lock
*request
,
1147 struct file_lock
*conflock
)
1149 struct file_lock
*fl
, *tmp
;
1150 struct file_lock
*new_fl
= NULL
;
1151 struct file_lock
*new_fl2
= NULL
;
1152 struct file_lock
*left
= NULL
;
1153 struct file_lock
*right
= NULL
;
1154 struct file_lock_context
*ctx
;
1161 ctx
= locks_get_lock_context(inode
, request
->c
.flc_type
);
1163 return lock_is_unlock(request
) ? 0 : -ENOMEM
;
1166 * We may need two file_lock structures for this operation,
1167 * so we get them in advance to avoid races.
1169 * In some cases we can be sure, that no new locks will be needed
1171 if (!(request
->c
.flc_flags
& FL_ACCESS
) &&
1172 (request
->c
.flc_type
!= F_UNLCK
||
1173 request
->fl_start
!= 0 || request
->fl_end
!= OFFSET_MAX
)) {
1174 new_fl
= locks_alloc_lock();
1175 new_fl2
= locks_alloc_lock();
1179 percpu_down_read(&file_rwsem
);
1180 spin_lock(&ctx
->flc_lock
);
1182 * New lock request. Walk all POSIX locks and look for conflicts. If
1183 * there are any, either return error or put the request on the
1184 * blocker's list of waiters and the global blocked_hash.
1186 if (request
->c
.flc_type
!= F_UNLCK
) {
1187 list_for_each_entry(fl
, &ctx
->flc_posix
, c
.flc_list
) {
1188 if (!posix_locks_conflict(&request
->c
, &fl
->c
))
1190 if (fl
->fl_lmops
&& fl
->fl_lmops
->lm_lock_expirable
1191 && (*fl
->fl_lmops
->lm_lock_expirable
)(fl
)) {
1192 owner
= fl
->fl_lmops
->lm_mod_owner
;
1193 func
= fl
->fl_lmops
->lm_expire_lock
;
1194 __module_get(owner
);
1195 spin_unlock(&ctx
->flc_lock
);
1196 percpu_up_read(&file_rwsem
);
1202 locks_copy_conflock(conflock
, fl
);
1204 if (!(request
->c
.flc_flags
& FL_SLEEP
))
1207 * Deadlock detection and insertion into the blocked
1208 * locks list must be done while holding the same lock!
1211 spin_lock(&blocked_lock_lock
);
1213 * Ensure that we don't find any locks blocked on this
1214 * request during deadlock detection.
1216 __locks_wake_up_blocks(&request
->c
);
1217 if (likely(!posix_locks_deadlock(request
, fl
))) {
1218 error
= FILE_LOCK_DEFERRED
;
1219 __locks_insert_block(&fl
->c
, &request
->c
,
1220 posix_locks_conflict
);
1222 spin_unlock(&blocked_lock_lock
);
1227 /* If we're just looking for a conflict, we're done. */
1229 if (request
->c
.flc_flags
& FL_ACCESS
)
1232 /* Find the first old lock with the same owner as the new lock */
1233 list_for_each_entry(fl
, &ctx
->flc_posix
, c
.flc_list
) {
1234 if (posix_same_owner(&request
->c
, &fl
->c
))
1238 /* Process locks with this owner. */
1239 list_for_each_entry_safe_from(fl
, tmp
, &ctx
->flc_posix
, c
.flc_list
) {
1240 if (!posix_same_owner(&request
->c
, &fl
->c
))
1243 /* Detect adjacent or overlapping regions (if same lock type) */
1244 if (request
->c
.flc_type
== fl
->c
.flc_type
) {
1245 /* In all comparisons of start vs end, use
1246 * "start - 1" rather than "end + 1". If end
1247 * is OFFSET_MAX, end + 1 will become negative.
1249 if (fl
->fl_end
< request
->fl_start
- 1)
1251 /* If the next lock in the list has entirely bigger
1252 * addresses than the new one, insert the lock here.
1254 if (fl
->fl_start
- 1 > request
->fl_end
)
1257 /* If we come here, the new and old lock are of the
1258 * same type and adjacent or overlapping. Make one
1259 * lock yielding from the lower start address of both
1260 * locks to the higher end address.
1262 if (fl
->fl_start
> request
->fl_start
)
1263 fl
->fl_start
= request
->fl_start
;
1265 request
->fl_start
= fl
->fl_start
;
1266 if (fl
->fl_end
< request
->fl_end
)
1267 fl
->fl_end
= request
->fl_end
;
1269 request
->fl_end
= fl
->fl_end
;
1271 locks_delete_lock_ctx(&fl
->c
, &dispose
);
1277 /* Processing for different lock types is a bit
1280 if (fl
->fl_end
< request
->fl_start
)
1282 if (fl
->fl_start
> request
->fl_end
)
1284 if (lock_is_unlock(request
))
1286 if (fl
->fl_start
< request
->fl_start
)
1288 /* If the next lock in the list has a higher end
1289 * address than the new one, insert the new one here.
1291 if (fl
->fl_end
> request
->fl_end
) {
1295 if (fl
->fl_start
>= request
->fl_start
) {
1296 /* The new lock completely replaces an old
1297 * one (This may happen several times).
1300 locks_delete_lock_ctx(&fl
->c
, &dispose
);
1304 * Replace the old lock with new_fl, and
1305 * remove the old one. It's safe to do the
1306 * insert here since we know that we won't be
1307 * using new_fl later, and that the lock is
1308 * just replacing an existing lock.
1313 locks_copy_lock(new_fl
, request
);
1314 locks_move_blocks(new_fl
, request
);
1317 locks_insert_lock_ctx(&request
->c
,
1319 locks_delete_lock_ctx(&fl
->c
, &dispose
);
1326 * The above code only modifies existing locks in case of merging or
1327 * replacing. If new lock(s) need to be inserted all modifications are
1328 * done below this, so it's safe yet to bail out.
1330 error
= -ENOLCK
; /* "no luck" */
1331 if (right
&& left
== right
&& !new_fl2
)
1336 if (lock_is_unlock(request
)) {
1337 if (request
->c
.flc_flags
& FL_EXISTS
)
1346 locks_copy_lock(new_fl
, request
);
1347 locks_move_blocks(new_fl
, request
);
1348 locks_insert_lock_ctx(&new_fl
->c
, &fl
->c
.flc_list
);
1353 if (left
== right
) {
1354 /* The new lock breaks the old one in two pieces,
1355 * so we have to use the second new lock.
1359 locks_copy_lock(left
, right
);
1360 locks_insert_lock_ctx(&left
->c
, &fl
->c
.flc_list
);
1362 right
->fl_start
= request
->fl_end
+ 1;
1363 locks_wake_up_blocks(&right
->c
);
1366 left
->fl_end
= request
->fl_start
- 1;
1367 locks_wake_up_blocks(&left
->c
);
1370 trace_posix_lock_inode(inode
, request
, error
);
1371 spin_unlock(&ctx
->flc_lock
);
1372 percpu_up_read(&file_rwsem
);
1374 * Free any unused locks.
1377 locks_free_lock(new_fl
);
1379 locks_free_lock(new_fl2
);
1380 locks_dispose_list(&dispose
);
1386 * posix_lock_file - Apply a POSIX-style lock to a file
1387 * @filp: The file to apply the lock to
1388 * @fl: The lock to be applied
1389 * @conflock: Place to return a copy of the conflicting lock, if found.
1391 * Add a POSIX style lock to a file.
1392 * We merge adjacent & overlapping locks whenever possible.
1393 * POSIX locks are sorted by owner task, then by starting address
1395 * Note that if called with an FL_EXISTS argument, the caller may determine
1396 * whether or not a lock was successfully freed by testing the return
1397 * value for -ENOENT.
1399 int posix_lock_file(struct file
*filp
, struct file_lock
*fl
,
1400 struct file_lock
*conflock
)
1402 return posix_lock_inode(file_inode(filp
), fl
, conflock
);
1404 EXPORT_SYMBOL(posix_lock_file
);
1407 * posix_lock_inode_wait - Apply a POSIX-style lock to a file
1408 * @inode: inode of file to which lock request should be applied
1409 * @fl: The lock to be applied
1411 * Apply a POSIX style lock request to an inode.
1413 static int posix_lock_inode_wait(struct inode
*inode
, struct file_lock
*fl
)
1418 error
= posix_lock_inode(inode
, fl
, NULL
);
1419 if (error
!= FILE_LOCK_DEFERRED
)
1421 error
= wait_event_interruptible(fl
->c
.flc_wait
,
1422 list_empty(&fl
->c
.flc_blocked_member
));
1426 locks_delete_block(fl
);
1430 static void lease_clear_pending(struct file_lease
*fl
, int arg
)
1434 fl
->c
.flc_flags
&= ~FL_UNLOCK_PENDING
;
1437 fl
->c
.flc_flags
&= ~FL_DOWNGRADE_PENDING
;
1441 /* We already had a lease on this file; just change its type */
1442 int lease_modify(struct file_lease
*fl
, int arg
, struct list_head
*dispose
)
1444 int error
= assign_type(&fl
->c
, arg
);
1448 lease_clear_pending(fl
, arg
);
1449 locks_wake_up_blocks(&fl
->c
);
1450 if (arg
== F_UNLCK
) {
1451 struct file
*filp
= fl
->c
.flc_file
;
1454 file_f_owner(filp
)->signum
= 0;
1455 fasync_helper(0, fl
->c
.flc_file
, 0, &fl
->fl_fasync
);
1456 if (fl
->fl_fasync
!= NULL
) {
1457 printk(KERN_ERR
"locks_delete_lock: fasync == %p\n", fl
->fl_fasync
);
1458 fl
->fl_fasync
= NULL
;
1460 locks_delete_lock_ctx(&fl
->c
, dispose
);
1464 EXPORT_SYMBOL(lease_modify
);
1466 static bool past_time(unsigned long then
)
1469 /* 0 is a special value meaning "this never expires": */
1471 return time_after(jiffies
, then
);
1474 static void time_out_leases(struct inode
*inode
, struct list_head
*dispose
)
1476 struct file_lock_context
*ctx
= inode
->i_flctx
;
1477 struct file_lease
*fl
, *tmp
;
1479 lockdep_assert_held(&ctx
->flc_lock
);
1481 list_for_each_entry_safe(fl
, tmp
, &ctx
->flc_lease
, c
.flc_list
) {
1482 trace_time_out_leases(inode
, fl
);
1483 if (past_time(fl
->fl_downgrade_time
))
1484 lease_modify(fl
, F_RDLCK
, dispose
);
1485 if (past_time(fl
->fl_break_time
))
1486 lease_modify(fl
, F_UNLCK
, dispose
);
1490 static bool leases_conflict(struct file_lock_core
*lc
, struct file_lock_core
*bc
)
1493 struct file_lease
*lease
= file_lease(lc
);
1494 struct file_lease
*breaker
= file_lease(bc
);
1496 if (lease
->fl_lmops
->lm_breaker_owns_lease
1497 && lease
->fl_lmops
->lm_breaker_owns_lease(lease
))
1499 if ((bc
->flc_flags
& FL_LAYOUT
) != (lc
->flc_flags
& FL_LAYOUT
)) {
1503 if ((bc
->flc_flags
& FL_DELEG
) && (lc
->flc_flags
& FL_LEASE
)) {
1508 rc
= locks_conflict(bc
, lc
);
1510 trace_leases_conflict(rc
, lease
, breaker
);
1515 any_leases_conflict(struct inode
*inode
, struct file_lease
*breaker
)
1517 struct file_lock_context
*ctx
= inode
->i_flctx
;
1518 struct file_lock_core
*flc
;
1520 lockdep_assert_held(&ctx
->flc_lock
);
1522 list_for_each_entry(flc
, &ctx
->flc_lease
, flc_list
) {
1523 if (leases_conflict(flc
, &breaker
->c
))
1530 * __break_lease - revoke all outstanding leases on file
1531 * @inode: the inode of the file to return
1532 * @mode: O_RDONLY: break only write leases; O_WRONLY or O_RDWR:
1534 * @type: FL_LEASE: break leases and delegations; FL_DELEG: break
1537 * break_lease (inlined for speed) has checked there already is at least
1538 * some kind of lock (maybe a lease) on this file. Leases are broken on
1539 * a call to open() or truncate(). This function can sleep unless you
1540 * specified %O_NONBLOCK to your open().
1542 int __break_lease(struct inode
*inode
, unsigned int mode
, unsigned int type
)
1545 struct file_lock_context
*ctx
;
1546 struct file_lease
*new_fl
, *fl
, *tmp
;
1547 unsigned long break_time
;
1548 int want_write
= (mode
& O_ACCMODE
) != O_RDONLY
;
1551 new_fl
= lease_alloc(NULL
, want_write
? F_WRLCK
: F_RDLCK
);
1553 return PTR_ERR(new_fl
);
1554 new_fl
->c
.flc_flags
= type
;
1556 /* typically we will check that ctx is non-NULL before calling */
1557 ctx
= locks_inode_context(inode
);
1563 percpu_down_read(&file_rwsem
);
1564 spin_lock(&ctx
->flc_lock
);
1566 time_out_leases(inode
, &dispose
);
1568 if (!any_leases_conflict(inode
, new_fl
))
1572 if (lease_break_time
> 0) {
1573 break_time
= jiffies
+ lease_break_time
* HZ
;
1574 if (break_time
== 0)
1575 break_time
++; /* so that 0 means no break time */
1578 list_for_each_entry_safe(fl
, tmp
, &ctx
->flc_lease
, c
.flc_list
) {
1579 if (!leases_conflict(&fl
->c
, &new_fl
->c
))
1582 if (fl
->c
.flc_flags
& FL_UNLOCK_PENDING
)
1584 fl
->c
.flc_flags
|= FL_UNLOCK_PENDING
;
1585 fl
->fl_break_time
= break_time
;
1587 if (lease_breaking(fl
))
1589 fl
->c
.flc_flags
|= FL_DOWNGRADE_PENDING
;
1590 fl
->fl_downgrade_time
= break_time
;
1592 if (fl
->fl_lmops
->lm_break(fl
))
1593 locks_delete_lock_ctx(&fl
->c
, &dispose
);
1596 if (list_empty(&ctx
->flc_lease
))
1599 if (mode
& O_NONBLOCK
) {
1600 trace_break_lease_noblock(inode
, new_fl
);
1601 error
= -EWOULDBLOCK
;
1606 fl
= list_first_entry(&ctx
->flc_lease
, struct file_lease
, c
.flc_list
);
1607 break_time
= fl
->fl_break_time
;
1608 if (break_time
!= 0)
1609 break_time
-= jiffies
;
1610 if (break_time
== 0)
1612 locks_insert_block(&fl
->c
, &new_fl
->c
, leases_conflict
);
1613 trace_break_lease_block(inode
, new_fl
);
1614 spin_unlock(&ctx
->flc_lock
);
1615 percpu_up_read(&file_rwsem
);
1617 locks_dispose_list(&dispose
);
1618 error
= wait_event_interruptible_timeout(new_fl
->c
.flc_wait
,
1619 list_empty(&new_fl
->c
.flc_blocked_member
),
1622 percpu_down_read(&file_rwsem
);
1623 spin_lock(&ctx
->flc_lock
);
1624 trace_break_lease_unblock(inode
, new_fl
);
1625 __locks_delete_block(&new_fl
->c
);
1628 * Wait for the next conflicting lease that has not been
1632 time_out_leases(inode
, &dispose
);
1633 if (any_leases_conflict(inode
, new_fl
))
1638 spin_unlock(&ctx
->flc_lock
);
1639 percpu_up_read(&file_rwsem
);
1640 locks_dispose_list(&dispose
);
1642 locks_free_lease(new_fl
);
1645 EXPORT_SYMBOL(__break_lease
);
1648 * lease_get_mtime - update modified time of an inode with exclusive lease
1650 * @time: pointer to a timespec which contains the last modified time
1652 * This is to force NFS clients to flush their caches for files with
1653 * exclusive leases. The justification is that if someone has an
1654 * exclusive lease, then they could be modifying it.
1656 void lease_get_mtime(struct inode
*inode
, struct timespec64
*time
)
1658 bool has_lease
= false;
1659 struct file_lock_context
*ctx
;
1660 struct file_lock_core
*flc
;
1662 ctx
= locks_inode_context(inode
);
1663 if (ctx
&& !list_empty_careful(&ctx
->flc_lease
)) {
1664 spin_lock(&ctx
->flc_lock
);
1665 flc
= list_first_entry_or_null(&ctx
->flc_lease
,
1666 struct file_lock_core
, flc_list
);
1667 if (flc
&& flc
->flc_type
== F_WRLCK
)
1669 spin_unlock(&ctx
->flc_lock
);
1673 *time
= current_time(inode
);
1675 EXPORT_SYMBOL(lease_get_mtime
);
1678 * fcntl_getlease - Enquire what lease is currently active
1681 * The value returned by this function will be one of
1682 * (if no lease break is pending):
1684 * %F_RDLCK to indicate a shared lease is held.
1686 * %F_WRLCK to indicate an exclusive lease is held.
1688 * %F_UNLCK to indicate no lease is held.
1690 * (if a lease break is pending):
1692 * %F_RDLCK to indicate an exclusive lease needs to be
1693 * changed to a shared lease (or removed).
1695 * %F_UNLCK to indicate the lease needs to be removed.
1697 * XXX: sfr & willy disagree over whether F_INPROGRESS
1698 * should be returned to userspace.
1700 int fcntl_getlease(struct file
*filp
)
1702 struct file_lease
*fl
;
1703 struct inode
*inode
= file_inode(filp
);
1704 struct file_lock_context
*ctx
;
1708 ctx
= locks_inode_context(inode
);
1709 if (ctx
&& !list_empty_careful(&ctx
->flc_lease
)) {
1710 percpu_down_read(&file_rwsem
);
1711 spin_lock(&ctx
->flc_lock
);
1712 time_out_leases(inode
, &dispose
);
1713 list_for_each_entry(fl
, &ctx
->flc_lease
, c
.flc_list
) {
1714 if (fl
->c
.flc_file
!= filp
)
1716 type
= target_leasetype(fl
);
1719 spin_unlock(&ctx
->flc_lock
);
1720 percpu_up_read(&file_rwsem
);
1722 locks_dispose_list(&dispose
);
1728 * check_conflicting_open - see if the given file points to an inode that has
1729 * an existing open that would conflict with the
1731 * @filp: file to check
1732 * @arg: type of lease that we're trying to acquire
1733 * @flags: current lock flags
1735 * Check to see if there's an existing open fd on this file that would
1736 * conflict with the lease we're trying to set.
1739 check_conflicting_open(struct file
*filp
, const int arg
, int flags
)
1741 struct inode
*inode
= file_inode(filp
);
1742 int self_wcount
= 0, self_rcount
= 0;
1744 if (flags
& FL_LAYOUT
)
1746 if (flags
& FL_DELEG
)
1747 /* We leave these checks to the caller */
1751 return inode_is_open_for_write(inode
) ? -EAGAIN
: 0;
1752 else if (arg
!= F_WRLCK
)
1756 * Make sure that only read/write count is from lease requestor.
1757 * Note that this will result in denying write leases when i_writecount
1758 * is negative, which is what we want. (We shouldn't grant write leases
1759 * on files open for execution.)
1761 if (filp
->f_mode
& FMODE_WRITE
)
1763 else if (filp
->f_mode
& FMODE_READ
)
1766 if (atomic_read(&inode
->i_writecount
) != self_wcount
||
1767 atomic_read(&inode
->i_readcount
) != self_rcount
)
1774 generic_add_lease(struct file
*filp
, int arg
, struct file_lease
**flp
, void **priv
)
1776 struct file_lease
*fl
, *my_fl
= NULL
, *lease
;
1777 struct inode
*inode
= file_inode(filp
);
1778 struct file_lock_context
*ctx
;
1779 bool is_deleg
= (*flp
)->c
.flc_flags
& FL_DELEG
;
1784 trace_generic_add_lease(inode
, lease
);
1786 error
= file_f_owner_allocate(filp
);
1790 /* Note that arg is never F_UNLCK here */
1791 ctx
= locks_get_lock_context(inode
, arg
);
1796 * In the delegation case we need mutual exclusion with
1797 * a number of operations that take the i_mutex. We trylock
1798 * because delegations are an optional optimization, and if
1799 * there's some chance of a conflict--we'd rather not
1800 * bother, maybe that's a sign this just isn't a good file to
1801 * hand out a delegation on.
1803 if (is_deleg
&& !inode_trylock(inode
))
1806 percpu_down_read(&file_rwsem
);
1807 spin_lock(&ctx
->flc_lock
);
1808 time_out_leases(inode
, &dispose
);
1809 error
= check_conflicting_open(filp
, arg
, lease
->c
.flc_flags
);
1814 * At this point, we know that if there is an exclusive
1815 * lease on this file, then we hold it on this filp
1816 * (otherwise our open of this file would have blocked).
1817 * And if we are trying to acquire an exclusive lease,
1818 * then the file is not open by anyone (including us)
1819 * except for this filp.
1822 list_for_each_entry(fl
, &ctx
->flc_lease
, c
.flc_list
) {
1823 if (fl
->c
.flc_file
== filp
&&
1824 fl
->c
.flc_owner
== lease
->c
.flc_owner
) {
1830 * No exclusive leases if someone else has a lease on
1836 * Modifying our existing lease is OK, but no getting a
1837 * new lease if someone else is opening for write:
1839 if (fl
->c
.flc_flags
& FL_UNLOCK_PENDING
)
1843 if (my_fl
!= NULL
) {
1845 error
= lease
->fl_lmops
->lm_change(lease
, arg
, &dispose
);
1855 locks_insert_lock_ctx(&lease
->c
, &ctx
->flc_lease
);
1857 * The check in break_lease() is lockless. It's possible for another
1858 * open to race in after we did the earlier check for a conflicting
1859 * open but before the lease was inserted. Check again for a
1860 * conflicting open and cancel the lease if there is one.
1862 * We also add a barrier here to ensure that the insertion of the lock
1863 * precedes these checks.
1866 error
= check_conflicting_open(filp
, arg
, lease
->c
.flc_flags
);
1868 locks_unlink_lock_ctx(&lease
->c
);
1873 if (lease
->fl_lmops
->lm_setup
)
1874 lease
->fl_lmops
->lm_setup(lease
, priv
);
1876 spin_unlock(&ctx
->flc_lock
);
1877 percpu_up_read(&file_rwsem
);
1878 locks_dispose_list(&dispose
);
1880 inode_unlock(inode
);
1881 if (!error
&& !my_fl
)
1886 static int generic_delete_lease(struct file
*filp
, void *owner
)
1888 int error
= -EAGAIN
;
1889 struct file_lease
*fl
, *victim
= NULL
;
1890 struct inode
*inode
= file_inode(filp
);
1891 struct file_lock_context
*ctx
;
1894 ctx
= locks_inode_context(inode
);
1896 trace_generic_delete_lease(inode
, NULL
);
1900 percpu_down_read(&file_rwsem
);
1901 spin_lock(&ctx
->flc_lock
);
1902 list_for_each_entry(fl
, &ctx
->flc_lease
, c
.flc_list
) {
1903 if (fl
->c
.flc_file
== filp
&&
1904 fl
->c
.flc_owner
== owner
) {
1909 trace_generic_delete_lease(inode
, victim
);
1911 error
= fl
->fl_lmops
->lm_change(victim
, F_UNLCK
, &dispose
);
1912 spin_unlock(&ctx
->flc_lock
);
1913 percpu_up_read(&file_rwsem
);
1914 locks_dispose_list(&dispose
);
1919 * generic_setlease - sets a lease on an open file
1920 * @filp: file pointer
1921 * @arg: type of lease to obtain
1922 * @flp: input - file_lock to use, output - file_lock inserted
1923 * @priv: private data for lm_setup (may be NULL if lm_setup
1924 * doesn't require it)
1926 * The (input) flp->fl_lmops->lm_break function is required
1929 int generic_setlease(struct file
*filp
, int arg
, struct file_lease
**flp
,
1934 return generic_delete_lease(filp
, *priv
);
1937 if (!(*flp
)->fl_lmops
->lm_break
) {
1942 return generic_add_lease(filp
, arg
, flp
, priv
);
1947 EXPORT_SYMBOL(generic_setlease
);
1950 * Kernel subsystems can register to be notified on any attempt to set
1951 * a new lease with the lease_notifier_chain. This is used by (e.g.) nfsd
1952 * to close files that it may have cached when there is an attempt to set a
1953 * conflicting lease.
1955 static struct srcu_notifier_head lease_notifier_chain
;
1958 lease_notifier_chain_init(void)
1960 srcu_init_notifier_head(&lease_notifier_chain
);
1964 setlease_notifier(int arg
, struct file_lease
*lease
)
1967 srcu_notifier_call_chain(&lease_notifier_chain
, arg
, lease
);
1970 int lease_register_notifier(struct notifier_block
*nb
)
1972 return srcu_notifier_chain_register(&lease_notifier_chain
, nb
);
1974 EXPORT_SYMBOL_GPL(lease_register_notifier
);
1976 void lease_unregister_notifier(struct notifier_block
*nb
)
1978 srcu_notifier_chain_unregister(&lease_notifier_chain
, nb
);
1980 EXPORT_SYMBOL_GPL(lease_unregister_notifier
);
1984 kernel_setlease(struct file
*filp
, int arg
, struct file_lease
**lease
, void **priv
)
1987 setlease_notifier(arg
, *lease
);
1988 if (filp
->f_op
->setlease
)
1989 return filp
->f_op
->setlease(filp
, arg
, lease
, priv
);
1991 return generic_setlease(filp
, arg
, lease
, priv
);
1993 EXPORT_SYMBOL_GPL(kernel_setlease
);
1996 * vfs_setlease - sets a lease on an open file
1997 * @filp: file pointer
1998 * @arg: type of lease to obtain
1999 * @lease: file_lock to use when adding a lease
2000 * @priv: private info for lm_setup when adding a lease (may be
2001 * NULL if lm_setup doesn't require it)
2003 * Call this to establish a lease on the file. The "lease" argument is not
2004 * used for F_UNLCK requests and may be NULL. For commands that set or alter
2005 * an existing lease, the ``(*lease)->fl_lmops->lm_break`` operation must be
2006 * set; if not, this function will return -ENOLCK (and generate a scary-looking
2009 * The "priv" pointer is passed directly to the lm_setup function as-is. It
2010 * may be NULL if the lm_setup operation doesn't require it.
2013 vfs_setlease(struct file
*filp
, int arg
, struct file_lease
**lease
, void **priv
)
2015 struct inode
*inode
= file_inode(filp
);
2016 vfsuid_t vfsuid
= i_uid_into_vfsuid(file_mnt_idmap(filp
), inode
);
2019 if ((!vfsuid_eq_kuid(vfsuid
, current_fsuid())) && !capable(CAP_LEASE
))
2021 if (!S_ISREG(inode
->i_mode
))
2023 error
= security_file_lock(filp
, arg
);
2026 return kernel_setlease(filp
, arg
, lease
, priv
);
2028 EXPORT_SYMBOL_GPL(vfs_setlease
);
2030 static int do_fcntl_add_lease(unsigned int fd
, struct file
*filp
, int arg
)
2032 struct file_lease
*fl
;
2033 struct fasync_struct
*new;
2036 fl
= lease_alloc(filp
, arg
);
2040 new = fasync_alloc();
2042 locks_free_lease(fl
);
2047 error
= vfs_setlease(filp
, arg
, &fl
, (void **)&new);
2049 locks_free_lease(fl
);
2056 * fcntl_setlease - sets a lease on an open file
2057 * @fd: open file descriptor
2058 * @filp: file pointer
2059 * @arg: type of lease to obtain
2061 * Call this fcntl to establish a lease on the file.
2062 * Note that you also need to call %F_SETSIG to
2063 * receive a signal when the lease is broken.
2065 int fcntl_setlease(unsigned int fd
, struct file
*filp
, int arg
)
2068 return vfs_setlease(filp
, F_UNLCK
, NULL
, (void **)&filp
);
2069 return do_fcntl_add_lease(fd
, filp
, arg
);
2073 * flock_lock_inode_wait - Apply a FLOCK-style lock to a file
2074 * @inode: inode of the file to apply to
2075 * @fl: The lock to be applied
2077 * Apply a FLOCK style lock request to an inode.
2079 static int flock_lock_inode_wait(struct inode
*inode
, struct file_lock
*fl
)
2084 error
= flock_lock_inode(inode
, fl
);
2085 if (error
!= FILE_LOCK_DEFERRED
)
2087 error
= wait_event_interruptible(fl
->c
.flc_wait
,
2088 list_empty(&fl
->c
.flc_blocked_member
));
2092 locks_delete_block(fl
);
2097 * locks_lock_inode_wait - Apply a lock to an inode
2098 * @inode: inode of the file to apply to
2099 * @fl: The lock to be applied
2101 * Apply a POSIX or FLOCK style lock request to an inode.
2103 int locks_lock_inode_wait(struct inode
*inode
, struct file_lock
*fl
)
2106 switch (fl
->c
.flc_flags
& (FL_POSIX
|FL_FLOCK
)) {
2108 res
= posix_lock_inode_wait(inode
, fl
);
2111 res
= flock_lock_inode_wait(inode
, fl
);
2118 EXPORT_SYMBOL(locks_lock_inode_wait
);
2121 * sys_flock: - flock() system call.
2122 * @fd: the file descriptor to lock.
2123 * @cmd: the type of lock to apply.
2125 * Apply a %FL_FLOCK style lock to an open file descriptor.
2126 * The @cmd can be one of:
2128 * - %LOCK_SH -- a shared lock.
2129 * - %LOCK_EX -- an exclusive lock.
2130 * - %LOCK_UN -- remove an existing lock.
2131 * - %LOCK_MAND -- a 'mandatory' flock. (DEPRECATED)
2133 * %LOCK_MAND support has been removed from the kernel.
2135 SYSCALL_DEFINE2(flock
, unsigned int, fd
, unsigned int, cmd
)
2137 int can_sleep
, error
, type
;
2138 struct file_lock fl
;
2141 * LOCK_MAND locks were broken for a long time in that they never
2142 * conflicted with one another and didn't prevent any sort of open,
2143 * read or write activity.
2145 * Just ignore these requests now, to preserve legacy behavior, but
2146 * throw a warning to let people know that they don't actually work.
2148 if (cmd
& LOCK_MAND
) {
2149 pr_warn_once("%s(%d): Attempt to set a LOCK_MAND lock via flock(2). This support has been removed and the request ignored.\n", current
->comm
, current
->pid
);
2153 type
= flock_translate_cmd(cmd
& ~LOCK_NB
);
2161 if (type
!= F_UNLCK
&& !(fd_file(f
)->f_mode
& (FMODE_READ
| FMODE_WRITE
)))
2164 flock_make_lock(fd_file(f
), &fl
, type
);
2166 error
= security_file_lock(fd_file(f
), fl
.c
.flc_type
);
2170 can_sleep
= !(cmd
& LOCK_NB
);
2172 fl
.c
.flc_flags
|= FL_SLEEP
;
2174 if (fd_file(f
)->f_op
->flock
)
2175 error
= fd_file(f
)->f_op
->flock(fd_file(f
),
2176 (can_sleep
) ? F_SETLKW
: F_SETLK
,
2179 error
= locks_lock_file_wait(fd_file(f
), &fl
);
2181 locks_release_private(&fl
);
2186 * vfs_test_lock - test file byte range lock
2187 * @filp: The file to test lock for
2188 * @fl: The lock to test; also used to hold result
2190 * Returns -ERRNO on failure. Indicates presence of conflicting lock by
2191 * setting conf->fl_type to something other than F_UNLCK.
2193 int vfs_test_lock(struct file
*filp
, struct file_lock
*fl
)
2195 WARN_ON_ONCE(filp
!= fl
->c
.flc_file
);
2196 if (filp
->f_op
->lock
)
2197 return filp
->f_op
->lock(filp
, F_GETLK
, fl
);
2198 posix_test_lock(filp
, fl
);
2201 EXPORT_SYMBOL_GPL(vfs_test_lock
);
2204 * locks_translate_pid - translate a file_lock's fl_pid number into a namespace
2205 * @fl: The file_lock who's fl_pid should be translated
2206 * @ns: The namespace into which the pid should be translated
2208 * Used to translate a fl_pid into a namespace virtual pid number
2210 static pid_t
locks_translate_pid(struct file_lock_core
*fl
, struct pid_namespace
*ns
)
2215 if (fl
->flc_flags
& FL_OFDLCK
)
2218 /* Remote locks report a negative pid value */
2219 if (fl
->flc_pid
<= 0)
2223 * If the flock owner process is dead and its pid has been already
2224 * freed, the translation below won't work, but we still want to show
2225 * flock owner pid number in init pidns.
2227 if (ns
== &init_pid_ns
)
2228 return (pid_t
) fl
->flc_pid
;
2231 pid
= find_pid_ns(fl
->flc_pid
, &init_pid_ns
);
2232 vnr
= pid_nr_ns(pid
, ns
);
2237 static int posix_lock_to_flock(struct flock
*flock
, struct file_lock
*fl
)
2239 flock
->l_pid
= locks_translate_pid(&fl
->c
, task_active_pid_ns(current
));
2240 #if BITS_PER_LONG == 32
2242 * Make sure we can represent the posix lock via
2243 * legacy 32bit flock.
2245 if (fl
->fl_start
> OFFT_OFFSET_MAX
)
2247 if (fl
->fl_end
!= OFFSET_MAX
&& fl
->fl_end
> OFFT_OFFSET_MAX
)
2250 flock
->l_start
= fl
->fl_start
;
2251 flock
->l_len
= fl
->fl_end
== OFFSET_MAX
? 0 :
2252 fl
->fl_end
- fl
->fl_start
+ 1;
2253 flock
->l_whence
= 0;
2254 flock
->l_type
= fl
->c
.flc_type
;
2258 #if BITS_PER_LONG == 32
2259 static void posix_lock_to_flock64(struct flock64
*flock
, struct file_lock
*fl
)
2261 flock
->l_pid
= locks_translate_pid(&fl
->c
, task_active_pid_ns(current
));
2262 flock
->l_start
= fl
->fl_start
;
2263 flock
->l_len
= fl
->fl_end
== OFFSET_MAX
? 0 :
2264 fl
->fl_end
- fl
->fl_start
+ 1;
2265 flock
->l_whence
= 0;
2266 flock
->l_type
= fl
->c
.flc_type
;
2270 /* Report the first existing lock that would conflict with l.
2271 * This implements the F_GETLK command of fcntl().
2273 int fcntl_getlk(struct file
*filp
, unsigned int cmd
, struct flock
*flock
)
2275 struct file_lock
*fl
;
2278 fl
= locks_alloc_lock();
2282 if (cmd
!= F_OFD_GETLK
&& flock
->l_type
!= F_RDLCK
2283 && flock
->l_type
!= F_WRLCK
)
2286 error
= flock_to_posix_lock(filp
, fl
, flock
);
2290 if (cmd
== F_OFD_GETLK
) {
2292 if (flock
->l_pid
!= 0)
2295 fl
->c
.flc_flags
|= FL_OFDLCK
;
2296 fl
->c
.flc_owner
= filp
;
2299 error
= vfs_test_lock(filp
, fl
);
2303 flock
->l_type
= fl
->c
.flc_type
;
2304 if (fl
->c
.flc_type
!= F_UNLCK
) {
2305 error
= posix_lock_to_flock(flock
, fl
);
2310 locks_free_lock(fl
);
2315 * vfs_lock_file - file byte range lock
2316 * @filp: The file to apply the lock to
2317 * @cmd: type of locking operation (F_SETLK, F_GETLK, etc.)
2318 * @fl: The lock to be applied
2319 * @conf: Place to return a copy of the conflicting lock, if found.
2321 * A caller that doesn't care about the conflicting lock may pass NULL
2322 * as the final argument.
2324 * If the filesystem defines a private ->lock() method, then @conf will
2325 * be left unchanged; so a caller that cares should initialize it to
2326 * some acceptable default.
2328 * To avoid blocking kernel daemons, such as lockd, that need to acquire POSIX
2329 * locks, the ->lock() interface may return asynchronously, before the lock has
2330 * been granted or denied by the underlying filesystem, if (and only if)
2331 * lm_grant is set. Additionally EXPORT_OP_ASYNC_LOCK in export_operations
2332 * flags need to be set.
2334 * Callers expecting ->lock() to return asynchronously will only use F_SETLK,
2335 * not F_SETLKW; they will set FL_SLEEP if (and only if) the request is for a
2336 * blocking lock. When ->lock() does return asynchronously, it must return
2337 * FILE_LOCK_DEFERRED, and call ->lm_grant() when the lock request completes.
2338 * If the request is for non-blocking lock the file system should return
2339 * FILE_LOCK_DEFERRED then try to get the lock and call the callback routine
2340 * with the result. If the request timed out the callback routine will return a
2341 * nonzero return code and the file system should release the lock. The file
2342 * system is also responsible to keep a corresponding posix lock when it
2343 * grants a lock so the VFS can find out which locks are locally held and do
2344 * the correct lock cleanup when required.
2345 * The underlying filesystem must not drop the kernel lock or call
2346 * ->lm_grant() before returning to the caller with a FILE_LOCK_DEFERRED
2349 int vfs_lock_file(struct file
*filp
, unsigned int cmd
, struct file_lock
*fl
, struct file_lock
*conf
)
2351 WARN_ON_ONCE(filp
!= fl
->c
.flc_file
);
2352 if (filp
->f_op
->lock
)
2353 return filp
->f_op
->lock(filp
, cmd
, fl
);
2355 return posix_lock_file(filp
, fl
, conf
);
2357 EXPORT_SYMBOL_GPL(vfs_lock_file
);
2359 static int do_lock_file_wait(struct file
*filp
, unsigned int cmd
,
2360 struct file_lock
*fl
)
2364 error
= security_file_lock(filp
, fl
->c
.flc_type
);
2369 error
= vfs_lock_file(filp
, cmd
, fl
, NULL
);
2370 if (error
!= FILE_LOCK_DEFERRED
)
2372 error
= wait_event_interruptible(fl
->c
.flc_wait
,
2373 list_empty(&fl
->c
.flc_blocked_member
));
2377 locks_delete_block(fl
);
2382 /* Ensure that fl->fl_file has compatible f_mode for F_SETLK calls */
2384 check_fmode_for_setlk(struct file_lock
*fl
)
2386 switch (fl
->c
.flc_type
) {
2388 if (!(fl
->c
.flc_file
->f_mode
& FMODE_READ
))
2392 if (!(fl
->c
.flc_file
->f_mode
& FMODE_WRITE
))
2398 /* Apply the lock described by l to an open file descriptor.
2399 * This implements both the F_SETLK and F_SETLKW commands of fcntl().
2401 int fcntl_setlk(unsigned int fd
, struct file
*filp
, unsigned int cmd
,
2402 struct flock
*flock
)
2404 struct file_lock
*file_lock
= locks_alloc_lock();
2405 struct inode
*inode
= file_inode(filp
);
2409 if (file_lock
== NULL
)
2412 error
= flock_to_posix_lock(filp
, file_lock
, flock
);
2416 error
= check_fmode_for_setlk(file_lock
);
2421 * If the cmd is requesting file-private locks, then set the
2422 * FL_OFDLCK flag and override the owner.
2427 if (flock
->l_pid
!= 0)
2431 file_lock
->c
.flc_flags
|= FL_OFDLCK
;
2432 file_lock
->c
.flc_owner
= filp
;
2436 if (flock
->l_pid
!= 0)
2440 file_lock
->c
.flc_flags
|= FL_OFDLCK
;
2441 file_lock
->c
.flc_owner
= filp
;
2444 file_lock
->c
.flc_flags
|= FL_SLEEP
;
2447 error
= do_lock_file_wait(filp
, cmd
, file_lock
);
2450 * Detect close/fcntl races and recover by zapping all POSIX locks
2451 * associated with this file and our files_struct, just like on
2452 * filp_flush(). There is no need to do that when we're
2453 * unlocking though, or for OFD locks.
2455 if (!error
&& file_lock
->c
.flc_type
!= F_UNLCK
&&
2456 !(file_lock
->c
.flc_flags
& FL_OFDLCK
)) {
2457 struct files_struct
*files
= current
->files
;
2459 * We need that spin_lock here - it prevents reordering between
2460 * update of i_flctx->flc_posix and check for it done in
2461 * close(). rcu_read_lock() wouldn't do.
2463 spin_lock(&files
->file_lock
);
2464 f
= files_lookup_fd_locked(files
, fd
);
2465 spin_unlock(&files
->file_lock
);
2467 locks_remove_posix(filp
, files
);
2472 trace_fcntl_setlk(inode
, file_lock
, error
);
2473 locks_free_lock(file_lock
);
2477 #if BITS_PER_LONG == 32
2478 /* Report the first existing lock that would conflict with l.
2479 * This implements the F_GETLK command of fcntl().
2481 int fcntl_getlk64(struct file
*filp
, unsigned int cmd
, struct flock64
*flock
)
2483 struct file_lock
*fl
;
2486 fl
= locks_alloc_lock();
2491 if (cmd
!= F_OFD_GETLK
&& flock
->l_type
!= F_RDLCK
2492 && flock
->l_type
!= F_WRLCK
)
2495 error
= flock64_to_posix_lock(filp
, fl
, flock
);
2499 if (cmd
== F_OFD_GETLK
) {
2501 if (flock
->l_pid
!= 0)
2504 fl
->c
.flc_flags
|= FL_OFDLCK
;
2505 fl
->c
.flc_owner
= filp
;
2508 error
= vfs_test_lock(filp
, fl
);
2512 flock
->l_type
= fl
->c
.flc_type
;
2513 if (fl
->c
.flc_type
!= F_UNLCK
)
2514 posix_lock_to_flock64(flock
, fl
);
2517 locks_free_lock(fl
);
2521 /* Apply the lock described by l to an open file descriptor.
2522 * This implements both the F_SETLK and F_SETLKW commands of fcntl().
2524 int fcntl_setlk64(unsigned int fd
, struct file
*filp
, unsigned int cmd
,
2525 struct flock64
*flock
)
2527 struct file_lock
*file_lock
= locks_alloc_lock();
2531 if (file_lock
== NULL
)
2534 error
= flock64_to_posix_lock(filp
, file_lock
, flock
);
2538 error
= check_fmode_for_setlk(file_lock
);
2543 * If the cmd is requesting file-private locks, then set the
2544 * FL_OFDLCK flag and override the owner.
2549 if (flock
->l_pid
!= 0)
2553 file_lock
->c
.flc_flags
|= FL_OFDLCK
;
2554 file_lock
->c
.flc_owner
= filp
;
2558 if (flock
->l_pid
!= 0)
2562 file_lock
->c
.flc_flags
|= FL_OFDLCK
;
2563 file_lock
->c
.flc_owner
= filp
;
2566 file_lock
->c
.flc_flags
|= FL_SLEEP
;
2569 error
= do_lock_file_wait(filp
, cmd
, file_lock
);
2572 * Detect close/fcntl races and recover by zapping all POSIX locks
2573 * associated with this file and our files_struct, just like on
2574 * filp_flush(). There is no need to do that when we're
2575 * unlocking though, or for OFD locks.
2577 if (!error
&& file_lock
->c
.flc_type
!= F_UNLCK
&&
2578 !(file_lock
->c
.flc_flags
& FL_OFDLCK
)) {
2579 struct files_struct
*files
= current
->files
;
2581 * We need that spin_lock here - it prevents reordering between
2582 * update of i_flctx->flc_posix and check for it done in
2583 * close(). rcu_read_lock() wouldn't do.
2585 spin_lock(&files
->file_lock
);
2586 f
= files_lookup_fd_locked(files
, fd
);
2587 spin_unlock(&files
->file_lock
);
2589 locks_remove_posix(filp
, files
);
2594 locks_free_lock(file_lock
);
2597 #endif /* BITS_PER_LONG == 32 */
2600 * This function is called when the file is being removed
2601 * from the task's fd array. POSIX locks belonging to this task
2602 * are deleted at this time.
2604 void locks_remove_posix(struct file
*filp
, fl_owner_t owner
)
2607 struct inode
*inode
= file_inode(filp
);
2608 struct file_lock lock
;
2609 struct file_lock_context
*ctx
;
2612 * If there are no locks held on this file, we don't need to call
2613 * posix_lock_file(). Another process could be setting a lock on this
2614 * file at the same time, but we wouldn't remove that lock anyway.
2616 ctx
= locks_inode_context(inode
);
2617 if (!ctx
|| list_empty(&ctx
->flc_posix
))
2620 locks_init_lock(&lock
);
2621 lock
.c
.flc_type
= F_UNLCK
;
2622 lock
.c
.flc_flags
= FL_POSIX
| FL_CLOSE
;
2624 lock
.fl_end
= OFFSET_MAX
;
2625 lock
.c
.flc_owner
= owner
;
2626 lock
.c
.flc_pid
= current
->tgid
;
2627 lock
.c
.flc_file
= filp
;
2629 lock
.fl_lmops
= NULL
;
2631 error
= vfs_lock_file(filp
, F_SETLK
, &lock
, NULL
);
2633 if (lock
.fl_ops
&& lock
.fl_ops
->fl_release_private
)
2634 lock
.fl_ops
->fl_release_private(&lock
);
2635 trace_locks_remove_posix(inode
, &lock
, error
);
2637 EXPORT_SYMBOL(locks_remove_posix
);
2639 /* The i_flctx must be valid when calling into here */
2641 locks_remove_flock(struct file
*filp
, struct file_lock_context
*flctx
)
2643 struct file_lock fl
;
2644 struct inode
*inode
= file_inode(filp
);
2646 if (list_empty(&flctx
->flc_flock
))
2649 flock_make_lock(filp
, &fl
, F_UNLCK
);
2650 fl
.c
.flc_flags
|= FL_CLOSE
;
2652 if (filp
->f_op
->flock
)
2653 filp
->f_op
->flock(filp
, F_SETLKW
, &fl
);
2655 flock_lock_inode(inode
, &fl
);
2657 if (fl
.fl_ops
&& fl
.fl_ops
->fl_release_private
)
2658 fl
.fl_ops
->fl_release_private(&fl
);
2661 /* The i_flctx must be valid when calling into here */
2663 locks_remove_lease(struct file
*filp
, struct file_lock_context
*ctx
)
2665 struct file_lease
*fl
, *tmp
;
2668 if (list_empty(&ctx
->flc_lease
))
2671 percpu_down_read(&file_rwsem
);
2672 spin_lock(&ctx
->flc_lock
);
2673 list_for_each_entry_safe(fl
, tmp
, &ctx
->flc_lease
, c
.flc_list
)
2674 if (filp
== fl
->c
.flc_file
)
2675 lease_modify(fl
, F_UNLCK
, &dispose
);
2676 spin_unlock(&ctx
->flc_lock
);
2677 percpu_up_read(&file_rwsem
);
2679 locks_dispose_list(&dispose
);
2683 * This function is called on the last close of an open file.
2685 void locks_remove_file(struct file
*filp
)
2687 struct file_lock_context
*ctx
;
2689 ctx
= locks_inode_context(file_inode(filp
));
2693 /* remove any OFD locks */
2694 locks_remove_posix(filp
, filp
);
2696 /* remove flock locks */
2697 locks_remove_flock(filp
, ctx
);
2699 /* remove any leases */
2700 locks_remove_lease(filp
, ctx
);
2702 spin_lock(&ctx
->flc_lock
);
2703 locks_check_ctx_file_list(filp
, &ctx
->flc_posix
, "POSIX");
2704 locks_check_ctx_file_list(filp
, &ctx
->flc_flock
, "FLOCK");
2705 locks_check_ctx_file_list(filp
, &ctx
->flc_lease
, "LEASE");
2706 spin_unlock(&ctx
->flc_lock
);
2710 * vfs_cancel_lock - file byte range unblock lock
2711 * @filp: The file to apply the unblock to
2712 * @fl: The lock to be unblocked
2714 * Used by lock managers to cancel blocked requests
2716 int vfs_cancel_lock(struct file
*filp
, struct file_lock
*fl
)
2718 WARN_ON_ONCE(filp
!= fl
->c
.flc_file
);
2719 if (filp
->f_op
->lock
)
2720 return filp
->f_op
->lock(filp
, F_CANCELLK
, fl
);
2723 EXPORT_SYMBOL_GPL(vfs_cancel_lock
);
2726 * vfs_inode_has_locks - are any file locks held on @inode?
2727 * @inode: inode to check for locks
2729 * Return true if there are any FL_POSIX or FL_FLOCK locks currently
2732 bool vfs_inode_has_locks(struct inode
*inode
)
2734 struct file_lock_context
*ctx
;
2737 ctx
= locks_inode_context(inode
);
2741 spin_lock(&ctx
->flc_lock
);
2742 ret
= !list_empty(&ctx
->flc_posix
) || !list_empty(&ctx
->flc_flock
);
2743 spin_unlock(&ctx
->flc_lock
);
2746 EXPORT_SYMBOL_GPL(vfs_inode_has_locks
);
2748 #ifdef CONFIG_PROC_FS
2749 #include <linux/proc_fs.h>
2750 #include <linux/seq_file.h>
2752 struct locks_iterator
{
2757 static void lock_get_status(struct seq_file
*f
, struct file_lock_core
*flc
,
2758 loff_t id
, char *pfx
, int repeat
)
2760 struct inode
*inode
= NULL
;
2762 struct pid_namespace
*proc_pidns
= proc_pid_ns(file_inode(f
->file
)->i_sb
);
2763 int type
= flc
->flc_type
;
2764 struct file_lock
*fl
= file_lock(flc
);
2766 pid
= locks_translate_pid(flc
, proc_pidns
);
2769 * If lock owner is dead (and pid is freed) or not visible in current
2770 * pidns, zero is shown as a pid value. Check lock info from
2771 * init_pid_ns to get saved lock pid value.
2773 if (flc
->flc_file
!= NULL
)
2774 inode
= file_inode(flc
->flc_file
);
2776 seq_printf(f
, "%lld: ", id
);
2779 seq_printf(f
, "%*s", repeat
- 1 + (int)strlen(pfx
), pfx
);
2781 if (flc
->flc_flags
& FL_POSIX
) {
2782 if (flc
->flc_flags
& FL_ACCESS
)
2783 seq_puts(f
, "ACCESS");
2784 else if (flc
->flc_flags
& FL_OFDLCK
)
2785 seq_puts(f
, "OFDLCK");
2787 seq_puts(f
, "POSIX ");
2789 seq_printf(f
, " %s ",
2790 (inode
== NULL
) ? "*NOINODE*" : "ADVISORY ");
2791 } else if (flc
->flc_flags
& FL_FLOCK
) {
2792 seq_puts(f
, "FLOCK ADVISORY ");
2793 } else if (flc
->flc_flags
& (FL_LEASE
|FL_DELEG
|FL_LAYOUT
)) {
2794 struct file_lease
*lease
= file_lease(flc
);
2796 type
= target_leasetype(lease
);
2798 if (flc
->flc_flags
& FL_DELEG
)
2799 seq_puts(f
, "DELEG ");
2801 seq_puts(f
, "LEASE ");
2803 if (lease_breaking(lease
))
2804 seq_puts(f
, "BREAKING ");
2805 else if (flc
->flc_file
)
2806 seq_puts(f
, "ACTIVE ");
2808 seq_puts(f
, "BREAKER ");
2810 seq_puts(f
, "UNKNOWN UNKNOWN ");
2813 seq_printf(f
, "%s ", (type
== F_WRLCK
) ? "WRITE" :
2814 (type
== F_RDLCK
) ? "READ" : "UNLCK");
2816 /* userspace relies on this representation of dev_t */
2817 seq_printf(f
, "%d %02x:%02x:%lu ", pid
,
2818 MAJOR(inode
->i_sb
->s_dev
),
2819 MINOR(inode
->i_sb
->s_dev
), inode
->i_ino
);
2821 seq_printf(f
, "%d <none>:0 ", pid
);
2823 if (flc
->flc_flags
& FL_POSIX
) {
2824 if (fl
->fl_end
== OFFSET_MAX
)
2825 seq_printf(f
, "%Ld EOF\n", fl
->fl_start
);
2827 seq_printf(f
, "%Ld %Ld\n", fl
->fl_start
, fl
->fl_end
);
2829 seq_puts(f
, "0 EOF\n");
2833 static struct file_lock_core
*get_next_blocked_member(struct file_lock_core
*node
)
2835 struct file_lock_core
*tmp
;
2837 /* NULL node or root node */
2838 if (node
== NULL
|| node
->flc_blocker
== NULL
)
2841 /* Next member in the linked list could be itself */
2842 tmp
= list_next_entry(node
, flc_blocked_member
);
2843 if (list_entry_is_head(tmp
, &node
->flc_blocker
->flc_blocked_requests
,
2852 static int locks_show(struct seq_file
*f
, void *v
)
2854 struct locks_iterator
*iter
= f
->private;
2855 struct file_lock_core
*cur
, *tmp
;
2856 struct pid_namespace
*proc_pidns
= proc_pid_ns(file_inode(f
->file
)->i_sb
);
2859 cur
= hlist_entry(v
, struct file_lock_core
, flc_link
);
2861 if (locks_translate_pid(cur
, proc_pidns
) == 0)
2864 /* View this crossed linked list as a binary tree, the first member of flc_blocked_requests
2865 * is the left child of current node, the next silibing in flc_blocked_member is the
2866 * right child, we can alse get the parent of current node from flc_blocker, so this
2867 * question becomes traversal of a binary tree
2869 while (cur
!= NULL
) {
2871 lock_get_status(f
, cur
, iter
->li_pos
, "-> ", level
);
2873 lock_get_status(f
, cur
, iter
->li_pos
, "", level
);
2875 if (!list_empty(&cur
->flc_blocked_requests
)) {
2877 cur
= list_first_entry_or_null(&cur
->flc_blocked_requests
,
2878 struct file_lock_core
,
2879 flc_blocked_member
);
2883 tmp
= get_next_blocked_member(cur
);
2884 /* Fall back to parent node */
2885 while (tmp
== NULL
&& cur
->flc_blocker
!= NULL
) {
2886 cur
= cur
->flc_blocker
;
2888 tmp
= get_next_blocked_member(cur
);
2897 static void __show_fd_locks(struct seq_file
*f
,
2898 struct list_head
*head
, int *id
,
2899 struct file
*filp
, struct files_struct
*files
)
2901 struct file_lock_core
*fl
;
2903 list_for_each_entry(fl
, head
, flc_list
) {
2905 if (filp
!= fl
->flc_file
)
2907 if (fl
->flc_owner
!= files
&& fl
->flc_owner
!= filp
)
2911 seq_puts(f
, "lock:\t");
2912 lock_get_status(f
, fl
, *id
, "", 0);
2916 void show_fd_locks(struct seq_file
*f
,
2917 struct file
*filp
, struct files_struct
*files
)
2919 struct inode
*inode
= file_inode(filp
);
2920 struct file_lock_context
*ctx
;
2923 ctx
= locks_inode_context(inode
);
2927 spin_lock(&ctx
->flc_lock
);
2928 __show_fd_locks(f
, &ctx
->flc_flock
, &id
, filp
, files
);
2929 __show_fd_locks(f
, &ctx
->flc_posix
, &id
, filp
, files
);
2930 __show_fd_locks(f
, &ctx
->flc_lease
, &id
, filp
, files
);
2931 spin_unlock(&ctx
->flc_lock
);
2934 static void *locks_start(struct seq_file
*f
, loff_t
*pos
)
2935 __acquires(&blocked_lock_lock
)
2937 struct locks_iterator
*iter
= f
->private;
2939 iter
->li_pos
= *pos
+ 1;
2940 percpu_down_write(&file_rwsem
);
2941 spin_lock(&blocked_lock_lock
);
2942 return seq_hlist_start_percpu(&file_lock_list
.hlist
, &iter
->li_cpu
, *pos
);
2945 static void *locks_next(struct seq_file
*f
, void *v
, loff_t
*pos
)
2947 struct locks_iterator
*iter
= f
->private;
2950 return seq_hlist_next_percpu(v
, &file_lock_list
.hlist
, &iter
->li_cpu
, pos
);
2953 static void locks_stop(struct seq_file
*f
, void *v
)
2954 __releases(&blocked_lock_lock
)
2956 spin_unlock(&blocked_lock_lock
);
2957 percpu_up_write(&file_rwsem
);
2960 static const struct seq_operations locks_seq_operations
= {
2961 .start
= locks_start
,
2967 static int __init
proc_locks_init(void)
2969 proc_create_seq_private("locks", 0, NULL
, &locks_seq_operations
,
2970 sizeof(struct locks_iterator
), NULL
);
2973 fs_initcall(proc_locks_init
);
2976 static int __init
filelock_init(void)
2980 flctx_cache
= kmem_cache_create("file_lock_ctx",
2981 sizeof(struct file_lock_context
), 0, SLAB_PANIC
, NULL
);
2983 filelock_cache
= kmem_cache_create("file_lock_cache",
2984 sizeof(struct file_lock
), 0, SLAB_PANIC
, NULL
);
2986 filelease_cache
= kmem_cache_create("file_lease_cache",
2987 sizeof(struct file_lease
), 0, SLAB_PANIC
, NULL
);
2989 for_each_possible_cpu(i
) {
2990 struct file_lock_list_struct
*fll
= per_cpu_ptr(&file_lock_list
, i
);
2992 spin_lock_init(&fll
->lock
);
2993 INIT_HLIST_HEAD(&fll
->hlist
);
2996 lease_notifier_chain_init();
2999 core_initcall(filelock_init
);