Commit e3903d31 authored Jul 23, 2020 by Lee Jones Committed by Martin K. Petersen Jul 24, 2020

scsi: esas2r: Demote a few non-conformant kerneldoc headers

Fixes the following W=1 kernel build warning(s):

drivers/scsi/esas2r/esas2r_log.c:86: warning: Function parameter or member 'level' not described in 'translate_esas2r_event_level_to_kernel'
drivers/scsi/esas2r/esas2r_log.c:120: warning: Function parameter or member 'level' not described in 'esas2r_log_master'
drivers/scsi/esas2r/esas2r_log.c:120: warning: Function parameter or member 'dev' not described in 'esas2r_log_master'
drivers/scsi/esas2r/esas2r_log.c:120: warning: Function parameter or member 'format' not described in 'esas2r_log_master'
drivers/scsi/esas2r/esas2r_log.c:120: warning: Function parameter or member 'args' not described in 'esas2r_log_master'
drivers/scsi/esas2r/esas2r_log.c:183: warning: Function parameter or member 'level' not described in 'esas2r_log'
drivers/scsi/esas2r/esas2r_log.c:183: warning: Function parameter or member 'format' not described in 'esas2r_log'
drivers/scsi/esas2r/esas2r_log.c:211: warning: Function parameter or member 'level' not described in 'esas2r_log_dev'
drivers/scsi/esas2r/esas2r_log.c:211: warning: Function parameter or member 'dev' not described in 'esas2r_log_dev'
drivers/scsi/esas2r/esas2r_log.c:211: warning: Function parameter or member 'format' not described in 'esas2r_log_dev'
drivers/scsi/esas2r/esas2r_log.c:237: warning: Function parameter or member 'level' not described in 'esas2r_log_hexdump'
drivers/scsi/esas2r/esas2r_log.c:237: warning: Function parameter or member 'buf' not described in 'esas2r_log_hexdump'
drivers/scsi/esas2r/esas2r_log.c:237: warning: Function parameter or member 'len' not described in 'esas2r_log_hexdump'

Link: https://lore.kernel.org/r/20200723122446.1329773-41-lee.jones@linaro.org

Cc: Bradley Grove <linuxdrivers@attotech.com>
Signed-off-by: Lee Jones <lee.jones@linaro.org>
Signed-off-by: Martin K. Petersen <martin.petersen@oracle.com>

parent a8b6d0ee

drivers/scsi/esas2r/esas2r_log.c

+5 −5

Original line number	Diff line number	Diff line
		@@ -75,7 +75,7 @@ static char event_buffer[EVENT_LOG_BUFF_SIZE];
		/* A lock to protect the shared buffer used for formatting messages. */
		static DEFINE_SPINLOCK(event_buffer_lock);

		/**
		/*
		* translates an esas2r-defined logging event level to a kernel logging level.
		*
		* @param [in] level the esas2r-defined logging event level to translate
		@@ -101,7 +101,7 @@ static const char *translate_esas2r_event_level_to_kernel(const long level)
		}
		}

		/**
		/*
		* the master logging function. this function will format the message as
		* outlined by the formatting string, the input device information and the
		* substitution arguments and output the resulting string to the system log.
		@@ -170,7 +170,7 @@ static int esas2r_log_master(const long level,
		return 0;
		}

		/**
		/*
		* formats and logs a message to the system log.
		*
		* @param [in] level the event level of the message
		@@ -193,7 +193,7 @@ int esas2r_log(const long level, const char *format, ...)
		return retval;
		}

		/**
		/*
		* formats and logs a message to the system log. this message will include
		* device information.
		*
		@@ -221,7 +221,7 @@ int esas2r_log_dev(const long level,
		return retval;
		}

		/**
		/*
		* formats and logs a message to the system log. this message will include
		* device information.
		*

Admin message