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_FILE 3PROC
  16 .Os
  17 .Sh NAME
  18 .Nm Pgrab_file
  19 .Nd grab and inspect an ELF object
  20 .Sh SYNOPSIS
  21 .Lb libproc

  22 .In libproc.h
  23 .Ft struct ps_prochandle
  24 .Fo Pgrab_file
  25 .Fa "const char *fname"
  26 .Fa "int *perr"
  27 .Fc
  28 .Sh DESCRIPTION
  29 The
  30 .Fn Pgrab_file
  31 function creates a handle to the ELF object contained in file
  32 .Fa fname .
  33 This handle is considered an
  34 .Em idle
  35 handle, it allows one to inspect aspects of the ELF contents present in
  36 the handle, for example obtaining CTF information and looking up
  37 symbols.
  38 .Pp
  39 There is no running state associated with this handle nor can there be.
  40 If one intends to control a running process or create a process, see
  41 .Xr Pgrab 3PROC

   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_FILE 3PROC
  16 .Os
  17 .Sh NAME
  18 .Nm Pgrab_file
  19 .Nd grab and inspect an ELF object
  20 .Sh LIBRARY
  21 .Lb libproc
  22 .Sh SYNOPSIS
  23 .In libproc.h
  24 .Ft struct ps_prochandle
  25 .Fo Pgrab_file
  26 .Fa "const char *fname"
  27 .Fa "int *perr"
  28 .Fc
  29 .Sh DESCRIPTION
  30 The
  31 .Fn Pgrab_file
  32 function creates a handle to the ELF object contained in file
  33 .Fa fname .
  34 This handle is considered an
  35 .Em idle
  36 handle, it allows one to inspect aspects of the ELF contents present in
  37 the handle, for example obtaining CTF information and looking up
  38 symbols.
  39 .Pp
  40 There is no running state associated with this handle nor can there be.
  41 If one intends to control a running process or create a process, see
  42 .Xr Pgrab 3PROC