From owner-svn-src-all@freebsd.org Sun Nov 8 01:43:26 2015 Return-Path: Delivered-To: svn-src-all@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 08DFAA22156; Sun, 8 Nov 2015 01:43:26 +0000 (UTC) (envelope-from bdrewery@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) by mx1.freebsd.org (Postfix) with ESMTP id E65921874; Sun, 8 Nov 2015 01:43:25 +0000 (UTC) (envelope-from bdrewery@FreeBSD.org) Received: from mail.xzibition.com (localhost [IPv6:::1]) by freefall.freebsd.org (Postfix) with ESMTP id DCD101194; Sun, 8 Nov 2015 01:43:25 +0000 (UTC) (envelope-from bdrewery@FreeBSD.org) Received: from mail.xzibition.com (localhost [172.31.3.2]) by mail.xzibition.com (Postfix) with ESMTP id 94F4A127AB; Sun, 8 Nov 2015 01:43:25 +0000 (UTC) X-Virus-Scanned: amavisd-new at mail.xzibition.com Received: from mail.xzibition.com ([172.31.3.2]) by mail.xzibition.com (mail.xzibition.com [172.31.3.2]) (amavisd-new, port 10026) with LMTP id 7kwySHYkaEcw; Sun, 8 Nov 2015 01:43:22 +0000 (UTC) Content-Type: text/plain; charset=us-ascii DKIM-Filter: OpenDKIM Filter v2.9.2 mail.xzibition.com 4E9EE127A8 Mime-Version: 1.0 (1.0) Subject: Re: svn commit: r290531 - head/share/man/man9 From: Bryan Drewery X-Mailer: iPhone Mail (12H143) In-Reply-To: <201511080141.tA81fitC064644@repo.freebsd.org> Date: Sat, 7 Nov 2015 17:43:17 -0800 Cc: "src-committers@freebsd.org" , "svn-src-all@freebsd.org" , "svn-src-head@freebsd.org" Content-Transfer-Encoding: quoted-printable Message-Id: <7C0173DE-0EC7-427C-AFBD-3F851B4C8E69@FreeBSD.org> References: <201511080141.tA81fitC064644@repo.freebsd.org> To: Mark Johnston X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 08 Nov 2015 01:43:26 -0000 Thanks for this!=20 Regards, Bryan Drewery > On Nov 7, 2015, at 17:41, Mark Johnston wrote: >=20 > Author: markj > Date: Sun Nov 8 01:41:44 2015 > New Revision: 290531 > URL: https://svnweb.freebsd.org/changeset/base/290531 >=20 > Log: > Add a manual page for PHOLD() and friends. >=20 > MFC after: 1 week >=20 > Added: > head/share/man/man9/PHOLD.9 (contents, props changed) > Modified: > head/share/man/man9/Makefile >=20 > Modified: head/share/man/man9/Makefile > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D > --- head/share/man/man9/Makefile Sun Nov 8 01:38:56 2015 (r290530) > +++ head/share/man/man9/Makefile Sun Nov 8 01:41:44 2015 (r290531) > @@ -209,6 +209,7 @@ MAN=3D accept_filter.9 \ > pfind.9 \ > pget.9 \ > pgfind.9 \ > + PHOLD.9 \ > physio.9 \ > pmap.9 \ > pmap_activate.9 \ > @@ -1314,6 +1315,11 @@ MLINKS+=3Dpfil.9 pfil_add_hook.9 \ > pfil.9 pfil_wlock.9 \ > pfil.9 pfil_wunlock.9 > MLINKS+=3Dpfind.9 zpfind.9 > +MLINKS+=3DPHOLD.9 PRELE.9 \ > + PHOLD.9 _PHOLD.9 \ > + PHOLD.9 _PRELE.9 \ > + PHOLD.9 PROC_ASSERT_HELD.9 \ > + PHOLD.9 PROC_ASSERT_NOT_HELD.9 > MLINKS+=3Dpmap_copy.9 pmap_copy_page.9 > MLINKS+=3Dpmap_extract.9 pmap_extract_and_hold.9 > MLINKS+=3Dpmap_init.9 pmap_init2.9 >=20 > Added: head/share/man/man9/PHOLD.9 > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D > --- /dev/null 00:00:00 1970 (empty, because file is newly added) > +++ head/share/man/man9/PHOLD.9 Sun Nov 8 01:41:44 2015 (r290531) > @@ -0,0 +1,67 @@ > +.\" Copyright (c) 2015 Mark Johnston > +.\" > +.\" Redistribution and use in source and binary forms, with or without > +.\" modification, are permitted provided that the following conditions > +.\" are met: > +.\" 1. Redistributions of source code must retain the above copyright > +.\" notice, this list of conditions and the following disclaimer. > +.\" 2. Redistributions in binary form must reproduce the above copyright > +.\" notice, this list of conditions and the following disclaimer in th= e > +.\" documentation and/or other materials provided with the distributio= n. > +.\" > +.\" THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS= OR > +.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRAN= TIES > +.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIME= D. > +.\" IN NO EVENT SHALL THE DEVELOPERS BE LIABLE FOR ANY DIRECT, INDIRECT, > +.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, B= UT > +.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF U= SE, > +.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY= > +.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT > +.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE= OF > +.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. > +.\" > +.\" $FreeBSD$ > +.\" > +.Dd November 7, 2015 > +.Dt PHOLD 9 > +.Os > +.Sh NAME > +.Nm PHOLD > +.Nd hold a process > +.Sh SYNOPSIS > +.In sys/proc.h > +.Fn PHOLD "struct proc *p" > +.Fn _PHOLD "struct proc *p" > +.Fn PRELE "struct proc *p" > +.Fn _PRELE "struct proc *p" > +.Fn PROC_ASSERT_HELD "struct proc *p" > +.Fn PROC_ASSERT_NOT_HELD "struct proc *p" > +.Sh DESCRIPTION > +The > +.Fn PHOLD > +macro increments the hold count of a process, and the > +.Fn PRELE > +macro decrements the hold count of a process. > +.Pp > +If a process with a non-zero hold count attempts to exit, it will sleep u= ntil > +its hold count has reached zero before the kernel begins releasing resour= ces > +associated with the process. > +Once a process has started exiting, it is invalid to increase its hold co= unt. > +Thus, callers must not attempt to hold a process that has the > +.Dv P_WEXIT > +flag set. > +The VM daemon will not swap out the kernel stack of a thread belonging to= a > +process with a non-zero hold count. > +.Pp > +The > +.Fn _PHOLD > +and > +.Fn _PRELE > +macros are identical to > +.Fn PHOLD > +and > +.Fn PRELE , > +except that they must be called with the process lock held. > +.Sh AUTHORS > +This manual page was written by > +.An Mark Johnston Aq Mt markj@FreeBSD.org . >=20