OpenE2K/qemu-e2k
13
4
Fork 0
Code Issues 4 Pull Requests Projects 2 Releases Activity

9pfs/9p-util.h: convert Doxygen -> kerneldoc format

Browse Source 
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>
This commit is contained in:
Christian Schoenebeck 2022-03-03 14:20:29 +01:00
parent e16fea4156
commit 041b0945f9
1 changed files with 5 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
hw/9pfs/9p-util.h
View File

@ -99,7 +99,7 @@ ssize_t flistxattrat_nofollow(int dirfd, const char *filename,
ssize_t fremovexattrat_nofollow(int dirfd, const char *filename, ssize_t fremovexattrat_nofollow(int dirfd, const char *filename,
const char *name); const char *name);
/** /*
* Darwin has d_seekoff, which appears to function similarly to d_off. * Darwin has d_seekoff, which appears to function similarly to d_off.
* However, it does not appear to be supported on all file systems, * However, it does not appear to be supported on all file systems,
* so ensure it is manually injected earlier and call here when * so ensure it is manually injected earlier and call here when
@ -115,15 +115,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 * It is highly recommended to use this function instead of open coding
* duplication of dirent objects, because the actual struct dirent * duplication of dirent objects, because the actual struct dirent
* size may be bigger or shorter than sizeof(struct dirent) and correct * size may be bigger or shorter than sizeof(struct dirent) and correct
* handling is platform specific (see gitlab issue #841). * 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) static inline struct dirent *qemu_dirent_dup(struct dirent *dent)
{ {