xref: /freebsd/share/man/man4/procdesc.4 (revision 6e1fc0118033f42b7c0d3623c8f67a89ebecabb2)
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