mutex_trylock (9) - Linux Manuals

mutex_trylock: try to acquire the mutex, without waiting

Command to display mutex_trylock manual in Linux: $ man 9 mutex_trylock

NAME

mutex_trylock - try to acquire the mutex, without waiting

SYNOPSIS

int __sched mutex_trylock(struct mutex * lock);

ARGUMENTS

lock

: the mutex to be acquired

DESCRIPTION

Try to acquire the mutex atomically. Returns 1 if the mutex has been acquired successfully, and 0 on contention.

NOTE

this function follows the spin_trylock convention, so it is negated from the down_trylock return values! Be careful about this when converting semaphore users to mutexes.

This function must not be used in interrupt context. The mutex must be released by the same task that acquired it.

AUTHOR

Rusty Russell <rusty [at] rustcorp.com.au>

: Author.