linux-kernel - drivers/leds/leds-lm3692x.c:121: warning: Function parameter or struct member 'brightness_ctrl' not described in 'lm3692x

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [day] [month] [year] [list]

Message-ID: <202412220226.Dfmc2u0x-lkp@intel.com>
Date: Sun, 22 Dec 2024 02:45:56 +0800
From: kernel test robot <lkp@...el.com>
To: Guido Günther <agx@...xcpu.org>
Cc: oe-kbuild-all@...ts.linux.dev, linux-kernel@...r.kernel.org,
	Pavel <pavel@....cz>
Subject: drivers/leds/leds-lm3692x.c:121: warning: Function parameter or
 struct member 'brightness_ctrl' not described in 'lm3692x_led'

tree:   https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head:   499551201b5f4fd3c0618a3e95e3d0d15ea18f31
commit: 260718b3a35d23fe89d27cc7b5e8bd30f4bba1aa leds: lm3692x: Disable chip on brightness 0
date:   5 years ago
config: s390-randconfig-002-20241220 (https://download.01.org/0day-ci/archive/20241222/202412220226.Dfmc2u0x-lkp@intel.com/config)
compiler: s390-linux-gcc (GCC) 14.2.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20241222/202412220226.Dfmc2u0x-lkp@intel.com/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@...el.com>
| Closes: https://lore.kernel.org/oe-kbuild-all/202412220226.Dfmc2u0x-lkp@intel.com/

All warnings (new ones prefixed by >>):

   drivers/leds/leds-lm3692x.c:121: warning: Function parameter or struct member 'lock' not described in 'lm3692x_led'
   drivers/leds/leds-lm3692x.c:121: warning: Function parameter or struct member 'client' not described in 'lm3692x_led'
   drivers/leds/leds-lm3692x.c:121: warning: Function parameter or struct member 'led_dev' not described in 'lm3692x_led'
   drivers/leds/leds-lm3692x.c:121: warning: Function parameter or struct member 'regmap' not described in 'lm3692x_led'
   drivers/leds/leds-lm3692x.c:121: warning: Function parameter or struct member 'enable_gpio' not described in 'lm3692x_led'
   drivers/leds/leds-lm3692x.c:121: warning: Function parameter or struct member 'regulator' not described in 'lm3692x_led'
   drivers/leds/leds-lm3692x.c:121: warning: Function parameter or struct member 'led_enable' not described in 'lm3692x_led'
   drivers/leds/leds-lm3692x.c:121: warning: Function parameter or struct member 'model_id' not described in 'lm3692x_led'
   drivers/leds/leds-lm3692x.c:121: warning: Function parameter or struct member 'boost_ctrl' not described in 'lm3692x_led'
>> drivers/leds/leds-lm3692x.c:121: warning: Function parameter or struct member 'brightness_ctrl' not described in 'lm3692x_led'
>> drivers/leds/leds-lm3692x.c:121: warning: Function parameter or struct member 'enabled' not described in 'lm3692x_led'


vim +121 drivers/leds/leds-lm3692x.c

9699cb6bbef273 Dan Murphy    2017-12-12   97  
9699cb6bbef273 Dan Murphy    2017-12-12   98  /**
9699cb6bbef273 Dan Murphy    2017-12-12   99   * struct lm3692x_led -
9699cb6bbef273 Dan Murphy    2017-12-12  100   * @lock - Lock for reading/writing the device
9699cb6bbef273 Dan Murphy    2017-12-12  101   * @client - Pointer to the I2C client
9699cb6bbef273 Dan Murphy    2017-12-12  102   * @led_dev - LED class device pointer
9699cb6bbef273 Dan Murphy    2017-12-12  103   * @regmap - Devices register map
9699cb6bbef273 Dan Murphy    2017-12-12  104   * @enable_gpio - VDDIO/EN gpio to enable communication interface
9699cb6bbef273 Dan Murphy    2017-12-12  105   * @regulator - LED supply regulator pointer
07abd4325e7013 Dan Murphy    2018-07-02  106   * @led_enable - LED sync to be enabled
07abd4325e7013 Dan Murphy    2018-07-02  107   * @model_id - Current device model ID enumerated
9699cb6bbef273 Dan Murphy    2017-12-12  108   */
9699cb6bbef273 Dan Murphy    2017-12-12  109  struct lm3692x_led {
9699cb6bbef273 Dan Murphy    2017-12-12  110  	struct mutex lock;
9699cb6bbef273 Dan Murphy    2017-12-12  111  	struct i2c_client *client;
9699cb6bbef273 Dan Murphy    2017-12-12  112  	struct led_classdev led_dev;
9699cb6bbef273 Dan Murphy    2017-12-12  113  	struct regmap *regmap;
9699cb6bbef273 Dan Murphy    2017-12-12  114  	struct gpio_desc *enable_gpio;
9699cb6bbef273 Dan Murphy    2017-12-12  115  	struct regulator *regulator;
07abd4325e7013 Dan Murphy    2018-07-02  116  	int led_enable;
07abd4325e7013 Dan Murphy    2018-07-02  117  	int model_id;
cffd61a5c77555 Guido Günther 2020-01-04  118  
260718b3a35d23 Guido Günther 2020-01-06  119  	u8 boost_ctrl, brightness_ctrl;
260718b3a35d23 Guido Günther 2020-01-06  120  	bool enabled;
9699cb6bbef273 Dan Murphy    2017-12-12 @121  };
9699cb6bbef273 Dan Murphy    2017-12-12  122  

:::::: The code at line 121 was first introduced by commit
:::::: 9699cb6bbef273d7be25441bfc20a2db9ee0f509 leds: lm3692x: Introduce LM3692x dual string driver

:::::: TO: Dan Murphy <dmurphy@...com>
:::::: CC: Jacek Anaszewski <jacek.anaszewski@...il.com>

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