[src/trunk]: src/share/man/man9 Describe UFP_DIRTYONLY and UFP_BACKWARD flags...

[riastradh <riastradh%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/c21857338a64
branches:  trunk
changeset: 806992:c21857338a64
user:      riastradh <riastradh%NetBSD.org@localhost>
date:      Mon Mar 23 08:00:33 2015 +0000

description:
Describe UFP_DIRTYONLY and UFP_BACKWARD flags to uvn_findpages.

PR kern/49335

diffstat:

 share/man/man9/uvm.9 |  20 +++++++++++++++++++-
 1 files changed, 19 insertions(+), 1 deletions(-)

diffs (41 lines):

diff -r 5b7a0dfc71a9 -r c21857338a64 share/man/man9/uvm.9
--- a/share/man/man9/uvm.9      Mon Mar 23 07:59:12 2015 +0000
+++ b/share/man/man9/uvm.9      Mon Mar 23 08:00:33 2015 +0000
@@ -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
 .\" All rights reserved.
@@ -466,6 +466,8 @@
 #define UFP_NOALLOC     0x02    /* don't allocate new pages */
 #define UFP_NOCACHE     0x04    /* don't return pages which already exist */
 #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
 .Pp
 .Dv UFP_ALL
@@ -478,6 +480,22 @@
 causes any pages which do already exist to be skipped.
 .Dv UFP_NORDONLY
 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
 .Fn uvm_vnp_setsize
 sets the size of vnode