[lwn:docs-next 127/127] drivers/scsi/fnic/fnic_fcs.c:299: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



tree:   git://git.lwn.net/linux-2.6 docs-next
head:   f9bbc12ccb35ac8b3fa01cec1a19cb523a7707c7
commit: f9bbc12ccb35ac8b3fa01cec1a19cb523a7707c7 [127/127] scripts: kernel-doc: improve parsing for kernel-doc comments syntax
config: x86_64-randconfig-a015-20210415 (attached as .config)
compiler: clang version 13.0.0 (https://github.com/llvm/llvm-project 6a18cc23efad410db48a3ccfc233d215de7d4cb9)
reproduce (this is a W=1 build):
        wget https://raw.githubusercontent.com/intel/lkp-tests/master/sbin/make.cross -O ~/bin/make.cross
        chmod +x ~/bin/make.cross
        # install x86_64 cross compiling tool for clang build
        # apt-get install binutils-x86-64-linux-gnu
        git remote add lwn git://git.lwn.net/linux-2.6
        git fetch --no-tags lwn docs-next
        git checkout f9bbc12ccb35ac8b3fa01cec1a19cb523a7707c7
        # save the attached .config to linux build tree
        COMPILER_INSTALL_PATH=$HOME/0day COMPILER=clang make.cross W=1 ARCH=x86_64 

If you fix the issue, kindly add following tag as appropriate
Reported-by: kernel test robot <lkp@xxxxxxxxx>

All warnings (new ones prefixed by >>):

>> drivers/scsi/fnic/fnic_fcs.c:299: warning: This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst
    * Check if the Received FIP FLOGI frame is rejected


vim +299 drivers/scsi/fnic/fnic_fcs.c

d3c995f1dcf938 Hiral Patel 2013-02-25  297  
d3c995f1dcf938 Hiral Patel 2013-02-25  298  /**
d3c995f1dcf938 Hiral Patel 2013-02-25 @299   * Check if the Received FIP FLOGI frame is rejected
d3c995f1dcf938 Hiral Patel 2013-02-25  300   * @fip: The FCoE controller that received the frame
d3c995f1dcf938 Hiral Patel 2013-02-25  301   * @skb: The received FIP frame
d3c995f1dcf938 Hiral Patel 2013-02-25  302   *
d3c995f1dcf938 Hiral Patel 2013-02-25  303   * Returns non-zero if the frame is rejected with unsupported cmd with
d3c995f1dcf938 Hiral Patel 2013-02-25  304   * insufficient resource els explanation.
d3c995f1dcf938 Hiral Patel 2013-02-25  305   */
d3c995f1dcf938 Hiral Patel 2013-02-25  306  static inline int is_fnic_fip_flogi_reject(struct fcoe_ctlr *fip,
d3c995f1dcf938 Hiral Patel 2013-02-25  307  					 struct sk_buff *skb)
d3c995f1dcf938 Hiral Patel 2013-02-25  308  {
d3c995f1dcf938 Hiral Patel 2013-02-25  309  	struct fc_lport *lport = fip->lp;
d3c995f1dcf938 Hiral Patel 2013-02-25  310  	struct fip_header *fiph;
d3c995f1dcf938 Hiral Patel 2013-02-25  311  	struct fc_frame_header *fh = NULL;
d3c995f1dcf938 Hiral Patel 2013-02-25  312  	struct fip_desc *desc;
d3c995f1dcf938 Hiral Patel 2013-02-25  313  	struct fip_encaps *els;
d3c995f1dcf938 Hiral Patel 2013-02-25  314  	u16 op;
d3c995f1dcf938 Hiral Patel 2013-02-25  315  	u8 els_op;
d3c995f1dcf938 Hiral Patel 2013-02-25  316  	u8 sub;
d3c995f1dcf938 Hiral Patel 2013-02-25  317  
d3c995f1dcf938 Hiral Patel 2013-02-25  318  	size_t rlen;
d3c995f1dcf938 Hiral Patel 2013-02-25  319  	size_t dlen = 0;
d3c995f1dcf938 Hiral Patel 2013-02-25  320  
d3c995f1dcf938 Hiral Patel 2013-02-25  321  	if (skb_linearize(skb))
d3c995f1dcf938 Hiral Patel 2013-02-25  322  		return 0;
d3c995f1dcf938 Hiral Patel 2013-02-25  323  
d3c995f1dcf938 Hiral Patel 2013-02-25  324  	if (skb->len < sizeof(*fiph))
d3c995f1dcf938 Hiral Patel 2013-02-25  325  		return 0;
d3c995f1dcf938 Hiral Patel 2013-02-25  326  
d3c995f1dcf938 Hiral Patel 2013-02-25  327  	fiph = (struct fip_header *)skb->data;
d3c995f1dcf938 Hiral Patel 2013-02-25  328  	op = ntohs(fiph->fip_op);
d3c995f1dcf938 Hiral Patel 2013-02-25  329  	sub = fiph->fip_subcode;
d3c995f1dcf938 Hiral Patel 2013-02-25  330  
d3c995f1dcf938 Hiral Patel 2013-02-25  331  	if (op != FIP_OP_LS)
d3c995f1dcf938 Hiral Patel 2013-02-25  332  		return 0;
d3c995f1dcf938 Hiral Patel 2013-02-25  333  
d3c995f1dcf938 Hiral Patel 2013-02-25  334  	if (sub != FIP_SC_REP)
d3c995f1dcf938 Hiral Patel 2013-02-25  335  		return 0;
d3c995f1dcf938 Hiral Patel 2013-02-25  336  
d3c995f1dcf938 Hiral Patel 2013-02-25  337  	rlen = ntohs(fiph->fip_dl_len) * 4;
d3c995f1dcf938 Hiral Patel 2013-02-25  338  	if (rlen + sizeof(*fiph) > skb->len)
d3c995f1dcf938 Hiral Patel 2013-02-25  339  		return 0;
d3c995f1dcf938 Hiral Patel 2013-02-25  340  
d3c995f1dcf938 Hiral Patel 2013-02-25  341  	desc = (struct fip_desc *)(fiph + 1);
d3c995f1dcf938 Hiral Patel 2013-02-25  342  	dlen = desc->fip_dlen * FIP_BPW;
d3c995f1dcf938 Hiral Patel 2013-02-25  343  
d3c995f1dcf938 Hiral Patel 2013-02-25  344  	if (desc->fip_dtype == FIP_DT_FLOGI) {
d3c995f1dcf938 Hiral Patel 2013-02-25  345  
d3c995f1dcf938 Hiral Patel 2013-02-25  346  		if (dlen < sizeof(*els) + sizeof(*fh) + 1)
d3c995f1dcf938 Hiral Patel 2013-02-25  347  			return 0;
d3c995f1dcf938 Hiral Patel 2013-02-25  348  
d3c995f1dcf938 Hiral Patel 2013-02-25  349  		els = (struct fip_encaps *)desc;
d3c995f1dcf938 Hiral Patel 2013-02-25  350  		fh = (struct fc_frame_header *)(els + 1);
d3c995f1dcf938 Hiral Patel 2013-02-25  351  
d3c995f1dcf938 Hiral Patel 2013-02-25  352  		if (!fh)
d3c995f1dcf938 Hiral Patel 2013-02-25  353  			return 0;
d3c995f1dcf938 Hiral Patel 2013-02-25  354  
d3c995f1dcf938 Hiral Patel 2013-02-25  355  		/*
d3c995f1dcf938 Hiral Patel 2013-02-25  356  		 * ELS command code, reason and explanation should be = Reject,
d3c995f1dcf938 Hiral Patel 2013-02-25  357  		 * unsupported command and insufficient resource
d3c995f1dcf938 Hiral Patel 2013-02-25  358  		 */
d3c995f1dcf938 Hiral Patel 2013-02-25  359  		els_op = *(u8 *)(fh + 1);
d3c995f1dcf938 Hiral Patel 2013-02-25  360  		if (els_op == ELS_LS_RJT) {
d3c995f1dcf938 Hiral Patel 2013-02-25  361  			shost_printk(KERN_INFO, lport->host,
d3c995f1dcf938 Hiral Patel 2013-02-25  362  				  "Flogi Request Rejected by Switch\n");
d3c995f1dcf938 Hiral Patel 2013-02-25  363  			return 1;
d3c995f1dcf938 Hiral Patel 2013-02-25  364  		}
d3c995f1dcf938 Hiral Patel 2013-02-25  365  		shost_printk(KERN_INFO, lport->host,
d3c995f1dcf938 Hiral Patel 2013-02-25  366  				"Flogi Request Accepted by Switch\n");
d3c995f1dcf938 Hiral Patel 2013-02-25  367  	}
d3c995f1dcf938 Hiral Patel 2013-02-25  368  	return 0;
d3c995f1dcf938 Hiral Patel 2013-02-25  369  }
d3c995f1dcf938 Hiral Patel 2013-02-25  370  

:::::: The code at line 299 was first introduced by commit
:::::: d3c995f1dcf938f1084388d92b8fb97bec366566 [SCSI] fnic: FIP VLAN Discovery Feature Support

:::::: TO: Hiral Patel <hiralpat@xxxxxxxxx>
:::::: CC: James Bottomley <JBottomley@xxxxxxxxxxxxx>

---
0-DAY CI Kernel Test Service, Intel Corporation
https://lists.01.org/hyperkitty/list/kbuild-all@xxxxxxxxxxxx

Attachment: .config.gz
Description: application/gzip


[Index of Archives]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Linux FS]     [Yosemite Forum]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]     [Linux Resources]

  Powered by Linux