X-Git-Url: https://err.no/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=fs%2F9p%2Ffid.h;h=c3bbd6af996dbb88a1aaeb5b20e5e167ff6589a1;hb=f5c8f7dae75e1e6bb3200fc61302e4d5e2df3dc2;hp=47a0ba742872aa1a18d172c28b8bd884fe98d730;hpb=f79e3185dd0f8650022518d7624c876d8929061b;p=linux-2.6

diff --git a/fs/9p/fid.h b/fs/9p/fid.h
index 47a0ba7428..c3bbd6af99 100644
--- a/fs/9p/fid.h
+++ b/fs/9p/fid.h
@@ -22,12 +22,26 @@
 
 #include <linux/list.h>
 
+/**
+ * struct v9fs_dentry - 9p private data stored in dentry d_fsdata
+ * @lock: protects the fidlist
+ * @fidlist: list of FIDs currently associated with this dentry
+ *
+ * This structure defines the 9p private data associated with
+ * a particular dentry.  In particular, this private data is used
+ * to lookup which 9P FID handle should be used for a particular VFS
+ * operation.  FID handles are associated with dentries instead of
+ * inodes in order to more closely map functionality to the Plan 9
+ * expected behavior for FID reclaimation and tracking.
+ *
+ * See Also: Mapping FIDs to Linux VFS model in
+ * Design and Implementation of the Linux 9P File System documentation
+ */
 struct v9fs_dentry {
 	spinlock_t lock; /* protect fidlist */
 	struct list_head fidlist;
 };
 
 struct p9_fid *v9fs_fid_lookup(struct dentry *dentry);
-struct p9_fid *v9fs_fid_lookup_remove(struct dentry *dentry);
 struct p9_fid *v9fs_fid_clone(struct dentry *dentry);
 int v9fs_fid_add(struct dentry *dentry, struct p9_fid *fid);