Initializes a read-write lock attributes object.

1  –  C Binding

    #include <pthread.h>

    int
    pthread_rwlockattr_init (
             pthread_rwlockattr_t   *attr);

2  –  Arguments

 attr

    Address of the read-write lock attributes object to be
    initialized.

3  –  Description

    This routine initializes the read-write lock attributes object
    referenced by attr and sets its attributes with default values.

    The results of calling this routine are undefined if attr
    references an already initialized read-write lock attributes
    object.

    After an initialized read-write lock attributes object has been
    used to initialize one or more read-write lock objects, any
    operation on that attributes object (including destruction) has
    no effect on those read-write lock objects.

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
    [ENOMEM]    Insufficient memory to initialize the read-write lock
                attributes object

5  –  Associated Routines

       pthread_rwlockattr_destroy()
       pthread_rwlock_init()