[android-common:android14-6.1 27/32] drivers/virt/gunyah/rsc_mgr.c:159: warning: Function parameter or member 'adev' not described in 'gh_rm'

[android-common:android14-6.1 27/32] drivers/virt/gunyah/rsc_mgr.c:159: warning: Function parameter or member 'adev' not described in 'gh_rm'

[kernel test robot]

tree:   https://android.googlesource.com/kernel/common android14-6.1
head:   b548c046c7de4c427ac5a0d5008a995d5e304f9b
commit: 1dce9d7d4deea1d677677ba5dc6e0879679e5b38 [27/32] ANDROID: gunyah: Add support for Gunyah vendor modules
config: arm64-allmodconfig (https://download.01.org/0day-ci/archive/20230926/202309261952.QTG34QLU-lkp@intel.com/config)
compiler: aarch64-linux-gcc (GCC) 13.2.0
reproduce (this is a W=1 build): (https://download.01.org/0day-ci/archive/20230926/202309261952.QTG34QLU-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@intel.com>
| Closes: https://lore.kernel.org/oe-kbuild-all/202309261952.QTG34QLU-lkp@intel.com/

All warnings (new ones prefixed by >>):

   drivers/virt/gunyah/rsc_mgr.c:159: warning: Function parameter or member 'msgq_client' not described in 'gh_rm'
>> drivers/virt/gunyah/rsc_mgr.c:159: warning: Function parameter or member 'adev' not described in 'gh_rm'
   drivers/virt/gunyah/rsc_mgr.c:166: warning: Function parameter or member 'rm_error' not described in 'gh_rm_remap_error'
   drivers/virt/gunyah/rsc_mgr.c:166: warning: Excess function parameter 'gh_error' description in 'gh_rm_remap_error'


vim +159 drivers/virt/gunyah/rsc_mgr.c

d5e8df2cc4a170 Elliot Berman           2022-08-10  123  
d5e8df2cc4a170 Elliot Berman           2022-08-10  124  /**
d5e8df2cc4a170 Elliot Berman           2022-08-10  125   * struct gh_rm - private data for communicating w/Gunyah resource manager
d5e8df2cc4a170 Elliot Berman           2022-08-10  126   * @dev: pointer to device
d5e8df2cc4a170 Elliot Berman           2022-08-10  127   * @tx_ghrsc: message queue resource to TX to RM
d5e8df2cc4a170 Elliot Berman           2022-08-10  128   * @rx_ghrsc: message queue resource to RX from RM
d5e8df2cc4a170 Elliot Berman           2022-08-10  129   * @msgq: mailbox instance of above
d5e8df2cc4a170 Elliot Berman           2022-08-10  130   * @active_rx_connection: ongoing gh_rm_connection for which we're receiving fragments
d5e8df2cc4a170 Elliot Berman           2022-08-10  131   * @last_tx_ret: return value of last mailbox tx
d5e8df2cc4a170 Elliot Berman           2022-08-10  132   * @call_xarray: xarray to allocate & lookup sequence IDs for Request/Response flows
d5e8df2cc4a170 Elliot Berman           2022-08-10  133   * @next_seq: next ID to allocate (for xa_alloc_cyclic)
d5e8df2cc4a170 Elliot Berman           2022-08-10  134   * @cache: cache for allocating Tx messages
d5e8df2cc4a170 Elliot Berman           2022-08-10  135   * @send_lock: synchronization to allow only one request to be sent at a time
d5e8df2cc4a170 Elliot Berman           2022-08-10  136   * @nh: notifier chain for clients interested in RM notification messages
f251362242ba3e Elliot Berman           2022-10-14  137   * @miscdev: /dev/gunyah
4cf9feacb7e4ba Elliot Berman           2022-12-13  138   * @irq_domain: Domain to translate Gunyah hwirqs to Linux irqs
d5e8df2cc4a170 Elliot Berman           2022-08-10  139   */
d5e8df2cc4a170 Elliot Berman           2022-08-10  140  struct gh_rm {
d5e8df2cc4a170 Elliot Berman           2022-08-10  141  	struct device *dev;
d5e8df2cc4a170 Elliot Berman           2022-08-10  142  	struct gh_resource tx_ghrsc;
d5e8df2cc4a170 Elliot Berman           2022-08-10  143  	struct gh_resource rx_ghrsc;
d5e8df2cc4a170 Elliot Berman           2022-08-10  144  	struct gh_msgq msgq;
d5e8df2cc4a170 Elliot Berman           2022-08-10  145  	struct mbox_client msgq_client;
d5e8df2cc4a170 Elliot Berman           2022-08-10  146  	struct gh_rm_connection *active_rx_connection;
d5e8df2cc4a170 Elliot Berman           2022-08-10  147  	int last_tx_ret;
d5e8df2cc4a170 Elliot Berman           2022-08-10  148  
d5e8df2cc4a170 Elliot Berman           2022-08-10  149  	struct xarray call_xarray;
d5e8df2cc4a170 Elliot Berman           2022-08-10  150  	u32 next_seq;
d5e8df2cc4a170 Elliot Berman           2022-08-10  151  
d5e8df2cc4a170 Elliot Berman           2022-08-10  152  	struct kmem_cache *cache;
d5e8df2cc4a170 Elliot Berman           2022-08-10  153  	struct mutex send_lock;
d5e8df2cc4a170 Elliot Berman           2022-08-10  154  	struct blocking_notifier_head nh;
f251362242ba3e Elliot Berman           2022-10-14  155  
1dce9d7d4deea1 Prakruthi Deepak Heragu 2023-02-27  156  	struct auxiliary_device adev;
f251362242ba3e Elliot Berman           2022-10-14  157  	struct miscdevice miscdev;
4cf9feacb7e4ba Elliot Berman           2022-12-13  158  	struct irq_domain *irq_domain;
d5e8df2cc4a170 Elliot Berman           2022-08-10 @159  };
d5e8df2cc4a170 Elliot Berman           2022-08-10  160  

:::::: The code at line 159 was first introduced by commit
:::::: d5e8df2cc4a17063dcebc67a939356ad49a665bd FROMLIST: gunyah: rsc_mgr: Add resource manager RPC core

:::::: TO: Elliot Berman <quic_eberman@quicinc.com>
:::::: CC: Aleksei Vetrov <vvvvvv@google.com>

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