Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit b1ce45e8 authored by Qian Cai's avatar Qian Cai Committed by Will Deacon
Browse files

arm64/mm: fix kernel-doc comments 



Building a kernel with W=1 generates several warnings due to abuse of
kernel-doc comments:

  | arch/arm64/mm/numa.c:281: warning: Cannot understand  *
  |   on line 281 - I thought it was a doc line

Tidy up the comments to remove the warnings.

Fixes: 1a2db300 ("arm64, numa: Add NUMA support for arm64 platforms.")
Signed-off-by: default avatarQian Cai <cai@lca.pw>
Signed-off-by: default avatarWill Deacon <will.deacon@arm.com>
parent 344bf332

arch/arm64/mm/numa.c

+12 −13
Original line number Diff line number Diff line
@@ -200,7 +200,7 @@ void __init setup_per_cpu_areas(void) 
#endif



/**

 * numa_add_memblk - Set node id to memblk

 * numa_add_memblk() - Set node id to memblk

 * @nid: NUMA node ID of the new memblk

 * @start: Start address of the new memblk

 * @end:  End address of the new memblk
@@ -223,7 +223,7 @@ int __init numa_add_memblk(int nid, u64 start, u64 end) 
	return ret;

}



/**

/*

 * Initialize NODE_DATA for a node on the local memory

 */

static void __init setup_node_data(int nid, u64 start_pfn, u64 end_pfn)
@@ -257,7 +257,7 @@ static void __init setup_node_data(int nid, u64 start_pfn, u64 end_pfn) 
	NODE_DATA(nid)->node_spanned_pages = end_pfn - start_pfn;

}



/**

/*

 * numa_free_distance

 *

 * The current table is freed.
@@ -277,10 +277,8 @@ void __init numa_free_distance(void) 
	numa_distance = NULL;

}



/**

 *

/*

 * Create a new NUMA distance table.

 *

 */

static int __init numa_alloc_distance(void)

{
@@ -311,7 +309,7 @@ static int __init numa_alloc_distance(void) 
}



/**

 * numa_set_distance - Set inter node NUMA distance from node to node.

 * numa_set_distance() - Set inter node NUMA distance from node to node.

 * @from: the 'from' node to set distance

 * @to: the 'to'  node to set distance

 * @distance: NUMA distance
@@ -321,7 +319,6 @@ static int __init numa_alloc_distance(void) 
 *

 * If @from or @to is higher than the highest known node or lower than zero

 * or @distance doesn't make sense, the call is ignored.

 *

 */

void __init numa_set_distance(int from, int to, int distance)

{
@@ -347,7 +344,7 @@ void __init numa_set_distance(int from, int to, int distance) 
	numa_distance[from * numa_distance_cnt + to] = distance;

}



/**

/*

 * Return NUMA distance @from to @to

 */

int __node_distance(int from, int to)
@@ -422,13 +419,15 @@ static int __init numa_init(int (*init_func)(void)) 
}



/**

 * dummy_numa_init - Fallback dummy NUMA init

 * dummy_numa_init() - Fallback dummy NUMA init

 *

 * Used if there's no underlying NUMA architecture, NUMA initialization

 * fails, or NUMA is disabled on the command line.

 *

 * Must online at least one node (node 0) and add memory blocks that cover all

 * allowed memory. It is unlikely that this function fails.

 *

 * Return: 0 on success, -errno on failure.

 */

static int __init dummy_numa_init(void)

{
@@ -454,7 +453,7 @@ static int __init dummy_numa_init(void) 
}



/**

 * arm64_numa_init - Initialize NUMA

 * arm64_numa_init() - Initialize NUMA

 *

 * Try each configured NUMA initialization method until one succeeds. The

 * last fallback is dummy single node config encomapssing whole memory.