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

Commit dad7557e authored by Wanpeng Li's avatar Wanpeng Li Committed by Linus Torvalds
Browse files

mm: fix kernel-doc warnings 



Fix kernel-doc warnings such as

  Warning(../mm/page_cgroup.c:432): No description found for parameter 'id'
  Warning(../mm/page_cgroup.c:432): Excess function parameter 'mem' description in 'swap_cgroup_record'

Signed-off-by: default avatarWanpeng Li <liwp@linux.vnet.ibm.com>
Cc: Randy Dunlap <randy.dunlap@oracle.com>
Signed-off-by: default avatarAndrew Morton <akpm@linux-foundation.org>
Signed-off-by: default avatarLinus Torvalds <torvalds@linux-foundation.org>
parent 4fe7efdb

mm/memblock.c

+6 −6
Original line number Diff line number Diff line
@@ -540,9 +540,9 @@ int __init_memblock memblock_reserve(phys_addr_t base, phys_addr_t size) 
 * __next_free_mem_range - next function for for_each_free_mem_range()

 * @idx: pointer to u64 loop variable

 * @nid: nid: node selector, %MAX_NUMNODES for all nodes

 * @p_start: ptr to phys_addr_t for start address of the range, can be %NULL

 * @p_end: ptr to phys_addr_t for end address of the range, can be %NULL

 * @p_nid: ptr to int for nid of the range, can be %NULL

 * @out_start: ptr to phys_addr_t for start address of the range, can be %NULL

 * @out_end: ptr to phys_addr_t for end address of the range, can be %NULL

 * @out_nid: ptr to int for nid of the range, can be %NULL

 *

 * Find the first free area from *@idx which matches @nid, fill the out

 * parameters, and update *@idx for the next iteration.  The lower 32bit of
@@ -616,9 +616,9 @@ void __init_memblock __next_free_mem_range(u64 *idx, int nid, 
 * __next_free_mem_range_rev - next function for for_each_free_mem_range_reverse()

 * @idx: pointer to u64 loop variable

 * @nid: nid: node selector, %MAX_NUMNODES for all nodes

 * @p_start: ptr to phys_addr_t for start address of the range, can be %NULL

 * @p_end: ptr to phys_addr_t for end address of the range, can be %NULL

 * @p_nid: ptr to int for nid of the range, can be %NULL

 * @out_start: ptr to phys_addr_t for start address of the range, can be %NULL

 * @out_end: ptr to phys_addr_t for end address of the range, can be %NULL

 * @out_nid: ptr to int for nid of the range, can be %NULL

 *

 * Reverse of __next_free_mem_range().

 */

mm/memcontrol.c

+2 −2
Original line number Diff line number Diff line
@@ -1234,7 +1234,7 @@ int mem_cgroup_inactive_file_is_low(struct lruvec *lruvec) 


/**

 * mem_cgroup_margin - calculate chargeable space of a memory cgroup

 * @mem: the memory cgroup

 * @memcg: the memory cgroup

 *

 * Returns the maximum amount of memory @mem can be charged with, in

 * pages.
@@ -1508,7 +1508,7 @@ static unsigned long mem_cgroup_reclaim(struct mem_cgroup *memcg, 


/**

 * test_mem_cgroup_node_reclaimable

 * @mem: the target memcg

 * @memcg: the target memcg

 * @nid: the node ID to be checked.

 * @noswap : specify true here if the user wants flle only information.

 *

mm/oom_kill.c

+1 −1
Original line number Diff line number Diff line
@@ -365,7 +365,7 @@ static struct task_struct *select_bad_process(unsigned int *ppoints, 


/**

 * dump_tasks - dump current memory state of all system tasks

 * @mem: current's memory controller, if constrained

 * @memcg: current's memory controller, if constrained

 * @nodemask: nodemask passed to page allocator for mempolicy ooms

 *

 * Dumps the current memory state of all eligible tasks.  Tasks not in the same

mm/page_cgroup.c

+2 −2
Original line number Diff line number Diff line
@@ -392,7 +392,7 @@ static struct swap_cgroup *lookup_swap_cgroup(swp_entry_t ent, 


/**

 * swap_cgroup_cmpxchg - cmpxchg mem_cgroup's id for this swp_entry.

 * @end: swap entry to be cmpxchged

 * @ent: swap entry to be cmpxchged

 * @old: old id

 * @new: new id

 *
@@ -422,7 +422,7 @@ unsigned short swap_cgroup_cmpxchg(swp_entry_t ent, 
/**

 * swap_cgroup_record - record mem_cgroup for this swp_entry.

 * @ent: swap entry to be recorded into

 * @mem: mem_cgroup to be recorded

 * @id: mem_cgroup to be recorded

 *

 * Returns old value at success, 0 at failure.

 * (Of course, old value can be 0.)

mm/pagewalk.c

+0 −1
Original line number Diff line number Diff line
@@ -162,7 +162,6 @@ static int walk_hugetlb_range(struct vm_area_struct *vma, 


/**

 * walk_page_range - walk a memory map's page tables with a callback

 * @mm: memory map to walk

 * @addr: starting address

 * @end: ending address

 * @walk: set of callbacks to invoke for each level of the tree