Ubuntu Manpage: semget - pobranie identyfikatora zestawu semaforów Systemu V

nazwa
składnia
opis
wartość zwracana
błędy
zgodne z
uwagi
usterki
zobacz także
o stronie
tłumaczenie

NAZWA

       semget - pobranie identyfikatora zestawu semaforów Systemu V

SKŁADNIA

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

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

OPIS

Wywołanie systemowe semget() zwraca identyfikator zestawu semaforów Systemu V skojarzonego z parametrem
key. Nowy zestaw składający się z nsems semaforów zostanie utworzony, jeśli parametr key będzie mieć
wartość IPC_PRIVATE lub gdy zestaw semaforów skojarzony z key nie istnieje, a w parametrze semflg
zostanie przekazany znacznik IPC_CREAT.

Jeśli w parametrze semflg podano zarówno IPC_CREAT, jak i IPC_EXCL oraz już istnieje zestaw semaforów o
kluczu key, to semget() kończy się błędem, ustawiając errno na wartość EEXIST. (Działa to analogicznie do
O_CREAT | O_EXCL w open(2)).

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). Bity te mają ten sam format i takie samo znaczenie, jak parametr mode
wywołania open(2) (prawa uruchamiania nie są istotne dla semaforów, natomiast prawa zapisu oznaczają
możliwość zmiany wartości semaforów).

Podczas tworzenia nowego zestawu semaforów semget() inicjuje związaną z zestawem semaforów strukturę
semid_ds (patrz semctl(2)) w następujący sposób:

sem_perm.cuid i sem_perm.uid przyjmują wartość efektywnego identyfikatora właściciela procesu
wywołującego.

sem_perm.cgid i sem_perm.gid przyjmują wartość efektywnego identyfikatora grupy procesu
wywołującego.

9 najmniej znaczących bitów pola sem_perm.mode jest kopiowanych z 9 najmniej znaczących bitów
semflg.

sem_nsems jest ustawiane na wartość nsems.

sem_otime przyjmie wartość 0.

sem_ctime przypisywany jest bieżący 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żeli zestaw semaforów już istnieje, to weryfikowane są uprawnienia.

WARTOŚĆ ZWRACANA

       W  przypadku pomyślnego zakończenia, funkcja zwraca identyfikator zestawu semaforów (liczbę nieujemną), a
       w przeciwnym przypadku zwraca -1 i przypisuje zmiennej errno stosowną wartość.

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  ani  nie  ma  praw
              dostępu do niego, ani nie ma ustawionego atrybutu CAP_IPC_OWNER.

       EEXIST IPC_CREAT i IPC_EXCL określono w semflg, lecz zestaw semaforów dla key już istnieje.

       EINVAL nsems jest mniejsze niż 0 lub większe niż ograniczenie liczby semaforów w zestawie (SEMMSL)

       EINVAL Zestaw  semaforów,  do  którego  odnosi  się  key już istnieje, lecz nsems jest większe niż liczba
              semaforów w tym zestawie.

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

       ENOMEM Zestaw  semaforów  powinien zostać utworzony, ale w systemie brak jest pamięci na utworzenie nowej
              struktury danych.

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

ZGODNE Z

       SVr4, POSIX.1-2001.

UWAGI

Dołączenie <sys/types.h> i <sys/ipc.h> nie jest wymagane na Linuksie ani przez żadną z wersji POSIX.
Jednak niektóre stare implementacje wymagają dołączenia tych plików nagłówkowych, SVID również
dokumentuje ich dołączenie. Aplikacje które mają być przenośne na tego typu stare systemy mogą wymagać
dołączenia omawianych plików nagłówkowych.

IPC_PRIVATE nie jest znacznikiem, ale szczególną wartością typu key_t. Jeśli wartość ta zostanie użyta
jako parametr key, to system uwzględni jedynie 9 najniższych bitów parametru msgflg i (w razie
powodzenia) utworzy nowy zestaw semaforów.

Inicjowanie semaforów
Wartości semaforów w nowo utworzonym zestawie są nieokreślone (POSIX.1-2001 jasno o tym mówi, choć
POSIX.1-2008 określa, że przyszła wersja tego standardu może wymagać implementacji inicjującej semafory z
wartością 0). Mimo że Linux, tak jak i wiele innych implementacji, nadaje im wartość początkową równą 0,
to przenośne aplikacje nie powinny zależeć od tego zachowania i zamiast tego powinny wyraźnie inicjować
semafory żądanymi wartościami.

Aby zainicjować semafory, należy na zestawie semaforów użyć operacji SETVAL lub SETALL wywołania
semctl(2). W sytuacji gdy wiele procesów nie wie, który pierwszy zainicjuje zestaw semaforów, to aby
uniknąć sytuacji wyścigu, można sprawdzić, czy pole sem_otime powiązanej struktury danych zwracanej przez
operację IPC_STAT wywołania semctl(2) ma wartość niezerową.

Limity semaforów
Wywołania semget() dotyczą następujące ograniczenia zasobów związanych z zestawami semaforów:

SEMMNI Limit liczby zestawów semaforów w systemie. W systemach Linux przed wersją 3.19 domyślna wartość
tego limitu wynosiła 128. Od Linuksa 3.19 jest to 32 000. Pod Linuksem to ograniczenie można
odczytać i zmienić, używając czwartego pola pliku /proc/sys/kernel/sem).

SEMMSL Maksymalna liczba semaforów dla danego ID semafora. W systemach Linux przed wersją 3.19 domyślna
wartość tego limitu wynosiła 250. Od Linuksa 3.19 jest to 32 000. Pod Linuksem to ograniczenie
można odczytać i zmienić, używając pierwszego pola pliku /proc/sys/kernel/sem).

SEMMNS Limit liczby semaforów w systemie: wartość zależna od lokalnych ustawień (pod Linuksem to
ograniczenie można odczytać i zmienić, używając drugiego pola pliku /proc/sys/kernel/sem). Proszę
zauważyć, że systemowa liczba semaforów jest również ograniczona przez iloczyn SEMMSL i SEMMNI.

USTERKI

       Nazwa  IPC_PRIVATE  prawdopodobnie  nie  jest  najszczęśliwsza.  IPC_NEW  w  sposób  bardziej przejrzysty
       odzwierciedlałoby rolę tej wartości.

ZOBACZ TAKŻE

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

O STRONIE

       Angielska wersja tej strony pochodzi z wydania 4.07 projektu Linux man-pages. Opis  projektu,  informacje
       dotyczące   zgłaszania   błędów,   oraz   najnowszą   wersję   oryginału   można   znaleźć   pod  adresem
       https://www.kernel.org/doc/man-pages/.

TŁUMACZENIE

       Autorami  polskiego  tłumaczenia  niniejszej   strony   podręcznika   man   są:   Rafał   Lewczuk   (PTM)
       <R.Lewczuk@elka.pw.edu.p>,   Andrzej   Krzysztofowicz   (PTM)   <ankry@mif.pg.gda.pl>,   Robert   Luberda
       <robert@debian.org> i Michał Kułach <michal.kulach@gmail.com>.

       Polskie tłumaczenie jest częścią  projektu  manpages-pl;  uwagi,  pomoc,  zgłaszanie  błędów  na  stronie
       http://sourceforge.net/projects/manpages-pl/. Jest zgodne z wersją  4.07 oryginału.