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

[kernel test robot]

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