drivers/phy/samsung/phy-exynos5-usbdrd.c:184: warning: Function parameter or member 'phys.phy' not described in 'exynos5_usbdrd_phy'

From: kernel test robot
Date: Sat Nov 11 2023 - 09:46:29 EST


tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head: 3ca112b71f35dd5d99fc4571a56b5fc6f0c15814
commit: 0b56e9a7e8358e59b21d8a425e463072bfae523c phy: Group vendor specific phy drivers
date: 6 years ago
config: arm-defconfig (https://download.01.org/0day-ci/archive/20231111/202311112233.05ft5O4Q-lkp@xxxxxxxxx/config)
compiler: arm-linux-gnueabi-gcc (GCC) 13.2.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20231111/202311112233.05ft5O4Q-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/202311112233.05ft5O4Q-lkp@xxxxxxxxx/

All warnings (new ones prefixed by >>):

drivers/phy/samsung/phy-exynos5-usbdrd.c:184: warning: Function parameter or member 'phys' not described in 'exynos5_usbdrd_phy'
>> drivers/phy/samsung/phy-exynos5-usbdrd.c:184: warning: Function parameter or member 'phys.phy' not described in 'exynos5_usbdrd_phy'
>> drivers/phy/samsung/phy-exynos5-usbdrd.c:184: warning: Function parameter or member 'phys.index' not described in 'exynos5_usbdrd_phy'
>> drivers/phy/samsung/phy-exynos5-usbdrd.c:184: warning: Function parameter or member 'phys.reg_pmu' not described in 'exynos5_usbdrd_phy'
>> drivers/phy/samsung/phy-exynos5-usbdrd.c:184: warning: Function parameter or member 'phys.pmu_offset' not described in 'exynos5_usbdrd_phy'
>> drivers/phy/samsung/phy-exynos5-usbdrd.c:184: warning: Function parameter or member 'phys.phy_cfg' not described in 'exynos5_usbdrd_phy'
drivers/phy/samsung/phy-exynos5-usbdrd.c:184: warning: Function parameter or member 'vbus' not described in 'exynos5_usbdrd_phy'
drivers/phy/samsung/phy-exynos5-usbdrd.c:184: warning: Function parameter or member 'vbus_boost' not described in 'exynos5_usbdrd_phy'


vim +184 drivers/phy/samsung/phy-exynos5-usbdrd.c

59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 146
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 147 /**
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 148 * struct exynos5_usbdrd_phy - driver data for USB 3.0 PHY
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 149 * @dev: pointer to device instance of this platform device
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 150 * @reg_phy: usb phy controller register memory base
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 151 * @clk: phy clock for register access
9bde18c1b5d2c9 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-11-21 152 * @pipeclk: clock for pipe3 phy
9bde18c1b5d2c9 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-11-21 153 * @utmiclk: clock for utmi+ phy
9bde18c1b5d2c9 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-11-21 154 * @itpclk: clock for ITP generation
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 155 * @drv_data: pointer to SoC level driver data structure
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 156 * @phys[]: array for 'EXYNOS5_DRDPHYS_NUM' number of PHY
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 157 * instances each with its 'phy' and 'phy_cfg'.
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 158 * @extrefclk: frequency select settings when using 'separate
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 159 * reference clocks' for SS and HS operations
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 160 * @ref_clk: reference clock to PHY block from which PHY's
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 161 * operational clocks are derived
a6867836db35d1 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-11-21 162 * vbus: VBUS regulator for phy
a6867836db35d1 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-11-21 163 * vbus_boost: Boost regulator for VBUS present on few Exynos boards
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 164 */
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 165 struct exynos5_usbdrd_phy {
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 166 struct device *dev;
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 167 void __iomem *reg_phy;
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 168 struct clk *clk;
9bde18c1b5d2c9 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-11-21 169 struct clk *pipeclk;
9bde18c1b5d2c9 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-11-21 170 struct clk *utmiclk;
9bde18c1b5d2c9 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-11-21 171 struct clk *itpclk;
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 172 const struct exynos5_usbdrd_phy_drvdata *drv_data;
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 173 struct phy_usb_instance {
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 174 struct phy *phy;
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 175 u32 index;
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 176 struct regmap *reg_pmu;
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 177 u32 pmu_offset;
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 178 const struct exynos5_usbdrd_phy_config *phy_cfg;
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 179 } phys[EXYNOS5_DRDPHYS_NUM];
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 180 u32 extrefclk;
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 181 struct clk *ref_clk;
4fc8a4e65fda32 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 182 struct regulator *vbus;
a6867836db35d1 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-11-21 183 struct regulator *vbus_boost;
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 @184 };
59025887fb08a8 drivers/phy/phy-exynos5-usbdrd.c Vivek Gautam 2014-05-13 185

:::::: The code at line 184 was first introduced by commit
:::::: 59025887fb08a8b913605fb20f8a62eb0bb69b36 phy: Add new Exynos5 USB 3.0 PHY driver

:::::: TO: Vivek Gautam <gautam.vivek@xxxxxxxxxxx>
:::::: CC: Kishon Vijay Abraham I <kishon@xxxxxx>

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