mirror of
				https://github.com/torvalds/linux.git
				synced 2025-11-04 02:30:34 +02:00 
			
		
		
		
	Add a section about the requirements of the error injectable functions and the type of errors. Since this section must be read before using ALLOW_ERROR_INJECTION() macro, that section is referred from the comment of the macro too. Link: https://lkml.kernel.org/r/167081321427.387937.15475445689482551048.stgit@devnote3 Link: https://lore.kernel.org/all/20221211115218.2e6e289bb85f8cf53c11aa97@kernel.org/T/#u Signed-off-by: Masami Hiramatsu (Google) <mhiramat@kernel.org> Cc: Alexei Starovoitov <alexei.starovoitov@gmail.com> Cc: Borislav Petkov (AMD) <bp@alien8.de> Cc: Chris Mason <clm@meta.com> Cc: Christoph Hellwig <hch@infradead.org> Cc: Florent Revest <revest@chromium.org> Cc: Greg Kroah-Hartman <gregkh@linuxfoundation.org> Cc: Jonathan Corbet <corbet@lwn.net> Cc: Josh Poimboeuf <jpoimboe@redhat.com> Cc: Kees Cook <keescook@chromium.org> Cc: KP Singh <kpsingh@kernel.org> Cc: Mark Rutland <mark.rutland@arm.com> Cc: Peter Zijlstra <peterz@infradead.org> Cc: Steven Rostedt (Google) <rostedt@goodmis.org> Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
		
			
				
	
	
		
			43 lines
		
	
	
	
		
			1.3 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			43 lines
		
	
	
	
		
			1.3 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/* SPDX-License-Identifier: GPL-2.0 */
 | 
						|
#ifndef _ASM_GENERIC_ERROR_INJECTION_H
 | 
						|
#define _ASM_GENERIC_ERROR_INJECTION_H
 | 
						|
 | 
						|
#if defined(__KERNEL__) && !defined(__ASSEMBLY__)
 | 
						|
enum {
 | 
						|
	EI_ETYPE_NULL,		/* Return NULL if failure */
 | 
						|
	EI_ETYPE_ERRNO,		/* Return -ERRNO if failure */
 | 
						|
	EI_ETYPE_ERRNO_NULL,	/* Return -ERRNO or NULL if failure */
 | 
						|
	EI_ETYPE_TRUE,		/* Return true if failure */
 | 
						|
};
 | 
						|
 | 
						|
struct error_injection_entry {
 | 
						|
	unsigned long	addr;
 | 
						|
	int		etype;
 | 
						|
};
 | 
						|
 | 
						|
struct pt_regs;
 | 
						|
 | 
						|
#ifdef CONFIG_FUNCTION_ERROR_INJECTION
 | 
						|
/*
 | 
						|
 * Whitelist generating macro. Specify functions which can be error-injectable
 | 
						|
 * using this macro. If you unsure what is required for the error-injectable
 | 
						|
 * functions, please read Documentation/fault-injection/fault-injection.rst
 | 
						|
 * 'Error Injectable Functions' section.
 | 
						|
 */
 | 
						|
#define ALLOW_ERROR_INJECTION(fname, _etype)				\
 | 
						|
static struct error_injection_entry __used				\
 | 
						|
	__section("_error_injection_whitelist")				\
 | 
						|
	_eil_addr_##fname = {						\
 | 
						|
		.addr = (unsigned long)fname,				\
 | 
						|
		.etype = EI_ETYPE_##_etype,				\
 | 
						|
	}
 | 
						|
 | 
						|
void override_function_with_return(struct pt_regs *regs);
 | 
						|
#else
 | 
						|
#define ALLOW_ERROR_INJECTION(fname, _etype)
 | 
						|
 | 
						|
static inline void override_function_with_return(struct pt_regs *regs) { }
 | 
						|
#endif
 | 
						|
#endif
 | 
						|
 | 
						|
#endif /* _ASM_GENERIC_ERROR_INJECTION_H */
 |