NAZWA¶
msgget - pobranie identyfikatora kolejki komunikatów Systemu V
SKŁADNIA¶
#include <sys/types.h>
#include <sys/ipc.h>
#include <sys/msg.h>
int msgget(key_t key, int msgflg);
OPIS¶
Wywołanie systemowe
msgget() zwraca identyfikator kolejki
komunikatów Systemu V skojarzony z wartością
argumentu
key. Tworzy nową kolejkę komunikatów,
gdy
key ma wartość
IPC_PRIVATE lub gdy
key
jest różny od
IPC_PRIVATE i nie istnieje kolejka o kluczu
podanym w
key, a w parametrze
msgflg ustawiono
IPC_CREAT.
Jeśli w parametrze
msgflg podano zarówno
IPC_CREAT,
jak i
IPC_EXCL oraz już istnieje kolejka komunikatów o
kluczu
key, to
msgget() 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 kolejki najmniej znaczące bity argumentu
msgflg
definiują prawa dostępu do niej. Prawa te mają
taką samą postać i znaczenie (semantykę) jak prawa
dostępu podawane w parametrze
mode wywołania
open(2) (Prawa do uruchamiania nie są używane).
Jeśli tworzona jest nowa kolejka komunikatów, wywołanie to
w następujący sposób inicjuje strukturę danych
msqid_ds (patrz
msgctl(2)):
- msg_perm.cuid i msg_perm.uid przyjmują
wartość efektywnego identyfikatora właściciela
procesu wywołującego.
- msg_perm.cgid i msg_perm.gid przyjmują
wartość efektywnego identyfikatora grupy procesu
wywołującego.
- 9 najmniej znaczących bitów pola msg_perm.mode jest
kopiowanych z 9 najmniej znaczących bitów
msgflg.
- msg_qnum, msg_lspid, msg_lrpid, msg_stime i
msg_rtime przyjmują wartość 0.
- msg_ctime jest ustawiane na bieżący czas.
- msg_qbytes przyjmuje wartość równą
ograniczeniu systemowemu MSGMNB.
Jeśli kolejka już istnieje, to są weryfikowane uprawnienia
i jest sprawdzane, czy kolejka nie jest przeznaczona do usunięcia.
WARTOŚĆ ZWRACANA¶
W przypadku pomyślnego zakończenia, funkcja zwraca identyfikator
kolejki komunikatów (liczbę nieujemną), a w przeciwnym
przypadku zwraca -1 i przypisuje zmiennej
errno stosowną
wartość.
BŁĘDY¶
W przypadku niepowodzenia zmienna
errno może przyjąć
jedną z następujących wartości:
- EACCES
- Kolejka komunikatów skojarzona z key istnieje,
jednakże proces wywołujący funkcję nie ma ani
wystarczających praw dostępu do tej kolejki, ani nie ma
ustawionego atrybutu CAP_IPC_OWNER.
- EEXIST
- IPC_CREAT i IPC_EXCL określono w msgflg, lecz
kolejka wiadomości dla key już istnieje.
- ENOENT
- Kolejka skojarzona z wartością key nie istnieje oraz
nie podano flagi IPC_CREAT w msgflg.
- ENOMEM
- Kolejka komunikatów powinna zostać utworzona, ale w systemie
brak jest pamięci na utworzenie nowej struktury danych.
- ENOSPC
- Kolejka komunikatów powinna zostać utworzona, ale
przekroczone zostałoby systemowe ograniczenie ( MSGMNI) na
liczbę istniejących kolejek komunikatów.
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 nową kolejkę.
Następujące ograniczenia systemowe dotyczą wywołania
msgget():
- MSGMNI
- Systemowy limit liczby kolejek komunikatów: wartość
zależna od lokalnych ustawień (pod Linuksem to ograniczenie
można odczytać i zmienić, używając
pliku /proc/sys/kernel/msgmni).
Uwagi linuksowe¶
Do wersji 2.3.20 Linux zwracał
EIDRM dla
msgget() na
kolejce komunikatów przeznaczonej do skasowania.
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¶
msgctl(2),
msgrcv(2),
msgsnd(2),
ftok(3),
capabilities(7),
mq_overview(7),
svipc(7)
O STRONIE¶
Angielska wersja tej strony pochodzi z wydania 3.71 projektu Linux
man-pages. Opis projektu, informacje dotyczące zgłaszania
błędów, oraz najnowszą wersję
oryginału można znaleźć pod adresem
http://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ą
3.71 oryginału.
