[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PULL 17/19] 9pfs/9p-util.h: convert Doxygen -> kerneldoc format
From: |
Christian Schoenebeck |
Subject: |
[PULL 17/19] 9pfs/9p-util.h: convert Doxygen -> kerneldoc format |
Date: |
Fri, 04 Mar 2022 13:27:49 +0100 |
API doc comments in QEMU are supposed to be in kerneldoc format, so
convert API doc comments from Doxygen format to kerneldoc format.
Signed-off-by: Christian Schoenebeck <qemu_oss@crudebyte.com>
Reviewed-by: Greg Kurz <groug@kaod.org>
Message-Id:
<dc1c4a85e233f5884ee5f6ec96b87db286083df7.1646314856.git.qemu_oss@crudebyte.com>
---
hw/9pfs/9p-util.h | 10 +++++-----
1 file changed, 5 insertions(+), 5 deletions(-)
diff --git a/hw/9pfs/9p-util.h b/hw/9pfs/9p-util.h
index 22835c5f61..cfa7af43c5 100644
--- a/hw/9pfs/9p-util.h
+++ b/hw/9pfs/9p-util.h
@@ -97,7 +97,7 @@ ssize_t flistxattrat_nofollow(int dirfd, const char *filename,
ssize_t fremovexattrat_nofollow(int dirfd, const char *filename,
const char *name);
-/**
+/*
* Darwin has d_seekoff, which appears to function similarly to d_off.
* However, it does not appear to be supported on all file systems,
* so ensure it is manually injected earlier and call here when
@@ -113,15 +113,15 @@ static inline off_t qemu_dirent_off(struct dirent *dent)
}
/**
- * Duplicate directory entry @dent.
+ * qemu_dirent_dup() - Duplicate directory entry @dent.
+ *
+ * @dent: original directory entry to be duplicated
+ * Return: duplicated directory entry which should be freed with g_free()
*
* It is highly recommended to use this function instead of open coding
* duplication of dirent objects, because the actual struct dirent
* size may be bigger or shorter than sizeof(struct dirent) and correct
* handling is platform specific (see gitlab issue #841).
- *
- * @dent - original directory entry to be duplicated
- * @returns duplicated directory entry which should be freed with g_free()
*/
static inline struct dirent *qemu_dirent_dup(struct dirent *dent)
{
--
2.20.1
- [PULL 00/19] 9p queue 2022-03-04, Christian Schoenebeck, 2022/03/04
- [PULL 13/19] 9pfs: drop Doxygen format from qemu_dirent_dup() API comment, Christian Schoenebeck, 2022/03/04
- [PULL 07/19] 9p: darwin: *xattr_nofollow implementations, Christian Schoenebeck, 2022/03/04
- [PULL 15/19] 9pfs/codir.c: convert Doxygen -> kerneldoc format, Christian Schoenebeck, 2022/03/04
- [PULL 19/19] fsdev/p9array.h: convert Doxygen -> kerneldoc format, Christian Schoenebeck, 2022/03/04
- [PULL 01/19] 9p: linux: Fix a couple Linux assumptions, Christian Schoenebeck, 2022/03/04
- [PULL 17/19] 9pfs/9p-util.h: convert Doxygen -> kerneldoc format,
Christian Schoenebeck <=
- [PULL 16/19] 9pfs/9p.c: convert Doxygen -> kerneldoc format, Christian Schoenebeck, 2022/03/04
- [PULL 11/19] 9p: darwin: meson: Allow VirtFS on Darwin, Christian Schoenebeck, 2022/03/04
- [PULL 04/19] 9p: darwin: Handle struct dirent differences, Christian Schoenebeck, 2022/03/04
- [PULL 08/19] 9p: darwin: Compatibility for f/l*xattr, Christian Schoenebeck, 2022/03/04
- [PULL 02/19] 9p: Rename 9p-util -> 9p-util-linux, Christian Schoenebeck, 2022/03/04
- [PULL 09/19] 9p: darwin: Implement compatibility for mknodat, Christian Schoenebeck, 2022/03/04
- [PULL 18/19] 9pfs/coth.h: drop Doxygen format on v9fs_co_run_in_worker(), Christian Schoenebeck, 2022/03/04
- [PULL 05/19] 9p: darwin: Ignore O_{NOATIME, DIRECT}, Christian Schoenebeck, 2022/03/04
- [PULL 10/19] 9p: darwin: Adjust assumption on virtio-9p-test, Christian Schoenebeck, 2022/03/04
- [PULL 06/19] 9p: darwin: Move XATTR_SIZE_MAX->P9_XATTR_SIZE_MAX, Christian Schoenebeck, 2022/03/04