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

tty: tty_audit: Demote non-conformant kernel-doc headers

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

drivers/tty/tty_audit.c:91: warning: Function parameter or member 'buf' not described in 'tty_audit_buf_push'
drivers/tty/tty_audit.c:129: warning: Function parameter or member 'sig' not described in 'tty_audit_fork'
drivers/tty/tty_audit.c:137: warning: Function parameter or member 'tty' not described in 'tty_audit_tiocsti'
drivers/tty/tty_audit.c:137: warning: Function parameter or member 'ch' not described in 'tty_audit_tiocsti'
drivers/tty/tty_audit.c:202: warning: Function parameter or member 'tty' not described in 'tty_audit_add_data'
drivers/tty/tty_audit.c:202: warning: Function parameter or member 'data' not described in 'tty_audit_add_data'
drivers/tty/tty_audit.c:202: warning: Function parameter or member 'size' not described in 'tty_audit_add_data'

Cc: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
Cc: Jiri Slaby <jirislaby@kernel.org>
Cc: Miloslav Trmac <mitr@redhat.com>
Signed-off-by: Lee Jones <lee.jones@linaro.org>
Link: https://lore.kernel.org/r/20201104193549.4026187-16-lee.jones@linaro.org
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>

authored by

Lee Jones and committed by
Greg Kroah-Hartman
ffb5d9cf 32ed2480

+6 -6
+6 -6
drivers/tty/tty_audit.c
··· 81 81 } 82 82 } 83 83 84 - /** 84 + /* 85 85 * tty_audit_buf_push - Push buffered data out 86 86 * 87 87 * Generate an audit message from the contents of @buf, which is owned by ··· 120 120 tty_audit_buf_free(buf); 121 121 } 122 122 123 - /** 123 + /* 124 124 * tty_audit_fork - Copy TTY audit state for a new task 125 125 * 126 126 * Set up TTY audit state in @sig from current. @sig needs no locking. ··· 130 130 sig->audit_tty = current->signal->audit_tty; 131 131 } 132 132 133 - /** 133 + /* 134 134 * tty_audit_tiocsti - Log TIOCSTI 135 135 */ 136 136 void tty_audit_tiocsti(struct tty_struct *tty, char ch) ··· 145 145 tty_audit_log("ioctl=TIOCSTI", dev, &ch, 1); 146 146 } 147 147 148 - /** 148 + /* 149 149 * tty_audit_push - Flush current's pending audit data 150 150 * 151 151 * Returns 0 if success, -EPERM if tty audit is disabled ··· 166 166 return 0; 167 167 } 168 168 169 - /** 169 + /* 170 170 * tty_audit_buf_get - Get an audit buffer. 171 171 * 172 172 * Get an audit buffer, allocate it if necessary. Return %NULL ··· 193 193 return tty_audit_buf_ref(); 194 194 } 195 195 196 - /** 196 + /* 197 197 * tty_audit_add_data - Add data for TTY auditing. 198 198 * 199 199 * Audit @data of @size from @tty, if necessary.