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

Commit 8d63494f authored by Randy Dunlap's avatar Randy Dunlap Committed by Linus Torvalds
Browse files

remap_file_pages: kernel-doc corrections 



Fix kernel-doc for sys_remap_file_pages() and add info to the 'prot' NOTE.
Rename __prot parameter to prot.

Signed-off-by: default avatarRandy Dunlap <randy.dunlap@oracle.com>
Acked-by: default avatarNick Piggin <nickpiggin@yahoo.com.au>
Signed-off-by: default avatarAndrew Morton <akpm@linux-foundation.org>
Signed-off-by: default avatarLinus Torvalds <torvalds@linux-foundation.org>
parent f32143a2

mm/fremap.c

+13 −11
Original line number Original line Diff line number Diff line
@@ -97,26 +97,28 @@ static int populate_range(struct mm_struct *mm, struct vm_area_struct *vma, 




}

}





/***

/**

 * sys_remap_file_pages - remap arbitrary pages of a shared backing store

 * sys_remap_file_pages - remap arbitrary pages of an existing VM_SHARED vma

 *                        file within an existing vma.

 * @start: start of the remapped virtual memory range

 * @start: start of the remapped virtual memory range

 * @size: size of the remapped virtual memory range

 * @size: size of the remapped virtual memory range

 * @prot: new protection bits of the range

 * @prot: new protection bits of the range (see NOTE)

 * @pgoff: to be mapped page of the backing store file

 * @pgoff: to-be-mapped page of the backing store file

 * @flags: 0 or MAP_NONBLOCKED - the later will cause no IO.

 * @flags: 0 or MAP_NONBLOCKED - the later will cause no IO.

 *

 *

 * this syscall works purely via pagetables, so it's the most efficient

 * sys_remap_file_pages remaps arbitrary pages of an existing VM_SHARED vma

 * (shared backing store file).

 *

 * This syscall works purely via pagetables, so it's the most efficient

 * way to map the same (large) file into a given virtual window. Unlike

 * way to map the same (large) file into a given virtual window. Unlike

 * mmap()/mremap() it does not create any new vmas. The new mappings are

 * mmap()/mremap() it does not create any new vmas. The new mappings are

 * also safe across swapout.

 * also safe across swapout.

 *

 *

 * NOTE: the 'prot' parameter right now is ignored, and the vma's default

 * NOTE: the 'prot' parameter right now is ignored (but must be zero),

 * protection is used. Arbitrary protections might be implemented in the

 * and the vma's default protection is used. Arbitrary protections

 * future.

 * might be implemented in the future.

 */

 */

asmlinkage long sys_remap_file_pages(unsigned long start, unsigned long size,

asmlinkage long sys_remap_file_pages(unsigned long start, unsigned long size,

	unsigned long __prot, unsigned long pgoff, unsigned long flags)

	unsigned long prot, unsigned long pgoff, unsigned long flags)

{

{

	struct mm_struct *mm = current->mm;

	struct mm_struct *mm = current->mm;

	struct address_space *mapping;

	struct address_space *mapping;
@@ -125,7 +127,7 @@ asmlinkage long sys_remap_file_pages(unsigned long start, unsigned long size, 
	int err = -EINVAL;

	int err = -EINVAL;

	int has_write_lock = 0;

	int has_write_lock = 0;





	if (__prot)

	if (prot)

		return err;

		return err;

	/*

	/*

	 * Sanitize the syscall parameters:

	 * Sanitize the syscall parameters: