Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

tis_mutex_destroy(3) [osf1 man page]

tis_mutex_destroy(3)					     Library Functions Manual					      tis_mutex_destroy(3)

NAME
tis_mutex_destroy - Destroys the specified mutex object. LIBRARY
Standard C Library (libc.so, libc.a) SYNOPSIS
#include <tis.h> int tis_mutex_destroy( pthread_mutex_t *mutex); STANDARDS
None PARAMETERS
Address of the mutex object (passed by reference) to be destroyed. DESCRIPTION
This routine destroys a mutex object by uninitializing it, and should be called when a mutex object is no longer referenced. After this routine is called, DECthreads can reclaim internal storage used by the mutex object. It is safe to destroy an initialized mutex that is unlocked. However, it is illegal to destroy a locked mutex object. The results of this routine are unpredictable if the mutex object specified in the mutex argument does not currently exist, or is not ini- tialized. RETURN VALUES
If an error condition occurs, this routine returns an integer value indicating the type of error. Possible return values are as follows: Successful completion. An attempt was made to destroy the object referenced by mutex while it is locked or referenced. The value speci- fied by mutex is invalid. The caller does not have privileges to perform the operation. ERRORS
None RELATED INFORMATION
Functions: tis_mutex_init(3), tis_mutex_lock(3), tis_mutex_trylock(3), tis_mutex_unlock(3) Manuals: Guide to DECthreads and Programmer's Guide delim off tis_mutex_destroy(3)

Check Out this Related Man Page

tis_mutex_lock(3)					     Library Functions Manual						 tis_mutex_lock(3)

NAME
tis_mutex_lock - Locks an unlocked mutex. LIBRARY
Standard C Library (libc.so, libc.a) SYNOPSIS
#include <tis.h> int tis_mutex_lock( pthread_mutex_t *mutex); STANDARDS
None PARAMETERS
Address of the mutex (passed by reference) to be locked. DESCRIPTION
This routine locks the specified mutex mutex. A deadlock can result if the current owner of a mutex calls this routine in an attempt to lock the same mutex a second time. (DECthreads does not detect or report the deadlock.) In a threaded environment, the thread that has locked a mutex becomes its current owner and remains the owner until the same thread has unlocked it. This routine returns with the mutex in the locked state and with the current thread as the mutex's current owner. RETURN VALUES
If an error condition occurs, this routine returns an integer value indicating the type of error. Possible return values are as follows: Successful completion. The value specified by mutex is invalid. A deadlock condition is detected. ERRORS
None RELATED INFORMATION
Functions: tis_mutex_destroy(3), tis_mutex_init(3), tis_mutex_trylock(3), tis_mutex_unlock(3) Manuals: Guide to DECthreads and Programmer's Guide delim off tis_mutex_lock(3)
Man Page

We Also Found This Discussion For You

1. What is on Your Mind?

Throw my Toys out of the Pram!

Hi Folks, Today hasn't been the best one of my career in IT. I've been a contractor for a major utility company for a number of years, on a number of seperate IT contracts mostly Unix. The company had 10 different flavours of unix and multiple different varsions of most of them. At the... (3 Replies)
Discussion started by: gull04
3 Replies