*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->Tru64 Unix man pages -> pthread_mutexattr_init (3)              



NAME    [Toc]    [Back]

       pthread_mutexattr_init  -  Initializes  a mutex attributes

SYNOPSIS    [Toc]    [Back]

       #include <pthread.h>

       int pthread_mutexattr_init(
               pthread_mutexattr_t *attr );

LIBRARY    [Toc]    [Back]

       DECthreads POSIX 1003.1c Library (libpthread.so)

STANDARDS    [Toc]    [Back]

       Interfaces documented on this reference  page  conform  to
       industry standards as follows:

       IEEE  Std  1003.1c-1995,  POSIX System Application Program

PARAMETERS    [Toc]    [Back]

       Address of the mutex attributes object to be  initialized.

DESCRIPTION    [Toc]    [Back]

       This routine initializes the mutex attributes object specified
 by the attr argument with a set of default values. A
       mutex  attributes object is used to specify the attributes
       of  one  or  more  mutexes  when  they  are  created.  The
       attributes  object created by this routine is used only in
       calls to the pthread_mutex_init(3) routine.

       When a mutex attributes object is used to create a  mutex,
       the  values  of  the  individual  attributes determine the
       characteristics  of  the  new  mutex.   Thus,   attributes
       objects  act  as  additional  arguments to mutex creation.
       Changing individual attributes  in  an  attributes  object
       does  not  affect any mutexes that were previously created
       using that attributes object.

       You can use the same mutex attributes object in successive
       calls to pthread_mutex_init(3), from any thread. If multiple
 threads  can  change  attributes  in  a  shared  mutex
       attributes  object,  your program must use a mutex to protect
 the integrity of the attributes object's contents.

       Results are undefined if this routine is  called  and  the
       attr  argument specifies a mutex attributes object that is
       already initialized.

RETURN VALUES    [Toc]    [Back]

       If an error condition  occurs,  this  routine  returns  an
       integer  value  indicating  the  type  of  error. Possible
       return  values  are  as  follows:  Successful  completion.
       Insufficient memory to create the mutex attributes object.

ERRORS    [Toc]    [Back]


SEE ALSO    [Toc]    [Back]

       Functions:  pthread_mutexattr_destroy(3),   pthread_mutexattr_gettype(3),             pthread_mutexattr_settype(3),

       Manuals: Guide to DECthreads and Programmer's Guide

[ Back ]
 Similar pages
Name OS Title
tis_mutex_init Tru64 Initializes a mutex object
pthread_mutexattr_gettype Tru64 Obtains the mutex type attribute in the specified mutex attributes object
pthread_attr_init Tru64 Initializes a thread attributes object
pthread_condattr_init Tru64 Initializes a condition variable attributes object
pthread_mutexattr_destroy Tru64 Destroys the specified mutex attributes object
pthread_mutexattr_setpshared Tru64 Sets the process-shared attribute of a mutex attributes object
pthread_mutexattr_getpshared Tru64 Obtains the process-shared attribute of a mutex attributes object
pthread_mutex_init Tru64 Initializes a mutex
tis_rwlock_init Tru64 Initializes a read-write lock object
pthread_rwlock_init Tru64 Initializes a read-write lock object
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service