Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

scsi: pm8001: Fix kernel-doc warnings

Fix the following kernel-doc warnings:

drivers/scsi/pm8001/pm8001_ctl.c:900: warning: cannot understand function prototype: 'const char *const mpiStateText[] = '
drivers/scsi/pm8001/pm8001_ctl.c:930: warning: Function parameter or member 'attr' not described in 'ctl_hmi_error_show'
drivers/scsi/pm8001/pm8001_ctl.c:951: warning: Function parameter or member 'attr' not described in 'ctl_raae_count_show'
drivers/scsi/pm8001/pm8001_ctl.c:972: warning: Function parameter or member 'attr' not described in 'ctl_iop0_count_show'
drivers/scsi/pm8001/pm8001_ctl.c:993: warning: Function parameter or member 'attr' not described in 'ctl_iop1_count_show'

Link: https://lore.kernel.org/r/20211129194609.3466071-11-bvanassche@acm.org
Fixes: 4ddbea1b6f51 ("scsi: pm80xx: Add sysfs attribute to check MPI state")
Acked-by: Jack Wang <jinpu.wang@ionos.com>
Signed-off-by: Bart Van Assche <bvanassche@acm.org>
Signed-off-by: Martin K. Petersen <martin.petersen@oracle.com>

authored by

Bart Van Assche and committed by
Martin K. Petersen
d6e71a43 acad9c43

+12 -12
+12 -12
drivers/scsi/pm8001/pm8001_ctl.c
··· 889 889 static DEVICE_ATTR(update_fw, S_IRUGO|S_IWUSR|S_IWGRP, 890 890 pm8001_show_update_fw, pm8001_store_update_fw); 891 891 892 - /** 893 - * ctl_mpi_state_show - controller MPI state check 894 - * @cdev: pointer to embedded class device 895 - * @buf: the buffer returned 896 - * 897 - * A sysfs 'read-only' shost attribute. 898 - */ 899 - 900 892 static const char *const mpiStateText[] = { 901 893 "MPI is not initialized", 902 894 "MPI is successfully initialized", ··· 896 904 "MPI initialization failed with error in [31:16]" 897 905 }; 898 906 907 + /** 908 + * ctl_mpi_state_show - controller MPI state check 909 + * @cdev: pointer to embedded class device 910 + * @attr: device attribute (unused) 911 + * @buf: the buffer returned 912 + * 913 + * A sysfs 'read-only' shost attribute. 914 + */ 899 915 static ssize_t ctl_mpi_state_show(struct device *cdev, 900 916 struct device_attribute *attr, char *buf) 901 917 { ··· 920 920 /** 921 921 * ctl_hmi_error_show - controller MPI initialization fails 922 922 * @cdev: pointer to embedded class device 923 + * @attr: device attribute (unused) 923 924 * @buf: the buffer returned 924 925 * 925 926 * A sysfs 'read-only' shost attribute. 926 927 */ 927 - 928 928 static ssize_t ctl_hmi_error_show(struct device *cdev, 929 929 struct device_attribute *attr, char *buf) 930 930 { ··· 941 941 /** 942 942 * ctl_raae_count_show - controller raae count check 943 943 * @cdev: pointer to embedded class device 944 + * @attr: device attribute (unused) 944 945 * @buf: the buffer returned 945 946 * 946 947 * A sysfs 'read-only' shost attribute. 947 948 */ 948 - 949 949 static ssize_t ctl_raae_count_show(struct device *cdev, 950 950 struct device_attribute *attr, char *buf) 951 951 { ··· 962 962 /** 963 963 * ctl_iop0_count_show - controller iop0 count check 964 964 * @cdev: pointer to embedded class device 965 + * @attr: device attribute (unused) 965 966 * @buf: the buffer returned 966 967 * 967 968 * A sysfs 'read-only' shost attribute. 968 969 */ 969 - 970 970 static ssize_t ctl_iop0_count_show(struct device *cdev, 971 971 struct device_attribute *attr, char *buf) 972 972 { ··· 983 983 /** 984 984 * ctl_iop1_count_show - controller iop1 count check 985 985 * @cdev: pointer to embedded class device 986 + * @attr: device attribute (unused) 986 987 * @buf: the buffer returned 987 988 * 988 989 * A sysfs 'read-only' shost attribute. 989 990 */ 990 - 991 991 static ssize_t ctl_iop1_count_show(struct device *cdev, 992 992 struct device_attribute *attr, char *buf) 993 993 {