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

usleep(3) OSS Library Calls Reference Manual
value of the signal mask when the corresponding sigsetjmp( ) function was called.
NOTES
The usleep( ) function is not supported for non-threaded applications.
To use the usleep() functionality in a threaded application that uses the Standard POSIX Threads
library, see spt_usleep(2).
To use this function in a threaded application that uses the POSIX User Thread Model library on
systems running H06.21 or later RVUs or J06.10 or later RVUs, you must perform all of the fol-
lowing tasks to make the function thread-aware in a multi-threaded application:
• Compile the application using the _PUT_MODEL_ feature test macro or equivalent
compiler command option.
• Link the application to the zputdll library (/G/system/zdllnnn/zputdll).
On systems running H06.24 or later H-series RVUs or J06.13 or later J-series RVUs, you can use |
this function with 32-bit or 64-bit threaded applications.
To use this function in a 32-bit threaded application on systems running H06.24 or later RVUs or |
J06.13 or later RVUs, perform the same tasks (described above) used to make the function |
thread-aware in a multi-threaded application on systems running H06.21/J06.10 or later RVUs.
To use this function in a 64-bit threaded application on systems running H06.24 or later RVUs or |
J06.13 or later RVUs, you must perform all of the following tasks to make the function thread- |
aware in a multi-threaded application:
• Compile the application using the _PUT_MODEL_ feature test macro or equivalent |
compiler command option.
• Compile the application using the -Wlp64 compiler command option. |
• Link the application to the yputdll library (/G/system/zdllnnn/yputdll). |
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
If the usleep( ) function returns because the requested time has elapsed, the value 0 (zero) is
returned. If the usleep( ) function returns because a signal was caught, the number of
microseconds still remaining when the signal was delivered is returned. If the function call fails,
the value -1 is returned and errno is set to indicate the error.
ERRORS
If the following condition occurs, the usleep( ) function sets errno to the corresponding value:
[EINVAL] The value specified for the useconds parameter was greater than 1000000.
If a signal is received via pthread_kill(2) that is not blocked, ignored, or handled, -1 is returned
with an errno of EINTR.
RELATED INFORMATION
Functions: alarm(3), pause(3), sigaction(2). sleep(3), spt_usleep(2).
7−80 Hewlett-Packard Company 527187-017