Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux
1
fork

Configure Feed

Select the types of activity you want to include in your feed.

nilfs2: revise the return value description style for consistency.

Also for comments that do not cause kernel-doc warnings (those that list
multiple error codes), revise the return value description style to match
Brian G.'s suggestion of "..., or one of the following negative error
codes on failure:".

Link: https://lkml.kernel.org/r/CAAq45aNh1qV8P6XgDhKeNstT=PvcPUaCXsAF-f9rvmzznsZL5A@mail.gmail.com
Link: https://lkml.kernel.org/r/20250110010530.21872-8-konishi.ryusuke@gmail.com
Signed-off-by: Ryusuke Konishi <konishi.ryusuke@gmail.com>
Cc: "Brian G ." <gissf1@gmail.com>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>

authored by

Ryusuke Konishi and committed by
Andrew Morton
2e62857f fd4e7fad

+23 -13
+2 -1
fs/nilfs2/btnode.c
··· 201 201 * Note that the current implementation does not support folio sizes larger 202 202 * than the page size. 203 203 * 204 - * Return: 0 on success, or the following negative error code on failure. 204 + * Return: 0 on success, or one of the following negative error codes on 205 + * failure: 205 206 * * %-EIO - I/O error (metadata corruption). 206 207 * * %-ENOMEM - Insufficient memory available. 207 208 */
+10 -6
fs/nilfs2/cpfile.c
··· 236 236 * stores it to the inode file given by @ifile and the nilfs root object 237 237 * given by @root. 238 238 * 239 - * Return: 0 on success, or the following negative error code on failure. 239 + * Return: 0 on success, or one of the following negative error codes on 240 + * failure: 240 241 * * %-EINVAL - Invalid checkpoint. 241 242 * * %-ENOMEM - Insufficient memory available. 242 243 * * %-EIO - I/O error (including metadata corruption). ··· 305 304 * In either case, the buffer of the block containing the checkpoint entry 306 305 * and the cpfile inode are made dirty for inclusion in the write log. 307 306 * 308 - * Return: 0 on success, or the following negative error code on failure. 307 + * Return: 0 on success, or one of the following negative error codes on 308 + * failure: 309 309 * * %-ENOMEM - Insufficient memory available. 310 310 * * %-EIO - I/O error (including metadata corruption). 311 311 * * %-EROFS - Read only filesystem ··· 375 373 * cpfile with the data given by the arguments @root, @blkinc, @ctime, and 376 374 * @minor. 377 375 * 378 - * Return: 0 on success, or the following negative error code on failure. 376 + * Return: 0 on success, or one of the following negative error codes on 377 + * failure: 379 378 * * %-ENOMEM - Insufficient memory available. 380 379 * * %-EIO - I/O error (including metadata corruption). 381 380 */ ··· 715 712 * number to continue searching. 716 713 * 717 714 * Return: Count of checkpoint info items stored in the output buffer on 718 - * success, or the following negative error code on failure. 715 + * success, or one of the following negative error codes on failure: 719 716 * * %-EINVAL - Invalid checkpoint mode. 720 717 * * %-ENOMEM - Insufficient memory available. 721 718 * * %-EIO - I/O error (including metadata corruption). ··· 740 737 * @cpfile: checkpoint file inode 741 738 * @cno: checkpoint number to delete 742 739 * 743 - * Return: 0 on success, or the following negative error code on failure. 740 + * Return: 0 on success, or one of the following negative error codes on 741 + * failure: 744 742 * * %-EBUSY - Checkpoint in use (snapshot specified). 745 743 * * %-EIO - I/O error (including metadata corruption). 746 744 * * %-ENOENT - No valid checkpoint found. ··· 1009 1005 * @cno: checkpoint number 1010 1006 * 1011 1007 * Return: 1 if the checkpoint specified by @cno is a snapshot, 0 if not, or 1012 - * the following negative error code on failure. 1008 + * one of the following negative error codes on failure: 1013 1009 * * %-EIO - I/O error (including metadata corruption). 1014 1010 * * %-ENOENT - No such checkpoint. 1015 1011 * * %-ENOMEM - Insufficient memory available.
+2 -1
fs/nilfs2/dat.c
··· 276 276 * @dat: DAT file inode 277 277 * @vblocknr: virtual block number 278 278 * 279 - * Return: 0 on success, or the following negative error code on failure. 279 + * Return: 0 on success, or one of the following negative error codes on 280 + * failure: 280 281 * * %-EINVAL - Invalid DAT entry (internal code). 281 282 * * %-EIO - I/O error (including metadata corruption). 282 283 * * %-ENOMEM - Insufficient memory available.
+2 -1
fs/nilfs2/ifile.c
··· 172 172 * @cno: number of checkpoint entry to read 173 173 * @inode_size: size of an inode 174 174 * 175 - * Return: 0 on success, or the following negative error code on failure. 175 + * Return: 0 on success, or one of the following negative error codes on 176 + * failure: 176 177 * * %-EINVAL - Invalid checkpoint. 177 178 * * %-ENOMEM - Insufficient memory available. 178 179 * * %-EIO - I/O error (including metadata corruption).
+2 -1
fs/nilfs2/ioctl.c
··· 1268 1268 * @filp: file object 1269 1269 * @argp: pointer to userspace memory that contains the volume name 1270 1270 * 1271 - * Return: 0 on success, or the following negative error code on failure. 1271 + * Return: 0 on success, or one of the following negative error codes on 1272 + * failure: 1272 1273 * * %-EFAULT - Error copying input data. 1273 1274 * * %-EINVAL - Label length exceeds record size in superblock. 1274 1275 * * %-EIO - I/O error.
+4 -2
fs/nilfs2/segment.c
··· 1122 1122 * a super root block containing this sufile change is complete, and it can 1123 1123 * be canceled with nilfs_sufile_cancel_freev() until then. 1124 1124 * 1125 - * Return: 0 on success, or the following negative error code on failure. 1125 + * Return: 0 on success, or one of the following negative error codes on 1126 + * failure: 1126 1127 * * %-EINVAL - Invalid segment number. 1127 1128 * * %-EIO - I/O error (including metadata corruption). 1128 1129 * * %-ENOMEM - Insufficient memory available. ··· 2835 2834 * This allocates a log writer object, initializes it, and starts the 2836 2835 * log writer. 2837 2836 * 2838 - * Return: 0 on success, or the following negative error code on failure. 2837 + * Return: 0 on success, or one of the following negative error codes on 2838 + * failure: 2839 2839 * * %-EINTR - Log writer thread creation failed due to interruption. 2840 2840 * * %-ENOMEM - Insufficient memory available. 2841 2841 */
+1 -1
fs/nilfs2/sufile.c
··· 850 850 * @nsi: size of suinfo array 851 851 * 852 852 * Return: Count of segment usage info items stored in the output buffer on 853 - * success, or the following negative error code on failure. 853 + * success, or one of the following negative error codes on failure: 854 854 * * %-EIO - I/O error (including metadata corruption). 855 855 * * %-ENOMEM - Insufficient memory available. 856 856 */