nilfs2-correct-return-value-kernel-doc-descriptions-for-metadata-files.patch removed from -mm tree
The quilt patch titled
Subject: nilfs2: correct return value kernel-doc descriptions for metadata files
has been removed from the -mm tree. Its filename was
nilfs2-correct-return-value-kernel-doc-descriptions-for-metadata-files.patch
This patch was dropped because it was merged into the mm-nonmm-stable branch of git://git.kernel.org/pub/scm/linux/kernel/git/akpm/mm
------------------------------------------------------
From: Ryusuke Konishi <[email protected]>
Subject: nilfs2: correct return value kernel-doc descriptions for metadata files
Date: Fri, 10 Jan 2025 10:01:47 +0900
Similar to the previous changes to fix return value descriptions, this fixes the format of the return value descriptions for metadata file functions other than sufile.
---
fs/nilfs2/cpfile.c | 51 +++++++++++++--------------------- fs/nilfs2/dat.c | 40 ++++++++++----------------- fs/nilfs2/ifile.c | 34 ++++++++++------------- fs/nilfs2/mdt.c | 63 +++++++++++++++++++------------------------ 4 files changed, 80 insertions(+), 108 deletions(-)
fs/nilfs2/cpfile.c renamed from fs/nilfs2/cpfile.c~nilfs2-correct-return-value-kernel-doc-descriptions-for-metadata-files +20 -31
@@ -191,14 +191,11 @@ static inline int nilfs_cpfile_get_check* @cnop: place to store the next checkpoint number * @bhp: place to store a pointer to buffer_head struct * -* Return Value: On success, it returns 0. On error, the following negative -* error code is returned. -* -* %-ENOMEM - Insufficient memory available. -* -* %-EIO - I/O error -* -* %-ENOENT - no block exists in the range. +* Return: 0 on success, or one of the following negative error codes on +* failure: +* * %-EIO - I/O error (including metadata corruption). +* * %-ENOENT - no block exists in the range. +* * %-ENOMEM - Insufficient memory available. */ static int nilfs_cpfile_find_checkpoint_block(struct inode *cpfile, __u64 start_cno, __u64 end_cno,
@@ -447,14 +444,11 @@ error:* the period from @start to @end, excluding @end itself. The checkpoints * which have been already deleted are ignored. * -* Return Value: On success, 0 is returned. On error, one of the following -* negative error codes is returned. -* -* %-EIO - I/O error. -* -* %-ENOMEM - Insufficient amount of memory available. -* -* %-EINVAL - invalid checkpoints. +* Return: 0 on success, or one of the following negative error codes on +* failure: +* * %-EINVAL - Invalid checkpoints. +* * %-EIO - I/O error (including metadata corruption). +* * %-ENOMEM - Insufficient memory available. */ int nilfs_cpfile_delete_checkpoints(struct inode *cpfile, __u64 start,
@@ -1058,14 +1052,11 @@ int nilfs_cpfile_is_snapshot(struct inod* Description: nilfs_change_cpmode() changes the mode of the checkpoint * specified by @cno. The mode @mode is NILFS_CHECKPOINT or NILFS_SNAPSHOT. * -* Return Value: On success, 0 is returned. On error, one of the following -* negative error codes is returned. -* -* %-EIO - I/O error. -* -* %-ENOMEM - Insufficient amount of memory available. -* -* %-ENOENT - No such checkpoint. +* Return: 0 on success, or one of the following negative error codes on +* failure: +* * %-EIO - I/O error (including metadata corruption). +* * %-ENOENT - No such checkpoint. +* * %-ENOMEM - Insufficient memory available. */ int nilfs_cpfile_change_cpmode (struct inode *cpfile,__u64 cno,int mode) {
@@ -1097,14 +1088,12 @@ int nilfs_cpfile_change_cpmode(struct in* @cpstat: pointer to a structure of checkpoint statistics * * Description: nilfs_cpfile_get_stat() returns information about checkpoints. +* The checkpoint statistics are stored in the location pointed to by @cpstat. * -* Return Value: On success, 0 is returned, and checkpoints information is -* stored in the place pointed by @cpstat. On error, one of the following -* negative error codes is returned. -* -* %-EIO - I/O error. -* -* %-ENOMEM - Insufficient amount of memory available. +* Return: 0 on success, or one of the following negative error codes on +* failure: +* * %-EIO - I/O error (including metadata corruption). +* * %-ENOMEM - Insufficient memory available. */ int nilfs_cpfile_get_stat (struct inode *cpfile,struct nilfs_cpstat *cpstat) {
fs/nilfs2/dat.c renamed from fs/nilfs2/dat.c~nilfs2-correct-return-value-kernel-doc-descriptions-for-metadata-files +16 -24
@@ -302,14 +302,11 @@ int nilfs_dat_mark_dirty(struct inode *d* Description: nilfs_dat_freev() frees the virtual block numbers specified by * @vblocknrs and @nitems. * -* Return Value: On success, 0 is returned. On error, one of the following -* negative error codes is returned. -* -* %-EIO - I/O error. -* -* %-ENOMEM - Insufficient amount of memory available. -* -* %-ENOENT - The virtual block number have not been allocated. +* Return: 0 on success, or one of the following negative error codes on +* failure: +* * %-EIO - I/O error (including metadata corruption). +* * %-ENOENT - The virtual block number have not been allocated. +* * %-ENOMEM - Insufficient memory available. */ int nilfs_dat_freev (struct inode *dat,__u64 *vblocknrs,size_t nitems) {
@@ -325,12 +322,10 @@ int nilfs_dat_freev(struct inode *dat, _* Description: nilfs_dat_move() changes the block number associated with * @vblocknr to @blocknr. * -* Return Value: On success, 0 is returned. On error, one of the following -* negative error codes is returned. -* -* %-EIO - I/O error. -* -* %-ENOMEM - Insufficient amount of memory available. +* Return: 0 on success, or one of the following negative error codes on +* failure: +* * %-EIO - I/O error (including metadata corruption). +* * %-ENOMEM - Insufficient memory available. */ int nilfs_dat_move (struct inode *dat,__u64 vblocknr,sector_t blocknr) {
@@ -390,17 +385,14 @@ int nilfs_dat_move(struct inode *dat, __* @blocknrp: pointer to a block number * * Description: nilfs_dat_translate() maps the virtual block number @vblocknr -* to the corresponding block number. -* -* Return Value: On success, 0 is returned and the block number associated -* with @vblocknr is stored in the place pointed by @blocknrp. On error, one -* of the following negative error codes is returned. -* -* %-EIO - I/O error. -* -* %-ENOMEM - Insufficient amount of memory available. +* to the corresponding block number. The block number associated with +* @vblocknr is stored in the place pointed to by @blocknrp. * -* %-ENOENT - A block number associated with @vblocknr does not exist. +* Return: 0 on success, or one of the following negative error codes on +* failure: +* * %-EIO - I/O error (including metadata corruption). +* * %-ENOENT - A block number associated with @vblocknr does not exist. +* * %-ENOMEM - Insufficient memory available. */ int nilfs_dat_translate (struct inode *dat,__u64 vblocknr,sector_t *blocknrp) {
fs/nilfs2/ifile.c renamed from fs/nilfs2/ifile.c~nilfs2-correct-return-value-kernel-doc-descriptions-for-metadata-files +15 -19
@@ -38,17 +38,16 @@ static inline struct nilfs_ifile_info *N* @out_ino: pointer to a variable to store inode number * @out_bh: buffer_head contains newly allocated disk inode * -* Return Value: On success, 0 is returned and the newly allocated inode -* number is stored in the place pointed by @ino, and buffer_head pointer -* that contains newly allocated disk inode structure is stored in the -* place pointed by @out_bh -* On error, one of the following negative error codes is returned. -* -* %-EIO - I/O error. -* -* %-ENOMEM - Insufficient amount of memory available. -* -* %-ENOSPC - No inode left. +* nilfs_ifile_create_inode() allocates a new inode in the ifile metadata +* file and stores the inode number in the variable pointed to by @out_ino, +* as well as storing the ifile's buffer with the disk inode in the location +* pointed to by @out_bh. +* +* Return: 0 on success, or one of the following negative error codes on +* failure: +* * %-EIO - I/O error (including metadata corruption). +* * %-ENOMEM - Insufficient memory available. +* * %-ENOSPC - No inode left. */ int nilfs_ifile_create_inode (struct inode *ifile,ino_t *out_ino,struct buffer_head **out_bh)
@@ -83,14 +82,11 @@ int nilfs_ifile_create_inode(struct inod* @ifile: ifile inode * @ino: inode number * -* Return Value: On success, 0 is returned. On error, one of the following -* negative error codes is returned. -* -* %-EIO - I/O error. -* -* %-ENOMEM - Insufficient amount of memory available. -* -* %-ENOENT - The inode number @ino have not been allocated. +* Return: 0 on success, or one of the following negative error codes on +* failure: +* * %-EIO - I/O error (including metadata corruption). +* * %-ENOENT - Inode number unallocated. +* * %-ENOMEM - Insufficient memory available. */ int nilfs_ifile_delete_inode (struct inode *ifile,ino_t ino) {
fs/nilfs2/mdt.c renamed from fs/nilfs2/mdt.c~nilfs2-correct-return-value-kernel-doc-descriptions-for-metadata-files +29 -34
87 lines not on this page · raw message
_
Patches currently in -mm which might be from [email protected] are