ИМЯ¶

shmctl - управление общей памятью System V

СИНТАКСИС¶

#include <sys/ipc.h>
#include <sys/shm.h>

int shmctl(int shmid, int cmd, struct shmid_ds *buf);

ОПИСАНИЕ¶

Вызов shmctl() выполняет управляющую операцию, указанную в cmd, над общим сегментом памяти System V, чей идентификатор задан в shmid.

В аргументе buf содержится указатель на структуру shmid_ds, определённую в <sys/shm.h> следующим образом:

struct shmid_ds {


    struct ipc_perm shm_perm;    /* владелец и права */


    size_t          shm_segsz;   /* размер сегмента (байты) */


    time_t          shm_atime;   /* время последнего подключения */


    time_t          shm_dtime;   /* время последнего отключения */


    time_t          shm_ctime;   /* время последнего изменения */


    pid_t           shm_cpid;    /* PID создателя */


    pid_t           shm_lpid;    /* PID последнего выполнявшего


                                    shmat(2)/shmdt(2) */


    shmatt_t        shm_nattch;  /* текущее количество подключений */


    ...
};

Структура ipc_perm определена следующим образом (значения полей устанавливаются с помощью IPC_SET):

struct ipc_perm {


    key_t          __key;    /* ключ, передаваемый в shmget(2) */


    uid_t          uid;      /* эффективный UID владельца */


    gid_t          gid;      /* эффективный GID владельца */


    uid_t          cuid;     /* эффективный UID создателя */


    gid_t          cgid;     /* эффективный GID создателя */


    unsigned short mode;     /* права + флаги SHM_DEST и


                                SHM_LOCKED */


    unsigned short __seq;    /* порядковый номер */
};

Возможные значения cmd:

IPC_STAT

Копирует информацию из структуры данных ядра, связанной с shmid, в структуру shsid_ds, расположенную по адресу buf. Вызывающий должен иметь права на чтение общего сегмента памяти.

IPC_SET

Записывает значения некоторых полей структуры shmid_ds, указанной в buf, в структуру данных ядра, связанную с общим сегментом памяти, обновляя при этом поле shm_ctime. Могут измениться следующие поля: shm_perm.uid, shm_perm.gid и shm_perm.mode (младшие 9 битов). Эффективный UID вызывающего процесса должен совпадать с UID владельца (shm_perm.uid) или создателя (shm_perm.cuid) общего сегмента памяти, или вызывающий должен иметь привилегии.

IPC_RMID

Помечает сегмент как удалённый. Сегмент будет удалён только после того как от него отключится последний процесс (т.е. когда поле shm_nattch из связанной структуры shmid_ds станет равно нулю). Вызывающий должен быть владельцем, создателем или иметь соответствующие привилегии. Аргумент buf игнорируется.

Если сегмент помечен на удаление, то в поле shm_perm.mode устанавливается (нестандартный) флаг SHM_DEST в связанной структуре данных, которая возвращается при операции IPC_STAT.

Вызывающий должен удостовериться, что сегмент в конечном итоге удалён; иначе ошибочные страницы останутся в памяти или в пространстве подкачки.

Смотрите также описание /proc/sys/kernel/shm_rmid_forced в proc(5).

IPC_INFO (есть только в Linux)

Возвращает параметры и информацию о системных максимальных значениях общей памяти в структуре, указанной в buf. Данная структура имеет тип shminfo (то есть, требуется приведение типов) и определена в <sys/shm.h>, если определён макрос тестирования свойств _GNU_SOURCE:

struct shminfo {


    unsigned long shmmax; /* максимальный размер


                             сегмента */


    unsigned long shmmin; /* минимальный размер сегмента;


                             всегда 1 */


    unsigned long shmmni; /* максимальное количество


                             сегментов */


    unsigned long shmseg; /* максимальное количество


                             сегментов, к которому может


                             подключиться; процесс


                             не используется в ядре */


    unsigned long shmall; /* макс. количество страниц


                             общей памяти в системе */
};
    

Значения shmmni, shmmax и shmall можно изменить с помощью файлов в /proc с теми же именами; подробней см. proc(5).

SHM_INFO (есть только в Linux)

Возвращает структуру shm_info, чьи поля содержат информацию о системных ресурсах, использованных общей памятью. Эта структура определена в <sys/shm.h>, если определён макрос тестирования свойств _GNU_SOURCE:

struct shm_info {


    int           used_ids; /* количество используемых в


                               данный момент сегментов */


    unsigned long shm_tot;  /* общее количество общих


                               страниц памяти */


    unsigned long shm_rss;  /* количество общих страниц,


                               находящихся в памяти */


    unsigned long shm_swp;  /* количество страниц памяти в


                               пространстве подкачки */


    unsigned long swap_attempts; /* не используется,


                                    начиная с Linux 2.4 */


    unsigned long swap_successes; /* не используется,


                                     начиная с Linux 2.4 */
};
    

SHM_STAT (есть только в Linux)

Возвращает структуру shmid_ds как в операции IPC_STAT. Однако аргумент shmid является не идентификатором сегмента, а индексом во внутреннем массиве ядра, в котором содержится информации о всех общих сегментов памяти в системе.

Вызывающий может запретить или разрешить размещение общего сегмента памяти в пространство подкачки с помощью следующих значений cmd:

SHM_LOCK (есть только в Linux)

Запрещает подкачку общего сегмента памяти. После включения блокировки вызывающий должен считать сбойными все страницы, наличие которых требуется. Если сегмент заблокирован, то в поле shm_perm.mode устанавливается (нестандартный) флаг SHM_LOCKED в связанной структуре, которая возвращается при операции IPC_STAT.

SHM_UNLOCK (есть только в Linux)

Разблокирует сегмент, разрешая выполнение подкачки.

В ядрах до версии 2.6.10 только привилегированный процесс мог использовать SHM_LOCK и SHM_UNLOCK. Начиная с ядра версии 2.6.10 непривилегированный процесс может использовать эти операции, если его эффективный UID совпадает с UID владельца или создателя сегмента и (для SHM_LOCK) количество блокируемой памяти находится в пределах ресурса RLIMIT_MEMLOCK (см. setrlimit(2)).

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

A successful IPC_INFO or SHM_INFO operation returns the index of the highest used entry in the kernel's internal array recording information about all shared memory segments. (This information can be used with repeated SHM_STAT operations to obtain information about all shared memory segments on the system.) A successful SHM_STAT operation returns the identifier of the shared memory segment whose index was given in shmid. Other operations return 0 on success.

В случае ошибки возвращается -1 и значение errno устанавливается соответствующим образом.

ОШИБКИ¶

EACCES

Указана операция IPC_STAT или SHM_STAT, но в shm_perm.mode не установлено право на чтение shmid, и вызывающий процесс не имеет мандата CAP_IPC_OWNER в пространстве имён пользователя, который управляет его пространством имён IPC.

EFAULT

Значение аргумента cmd равно IPC_SET или IPC_STAT, но адрес, указанный в buf, недоступен.

EIDRM

Значение shmid указывает на удалённый идентификатор.

EINVAL

shmid is not a valid identifier, or cmd is not a valid command. Or: for a SHM_STAT operation, the index value specified in shmid referred to an array slot that is currently unused.

ENOMEM

(в ядрах, начиная с 2.6.9) Указана операция SHM_LOCK и размер блокируемого сегмента таков, что общее количество байт, блокируемое общими сегментами памяти, превысило бы ограничение, установленное для действительного идентификатора пользователя вызывающего процесса. Этот лимит определён мягким ограничителем ресурса RLIMIT_MEMLOCK (см. setrlimit(2)).

EOVERFLOW

Попытка выполнить IPC_STAT, но значения GID или UID слишком велики для помещения в структуру, на которую указывает buf.

EPERM

Попытка выполнить IPC_SET или IPC_RMID, но эффективный пользовательский идентификатор вызывающего процесса не равен идентификатору создателя (shm_perm.cuid) или владельца (shm_perm.uid) и процесс не привилегированный (Linux: не имеет мандата CAP_SYS_ADMIN).

Или (в ядрах до 2.6.9) процесс не имеет привилегий (Linux: не имеет мандата CAP_IPC_LOCK) для выполнения SHM_LOCK или SHM_UNLOCK. Начиная с Linux 2.6.9 эта ошибка также возникает, если значение RLIMIT_MEMLOCK равно 0 и вызывающий не имеет привилегий.

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

POSIX.1-2001, POSIX.1-2008, SVr4.

ЗАМЕЧАНИЯ¶

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

Операции IPC_INFO, SHM_STAT и SHM_INFO используются программой ipcs(1) для получения информации о выделенных ресурсах. В будущем для этого может быть задействован интерфейс файловой системы /proc.

Linux разрешает процессу подключаться (shmat(2)) к общему сегменту память, который уже помечен как удалённый с помощью shmctl(IPC_RMID). Это свойство недоступно в других реализациях UNIX; в переносимых приложениях лучше не использовать это свойство.

В Linux 2.2 различные поля struct shmid_ds имели тип short. В Linux 2.4 тип был изменён на long. Для задействования преимуществ этого изменения необходима перекомпиляция программы с glibc-2.1.91 или более поздней версией (ядро различает старые и новые вызовы по флагу IPC_64 в аргументе cmd).

СМ. ТАКЖЕ¶

mlock(2), setrlimit(2), shmget(2), shmop(2), capabilities(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.