locks: update Locking documentation to clarify fl_release_private behavior
authorJeff Layton <jlayton@primarydata.com>
Tue, 12 Aug 2014 14:38:07 +0000 (10:38 -0400)
committerJeff Layton <jlayton@primarydata.com>
Thu, 14 Aug 2014 14:08:20 +0000 (10:08 -0400)
Acked-by: J. Bruce Fields <bfields@fieldses.org>
Signed-off-by: Jeff Layton <jlayton@primarydata.com>
Documentation/filesystems/Locking

index b18dd17..f1997e9 100644 (file)
@@ -349,7 +349,11 @@ prototypes:
 locking rules:
                        inode->i_lock   may block
 fl_copy_lock:          yes             no
-fl_release_private:    maybe           no
+fl_release_private:    maybe           maybe[1]
+
+[1]:   ->fl_release_private for flock or POSIX locks is currently allowed
+to block. Leases however can still be freed while the i_lock is held and
+so fl_release_private called on a lease should not block.
 
 ----------------------- lock_manager_operations ---------------------------
 prototypes: