pthread_mutex

#include <pthread.h>

pthread_mutex_t mutex = PTHREAD_MUTEX_INITIALIZER;

int pthread_mutex_init( pthread_mutex_t *mutex,

const pthread_mutexattr_t *attr );

mutex

Указатель на объект pthread_mutex_t, который необходимо инициализировать.

attr

NULL, или указатель на объект pthread_mutexattr_t, который указывает атрибуты, которые требуется использовать для мьютекса. Для получения дополнительной информации см. pthread_mutexattr_init().

Описание:

Функция pthread_mutex_init() инициализирует мьютекс, используя атрибуты, указанные объектом атрибутов мьютекса attr. Если attr равен NULL, то мьютекс инициализируется с атрибутами по умолчанию (см. pthread_mutexattr_init()). После инициализации мьютекс находится в разблокированном состоянии.

Необходимо выделять объекты синхронизации только в обычной памяти. На некоторых процессорах (например, на некоторых PPC) атомарные операции, такие как вызовы pthread_mutex_lock(), приведут к возникновению ошибки, если управляющая структура размещена в некэшированной памяти.

Можно инициализировать статически выделенный мьютекс с атрибутами по умолчанию, назначив ему макрос PTHREAD_MUTEX_INITIALIZER или PTHREAD_RMUTEX_INITIALIZER (для рекурсивных мьютексов).

Чтобы уничтожить мьютекс, следует вызвать pthread_mutex_destroy(). После уничтожения мьютекса, не допускается его использование без повторной инициализации с помощью вызова pthread_mutex_init().

Возвращаемое значение:

EOK

Успешное завершение.

EAGAIN

Все объекты синхронизации ядра в данный момент используются.

EBUSY

Данный мьютекс ранее был инициализирован и не был уничтожен.

EFAULT

Произошла ошибка при попытке ядра получить доступ mutex или attr.

EINVAL

Некорректное значение attr.

pthread_mutex_init()

Прототип:

Аргументы:

Библиотека:

Описание:

Возвращаемое значение:

Классификация:

Тематические ссылки: