drivers/rpmsg/rpmsg_char.c:75: warning: Function parameter or member 'remote_flow_restricted' not described in 'rpmsg_eptdev'

From: kernel test robot
Date: Sat Jan 06 2024 - 09:32:07 EST


Hi Chris,

FYI, the error/warning still remains.

tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git master
head: 95c8a35f1c017327eab3b6a2ff5c04255737c856
commit: 5550201c0fe26a76c53983bd36a58d4c4395ec22 rpmsg: char: Add RPMSG GET/SET FLOWCONTROL IOCTL support
date: 6 months ago
config: x86_64-buildonly-randconfig-001-20240105 (https://download.01.org/0day-ci/archive/20240106/202401062227.o7hS4CFl-lkp@xxxxxxxxx/config)
compiler: ClangBuiltLinux clang version 17.0.6 (https://github.com/llvm/llvm-project 6009708b4367171ccdbf4b5905cb6a803753fe18)
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20240106/202401062227.o7hS4CFl-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/202401062227.o7hS4CFl-lkp@xxxxxxxxx/

All warnings (new ones prefixed by >>):

>> drivers/rpmsg/rpmsg_char.c:75: warning: Function parameter or member 'remote_flow_restricted' not described in 'rpmsg_eptdev'
>> drivers/rpmsg/rpmsg_char.c:75: warning: Function parameter or member 'remote_flow_updated' not described in 'rpmsg_eptdev'


vim +75 drivers/rpmsg/rpmsg_char.c

c0cdc19f84a471 Bjorn Andersson 2017-01-11 41
c0cdc19f84a471 Bjorn Andersson 2017-01-11 42 /**
c0cdc19f84a471 Bjorn Andersson 2017-01-11 43 * struct rpmsg_eptdev - endpoint device context
c0cdc19f84a471 Bjorn Andersson 2017-01-11 44 * @dev: endpoint device
c0cdc19f84a471 Bjorn Andersson 2017-01-11 45 * @cdev: cdev for the endpoint device
c0cdc19f84a471 Bjorn Andersson 2017-01-11 46 * @rpdev: underlaying rpmsg device
c0cdc19f84a471 Bjorn Andersson 2017-01-11 47 * @chinfo: info used to open the endpoint
c0cdc19f84a471 Bjorn Andersson 2017-01-11 48 * @ept_lock: synchronization of @ept modifications
c0cdc19f84a471 Bjorn Andersson 2017-01-11 49 * @ept: rpmsg endpoint reference, when open
c0cdc19f84a471 Bjorn Andersson 2017-01-11 50 * @queue_lock: synchronization of @queue operations
c0cdc19f84a471 Bjorn Andersson 2017-01-11 51 * @queue: incoming message queue
c0cdc19f84a471 Bjorn Andersson 2017-01-11 52 * @readq: wait object for incoming queue
bea9b79c2d10fe Arnaud Pouliquen 2022-01-24 53 * @default_ept: set to channel default endpoint if the default endpoint should be re-used
bea9b79c2d10fe Arnaud Pouliquen 2022-01-24 54 * on device open to prevent endpoint address update.
5550201c0fe26a Chris Lew 2023-07-07 55 * remote_flow_restricted: to indicate if the remote has requested for flow to be limited
5550201c0fe26a Chris Lew 2023-07-07 56 * remote_flow_updated: to indicate if the flow control has been requested
c0cdc19f84a471 Bjorn Andersson 2017-01-11 57 */
c0cdc19f84a471 Bjorn Andersson 2017-01-11 58 struct rpmsg_eptdev {
c0cdc19f84a471 Bjorn Andersson 2017-01-11 59 struct device dev;
c0cdc19f84a471 Bjorn Andersson 2017-01-11 60 struct cdev cdev;
c0cdc19f84a471 Bjorn Andersson 2017-01-11 61
c0cdc19f84a471 Bjorn Andersson 2017-01-11 62 struct rpmsg_device *rpdev;
c0cdc19f84a471 Bjorn Andersson 2017-01-11 63 struct rpmsg_channel_info chinfo;
c0cdc19f84a471 Bjorn Andersson 2017-01-11 64
c0cdc19f84a471 Bjorn Andersson 2017-01-11 65 struct mutex ept_lock;
c0cdc19f84a471 Bjorn Andersson 2017-01-11 66 struct rpmsg_endpoint *ept;
bea9b79c2d10fe Arnaud Pouliquen 2022-01-24 67 struct rpmsg_endpoint *default_ept;
c0cdc19f84a471 Bjorn Andersson 2017-01-11 68
c0cdc19f84a471 Bjorn Andersson 2017-01-11 69 spinlock_t queue_lock;
c0cdc19f84a471 Bjorn Andersson 2017-01-11 70 struct sk_buff_head queue;
c0cdc19f84a471 Bjorn Andersson 2017-01-11 71 wait_queue_head_t readq;
bea9b79c2d10fe Arnaud Pouliquen 2022-01-24 72
5550201c0fe26a Chris Lew 2023-07-07 73 bool remote_flow_restricted;
5550201c0fe26a Chris Lew 2023-07-07 74 bool remote_flow_updated;
c0cdc19f84a471 Bjorn Andersson 2017-01-11 @75 };
c0cdc19f84a471 Bjorn Andersson 2017-01-11 76

:::::: The code at line 75 was first introduced by commit
:::::: c0cdc19f84a4712cf74888f83af286e3c2e14efd rpmsg: Driver for user space endpoint interface

:::::: TO: Bjorn Andersson <bjorn.andersson@xxxxxxxxxx>
:::::: CC: Bjorn Andersson <bjorn.andersson@xxxxxxxxxx>

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