pthread_spin_init()

Инициализировать циклическую блокировку

Прототип:

#include <pthread.h>
int pthread_spin_init( pthread_spinlock_t *spinner,
int pshared );

Аргументы:

spinner
Указатель на объект pthread_spinlock_t, который требуется инициализировать.
pshared
Значение, которое требуется использовать для межпроцессного атрибута циклической блокировки. Возможные значения:
PTHREAD_PROCESS_SHARED
циклическая блокировка может использоваться любым потоком, имеющим доступ к памяти, в которой выделена циклическая блокировка, даже если она выделена в памяти, совместно используемой несколькими процессами.
PTHREAD_PROCESS_PRIVATE
с циклической блокировкой могут работать только потоки, созданные в том же процессе, что и поток, инициализировавший циклическую блокировку. Если потоки разных процессов пытаются работать с такой циклической блокировкой, поведение не определено.

Библиотека:

libc

Описание:

Функция pthread_spin_init() выделяет ресурсы, необходимые для циклической блокировки потока spinner, и инициализирует spinner в разблокированном состоянии.

Любой поток, который может получить доступ к памяти, где выделена циклическая блокировка, может работать с циклической блокировкой.

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

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

Нуль в случае успеха или номер ошибки, указывающий на ошибку.

Коды ошибок:

EAGAIN
В системе нет ресурсов, необходимых для инициализации новой циклической блокировки.
EBUSY
Циклическая блокировка процесса spinner используется другим потоком и не может быть инициализирована.
EINVAL
Некорректный объект pthread_spinlock_t spinner.
ENOMEM
В системе недостаточно свободной памяти для создания новой циклической блокировки.

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

POSIX 1003.1 THR SPI

Точка остановки потока
Нет
Обработчик прерываний
Нет
Обработчик сигналов
Да
В потоке
Да

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

pthread_spin_destroy(), pthread_spin_lock(), pthread_spin_trylock(), pthread_spin_unlock()




Предыдущий раздел: Описание API системной библиотеки