SEMGET(2)

NAZWA
semget - pobranie identyfikatora zestawu semaforów

SKŁADNIA
#include <sys/types.h>
#include <sys/ipc.h>
#include <sys/sem.h>

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

OPIS
Uwaga! To tłumaczenie może być nieaktualne!

Funkcja ta zwraca identyfikator zestawu semaforów, skojarzonego z parametrem key. Jeśli key ma wartość IPC_PRIVATE lub, gdy z wartością key nie jest skojarzony żaden istniejący zestaw semaforów, a w parametrze semflg został przekazany znacznik IPC_CREAT (tzn. semflg & IPC_CREAT jest niezerowe), to tworzony jest nowy zestaw semaforów nsems.

Znaczniki IPC_CREAT i IPC_EXCL przekazywane parametrem semflg pełnią tę samą rolę w obsłudze semaforów, co O_CREAT i O_EXCL w parametrze mode funkcji systemowej open(2): np. funkcja semget zgłosi błąd, jeśli w semflg przekazane zostaną obydwa znaczniki IPC_CREAT i IPC_EXCL, zaś zestaw semaforów identyfikowany kluczem key już będzie istnieć.

Podczas tworzenia, 9 najmniej znaczących bitów argumentu semflg określa prawa dostępu do zestawu semaforów (dla właściciela, grupy i innych). Prawa dostępu mają ten sam format i takie samo znaczenie, co parametr mode funkcji systemowych open(2) i creat(2) (bity praw uruchamiania nie są istotne dla semaforów, natomiast bity praw zapisu oznaczają możliwość zmiany wartości semaforów).

Podczas tworzenia nowego zestawu semaforów semget inicjalizuje strukturę semid_ds związaną z zestawem semaforów w następujący sposób:

    sem_perm.cuid oraz sem_perm.uid przypisany zostanie efektywny identyfikator użytkownika procesu wywołującego.

    sem_perm.cgid oraz sem_perm.gid przypisany zostanie efektywny identyfikator grupy procesu wywołującego.

    9 najmniej znaczącym bitom pola sem_perm.mode zostaną przypisane ich odpowiedniki z parametru semflg.

    Polu sem_nsems przypisania zostanie, zawarta w parametrze nsems, liczba semaforów w zestawie.

    sem_otime przyjmie wartość 0.

    sem_ctime przypisany zostanie aktualny czas.

Parametr nsems może mieć wartość 0 (nie jest brany pod uwagę), jeśli nie będzie tworzony zestaw semaforów. W przeciwnym przypadku parametr nsems musi być większy od 0 i mniejszy lub równy maksymalnej liczbie semaforów w zestawie (SEMMSL).

Jeśli zestaw semaforów już istnieje, wówczas weryfikowane są prawa dostępu.

WARTOŚĆ ZWRACANA
W wyniku pomyślnego wykonania wywołania, funkcja zwróci identyfikator zestawu semaforów (nieujemną liczbę całkowitą). W przeciwnym przypadku zwróci -1, zaś zmiennej errno zostanie przypisany kod wskazujący rodzaj błędu.

BŁĘDY
W przypadku niepowodzenia, zmiennej errno zostanie przypisana jedna z następujących wartości:

EACCES
    Zestaw semaforów identyfikowany kluczem key istnieje, ale proces wywołujący nie ma praw dostępu do niego.

EEXIST
    Zestaw semaforów o identyfikatorze key istnieje, ale w parametrze semflg przekazane zostały jednocześnie oba znaczniki IPC_CREAT i IPC_EXCL.

ENOENT
    Nie ma zestawu semaforów o identyfikatorze key, zaś znacznik IPC_CREAT nie został przekazany w parametrze semflg.

EINVAL
    nsems jest mniejsze niż 0 lub większe niż ograniczenie liczby semaforów w zestawie (SEMMSL), lub zestaw semaforów, do któregoodnosi się key już istnieje a nsems jest większe niż liczba semaforów w tym zestawie.

ENOMEM
    Zestaw semaforów powinien zostać utworzony, ale zabrakło pamięci na nową strukturę danych.

ENOSPC
    Nastąpiła próba przekroczenia ograniczenia liczby zestawów (SEMMNI), lub łącznej liczby semaforów w systemie (SEMMNS).

UWAGI
Stała IPC_PRIVATE nie jest znacznikiem, tylko specjalną wartością typu key_t. Jeśli zostanie ona przekazana jako wartość parametru key, wówczas (w razie pomyślnego wykonania) funkcja systemowa pominie wszystko oprócz najmniej znaczących 9 bitów semflg, tworząc nowy zestaw semaforów, nie posiadający identyfikatora.

Występują następujące ograniczenia zasobów systemowych, związane z wywołaniem semget:

SEMMNI
    Maksymalna liczba zestawów semaforów w systemie: zależna od polityki.

SEMMSL
    Maksymalna liczba semaforów w zestawie: zależna od implementacji (aktualnie 500).

SEMMNS
    Maksymalna liczba semaforów w systemie: zależna od polityki. Wartość większa niż SEMMSL * SEMMNI pozbawia to ograniczenie sensu.

USTERKI
Wybrana nazwa, IPC_PRIVATE, prawdopodobnie nie jest najszczęśliwsza. IPC_NEW w sposób bardziej przejrzysty odzwierciedlało by rolę tej wartości.

Struktury danych skojarzone z poszczególnymi semaforami z zestawu nie są inicjalizowane przez wywołanie systemowe. Aby zainicjalizować te struktury, należy następnie użyć dla tego zestawu semaforów wywołania semctl(2) z rozkazami SETVAL lub SETALL.

ZGODNE Z
SVr4, SVID. SVr4 dokumentuje dodatkowe stałe błędów: EFBIG, E2BIG, EAGAIN, ERANGE, EFAULT.

ZOBACZ TAKŻE
ftok(3), ipc(5), semctl(2), semop(2)

INFORMACJE O TŁUMACZENIU
Powyższe tłumaczenie pochodzi z nieistniejącego już Projektu Tłumaczenia Manuali i może nie być aktualne. W razie zauważenia różnic między powyższym opisem a rzeczywistym zachowaniem opisywanego programu lub funkcji, prosimy o zapoznanie się z oryginalną (angielską) wersją strony podręcznika za pomocą polecenia:

    man --locale=C 2 semget

Prosimy o pomoc w aktualizacji stron man - więcej informacji można znaleźć pod adresem http://sourceforge.net/projects/manpages-pl/.