Provided by: manpages-pl-dev_4.21.0-2_all 
NAZWA
shmget - utworzenie segmentu pamięci dzielonej Systemu V
BIBLIOTEKA
Standardowa biblioteka C (libc, -lc)
SKŁADNIA
#include <sys/shm.h>
int shmget(key_t key, size_t size, int shmflg);
OPIS
shmget() returns the identifier of the System V shared memory segment associated with the value of the
argument key. It may be used either to obtain the identifier of a previously created shared memory
segment (when shmflg is zero and key does not have the value IPC_PRIVATE), or to create a new set.
A new shared memory segment, with size equal to the value of size rounded up to a multiple of PAGE_SIZE,
is created if key has the value IPC_PRIVATE or key isn't IPC_PRIVATE, no shared memory segment
corresponding to key exists, and IPC_CREAT is specified in shmflg.
Jeżeli w parametrze shmflg podano zarówno IPC_CREAT, jak i IPC_EXCL oraz już istnieje segment w pamięci
dzielonej o kluczu key, to shmget() kończy się błędem, ustawiając errno na wartość EEXIST. (Działa to
analogicznie do O_CREAT | O_EXCL w open(2)).
Wartość shmflg składa się z:
IPC_CREAT
Tworzy nowy segment. Jeśli ten znacznik nie zostanie ustawiony, to shmget() spróbuje znaleźć
segment skojarzony z key i sprawdzić, czy użytkownik ma uprawnienia dostępu do segmentu.
IPC_EXCL
Ta flaga przekazana łącznie z IPC_CREAT zapewnia, że to wywołanie utworzy segment. Jeśli segment
już istnieje, wywołanie zawiedzie.
SHM_HUGETLB (od Linuksa 2.6)
Allocate the segment using "huge" pages. See the Linux kernel source file
Documentation/admin-guide/mm/hugetlbpage.rst for further information.
SHM_HUGE_2MB, SHM_HUGE_1GB (od Linuksa 3.8)
Used in conjunction with SHM_HUGETLB to select alternative hugetlb page sizes (respectively, 2 MB
and 1 GB) on systems that support multiple hugetlb page sizes.
Ogólniej, pożądany rozmiar dużej strony można skonfigurować kodując go w sześciu bajtach na
przesunięciu SHM_HUGE_SHIFT za pomocą logarytmu o podstawie 2. Dlatego, powyższe dwie stałe są
zdefiniowane jako:
#define SHM_HUGE_2MB (21 << SHM_HUGE_SHIFT)
#define SHM_HUGE_1GB (30 << SHM_HUGE_SHIFT)
Dodatkowe informacje można odnaleźć przy omówieniu podobnie nazwanych stałych w mmap(2).
SHM_NORESERVE (od Linuksa 2.6.15)
Ten znacznik stosuje się w takim samym celu jak znacznik MAP_NORESERVE funkcji mmap(2). Nie
rezerwuje przestrzeni wymiany dla tego segmentu. Jeśli przestrzeń wymiany zostanie zarezerwowana,
ma się gwarancję, że jest możliwe zmodyfikowanie segmentu. Gdy przestrzeń wymiany nie jest
zarezerwowana, można otrzymać sygnał SIGSEGV podczas próby zapisu do segmentu, gdy zabraknie
dostępnej fizycznej pamięci. Patrz także opis pliku /proc/sys/vm/overcommit_memory w proc(5).
Oprócz powyższych flag, 9 najmniej znaczących bitów sgmflg określa prawa dostępu do segmentu dla jego
właściciela, grupy oraz innych. Bity są w takim samym formacie i mają takie samo znaczenie, jak parametr
mode wywołania open(2). Prawa uruchamiania nie są obecnie używane przez system.
Jeżeli tworzona jest nowa kolejka komunikatów, wywołanie to w następujący sposób inicjuje strukturę
danych msqid_ds (patrz msgctl(2)):
• shm_perm.cuid i shm_perm.uid przyjmują wartość efektywnego identyfikatora właściciela procesu
wywołującego.
• shm_perm.cgid i shm_perm.gid przyjmują wartość efektywnego identyfikatora grupy procesu wywołującego.
• 9 najmniej znaczących bitów pola shm_perm.mode jest kopiowanych z 9 najmniej znaczących bitów shmflg.
• shm_segsz jest ustawiane na wartość parametru size.
• shm_lpid, shm_nattch, shm_atime i shm_dtime są ustawiane na 0.
• shm_ctime jest ustawiane na bieżący czas.
Jeśli dany segment pamięci dzielonej już istnieje, to są weryfikowane uprawnienia i jest sprawdzane, czy
segment nie jest przeznaczony do usunięcia.
WARTOŚĆ ZWRACANA
W przypadku powodzenia zwracany jest poprawny identyfikator pamięci współdzielonej. W razie wystąpienia
błędu zwracane jest -1 i ustawiana jest errno wskazując błąd.
BŁĘDY
EACCES The user does not have permission to access the shared memory segment, and does not have the
CAP_IPC_OWNER capability in the user namespace that governs its IPC namespace.
EEXIST IPC_CREAT i IPC_EXCL były określone w shmflg, lecz segment pamięci dzielonej już istnieje dla key.
EINVAL Miał być utworzony nowy segment, a wartość size jest mniejsza niż SHMMIN lub większa niż SHMMAX.
EINVAL Segment dla podanego key istnieje, lecz size jest większy niż rozmiar tego segmentu.
ENFILE Zostało osiągnięte systemowe ograniczenie na całkowitą liczbę otwartych plików.
ENOENT Segment o zadanej wartości key nie istnieje i nie ustawiono znacznika IPC_CREAT.
ENOMEM Nie udało się przydzielić pamięci dla segmentu.
ENOSPC Wszystkie możliwe identyfikatory pamięci dzielonej zostały wykorzystane (SHMMNI) lub przydzielenie
segmentu o żądanym rozmiarze size spowodowałoby przekroczenie systemowego ograniczenia na wielkość
pamięci dzielonej (SHMALL).
EPERM The SHM_HUGETLB flag was specified, but the caller was not privileged (did not have the
CAP_IPC_LOCK capability) and is not a member of the sysctl_hugetlb_shm_group group; see the
description of /proc/sys/vm/sysctl_hugetlb_shm_group in proc(5).
STANDARDY
POSIX.1-2001, POSIX.1-2008, SVr4.
SHM_HUGETLB i SHM_NORESERVE są linuksowymi rozszerzeniami.
UWAGI
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 shmflg i utworzy nowy
segment pamięci dzielonej.
Limity pamięci dzielonej
Następujące ograniczenia odnoszące się do zasobów pamięci dzielonej dotyczą wywołania shmget():
SHMALL Systemowy limit całkowitej wielkości pamięci dzielonej, mierzony w jednostkach systemowego
rozmiaru strony.
W Linuksie to ograniczenie można odczytać i zmienić, używając pliku /proc/sys/kernel/shmall. Od
Linuksa 3.16 domyślną wartością tego limitu jest:
ULONG_MAX - 2^24
Ta wartość (odpowiednia dla systemów 32 i 64-bitowych) skutkuje brakiem limitów dla alokacji. Ta
wartość, zamiast ULONG_MAX, została wybrana jako domyślna, aby zapobiec przypadkom gdy pewne stare
aplikacje zwiększały istniejący limit bez sprawdzania jego wartości bieżącej. Mogło to doprowadzić
do przepełnienia wartości, jeśli limit był ustawiony na ULONG_MAX.
Od Linuksa 2.4 do 3.15 domyślną wartością limitu było:
SHMMAX / PAGE_SIZE * (SHMMNI / 16)
If SHMMAX and SHMMNI were not modified, then multiplying the result of this formula by the page
size (to get a value in bytes) yielded a value of 8 GB as the limit on the total memory used by
all shared memory segments.
SHMMAX Maksymalny rozmiar segmentu pamięci dzielonej w bajtach.
W Linuksie to ograniczenie można odczytać i zmienić, używając pliku /proc/sys/kernel/shmmax. Od
Linuksa 3.16 domyślną wartością tego limitu jest:
ULONG_MAX - 2^24
Ta wartość (odpowiednia dla systemów 32 i 64-bitowych) skutkuje brakiem limitów dla alokacji.
Wyjaśnienie dlaczego jest to wartość domyślna (zamiast ULONG_MAX) znajduje się w opisie SHMALL.
From Linux 2.2 up to Linux 3.15, the default value of this limit was 0x2000000 (32 MiB).
Because it is not possible to map just part of a shared memory segment, the amount of virtual
memory places another limit on the maximum size of a usable segment: for example, on i386 the
largest segments that can be mapped have a size of around 2.8 GB, and on x86-64 the limit is
around 127 TB.
SHMMIN Minimalny rozmiar (w bajtach) pojedynczego segmentu pamięci dzielonej: zależny od implementacji
(obecnie 1 bajt, ale efektywny minimalny rozmiar wynosi PAGE_SIZE).
SHMMNI Systemowy limit liczby segmentów pamięci dzielonej. W Linuksie 2.2 domyślna wartość tego limitu
wynosiła 128; od Linuksa 2.4 domyślna wartość wynosi 4096.
W Linuksie to ograniczenie można odczytać i zmienić, używając pliku /proc/sys/kernel/shmmni.
System Linux nie stawia ograniczeń dotyczących liczby segmentów pamięci dzielonej dołączonych do jednego
procesu (SHMSEG).
Uwagi linuksowe
Until Linux 2.3.30, Linux would return EIDRM for a shmget() on a shared memory segment scheduled for
deletion.
BŁĘDY
Nazwa IPC_PRIVATE prawdopodobnie nie jest najszczęśliwsza. IPC_NEW w sposób bardziej przejrzysty
odzwierciedlałoby rolę tej wartości.
PRZYKŁADY
See shmop(2).
ZOBACZ TAKŻE
memfd_create(2), shmat(2), shmctl(2), shmdt(2), ftok(3), capabilities(7), shm_overview(7), sysvipc(7)
TŁUMACZENIE
Autorami polskiego tłumaczenia niniejszej strony podręcznika są: Rafał Lewczuk <R.Lewczuk@elka.pw.edu.p>,
Andrzej Krzysztofowicz <ankry@green.mf.pg.gda.pl>, Robert Luberda <robert@debian.org> i Michał Kułach
<michal.kulach@gmail.com>
Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać
zapoznając się z GNU General Public License w wersji 3 lub nowszej. Nie przyjmuje się ŻADNEJ
ODPOWIEDZIALNOŚCI.
Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej manpages-pl-
list@lists.sourceforge.net.
Linux man-pages 6.03 10 lutego 2023 r. shmget(2)