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

  man pages->FreeBSD man pages -> pthread_mutexattr (3)              
Title
Content
Arch
Section
 

PTHREAD_MUTEXATTR(3)

Contents


NAME    [Toc]    [Back]

     pthread_mutexattr_init, pthread_mutexattr_destroy,
     pthread_mutexattr_setprioceiling, pthread_mutexattr_getprioceiling,
     pthread_mutexattr_setprotocol, pthread_mutexattr_getprotocol,
     pthread_mutexattr_settype, pthread_mutexattr_gettype -- mutex attribute
     operations

LIBRARY    [Toc]    [Back]

     Reentrant C Library (libc_r, -lc_r)

SYNOPSIS    [Toc]    [Back]

     #include <pthread.h>

     int
     pthread_mutexattr_init(pthread_mutexattr_t *attr);

     int
     pthread_mutexattr_destroy(pthread_mutexattr_t *attr);

     int
     pthread_mutexattr_setprioceiling(pthread_mutexattr_t *attr,
	 int prioceiling);

     int
     pthread_mutexattr_getprioceiling(pthread_mutexattr_t *attr,
	 int *prioceiling);

     int
     pthread_mutexattr_setprotocol(pthread_mutexattr_t *attr, int protocol);

     int
     pthread_mutexattr_getprotocol(pthread_mutexattr_t *attr, int *protocol);

     int
     pthread_mutexattr_settype(pthread_mutexattr_t *attr, int type);

     int
     pthread_mutexattr_gettype(pthread_mutexattr_t *attr, int *type);

DESCRIPTION    [Toc]    [Back]

     Mutex attributes are used to specify parameters to pthread_mutex_init().
     One attribute object can be used in multiple calls to
     pthread_mutex_init(), with or without modifications between calls.

     The pthread_mutexattr_init() function initializes attr with all the
     default mutex attributes.

     The pthread_mutexattr_destroy() function destroys attr.

     The pthread_mutexattr_set*() functions set the attribute that corresponds
     to each function name.

     The pthread_mutexattr_get*() functions copy the value of the attribute
     that corresponds to each function name to the location pointed to by the
     second function parameter.

RETURN VALUES    [Toc]    [Back]

     If successful, these functions return 0.  Otherwise, an error number is
     returned to indicate the error.

ERRORS    [Toc]    [Back]

     The pthread_mutexattr_init() function will fail if:

     [ENOMEM]		Out of memory.

     The pthread_mutexattr_destroy() function will fail if:

     [EINVAL]		Invalid value for attr.

     The pthread_mutexattr_setprioceiling() function will fail if:

     [EINVAL]		Invalid value for attr, or invalid value for
			prioceiling.

     The pthread_mutexattr_getprioceiling() function will fail if:

     [EINVAL]		Invalid value for attr.

     The pthread_mutexattr_setprotocol() function will fail if:

     [EINVAL]		Invalid value for attr, or invalid value for protocol.

     The pthread_mutexattr_getprotocol() function will fail if:

     [EINVAL]		Invalid value for attr.

     The pthread_mutexattr_settype() function will fail if:

     [EINVAL]		Invalid value for attr, or invalid value for type.

     The pthread_mutexattr_gettype() function will fail if:

     [EINVAL]		Invalid value for attr.

SEE ALSO    [Toc]    [Back]

      
      
     pthread_mutex_init(3)

STANDARDS    [Toc]    [Back]

     The pthread_mutexattr_init() and pthread_mutexattr_destroy() functions
     conform to ISO/IEC 9945-1:1996 (``POSIX.1'')

     The pthread_mutexattr_setprioceiling(),
     pthread_mutexattr_getprioceiling(), pthread_mutexattr_setprotocol(),
     pthread_mutexattr_getprotocol(), pthread_mutexattr_settype(), and
     pthread_mutexattr_gettype() functions conform to Version 2 of the Single
     UNIX Specification (``SUSv2'')


FreeBSD 5.2.1			  May 1, 2000			 FreeBSD 5.2.1
[ Back ]
 Similar pages
Name OS Title
pthread_mutexattr_getkind_np FreeBSD mutex attribute operations (legacy)
pthread_mutexattr_setkind_np FreeBSD mutex attribute operations (legacy)
pthread_mutexattr_gettype Tru64 Obtains the mutex type attribute in the specified mutex attributes object
pthread_mutexattr_settype Tru64 Specifies the mutex type attribute that is used when a mutex is created
pthread_mutexattr_settype IRIX set/get a mutex attribute object's type
pthread_mutexattr_setprotocol IRIX set/get a mutex attribute object's priority and protocol
pthread_mutexattr_init IRIX initialize/destroy a mutex attribute object
pthread_mutexattr_getpshared Tru64 Obtains the process-shared attribute of a mutex attributes object
pthread_mutexattr_setpshared Tru64 Sets the process-shared attribute of a mutex attributes object
pthread_attr_getguardsize FreeBSD thread attribute operations
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service