15ea1c4a2SRobert Watson.\" 25ea1c4a2SRobert Watson.\" Copyright (c) 2013 Robert N. M. Watson 35ea1c4a2SRobert Watson.\" All rights reserved. 45ea1c4a2SRobert Watson.\" 55ea1c4a2SRobert Watson.\" This software was developed by SRI International and the University of 65ea1c4a2SRobert Watson.\" Cambridge Computer Laboratory under DARPA/AFRL contract (FA8750-10-C-0237) 75ea1c4a2SRobert Watson.\" ("CTSRD"), as part of the DARPA CRASH research programme. 85ea1c4a2SRobert Watson.\" 95ea1c4a2SRobert Watson.\" Redistribution and use in source and binary forms, with or without 105ea1c4a2SRobert Watson.\" modification, are permitted provided that the following conditions 115ea1c4a2SRobert Watson.\" are met: 125ea1c4a2SRobert Watson.\" 1. Redistributions of source code must retain the above copyright 135ea1c4a2SRobert Watson.\" notice, this list of conditions and the following disclaimer. 145ea1c4a2SRobert Watson.\" 2. Redistributions in binary form must reproduce the above copyright 155ea1c4a2SRobert Watson.\" notice, this list of conditions and the following disclaimer in the 165ea1c4a2SRobert Watson.\" documentation and/or other materials provided with the distribution. 175ea1c4a2SRobert Watson.\" 185ea1c4a2SRobert Watson.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 195ea1c4a2SRobert Watson.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 205ea1c4a2SRobert Watson.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 215ea1c4a2SRobert Watson.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 225ea1c4a2SRobert Watson.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 235ea1c4a2SRobert Watson.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 245ea1c4a2SRobert Watson.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 255ea1c4a2SRobert Watson.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 265ea1c4a2SRobert Watson.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 275ea1c4a2SRobert Watson.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 285ea1c4a2SRobert Watson.\" SUCH DAMAGE. 295ea1c4a2SRobert Watson.\" 305ea1c4a2SRobert Watson.\" $FreeBSD$ 315ea1c4a2SRobert Watson.\" 325ea1c4a2SRobert Watson.Dd August 21, 2013 335ea1c4a2SRobert Watson.Dt PROCDESC 4 345ea1c4a2SRobert Watson.Os 355ea1c4a2SRobert Watson.Sh NAME 365ea1c4a2SRobert Watson.Nm procdesc 375ea1c4a2SRobert Watson.Nd process descriptor facility 385ea1c4a2SRobert Watson.Sh DESCRIPTION 395ea1c4a2SRobert Watson.Nm 405ea1c4a2SRobert Watsonis a file-descriptor-oriented interface to process signalling and control, 415ea1c4a2SRobert Watsonwhich supplements historic 425ea1c4a2SRobert Watson.Ux 435ea1c4a2SRobert Watson.Xr fork 2 , 445ea1c4a2SRobert Watson.Xr kill 2 , 455ea1c4a2SRobert Watsonand 465ea1c4a2SRobert Watson.Xr wait4 2 475ea1c4a2SRobert Watsonprimitives with 485ea1c4a2SRobert Watsonnew system calls such as 495ea1c4a2SRobert Watson.Xr pdfork 2 , 505ea1c4a2SRobert Watson.Xr pdkill 2 , 515ea1c4a2SRobert Watsonand 525ea1c4a2SRobert Watson.Xr pdwait4 2 . 535ea1c4a2SRobert Watson.Nm 545ea1c4a2SRobert Watsonis designed for use with 555ea1c4a2SRobert Watson.Xr capsicum 4 , 565ea1c4a2SRobert Watsonreplacing process identifiers with capability-oriented references. 575ea1c4a2SRobert WatsonHowever, it can also be used independently of 585ea1c4a2SRobert Watson.Xr capsicum 4 , 595ea1c4a2SRobert Watsondisplacing PIDs, which may otherwise suffer from race conditions. 605ea1c4a2SRobert WatsonGiven a process descriptor, it is possible to query its conventional PID using 615ea1c4a2SRobert Watson.Xr pdgetpid 2 . 625ea1c4a2SRobert Watson.Sh SEE ALSO 635ea1c4a2SRobert Watson.Xr fork 2 , 645ea1c4a2SRobert Watson.Xr kill 2 , 655ea1c4a2SRobert Watson.Xr pdfork 2 , 665ea1c4a2SRobert Watson.Xr pdgetpid 2 , 675ea1c4a2SRobert Watson.Xr pdkill 2 , 6804ba6e50SPawel Jakub Dawidek.Xr pdwait4 2 , 6954239186SSergey Kandaurov.Xr wait4 2 , 705ea1c4a2SRobert Watson.Xr capsicum 4 715ea1c4a2SRobert Watson.Sh HISTORY 725ea1c4a2SRobert Watson.Nm 735ea1c4a2SRobert Watsonfirst appeared in 745ea1c4a2SRobert Watson.Fx 9.0 , 755ea1c4a2SRobert Watsonand was developed at the University of Cambridge. 765ea1c4a2SRobert Watson.Sh AUTHORS 775ea1c4a2SRobert Watson.Nm 785ea1c4a2SRobert Watsonwas developed by 795ea1c4a2SRobert Watson.An -nosplit 80*6c899950SBaptiste Daroussin.An Robert Watson Aq Mt rwatson@FreeBSD.org 815ea1c4a2SRobert Watsonand 82*6c899950SBaptiste Daroussin.An Jonathan Anderson Aq Mt jonathan@FreeBSD.org 835ea1c4a2SRobert Watsonat the University of Cambridge, and 84*6c899950SBaptiste Daroussin.An Ben Laurie Aq Mt benl@FreeBSD.org 855ea1c4a2SRobert Watsonand 86*6c899950SBaptiste Daroussin.An Kris Kennaway Aq Mt kris@FreeBSD.org 875ea1c4a2SRobert Watsonat Google, Inc. 885ea1c4a2SRobert Watson.Sh BUGS 895ea1c4a2SRobert Watson.Nm 905ea1c4a2SRobert Watsonis considered experimental in 915ea1c4a2SRobert Watson.Fx . 92