From owner-svn-src-stable@FreeBSD.ORG Tue Mar 2 11:00:11 2010 Return-Path: Delivered-To: svn-src-stable@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 53C1F1065670; Tue, 2 Mar 2010 11:00:11 +0000 (UTC) (envelope-from kib@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id 27A088FC13; Tue, 2 Mar 2010 11:00:11 +0000 (UTC) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.3/8.14.3) with ESMTP id o22B0BW5007509; Tue, 2 Mar 2010 11:00:11 GMT (envelope-from kib@svn.freebsd.org) Received: (from kib@localhost) by svn.freebsd.org (8.14.3/8.14.3/Submit) id o22B0BoI007508; Tue, 2 Mar 2010 11:00:11 GMT (envelope-from kib@svn.freebsd.org) Message-Id: <201003021100.o22B0BoI007508@svn.freebsd.org> From: Konstantin Belousov Date: Tue, 2 Mar 2010 11:00:11 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-stable@freebsd.org, svn-src-stable-8@freebsd.org X-SVN-Group: stable-8 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Subject: svn commit: r204575 - stable/8/share/man/man9 X-BeenThere: svn-src-stable@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: SVN commit messages for all the -stable branches of the src tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 02 Mar 2010 11:00:11 -0000 Author: kib Date: Tue Mar 2 11:00:10 2010 New Revision: 204575 URL: http://svn.freebsd.org/changeset/base/204575 Log: MFC r204416: Update man page for vm_page_alloc(9). Modified: stable/8/share/man/man9/vm_page_alloc.9 Directory Properties: stable/8/share/man/man9/ (props changed) Modified: stable/8/share/man/man9/vm_page_alloc.9 ============================================================================== --- stable/8/share/man/man9/vm_page_alloc.9 Tue Mar 2 10:43:41 2010 (r204574) +++ stable/8/share/man/man9/vm_page_alloc.9 Tue Mar 2 11:00:10 2010 (r204575) @@ -26,7 +26,7 @@ .\" .\" $FreeBSD$ .\" -.Dd July 13, 2001 +.Dd February 27, 2010 .Dt VM_PAGE_ALLOC 9 .Os .Sh NAME @@ -48,16 +48,26 @@ within .Fa object . It is assumed that a page has not already been allocated at .Fa pindex . -The page returned is inserted into the object, but is not inserted -into the pmap. +The page returned is inserted into the object, unless +.Dv VM_ALLOC_NOOBJ +is specified in the +.Fa page_req , +but is not inserted into a pmap. +The page may exists in the vm object cache, in which case it will +be reactivated instead, moving from the cache into the object page list. .Pp .Fn vm_page_alloc -will not block. +will not sleep. .Pp Its arguments are: .Bl -tag -width ".Fa page_req" .It Fa object The VM object to allocate the page for. +The +.Fa object +must be locked if +.Dv VM_ALLOC_NOOBJ +is not specified. .It Fa pindex The index into the object at which the page should be inserted. .It Fa page_req @@ -82,12 +92,24 @@ than zero. .It Dv VM_ALLOC_ZERO Indicate a preference for a pre-zeroed page. There is no guarantee that the page thus returned will be zeroed, but -it will be marked as such. +it will be marked by +.Dv PG_ZERO +flag if it is zeroed. .It Dv VM_ALLOC_NOOBJ -The page is associated with an unmanaged memory region, that is, there -is no backing VM object. -This is typically used to allocate pages within the kernel virtual -address space. +Do not associate the allocated page with a vm object. +The +.Fa object +argument is ignored. +.It Dv VM_ALLOC_NOBUSY +The page returned will not be busied. +.It Dv VM_ALLOC_WIRED +The returned page is wired. +.It Dv VM_ALLOC_IFNOTCACHED +Only allocate the page if it is not cached in the +.Fa object . +If the page at the specified +.Fa pindex +is cached, NULL is returned instead. .El .El .Sh RETURN VALUES