Documentation: Exporting: update description of d_splice_alias
authorPhillip Lougher <phillip@lougher.demon.co.uk>
Tue, 26 Jul 2011 02:40:45 +0000 (03:40 +0100)
committerAl Viro <viro@zeniv.linux.org.uk>
Tue, 26 Jul 2011 16:57:09 +0000 (12:57 -0400)
Following commits a904937 and 0c1aa9a update the d_splice_alias
desciption.

Signed-off-by: Phillip Lougher <phillip@squashfs.org.uk>
Signed-off-by: Al Viro <viro@zeniv.linux.org.uk>
Documentation/filesystems/nfs/Exporting

index 87019d2b59815eca1accd2c39497c8de43ca8b49..09994c247289944248eb98c9340b1f5e337ed328 100644 (file)
@@ -92,7 +92,14 @@ For a filesystem to be exportable it must:
    1/ provide the filehandle fragment routines described below.
    2/ make sure that d_splice_alias is used rather than d_add
       when ->lookup finds an inode for a given parent and name.
-      Typically the ->lookup routine will end with a:
+
+      If inode is NULL, d_splice_alias(inode, dentry) is eqivalent to
+
+               d_add(dentry, inode), NULL
+
+      Similarly, d_splice_alias(ERR_PTR(err), dentry) = ERR_PTR(err)
+
+      Typically the ->lookup routine will simply end with a:
 
                return d_splice_alias(inode, dentry);
        }