PLWP_GETGWINDOWS(3PROC) Process Control Library Functions

NAME


Plwp_getgwindows - get thread unspilled register windows

SYNOPSIS


int
Plwp_getgwindows(struct ps_prochandle *P, lwpid_t lwpid,
gwindows_t *gwins);

DESCRIPTION


The Plwp_getgwindows() function returns information about register windows
that were not spilled to the stack for the thread identified by lwpid in
the process handle P. The argument gwins will be filled in with
information about the register windows.

RETURN VALUES


Upon successful completion, the Plwp_getgwindows() function returns 0 and
gwins is filled in with information about the windows. Otherwise, -1 is
returned and errno is set to indicate the error.

ERRORS


For a full list of possible errors see the DIAGNOSTICS section in proc(4).

The Plwp_getgwindows() function will fail if:

ENODATA The process handle P does not have any gwindows
information.

EBUSY The process handle P refers to a live process and it is
not stopped.

ENOENT The process handle P refers to a live process and there
is no thread with id lwpid.

EINVAL The process handle P refers to a core file and there is
no thread with id lwpid.

ARCHITECTURE


The Plwp_getgwindows() function is only available on SPARC platforms.

INTERFACE STABILITY


Uncommitted

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

SEE ALSO


libproc(3LIB), proc(4)

illumos May 11, 2016 illumos