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

Pasfd
obtain the process address space file descriptor

Process Control Library (libproc, -lproc)

#include <libproc.h>

int
Pasfd(struct ps_prochandle *P);

The Pasfd() funtion returns a file descriptor that allows direct access to the address space of the process handle P. A defined file descriptor is provided when using the Pcreate(3PROC), Pgrab(3PROC), Pgrab_file(3PROC), and Pgrab_core(3PROC) functions. Note that the address space may be different in each of these cases and doesn't necessarily correspond to the /proc as file, except for live processes. Other means of obtaining a libproc process handle may not define a file descriptor that contains the address space.

The returned file descriptor must not be closed and is only valid for as long as the corresponding process handle P is valid. After a call to Prelease(3PROC) the file descriptor is invalidated.

Upon successful completion, the Pasfd() function returns a valid file descriptor. Otherwise, if none exists, then -1 is returned.

Uncommitted

See LOCKING in libproc(3LIB).

libproc(3LIB), Pcreate(3PROC), Pgrab(3PROC), Pgrab_core(3PROC), Pgrab_file(3PROC), Prelease(3PROC), proc(5)
May 11, 2016 OmniOS