1*5ea1c4a2SRobert Watson.\" 2*5ea1c4a2SRobert Watson.\" Copyright (c) 2013 Robert N. M. Watson 3*5ea1c4a2SRobert Watson.\" All rights reserved. 4*5ea1c4a2SRobert Watson.\" 5*5ea1c4a2SRobert Watson.\" This software was developed by SRI International and the University of 6*5ea1c4a2SRobert Watson.\" Cambridge Computer Laboratory under DARPA/AFRL contract (FA8750-10-C-0237) 7*5ea1c4a2SRobert Watson.\" ("CTSRD"), as part of the DARPA CRASH research programme. 8*5ea1c4a2SRobert Watson.\" 9*5ea1c4a2SRobert Watson.\" Redistribution and use in source and binary forms, with or without 10*5ea1c4a2SRobert Watson.\" modification, are permitted provided that the following conditions 11*5ea1c4a2SRobert Watson.\" are met: 12*5ea1c4a2SRobert Watson.\" 1. Redistributions of source code must retain the above copyright 13*5ea1c4a2SRobert Watson.\" notice, this list of conditions and the following disclaimer. 14*5ea1c4a2SRobert Watson.\" 2. Redistributions in binary form must reproduce the above copyright 15*5ea1c4a2SRobert Watson.\" notice, this list of conditions and the following disclaimer in the 16*5ea1c4a2SRobert Watson.\" documentation and/or other materials provided with the distribution. 17*5ea1c4a2SRobert Watson.\" 18*5ea1c4a2SRobert Watson.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 19*5ea1c4a2SRobert Watson.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 20*5ea1c4a2SRobert Watson.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 21*5ea1c4a2SRobert Watson.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 22*5ea1c4a2SRobert Watson.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 23*5ea1c4a2SRobert Watson.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 24*5ea1c4a2SRobert Watson.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 25*5ea1c4a2SRobert Watson.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 26*5ea1c4a2SRobert Watson.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 27*5ea1c4a2SRobert Watson.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 28*5ea1c4a2SRobert Watson.\" SUCH DAMAGE. 29*5ea1c4a2SRobert Watson.\" 30*5ea1c4a2SRobert Watson.\" $FreeBSD$ 31*5ea1c4a2SRobert Watson.\" 32*5ea1c4a2SRobert Watson.Dd August 21, 2013 33*5ea1c4a2SRobert Watson.Dt PROCDESC 4 34*5ea1c4a2SRobert Watson.Os 35*5ea1c4a2SRobert Watson.Sh NAME 36*5ea1c4a2SRobert Watson.Nm procdesc 37*5ea1c4a2SRobert Watson.Nd process descriptor facility 38*5ea1c4a2SRobert Watson.Sh SYNOPSIS 39*5ea1c4a2SRobert Watson.Cd "options PROCDESC" 40*5ea1c4a2SRobert Watson.Sh DESCRIPTION 41*5ea1c4a2SRobert Watson.Nm 42*5ea1c4a2SRobert Watsonis a file-descriptor-oriented interface to process signalling and control, 43*5ea1c4a2SRobert Watsonwhich supplements historic 44*5ea1c4a2SRobert Watson.Ux 45*5ea1c4a2SRobert Watson.Xr fork 2 , 46*5ea1c4a2SRobert Watson.Xr kill 2 , 47*5ea1c4a2SRobert Watsonand 48*5ea1c4a2SRobert Watson.Xr wait4 2 49*5ea1c4a2SRobert Watsonprimitives with 50*5ea1c4a2SRobert Watsonnew system calls such as 51*5ea1c4a2SRobert Watson.Xr pdfork 2 , 52*5ea1c4a2SRobert Watson.Xr pdkill 2 , 53*5ea1c4a2SRobert Watsonand 54*5ea1c4a2SRobert Watson.Xr pdwait4 2 . 55*5ea1c4a2SRobert Watson.Nm 56*5ea1c4a2SRobert Watsonis designed for use with 57*5ea1c4a2SRobert Watson.Xr capsicum 4 , 58*5ea1c4a2SRobert Watsonreplacing process identifiers with capability-oriented references. 59*5ea1c4a2SRobert WatsonHowever, it can also be used independently of 60*5ea1c4a2SRobert Watson.Xr capsicum 4 , 61*5ea1c4a2SRobert Watsondisplacing PIDs, which may otherwise suffer from race conditions. 62*5ea1c4a2SRobert WatsonGiven a process descriptor, it is possible to query its conventional PID using 63*5ea1c4a2SRobert Watson.Xr pdgetpid 2 . 64*5ea1c4a2SRobert Watson.Sh SEE ALSO 65*5ea1c4a2SRobert Watson.Xr fork 2 , 66*5ea1c4a2SRobert Watson.Xr kill 2 , 67*5ea1c4a2SRobert Watson.Xr wait4 2 , 68*5ea1c4a2SRobert Watson.Xr pdfork 2 , 69*5ea1c4a2SRobert Watson.Xr pdgetpid 2 , 70*5ea1c4a2SRobert Watson.Xr pdkill 2 , 71*5ea1c4a2SRobert Watson.Xr pdwait4 , 72*5ea1c4a2SRobert Watson.Xr capsicum 4 73*5ea1c4a2SRobert Watson.Sh HISTORY 74*5ea1c4a2SRobert Watson.Nm 75*5ea1c4a2SRobert Watsonfirst appeared in 76*5ea1c4a2SRobert Watson.Fx 9.0 , 77*5ea1c4a2SRobert Watsonand was developed at the University of Cambridge. 78*5ea1c4a2SRobert Watson.Sh AUTHORS 79*5ea1c4a2SRobert Watson.Nm 80*5ea1c4a2SRobert Watsonwas developed by 81*5ea1c4a2SRobert Watson.An -nosplit 82*5ea1c4a2SRobert Watson.An "Robert Watson" Aq rwatson@FreeBSD.org 83*5ea1c4a2SRobert Watsonand 84*5ea1c4a2SRobert Watson.An "Jonathan Anderson" Aq jonathan@FreeBSD.org 85*5ea1c4a2SRobert Watsonat the University of Cambridge, and 86*5ea1c4a2SRobert Watson.An "Ben Laurie" Aq benl@FreeBSD.org 87*5ea1c4a2SRobert Watsonand 88*5ea1c4a2SRobert Watson.An "Kris Kennaway" Aq kris@FreeBSD.org 89*5ea1c4a2SRobert Watsonat Google, Inc. 90*5ea1c4a2SRobert Watson.Sh BUGS 91*5ea1c4a2SRobert Watson.Nm 92*5ea1c4a2SRobert Watsonis considered experimental in 93*5ea1c4a2SRobert Watson.Fx . 94