STACK_GETBOUNDS(3C) Standard C Library Functions STACK_GETBOUNDS(3C)
stack_getbounds - retrieve stack boundaries
#include <ucontext.h>
int stack_getbounds(stack_t *sp);
The stack_getbounds() function retrieves the stack boundaries that
the calling thread is currently operating on. If the thread is
currently operating on the alternate signal stack, this function will
retrieve the bounds of that stack.
If successful, stack_getbounds() sets the ss_sp member of the stack_t
structure pointed to by sp to the base of the stack region and the
ss_size member to its size (maximum extent) in bytes. The ss_flags
member is set to SS_ONSTACK if the calling thread is executing on its
alternate signal stack, and zero otherwise.
Upon successful completion, stack_getbounds() returns 0. Otherwise,
-1 is returned and errno is set to indicate the error.
The stack_getbounds() function will fail if:
EFAULT
The sp argument does not refer to a valid address.
See attributes(7) for descriptions of the following attributes:
+--------------------+-------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-------------------+
|Interface Stability | Evolving |
+--------------------+-------------------+
|MT-Level | Async-Signal-Safe |
+--------------------+-------------------+
getustack(2), sigaction(2), sigaltstack(2), stack_setbounds(3C),
attributes(7)
July 18, 2002 STACK_GETBOUNDS(3C)
NAME
stack_getbounds - retrieve stack boundaries
SYNOPSIS
#include <ucontext.h>
int stack_getbounds(stack_t *sp);
DESCRIPTION
The stack_getbounds() function retrieves the stack boundaries that
the calling thread is currently operating on. If the thread is
currently operating on the alternate signal stack, this function will
retrieve the bounds of that stack.
If successful, stack_getbounds() sets the ss_sp member of the stack_t
structure pointed to by sp to the base of the stack region and the
ss_size member to its size (maximum extent) in bytes. The ss_flags
member is set to SS_ONSTACK if the calling thread is executing on its
alternate signal stack, and zero otherwise.
RETURN VALUES
Upon successful completion, stack_getbounds() returns 0. Otherwise,
-1 is returned and errno is set to indicate the error.
ERRORS
The stack_getbounds() function will fail if:
EFAULT
The sp argument does not refer to a valid address.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+--------------------+-------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-------------------+
|Interface Stability | Evolving |
+--------------------+-------------------+
|MT-Level | Async-Signal-Safe |
+--------------------+-------------------+
SEE ALSO
getustack(2), sigaction(2), sigaltstack(2), stack_setbounds(3C),
attributes(7)
July 18, 2002 STACK_GETBOUNDS(3C)