microsoft
/
WSL2-Linux-Kernel
зеркало из https://github.com/microsoft/WSL2-Linux-Kernel.git
1
0
Форкнуть 0
Код Задачи Пакеты Проекты Релизы Вики Активность

x86: convert mtrr/generic.c to kernel-doc 

Convert function comment blocks to kernel-doc notation.

Signed-off-by: Randy Dunlap <randy.dunlap@oracle.com>
Signed-off-by: Ingo Molnar <mingo@elte.hu>
Signed-off-by: Thomas Gleixner <tglx@linutronix.de>
This commit is contained in:
Randy Dunlap 2008-03-13 16:59:12 -07:00 коммит произвёл Ingo Molnar
Родитель c0c20fb5a8
Коммит 1d3381ebf4
1 изменённых файлов: 23 добавлений и 19 удалений
Показать статистику Скачать Patch файл Скачать Diff файл Показать все файлы Свернуть все файлы

42
arch/x86/kernel/cpu/mtrr/generic.c
Просмотреть файл

@ -176,12 +176,13 @@ static inline void k8_enable_fixed_iorrs(void)
} }
/** /**
* Checks and updates an fixed-range MTRR if it differs from the value it * set_fixed_range - checks & updates a fixed-range MTRR if it differs from the value it should have
* should have. If K8 extentions are wanted, update the K8 SYSCFG MSR also. * @msr: MSR address of the MTTR which should be checked and updated
* see AMD publication no. 24593, chapter 7.8.1, page 233 for more information * @changed: pointer which indicates whether the MTRR needed to be changed
* \param msr MSR address of the MTTR which should be checked and updated * @msrwords: pointer to the MSR values which the MSR should have
* \param changed pointer which indicates whether the MTRR needed to be changed *
* \param msrwords pointer to the MSR values which the MSR should have * If K8 extentions are wanted, update the K8 SYSCFG MSR also.
* See AMD publication no. 24593, chapter 7.8.1, page 233 for more information.
*/ */
static void set_fixed_range(int msr, bool *changed, unsigned int *msrwords) static void set_fixed_range(int msr, bool *changed, unsigned int *msrwords)
{ {
@ -199,12 +200,15 @@ static void set_fixed_range(int msr, bool *changed, unsigned int *msrwords)
} }
} }
/**
* generic_get_free_region - Get a free MTRR.
* @base: The starting (base) address of the region.
* @size: The size (in bytes) of the region.
* @replace_reg: mtrr index to be replaced; set to invalid value if none.
*
* Returns: The index of the region on success, else negative on error.
*/
int generic_get_free_region(unsigned long base, unsigned long size, int replace_reg) int generic_get_free_region(unsigned long base, unsigned long size, int replace_reg)
/* [SUMMARY] Get a free MTRR.
<base> The starting (base) address of the region.
<size> The size (in bytes) of the region.
[RETURNS] The index of the region on success, else -1 on error.
*/
{ {
int i, max; int i, max;
mtrr_type ltype; mtrr_type ltype;
@ -249,8 +253,8 @@ static void generic_get_mtrr(unsigned int reg, unsigned long *base,
} }
/** /**
* Checks and updates the fixed-range MTRRs if they differ from the saved set * set_fixed_ranges - checks & updates the fixed-range MTRRs if they differ from the saved set
* \param frs pointer to fixed-range MTRR values, saved by get_fixed_ranges() * @frs: pointer to fixed-range MTRR values, saved by get_fixed_ranges()
*/ */
static int set_fixed_ranges(mtrr_type * frs) static int set_fixed_ranges(mtrr_type * frs)
{ {
@ -294,13 +298,13 @@ static bool set_mtrr_var_ranges(unsigned int index, struct mtrr_var_range *vr)
static u32 deftype_lo, deftype_hi; static u32 deftype_lo, deftype_hi;
/**
* set_mtrr_state - Set the MTRR state for this CPU.
*
* NOTE: The CPU must already be in a safe state for MTRR changes.
* RETURNS: 0 if no changes made, else a mask indicating what was changed.
*/
static unsigned long set_mtrr_state(void) static unsigned long set_mtrr_state(void)
/* [SUMMARY] Set the MTRR state for this CPU.
<state> The MTRR state information to read.
<ctxt> Some relevant CPU context.
[NOTE] The CPU must already be in a safe state for MTRR changes.
[RETURNS] 0 if no changes made, else a mask indication what was changed.
*/
{ {
unsigned int i; unsigned int i;
unsigned long change_mask = 0; unsigned long change_mask = 0;