share/man/man3proc/pr_door_info.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 PR_DOOR_INFO 3PROC
  16 .Os
  17 .Sh NAME
  18 .Nm pr_door_info
  19 .Nd inject door_info library call into victim process
  20 .Sh SYNOPSIS
  21 .Lb libproc
  22 .In libproc.h
  23 .Ft int
  24 .Fo pr_door_info
  25 .Fa "struct ps_prochandle *P"
  26 .Fa "int did"
  27 .Fa "struct door_info *info"
  28 .Fc
  29 .Sh DESCRIPTION
  30 The
  31 .Fn pr_door_info
  32 function injects the
  33 .Xr door_info 3C
  34 library call into the target process
  35 .Fa P
  36 by means of the agent LWP.
  37 If the process handle
  38 .Fa P
  39 is
  40 .Dv NULL
  41 then this is equivalent to calling
  42 .Xr door_info 3C
  43 on the currently running process.
  44 .Pp
  45 The arguments
  46 .Fa did
  47 and
  48 .Fa info
  49 have the same meaning as in
  50 .Xr door_info 3C .
  51 See
  52 .Xr door_info 3C
  53 for the full description and purpose of the
  54 .Sy door_info
  55 library call and its arguments.
  56 .Pp
  57 The
  58 .Fn pr_door_info
  59 function only works on active processes.
  60 Process handles that correspond to core files, zombie processes, or ELF objects
  61 do not support library call injection.
  62 .Sh RETURN VALUES
  63 Upon successful completion, the
  64 .Fn pr_door_info
  65 function's return value is that described in
  66 .Xr door_info 3C .
  67 Otherwise,
  68 .Sy -1
  69 is returned and
  70 .Sy errno
  71 is set to
  72 .Er ENOSYS
  73 to indicate that the library call could not be injected.
  74 .Sh ERRORS
  75 For the full list of errors see the
  76 .Sy ERRORS
  77 section in
  78 .Xr door_info 3C .
  79 .Pp
  80 The
  81 .Fn pr_door_info
  82 function will fail if:
  83 .Bl -tag -width Er
  84 .It Er ENOSYS
  85 An error occurred while trying to invoke the agent LWP and inject a
  86 library call in the process handle
  87 .Fa P
  88 or the process handle
  89 .Fa P
  90 does not support library call injection.
  91 .El
  92 .Sh INTERFACE STABILITY
  93 .Sy Uncommitted
  94 .Sh MT-LEVEL
  95 See
  96 .Sy LOCKING
  97 in
  98 .Xr libproc 3LIB .
  99 .Sh SEE ALSO
 100 .Xr door_info 3C ,
 101 .Xr libproc 3LIB ,
 102 .Xr proc 4