tjh.dev / kernel
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: describe the members of nilfs_bmap_operations structure

Add missing member variable descriptions in the kernel-doc comments for
the nilfs_bmap_operations structure, hiding the internal operations with
the "private:" tag. This eliminates the following warnings output by the
kernel-doc script:

fs/nilfs2/bmap.h:74: warning: Function parameter or struct member
'bop_lookup' not described in 'nilfs_bmap_operations'
fs/nilfs2/bmap.h:74: warning: Function parameter or struct member
'bop_lookup_contig' not described in 'nilfs_bmap_operations'
...
fs/nilfs2/bmap.h:74: warning: Function parameter or struct member
'bop_gather_data' not described in 'nilfs_bmap_operations'

Link: https://lkml.kernel.org/r/20240816074319.3253-7-konishi.ryusuke@gmail.com
Signed-off-by: Ryusuke Konishi <konishi.ryusuke@gmail.com>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>

authored by

Ryusuke Konishi and committed by
Andrew Morton d9e5551e 0e13ddee

+14 -1
+14 -1
fs/nilfs2/bmap.h
··· 44 44 45 45 /** 46 46 * struct nilfs_bmap_operations - bmap operation table 47 + * @bop_lookup: single block search operation 48 + * @bop_lookup_contig: consecutive block search operation 49 + * @bop_insert: block insertion operation 50 + * @bop_delete: block delete operation 51 + * @bop_clear: block mapping resource release operation 52 + * @bop_propagate: operation to propagate dirty state towards the 53 + * mapping root 54 + * @bop_lookup_dirty_buffers: operation to collect dirty block buffers 55 + * @bop_assign: disk block address assignment operation 56 + * @bop_mark: operation to mark in-use blocks as dirty for 57 + * relocation by GC 58 + * @bop_seek_key: find valid block key operation 59 + * @bop_last_key: find last valid block key operation 47 60 */ 48 61 struct nilfs_bmap_operations { 49 62 int (*bop_lookup)(const struct nilfs_bmap *, __u64, int, __u64 *); ··· 79 66 int (*bop_seek_key)(const struct nilfs_bmap *, __u64, __u64 *); 80 67 int (*bop_last_key)(const struct nilfs_bmap *, __u64 *); 81 68 82 - /* The following functions are internal use only. */ 69 + /* private: internal use only */ 83 70 int (*bop_check_insert)(const struct nilfs_bmap *, __u64); 84 71 int (*bop_check_delete)(struct nilfs_bmap *, __u64); 85 72 int (*bop_gather_data)(struct nilfs_bmap *, __u64 *, __u64 *, int);