pthread__mutex__attr_8h_source.html

/*

 * Copyright (C) 2014 Freie Universität Berlin

 *

 * This file is subject to the terms and conditions of the GNU Lesser

 * General Public License v2.1. See the file LICENSE in the top level

 * directory for more details.

 */


#ifndef PTHREAD_MUTEX_ATTR_H

#define PTHREAD_MUTEX_ATTR_H


#include <errno.h>


#ifdef __cplusplus

extern "C" {

#endif


#define PTHREAD_MUTEX_NORMAL     0

#define PTHREAD_MUTEX_RECURSIVE  1

#define PTHREAD_MUTEX_ERRORCHECK 2

#define PTHREAD_MUTEX_DEFAULT    PTHREAD_MUTEX_NORMAL


#define PTHREAD_PRIO_NONE        0

#define PTHREAD_PRIO_INHERIT     1


#define PTHREAD_PRIO_PROTECT     2

#define PTHREAD_MUTEX_STALLED    0

#define PTHREAD_MUTEX_ROBUST     1


typedef struct

{

    int pshared;

    int kind;

    int protocol;

    int robustness;

} pthread_mutexattr_t;


int pthread_mutexattr_init(pthread_mutexattr_t *attr);


int pthread_mutexattr_destroy(pthread_mutexattr_t *attr);


int pthread_mutexattr_getpshared(const pthread_mutexattr_t *attr, int *pshared);


int pthread_mutexattr_setpshared(pthread_mutexattr_t *attr, int pshared);


int pthread_mutexattr_gettype(const pthread_mutexattr_t *attr, int *kind);


int pthread_mutexattr_settype(pthread_mutexattr_t *attr, int kind);


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


int pthread_mutexattr_setprotocol(pthread_mutexattr_t *attr, int protocol);


/* Return in *PRIOCEILING the mutex prioceiling attribute in *ATTR.  */

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


/* Set the mutex prioceiling attribute in *ATTR to PRIOCEILING.  */

int pthread_mutexattr_setprioceiling(pthread_mutexattr_t *attr, int prioceiling);


int pthread_mutexattr_getrobust(const pthread_mutexattr_t *attr, int *robustness);


int pthread_mutexattr_setrobust(pthread_mutexattr_t *attr, int robustness);


#ifdef __cplusplus

}

#endif


#endif /* PTHREAD_MUTEX_ATTR_H */


errno.h

pthread_mutexattr_getprotocol
int pthread_mutexattr_getprotocol(const pthread_mutexattr_t *attr, int *protocol)
Query the priority inheritance of the mutex to create.

pthread_mutexattr_destroy
int pthread_mutexattr_destroy(pthread_mutexattr_t *attr)
Destroys a pthread_mutexattr_t.

pthread_mutexattr_getrobust
int pthread_mutexattr_getrobust(const pthread_mutexattr_t *attr, int *robustness)
Query the attribute set whether to create a robut mutex.

pthread_mutexattr_settype
int pthread_mutexattr_settype(pthread_mutexattr_t *attr, int kind)
Sets the type of the mutex to create.

pthread_mutexattr_setpshared
int pthread_mutexattr_setpshared(pthread_mutexattr_t *attr, int pshared)
Set whether to share the mutex with child processes.

pthread_mutexattr_setrobust
int pthread_mutexattr_setrobust(pthread_mutexattr_t *attr, int robustness)
Set whether the mutex to create should be robust.

pthread_mutexattr_gettype
int pthread_mutexattr_gettype(const pthread_mutexattr_t *attr, int *kind)
Query the type of the mutex to create.

pthread_mutexattr_setprotocol
int pthread_mutexattr_setprotocol(pthread_mutexattr_t *attr, int protocol)
Sets the priority inheritance of the mutex to create.

pthread_mutexattr_getpshared
int pthread_mutexattr_getpshared(const pthread_mutexattr_t *attr, int *pshared)
Queries the attribute set whether to share the mutex with child processes.

pthread_mutexattr_init
int pthread_mutexattr_init(pthread_mutexattr_t *attr)
Initialize a pthread_mutexattr_t.

pthread_mutexattr_t
This type is unused right now, and only exists for POSIX compatibility.
Definition pthread_mutex_attr.h:89

pthread_mutexattr_t::kind
int kind
Type of the mutex.
Definition pthread_mutex_attr.h:91

pthread_mutexattr_t::protocol
int protocol
Priority inheritance of the mutex.
Definition pthread_mutex_attr.h:92

pthread_mutexattr_t::pshared
int pshared
Whether to share the mutex with child processes.
Definition pthread_mutex_attr.h:90

pthread_mutexattr_t::robustness
int robustness
What to do if a thread terminates while it holds a mutex.
Definition pthread_mutex_attr.h:93