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.\" 302182de2dSChristian S.J. Peron.Dd May 15, 2020 315ea1c4a2SRobert Watson.Dt PROCDESC 4 325ea1c4a2SRobert Watson.Os 335ea1c4a2SRobert Watson.Sh NAME 345ea1c4a2SRobert Watson.Nm procdesc 355ea1c4a2SRobert Watson.Nd process descriptor facility 365ea1c4a2SRobert Watson.Sh DESCRIPTION 375ea1c4a2SRobert Watson.Nm 385ea1c4a2SRobert Watsonis a file-descriptor-oriented interface to process signalling and control, 395ea1c4a2SRobert Watsonwhich supplements historic 405ea1c4a2SRobert Watson.Ux 4161a33bf9SChristian S.J. Peron.Xr fork 2 425ea1c4a2SRobert Watsonand 4361a33bf9SChristian S.J. Peron.Xr kill 2 , 445ea1c4a2SRobert Watsonprimitives with 455ea1c4a2SRobert Watsonnew system calls such as 4661a33bf9SChristian S.J. Peron.Xr pdfork 2 475ea1c4a2SRobert Watsonand 4861a33bf9SChristian S.J. Peron.Xr pdkill 2 , 495ea1c4a2SRobert Watson.Nm 505ea1c4a2SRobert Watsonis designed for use with 515ea1c4a2SRobert Watson.Xr capsicum 4 , 525ea1c4a2SRobert Watsonreplacing process identifiers with capability-oriented references. 535ea1c4a2SRobert WatsonHowever, it can also be used independently of 545ea1c4a2SRobert Watson.Xr capsicum 4 , 555ea1c4a2SRobert Watsondisplacing PIDs, which may otherwise suffer from race conditions. 565ea1c4a2SRobert WatsonGiven a process descriptor, it is possible to query its conventional PID using 575ea1c4a2SRobert Watson.Xr pdgetpid 2 . 585ea1c4a2SRobert Watson.Sh SEE ALSO 595ea1c4a2SRobert Watson.Xr fork 2 , 605ea1c4a2SRobert Watson.Xr kill 2 , 61*6e1fc011SGraham Percival.Xr kqueue 2 , 625ea1c4a2SRobert Watson.Xr pdfork 2 , 635ea1c4a2SRobert Watson.Xr pdgetpid 2 , 645ea1c4a2SRobert Watson.Xr pdkill 2 , 6554239186SSergey Kandaurov.Xr wait4 2 , 665ea1c4a2SRobert Watson.Xr capsicum 4 675ea1c4a2SRobert Watson.Sh HISTORY 685ea1c4a2SRobert Watson.Nm 695ea1c4a2SRobert Watsonfirst appeared in 705ea1c4a2SRobert Watson.Fx 9.0 , 715ea1c4a2SRobert Watsonand was developed at the University of Cambridge. 725ea1c4a2SRobert Watson.Sh AUTHORS 735ea1c4a2SRobert Watson.Nm 745ea1c4a2SRobert Watsonwas developed by 755ea1c4a2SRobert Watson.An -nosplit 766c899950SBaptiste Daroussin.An Robert Watson Aq Mt rwatson@FreeBSD.org 775ea1c4a2SRobert Watsonand 786c899950SBaptiste Daroussin.An Jonathan Anderson Aq Mt jonathan@FreeBSD.org 795ea1c4a2SRobert Watsonat the University of Cambridge, and 806c899950SBaptiste Daroussin.An Ben Laurie Aq Mt benl@FreeBSD.org 815ea1c4a2SRobert Watsonand 826c899950SBaptiste Daroussin.An Kris Kennaway Aq Mt kris@FreeBSD.org 835ea1c4a2SRobert Watsonat Google, Inc. 84