v2: add function documentation instead of adding a separate file under
    Documentation/

Cc: Li Zefan <lize...@huawei.com>
Cc: Tejun Heo <t...@kernel.org>
Cc: Hugh Dickins <hu...@google.com>
Cc: Hillf Danton <dhi...@gmail.com>
Cc: Lennart Poettering <lpoet...@redhat.com>
Signed-off-by: Aristeu Rozanski <a...@redhat.com>

---
 fs/xattr.c |   18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

Index: github/fs/xattr.c
===================================================================
--- github.orig/fs/xattr.c      2012-09-11 14:48:12.648072176 -0400
+++ github/fs/xattr.c   2012-09-11 15:33:14.502770685 -0400
@@ -892,8 +892,19 @@
 
 }
 
-/*
- * xattr SET operation for in-memory/pseudo filesystems
+/**
+ * simple_xattr_set: xattr SET operation for in-memory/pseudo filesystems
+ * @xattrs: simple_xattr list
+ * @name: name of the new extended attribute
+ * @value: value of the new extended attribute. If NULL, will remove the
+ *        attribute
+ * @flags: if XATTR_CREATE is set, no already existing extended attribute may
+ *        exist. If XATTR_REPLACE is set, the extended attribute should exist.
+ *
+ * returns -ENOMEM for allocation failures, -EEXIST in case XATTR_CREATE is
+ *        set in flags and an extended attribute with the same name exists,
+ *        -ENODATA if XATTR_REPLACE is set in flags but no entry with the
+ *        specified name exists.
  */
 int simple_xattr_set(struct simple_xattrs *xattrs, const char *name,
                     const void *value, size_t size, int flags)
@@ -950,6 +961,9 @@
        return used;
 }
 
+/*
+ * Adds an extended attribute to the list
+ */
 void simple_xattr_list_add(struct simple_xattrs *xattrs,
                           struct simple_xattr *new_xattr)
 {

--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/

Reply via email to