xref: /openbmc/linux/arch/x86/kernel/cpu/mtrr/mtrr.h (revision b5d3c72829b1f2b181cd7c5b426f7deaae452045)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3  * local MTRR defines.
4  */
5 
6 #include <linux/types.h>
7 #include <linux/stddef.h>
8 
9 #define MTRR_CHANGE_MASK_FIXED     0x01
10 #define MTRR_CHANGE_MASK_VARIABLE  0x02
11 #define MTRR_CHANGE_MASK_DEFTYPE   0x04
12 
13 extern unsigned int mtrr_usage_table[MTRR_MAX_VAR_RANGES];
14 
15 struct mtrr_ops {
16 	u32	var_regs;
17 	void	(*set)(unsigned int reg, unsigned long base,
18 		       unsigned long size, mtrr_type type);
19 	void	(*get)(unsigned int reg, unsigned long *base,
20 		       unsigned long *size, mtrr_type *type);
21 	int	(*get_free_region)(unsigned long base, unsigned long size,
22 				   int replace_reg);
23 	int	(*validate_add_page)(unsigned long base, unsigned long size,
24 				     unsigned int type);
25 	int	(*have_wrcomb)(void);
26 };
27 
28 extern int generic_get_free_region(unsigned long base, unsigned long size,
29 				   int replace_reg);
30 extern int generic_validate_add_page(unsigned long base, unsigned long size,
31 				     unsigned int type);
32 
33 extern const struct mtrr_ops generic_mtrr_ops;
34 
35 extern int positive_have_wrcomb(void);
36 
37 /* library functions for processor-specific routines */
38 struct set_mtrr_context {
39 	unsigned long	flags;
40 	unsigned long	cr4val;
41 	u32		deftype_lo;
42 	u32		deftype_hi;
43 	u32		ccr3;
44 };
45 
46 void set_mtrr_done(struct set_mtrr_context *ctxt);
47 void set_mtrr_cache_disable(struct set_mtrr_context *ctxt);
48 void set_mtrr_prepare_save(struct set_mtrr_context *ctxt);
49 
50 void fill_mtrr_var_range(unsigned int index,
51 		u32 base_lo, u32 base_hi, u32 mask_lo, u32 mask_hi);
52 bool get_mtrr_state(void);
53 
54 extern const struct mtrr_ops *mtrr_if;
55 
56 extern unsigned int num_var_ranges;
57 extern u64 mtrr_tom2;
58 extern struct mtrr_state_type mtrr_state;
59 extern u32 phys_hi_rsvd;
60 
61 void mtrr_state_warn(void);
62 const char *mtrr_attrib_to_str(int x);
63 void mtrr_wrmsr(unsigned, unsigned, unsigned);
64 #ifdef CONFIG_X86_32
65 void mtrr_set_if(void);
66 void mtrr_register_syscore(void);
67 #else
68 static inline void mtrr_set_if(void) { }
69 static inline void mtrr_register_syscore(void) { }
70 #endif
71 
72 /* CPU specific mtrr_ops vectors. */
73 extern const struct mtrr_ops amd_mtrr_ops;
74 extern const struct mtrr_ops cyrix_mtrr_ops;
75 extern const struct mtrr_ops centaur_mtrr_ops;
76 
77 extern int changed_by_mtrr_cleanup;
78 extern int mtrr_cleanup(void);
79 void generic_rebuild_map(void);
80 
81 /*
82  * Must be used by code which uses mtrr_if to call platform-specific
83  * MTRR manipulation functions.
84  */
85 static inline bool mtrr_enabled(void)
86 {
87 	return !!mtrr_if;
88 }
89