drivers/clk/renesas/r9a06g032-clocks.c:119: warning: Function parameter or member 'dual' not described in 'r9a06g032_clkdesc'
From: kernel test robot
Date: Sun Sep 10 2023 - 02:11:55 EST
tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head: 535a265d7f0dd50d8c3a4f8b4f3a452d56bd160f
commit: 5a5ca2c758c200663fdf5c04f71796a8f300151a clk: renesas: r9a06g032: Document structs
date: 6 months ago
config: m68k-allyesconfig (https://download.01.org/0day-ci/archive/20230910/202309101314.kTRoxND5-lkp@xxxxxxxxx/config)
compiler: m68k-linux-gcc (GCC) 13.2.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20230910/202309101314.kTRoxND5-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/202309101314.kTRoxND5-lkp@xxxxxxxxx/
All warnings (new ones prefixed by >>):
>> drivers/clk/renesas/r9a06g032-clocks.c:119: warning: Function parameter or member 'dual' not described in 'r9a06g032_clkdesc'
vim +119 drivers/clk/renesas/r9a06g032-clocks.c
a1aae0a6b122300 Ralph Siemsen 2023-03-01 66
5a5ca2c758c2006 Ralph Siemsen 2023-03-01 67 /**
5a5ca2c758c2006 Ralph Siemsen 2023-03-01 68 * struct r9a06g032_clkdesc - describe a single clock
5a5ca2c758c2006 Ralph Siemsen 2023-03-01 69 * @name: string describing this clock
5a5ca2c758c2006 Ralph Siemsen 2023-03-01 70 * @managed: boolean indicating if this clock should be
5a5ca2c758c2006 Ralph Siemsen 2023-03-01 71 * started/stopped as part of power management
5a5ca2c758c2006 Ralph Siemsen 2023-03-01 72 * @type: see enum @gate_type
5a5ca2c758c2006 Ralph Siemsen 2023-03-01 73 * @index: the ID of this clock element
5a5ca2c758c2006 Ralph Siemsen 2023-03-01 74 * @source: the ID+1 of the parent clock element.
5a5ca2c758c2006 Ralph Siemsen 2023-03-01 75 * Root clock uses ID of ~0 (PARENT_ID);
5a5ca2c758c2006 Ralph Siemsen 2023-03-01 76 * @gate: clock enable/disable
5a5ca2c758c2006 Ralph Siemsen 2023-03-01 77 * @div_min: smallest permitted clock divider
5a5ca2c758c2006 Ralph Siemsen 2023-03-01 78 * @div_max: largest permitted clock divider
5a5ca2c758c2006 Ralph Siemsen 2023-03-01 79 * @reg: clock divider register offset, in 32-bit words
5a5ca2c758c2006 Ralph Siemsen 2023-03-01 80 * @div_table: optional list of fixed clock divider values;
5a5ca2c758c2006 Ralph Siemsen 2023-03-01 81 * must be in ascending order, zero for unused
5a5ca2c758c2006 Ralph Siemsen 2023-03-01 82 * @div: divisor for fixed-factor clock
5a5ca2c758c2006 Ralph Siemsen 2023-03-01 83 * @mul: multiplier for fixed-factor clock
5a5ca2c758c2006 Ralph Siemsen 2023-03-01 84 * @group: UART group, 0=UART0/1/2, 1=UART3/4/5/6/7
5a5ca2c758c2006 Ralph Siemsen 2023-03-01 85 * @sel: select either g1/r1 or g2/r2 as clock source
5a5ca2c758c2006 Ralph Siemsen 2023-03-01 86 * @g1: 1st source gate (clock enable/disable)
5a5ca2c758c2006 Ralph Siemsen 2023-03-01 87 * @r1: 1st source reset (module reset)
5a5ca2c758c2006 Ralph Siemsen 2023-03-01 88 * @g2: 2nd source gate (clock enable/disable)
5a5ca2c758c2006 Ralph Siemsen 2023-03-01 89 * @r2: 2nd source reset (module reset)
5a5ca2c758c2006 Ralph Siemsen 2023-03-01 90 *
5a5ca2c758c2006 Ralph Siemsen 2023-03-01 91 * Describes a single element in the clock tree hierarchy.
5a5ca2c758c2006 Ralph Siemsen 2023-03-01 92 * As there are quite a large number of clock elements, this
5a5ca2c758c2006 Ralph Siemsen 2023-03-01 93 * structure is packed tightly to conserve space.
5a5ca2c758c2006 Ralph Siemsen 2023-03-01 94 */
4c3d88526eba214 Michel Pollet 2018-06-14 95 struct r9a06g032_clkdesc {
4c3d88526eba214 Michel Pollet 2018-06-14 96 const char *name;
aad03a66f902e18 Gareth Williams 2019-05-28 97 uint32_t managed:1;
a1aae0a6b122300 Ralph Siemsen 2023-03-01 98 enum gate_type type:3;
4c3d88526eba214 Michel Pollet 2018-06-14 99 uint32_t index:8;
4c3d88526eba214 Michel Pollet 2018-06-14 100 uint32_t source:8; /* source index + 1 (0 == none) */
4c3d88526eba214 Michel Pollet 2018-06-14 101 union {
a1aae0a6b122300 Ralph Siemsen 2023-03-01 102 /* type = K_GATE */
4c3d88526eba214 Michel Pollet 2018-06-14 103 struct r9a06g032_gate gate;
a1aae0a6b122300 Ralph Siemsen 2023-03-01 104 /* type = K_DIV */
4c3d88526eba214 Michel Pollet 2018-06-14 105 struct {
4c3d88526eba214 Michel Pollet 2018-06-14 106 unsigned int div_min:10, div_max:10, reg:10;
4c3d88526eba214 Michel Pollet 2018-06-14 107 u16 div_table[4];
4c3d88526eba214 Michel Pollet 2018-06-14 108 };
a1aae0a6b122300 Ralph Siemsen 2023-03-01 109 /* type = K_FFC */
4c3d88526eba214 Michel Pollet 2018-06-14 110 struct {
4c3d88526eba214 Michel Pollet 2018-06-14 111 u16 div, mul;
4c3d88526eba214 Michel Pollet 2018-06-14 112 };
a1aae0a6b122300 Ralph Siemsen 2023-03-01 113 /* type = K_DUALGATE */
4c3d88526eba214 Michel Pollet 2018-06-14 114 struct {
f46efcc4746f5c1 Ralph Siemsen 2022-05-18 115 uint16_t group:1;
4c3d88526eba214 Michel Pollet 2018-06-14 116 u16 sel, g1, r1, g2, r2;
4c3d88526eba214 Michel Pollet 2018-06-14 117 } dual;
4c3d88526eba214 Michel Pollet 2018-06-14 118 };
ceabbf94c317c61 Geert Uytterhoeven 2020-11-30 @119 };
4c3d88526eba214 Michel Pollet 2018-06-14 120
:::::: The code at line 119 was first introduced by commit
:::::: ceabbf94c317c6175dee6e91805fca4a6353745a clk: renesas: r9a06g032: Drop __packed for portability
:::::: TO: Geert Uytterhoeven <geert+renesas@xxxxxxxxx>
:::::: CC: Stephen Boyd <sboyd@xxxxxxxxxx>
--
0-DAY CI Kernel Test Service
https://github.com/intel/lkp-tests/wiki