1 .\"
   2 .\" This file and its contents are supplied under the terms of the
   3 .\" Common Development and Distribution License ("CDDL"), version 1.0.
   4 .\" You may only use this file in accordance with the terms of version
   5 .\" 1.0 of the CDDL.
   6 .\"
   7 .\" A full copy of the text of the CDDL should have accompanied this
   8 .\" source.  A copy of the CDDL is also available via the Internet at
   9 .\" http://www.illumos.org/license/CDDL.
  10 .\"
  11 .\"
  12 .\" Copyright 2015 Joyent, Inc.
  13 .\"
  14 .Dd May 11, 2016
  15 .Dt PREOPEN 3PROC
  16 .Os
  17 .Sh NAME
  18 .Nm Preopen
  19 .Nd reopen a process
  20 .Sh SYNOPSIS
  21 .Lb libproc

  22 .In libproc.h
  23 .Ft int
  24 .Fo Preopen
  25 .Fa "struct ps_prochandle *P"
  26 .Fc
  27 .Sh DESCRIPTION
  28 The
  29 .Fn Preopen
  30 function is used to regain control of the process represented by the
  31 handle
  32 .Fa P .
  33 A loss of control is indicated by the
  34 .Xr Pstatus 3PROC
  35 function returning the value
  36 .Dv PS_LOST .
  37 This may occur when the controlled process performs an
  38 .Xr exec 2
  39 of a setuid or setgid binary or one where the controlling process cannot
  40 read the object file.
  41 For more information on this, see the

   1 .\"
   2 .\" This file and its contents are supplied under the terms of the
   3 .\" Common Development and Distribution License ("CDDL"), version 1.0.
   4 .\" You may only use this file in accordance with the terms of version
   5 .\" 1.0 of the CDDL.
   6 .\"
   7 .\" A full copy of the text of the CDDL should have accompanied this
   8 .\" source.  A copy of the CDDL is also available via the Internet at
   9 .\" http://www.illumos.org/license/CDDL.
  10 .\"
  11 .\"
  12 .\" Copyright 2015 Joyent, Inc.
  13 .\"
  14 .Dd May 11, 2016
  15 .Dt PREOPEN 3PROC
  16 .Os
  17 .Sh NAME
  18 .Nm Preopen
  19 .Nd reopen a process
  20 .Sh LIBRARY
  21 .Lb libproc
  22 .Sh SYNOPSIS
  23 .In libproc.h
  24 .Ft int
  25 .Fo Preopen
  26 .Fa "struct ps_prochandle *P"
  27 .Fc
  28 .Sh DESCRIPTION
  29 The
  30 .Fn Preopen
  31 function is used to regain control of the process represented by the
  32 handle
  33 .Fa P .
  34 A loss of control is indicated by the
  35 .Xr Pstatus 3PROC
  36 function returning the value
  37 .Dv PS_LOST .
  38 This may occur when the controlled process performs an
  39 .Xr exec 2
  40 of a setuid or setgid binary or one where the controlling process cannot
  41 read the object file.
  42 For more information on this, see the