PR_DOOR_INFO(3PROC) Process Control Library Functions PR_DOOR_INFO(3PROC)

NAME

pr_door_info - inject door_info library call into victim process

LIBRARY

Process Control Library (libproc, -lproc)

SYNOPSIS

#include <libproc.h>

int
pr_door_info(struct ps_prochandle *P, int did, struct door_info *info);

DESCRIPTION

The pr_door_info() function injects the door_info(3C) library call into
the target process P by means of the agent LWP. If the process handle
P is NULL then this is equivalent to calling door_info(3C) on the
currently running process.

The arguments did and info have the same meaning as in door_info(3C).
See door_info(3C) for the full description and purpose of the door_info
library call and its arguments.

The pr_door_info() function only works on active processes. Process
handles that correspond to core files, zombie processes, or ELF objects
do not support library call injection.

RETURN VALUES

Upon successful completion, the pr_door_info() function's return value
is that described in door_info(3C). Otherwise, -1 is returned and
errno is set to ENOSYS to indicate that the library call could not be
injected.

ERRORS

For the full list of errors see the ERRORS section in door_info(3C).

The pr_door_info() function will fail if:

ENOSYS An error occurred while trying to invoke the agent
LWP and inject a library call in the process handle
P or the process handle P does not support library
call injection.

INTERFACE STABILITY

Uncommitted

MT-LEVEL
See LOCKING in libproc(3LIB).

SEE ALSO

door_info(3C), libproc(3LIB), proc(5)

illumos November 27, 2023 illumos