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 PGRAB 3PROC
  16 .Os
  17 .Sh NAME
  18 .Nm Pgrab
  19 .Nd grab and control a process
  20 .Sh SYNOPSIS
  21 .Lb libproc

  22 .In libproc.h
  23 .Ft "struct ps_prochandle *"
  24 .Fo Pgrab
  25 .Fa "pid_t pid"
  26 .Fa "int flags"
  27 .Fa "int *perr"
  28 .Fc
  29 .Sh DESCRIPTION
  30 The
  31 .Fn Pgrab
  32 function attempts to grab the process identified by
  33 .Fa pid
  34 and returns a handle to it that allows the process to be controlled,
  35 interrogated, and manipulated.
  36 This interface only works with processes that already exist.
  37 Use
  38 .Xr Pgrab_core 3PROC
  39 for core files and
  40 .Xr Pcreate 3PROC
  41 to create processes.

   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 PGRAB 3PROC
  16 .Os
  17 .Sh NAME
  18 .Nm Pgrab
  19 .Nd grab and control a process
  20 .Sh LIBRARY
  21 .Lb libproc
  22 .Sh SYNOPSIS
  23 .In libproc.h
  24 .Ft "struct ps_prochandle *"
  25 .Fo Pgrab
  26 .Fa "pid_t pid"
  27 .Fa "int flags"
  28 .Fa "int *perr"
  29 .Fc
  30 .Sh DESCRIPTION
  31 The
  32 .Fn Pgrab
  33 function attempts to grab the process identified by
  34 .Fa pid
  35 and returns a handle to it that allows the process to be controlled,
  36 interrogated, and manipulated.
  37 This interface only works with processes that already exist.
  38 Use
  39 .Xr Pgrab_core 3PROC
  40 for core files and
  41 .Xr Pcreate 3PROC
  42 to create processes.