ИМЯ¶

semget - считывает идентификатор набора семафоров System V

СИНТАКСИС¶

#include <sys/types.h>
#include <sys/ipc.h>
#include <sys/sem.h>

int semget(key_t key, int nsems, int semflg);

ОПИСАНИЕ¶

Системный вызов semget() возвращает идентификатор набора семафоров System V, связанный со значением аргумента key. Его можно использовать для получения идентификатора уже созданного набора семафоров (если semflg равно нулю и значение key не равно IPC_PRIVATE) или для создания нового.

Новый набор семафоров nsems создаётся, если значение key равно IPC_PRIVATE или с ключом key не связано ни одного существующего набора семафоров, а в semflg задано IPC_CREAT.

Если в semflg одновременно указаны IPC_CREAT и IPC_EXCL и набор семафоров для key уже существует, то semget() завершается с ошибкой и errno присваивается значение EEXIST (такой же результат как с O_CREAT | O_EXCL у open(2)).

При создании в 9 начальных битах аргумента semflg указываются права (владелец, группа и др.) на набор семафоров. Формат значения битов совпадает с аргументом mode вызова open(2) (но права на выполнение для семафоров ничего не означают, а права на запись означают право изменять значения семафоров).

При создании нового набора семафоров semget() инициализирует связанную с семафором структуру данных semid_ds (см. semctl(2)) следующим образом:

Полям sem_perm.cuid и sem_perm.uid присваиваются значения эффективного идентификатора пользователя вызывающего процесса.

Полям sem_perm.cgid и sem_perm.gid присваиваются значения эффективного идентификатора группы вызывающего процесса.

Младшим 9 битам sem_perm.mode присваивается значение младших 9 бит semflg.

Полю sem_nsems присваивается значение nsems.

Полю sem_otime присваивается значение 0.

Полю sem_ctime присваивается значение текущего времени.

Если набор семафоров не создаётся, то аргумент nsems может быть равен 0 (не учитывать). Иначе аргумент nsems должен быть больше 0 и меньше или равен максимальному количеству семафоров в наборе (SEMMSL).

Если набор семафоров уже существует, то проверяются права доступа.

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶

При успешном выполнении возвращается идентификатор набора семафоров (неотрицательное целое), иначе возвращается -1, а переменной errno присваивается номер ошибки.

ОШИБКИ¶

При ошибке errno присваиваются следующие значения:

EACCES

Набор семафоров для ключа key существует, но вызывающий процесс не имеет прав доступа к нему и не имеет мандата CAP_IPC_OWNER в пространстве имён пользователя, который управляет его пространством имён IPC.

EEXIST

В semflg указаны IPC_CREAT и IPC_EXCL, но набор семафоров уже существует для key.

EINVAL

Значение nsems меньше 0 или больше максимально возможного для набора количества семафоров (SEMMSL).

EINVAL

Набор семафоров, соответствующий key, уже существует, но nsems больше, чем количество семафоров в этом наборе.

ENOENT

Для ключа key не существует набора семафоров и в semflg нет флага IPC_CREAT.

ENOMEM

Набор семафоров должен быть создан, но в системе не хватает памяти для хранения новой структуры данных.

ENOSPC

Набор семафоров должен быть создан, но при этом будет превышен системный лимит на количество наборов семафоров (SEMMNI) или системный лимит на количество семафоров (SEMMNS).

СООТВЕТСТВИЕ СТАНДАРТАМ¶

SVr4, POSIX.1-2001.

ЗАМЕЧАНИЯ¶

Включение файлов <sys/types.h> и <sys/ipc.h> не требуется в Linux или любых версий POSIX. Однако, некоторые старые реализации требуют включения данных заголовочных файлов, и это также требуется по SVID. В приложениях, которые нужно перенести на такие старые системы, может потребоваться включить данных заголовочные файлы.

Значение IPC_PRIVATE не поле флага, а тип key_t. Если key равно этому специальному значению, то системный вызов игнорирует всё кроме 9-ти младших битов semflg и создаёт новый набор семафоров (при успешном выполнении).

ДЕФЕКТЫ¶

Имя IPC_PRIVATE, возможно, было выбрано неудачно, IPC_NEW отражает смысл действия более ясно.

СМ. ТАКЖЕ¶

semctl(2), semop(2), ftok(3), capabilities(7), sem_overview(7), svipc(7)

ЗАМЕЧАНИЯ¶

Эта страница является частью проекта Linux man-pages версии 4.16. Описание проекта, информацию об ошибках и последнюю версию этой страницы можно найти по адресу https://www.kernel.org/doc/man-pages/.

ПЕРЕВОД¶

Русский перевод этой страницы руководства был сделан Alexander Golubev <fatzer2@gmail.com>, Azamat Hackimov <azamat.hackimov@gmail.com>, Hotellook, Nikita <zxcvbnm3230@mail.ru>, Spiros Georgaras <sng@hellug.gr>, Vladislav <ivladislavefimov@gmail.com>, Yuri Kozlov <yuray@komyakino.ru> и Иван Павлов <pavia00@gmail.com>

Этот перевод является бесплатной документацией; прочитайте Стандартную общественную лицензию GNU версии 3 или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ.

Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на man-pages-ru-talks@lists.sourceforge.net.