kernel/user_namespace.c:239: warning: Function parameter or member 'map_up' not described in 'idmap_key'

From: kernel test robot
Date: Tue Oct 17 2023 - 08:26:02 EST


Hi Randy,

FYI, the error/warning still remains.

tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head: 213f891525c222e8ed145ce1ce7ae1f47921cb9c
commit: e227db4d4f125efb1cae2f1337da85bc10b3185e userns: fix a struct's kernel-doc notation
date: 9 months ago
config: x86_64-buildonly-randconfig-001-20231012 (https://download.01.org/0day-ci/archive/20231017/202310172019.KFiYMz7T-lkp@xxxxxxxxx/config)
compiler: gcc-12 (Debian 12.2.0-14) 12.2.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20231017/202310172019.KFiYMz7T-lkp@xxxxxxxxx/reproduce)

If you fix the issue in a separate patch/commit (i.e. not just a new version of
the same patch/commit), kindly add following tags
| Reported-by: kernel test robot <lkp@xxxxxxxxx>
| Closes: https://lore.kernel.org/oe-kbuild-all/202310172019.KFiYMz7T-lkp@xxxxxxxxx/

All warnings (new ones prefixed by >>):

>> kernel/user_namespace.c:239: warning: Function parameter or member 'map_up' not described in 'idmap_key'
>> kernel/user_namespace.c:239: warning: Function parameter or member 'id' not described in 'idmap_key'
>> kernel/user_namespace.c:239: warning: Function parameter or member 'count' not described in 'idmap_key'
kernel/user_namespace.c:246: warning: Function parameter or member 'k' not described in 'cmp_map_id'
kernel/user_namespace.c:246: warning: Function parameter or member 'e' not described in 'cmp_map_id'
kernel/user_namespace.c:277: warning: Function parameter or member 'extents' not described in 'map_id_range_down_max'
kernel/user_namespace.c:277: warning: Function parameter or member 'map' not described in 'map_id_range_down_max'
kernel/user_namespace.c:277: warning: Function parameter or member 'id' not described in 'map_id_range_down_max'
kernel/user_namespace.c:277: warning: Function parameter or member 'count' not described in 'map_id_range_down_max'
kernel/user_namespace.c:295: warning: Function parameter or member 'extents' not described in 'map_id_range_down_base'
kernel/user_namespace.c:295: warning: Function parameter or member 'map' not described in 'map_id_range_down_base'
kernel/user_namespace.c:295: warning: Function parameter or member 'id' not described in 'map_id_range_down_base'
kernel/user_namespace.c:295: warning: Function parameter or member 'count' not described in 'map_id_range_down_base'
kernel/user_namespace.c:344: warning: Function parameter or member 'extents' not described in 'map_id_up_base'
kernel/user_namespace.c:344: warning: Function parameter or member 'map' not described in 'map_id_up_base'
kernel/user_namespace.c:344: warning: Function parameter or member 'id' not described in 'map_id_up_base'
kernel/user_namespace.c:364: warning: Function parameter or member 'extents' not described in 'map_id_up_max'
kernel/user_namespace.c:364: warning: Function parameter or member 'map' not described in 'map_id_up_max'
kernel/user_namespace.c:364: warning: Function parameter or member 'id' not described in 'map_id_up_max'
kernel/user_namespace.c:776: warning: Function parameter or member 'map' not described in 'insert_extent'
kernel/user_namespace.c:776: warning: Function parameter or member 'extent' not described in 'insert_extent'
kernel/user_namespace.c:844: warning: Function parameter or member 'map' not described in 'sort_idmaps'


vim +239 kernel/user_namespace.c

5c1469de7545a35 Eric W. Biederman 2010-06-13 230
6397fac4915ab30 Christian Brauner 2017-10-25 231 /**
e227db4d4f125ef Randy Dunlap 2023-01-07 232 * struct idmap_key - holds the information necessary to find an idmapping in a
6397fac4915ab30 Christian Brauner 2017-10-25 233 * sorted idmap array. It is passed to cmp_map_id() as first argument.
6397fac4915ab30 Christian Brauner 2017-10-25 234 */
6397fac4915ab30 Christian Brauner 2017-10-25 235 struct idmap_key {
6397fac4915ab30 Christian Brauner 2017-10-25 236 bool map_up; /* true -> id from kid; false -> kid from id */
6397fac4915ab30 Christian Brauner 2017-10-25 237 u32 id; /* id to find */
6397fac4915ab30 Christian Brauner 2017-10-25 238 u32 count; /* == 0 unless used with map_id_range_down() */
6397fac4915ab30 Christian Brauner 2017-10-25 @239 };
6397fac4915ab30 Christian Brauner 2017-10-25 240

:::::: The code at line 239 was first introduced by commit
:::::: 6397fac4915ab3002dc15aae751455da1a852f25 userns: bump idmap limits to 340

:::::: TO: Christian Brauner <christian.brauner@xxxxxxxxxx>
:::::: CC: Eric W. Biederman <ebiederm@xxxxxxxxxxxx>

--
0-DAY CI Kernel Test Service
https://github.com/intel/lkp-tests/wiki