Obtains a value representing a desired expiration time.

1  –  C Binding

    #include <pthread.h>

    int
    pthread_get_expiration_np (
                const struct timespec   *delta,
                struct timespec   *abstime);

2  –  Arguments

 delta

    Number of seconds and nanoseconds to add to the current system
    time. (The result is the time in the future.) This result will be
    placed in abstime.

 abstime

    Value representing the absolute expiration time. The absolute
    expiration time is obtained by adding delta to the current system
    time. The resulting abstime is in Universal Coordinated Time
    (UTC).

3  –  Description

    This routine adds a specified interval to the current absolute
    system time and returns a new absolute time. This new absolute
    time may then be used as the expiration time in a call to
    pthread_cond_timedwait().

    The timespec structure contains the following two fields:

    o  tv_sec is an integral number of seconds.

    o  tv_nsec is an integral number of nanoseconds.

4  –  Return Values

    If an error condition occurs, this routine returns an integer
    value indicating the type of error. Possible return values are as
    follows:

    Return      Description

    0           Successful completion.
    [EINVAL]    The value specified by delta is invalid.

5  –  Associated Routines

       pthread_cond_timedwait()