PR_STAT(3PROC) Process Control Library Functions PR_STAT(3PROC)
NAME
pr_fstat,
pr_fstat64,
pr_lstat,
pr_lstat64,
pr_stat,
pr_stat64 - inject
stat system call into victim process
LIBRARY
Process Control Library (libproc, -lproc)
SYNOPSIS
#include <libproc.h> int pr_fstat(
struct ps_prochandle *P,
int fd,
struct stat *buf);
int pr_fstat64(
struct ps_prochandle *P,
int fd,
struct stat64 *buf);
int pr_lstat(
struct ps_prochandle *P,
const char *path,
struct stat *buf);
int pr_lstat64(
struct ps_prochandle *P,
const char *path,
struct stat64 *buf);
int pr_stat(
struct ps_prochandle *P,
const char *path,
struct stat *buf);
int pr_stat64(
struct ps_prochandle *P,
const char *path,
struct stat64 *buf);
DESCRIPTION
The
pr_stat(),
pr_lstat(), and
pr_fast() functions inject the
stat(2),
lstat(2), and
fstat(2) system calls respectively into the target process
P by means of the agent LWP. If the process handle
P is the value NULL then
this will be equivalent to calling
stat(2),
lstat(2), or
fstat(2) on the
currently running process.
The arguments
path, and
buf to the
pr_stat() function have the same meaning
as in
stat(2). See
stat(2) for the full description and purpose of the
stat system call and its arguments.
The arguments
fd, and
buf to the
pr_fstat() function have the same meaning
as in
fstat(2), see
fstat(2) for the full description and purpose of the
fstat system call and its arguments.
The arguments
path, and
buf to the
pr_lstat() function have the same
meaning as in
lstat(2), see
lstat(2) for the full description and purpose
of the
lstat system call and its arguments.
The
pr_stat(),
pr_lstat(), and
pr_fstat() functions only work on active
processes. Process handles that correspond to core files, zombie
processes, or ELF objects do not support system call injection.
The
pr_stat64(),
pr_fstat64(), and
pr_lstat64() functions are equivalent to
pr_stat(),
pr_fstat(), and
pr_lstat() respectively; however, rather than
having the stat information be subject to the data model of the target
process, they always provide 64-bit stat information. See
lf64(7) for more
information.
RETURN VALUES
Upon successful completion, the
pr_stat() function's return value is that
described in
stat(2). Otherwise,
-1 is returned and
errno is set to ENOSYS
to indicate that the system call could not be injected.
ERRORS
For the full list of errors see the
ERRORS section in
stat(2).
The
pr_stat() function will fail if:
ENOSYS An error occurred while trying to invoke the agent LWP
and inject a system call in the process handle
P or the
process handle
P does not support system call injection.
INTERFACE STABILITY
UncommittedMT-LEVEL See
LOCKING in
libproc(3LIB).
SEE ALSO
stat(2),
libproc(3LIB),
proc(5),
lf64(7)illumos November 27, 2023 illumos