• Randy Dunlap's avatar
    scsi: libfcoe: Fix a slew of kernel-doc warnings · d9c91182
    Randy Dunlap authored
    Fix all kernel-doc warnings in <scsi/libfcoe.h>:
    
    libfcoe.h:163: warning: Function parameter or struct member 'ctlr' not described in 'fcoe_ctlr_priv'
    libfcoe.h:163: warning: Excess function parameter 'cltr' description in 'fcoe_ctlr_priv'
    libfcoe.h:163: warning: No description found for return value of 'fcoe_ctlr_priv'
    libfcoe.h:218: warning: Function parameter or struct member 'fd_flags' not described in 'fcoe_fcf'
    libfcoe.h:218: warning: Excess struct member 'event' description in 'fcoe_fcf'
    libfcoe.h:240: warning: Function parameter or struct member 'rdata' not described in 'fcoe_rport'
    libfcoe.h:273: warning: No description found for return value of 'is_fip_mode'
    libfcoe.h:332: warning: Function parameter or struct member 'crc_eof_page' not described in 'fcoe_percpu_s'
    libfcoe.h:332: warning: Function parameter or struct member 'lock' not described in 'fcoe_percpu_s'
    libfcoe.h:332: warning: Excess struct member 'page' description in 'fcoe_percpu_s'
    libfcoe.h:362: warning: Function parameter or struct member 'data_src_addr' not described in 'fcoe_port'
    libfcoe.h:362: warning: Function parameter or struct member 'get_netdev' not described in 'fcoe_port'
    libfcoe.h:362: warning: Excess struct member 'data_srt_addr' description in 'fcoe_port'
    libfcoe.h:369: warning: No description found for return value of 'fcoe_get_netdev'
    libfcoe.h:386: warning: missing initial short description on line:
     * struct netdev_list
    libfcoe.h:393: warning: expecting prototype for struct netdev_list. Prototype was for struct fcoe_netdev_mapping instead
    Signed-off-by: default avatarRandy Dunlap <rdunlap@infradead.org>
    Link: https://lore.kernel.org/r/20240408025425.18778-6-rdunlap@infradead.orgSigned-off-by: default avatarMartin K. Petersen <martin.petersen@oracle.com>
    d9c91182
libfcoe.h 13.8 KB