Describe UFP_DIRTYONLY and UFP_BACKWARD flags to uvn_findpages.

PR kern/49335
This commit is contained in:
riastradh 2015-03-23 08:00:33 +00:00
parent d32bef14a2
commit e3235bfa54

View File

@ -1,4 +1,4 @@
.\" $NetBSD: uvm.9,v 1.107 2012/07/02 21:10:31 jym Exp $ .\" $NetBSD: uvm.9,v 1.108 2015/03/23 08:00:33 riastradh Exp $
.\" .\"
.\" Copyright (c) 1998 Matthew R. Green .\" Copyright (c) 1998 Matthew R. Green
.\" All rights reserved. .\" All rights reserved.
@ -466,6 +466,8 @@ The flags can be
#define UFP_NOALLOC 0x02 /* don't allocate new pages */ #define UFP_NOALLOC 0x02 /* don't allocate new pages */
#define UFP_NOCACHE 0x04 /* don't return pages which already exist */ #define UFP_NOCACHE 0x04 /* don't return pages which already exist */
#define UFP_NORDONLY 0x08 /* don't return PG_READONLY pages */ #define UFP_NORDONLY 0x08 /* don't return PG_READONLY pages */
#define UFP_DIRTYONLY 0x10 /* stop at first clean pg, clean dirty pgs */
#define UFP_BACKWARD 0x20 /* find pages in reverse order */
.Ed .Ed
.Pp .Pp
.Dv UFP_ALL .Dv UFP_ALL
@ -478,6 +480,22 @@ causes any pages which do not already exist to be skipped.
causes any pages which do already exist to be skipped. causes any pages which do already exist to be skipped.
.Dv UFP_NORDONLY .Dv UFP_NORDONLY
causes any pages which are marked PG_READONLY to be skipped. causes any pages which are marked PG_READONLY to be skipped.
.Dv UFP_DIRTYONLY
causes
.Fn uvn_findpages
to stop early at the first clean page, and as a side effect to mark
each dirty page as clean.
It is the caller's responsibility to write the pages back to permanent
storage before unbusying them.
.Dv UFP_BACKWARD
causes
.Fn uvn_findpages
to traverse the array of pages in reverse order, starting at the end.
If
.Fn uvn_findpages
returns early in this case, it will have filled
.Li * Ns Fa npagesp
entries at the end rather than beginning of the page array.
.Pp .Pp
.Fn uvm_vnp_setsize .Fn uvm_vnp_setsize
sets the size of vnode sets the size of vnode