NAME

Plwp_getgwindows — get thread unspilled register windows

LIBRARY

Process Control Library (libproc, -lproc)

SYNOPSIS

#include <libproc.h>

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(5).

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).