Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

sigaltstack(2) OSS System Calls Reference Manual
• Compile the application using the -Wlp64 compiler command option.
• Link the application to the yputdll library (/G/system/zdllnnn/yputdll).
To call the sigaltstack() function with the POSIX User Thread Model library, you must specify
the ss parameter as a null pointer. The PUT library will automatically create an alternate signal
stack on behalf of the process. You can use sigaltstack() with the PUT library to obtain informa-
tion about the alternate signal stack.
For detailed information about writing multi-threaded and 64-bit applications for the Open Sys-
tem Services environment, see the Open System Services Programmer’s Guide.
RETURN VALUES
Upon successful completion of the sigaltstack() function, the value 0 (zero) is returned. Other-
wise, the value -1 is returned and errno is set to indicate the error.
ERRORS
If any of the following conditions occurs, the sigaltstack() function sets errno to the correspond-
ing value and no action is taken:
[EFAULT] One of the following conditions exists:
• Either the ss parameter or the oss parameter references an invalid
memory address.
• The specified stack address and size do not describe a valid user stack
segment as created by the STACK_ALLOCATE_() procedure.
[EINVAL] One of the following conditions exists:
• The ss parameter is not a null pointer and the ss_flags field pointed to by
the ss parameter contains flags other than SS_DISABLE.
• The sigaltstack() function is being used in a threaded application that
uses the POSIX User Thread Model library and the ss parameter is not a
null pointer.
[ENOMEM] The size of the alternate stack area is less than MINSIGSTKSZ.
[EPERM] An attempt was made to modify an active stack.
RELATED INFORMATION
Commands: kill(1).
Functions: fork(2), kill(2), pause(3), pthread_sigmask(2), setjmp(3), sigaction(2),
sigaddset(3), sigdelset(3), sigemptyset(3), sigfillset(3), sigismember(3), signal(3), sigproc-
mask(2), sigsuspend(2), umask(2), wait(2).
Files: signal(4).
STANDARDS CONFORMANCE
The POSIX standards leave some features to the implementing vendor to define. The following
features are affected in the HP implementation:
• The ordering of fields within the stack_t structure might not match the ordering used in
signal.h header files in other environments or on other systems.
7−100 Hewlett-Packard Company 527186-023