iofunc_attr_trylock()

Try to lock the attribute structure

Synopsis:

#include <sys/iofunc.h>

int iofunc_attr_trylock( iofunc_attr_t *attr );

Arguments:

attr: A pointer to the iofunc_attr_t structure that you want to lock.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

The iofunc_attr_trylock() function attempts to lock the attribute structure attr, preventing other threads in the resource manager from changing information. If it can't lock attr immediately, it returns EBUSY.

Call this function (or iofunc_attr_lock()) before you make any modifications to the attribute structure. After you're finished making modifications, call iofunc_attr_unlock() to release the lock.

Note that this is a counting locking mechanism. This means that a given thread can lock the attributes structure multiple times; it must then unlock the attributes structure a corresponding number of times in order to have the attributes structure considered unlocked. If another thread attempts to lock the structure while a thread has the structure locked, the other thread will block.

Returns:

EOK: Success.
EBUSY: The calling thread couldn't lock the attributes immediately.
EAGAIN: On the first use, all kernel mutex objects were in use.

Classification:

QNX Neutrino

Safety:
Cancellation point	Yes
Interrupt handler	No
Signal handler	Yes
Thread	Yes