|
Сервер содержит море(!) аналитической информации
|
CIT Forum CD-ROM
|
|
SHMCTL(2)
НАЗВАНИЕ
shmctl - операции управления разделяемыми сегментами памяти
СИНТАКСИС
#include <sys/types.h>
#include <sys/ipc.h>
#include <sys/shm.h>
int shmctl (shmid, cmd, buf)
int shmid, cmd;
struct shmid_ds *buf;
ОПИСАНИЕ
Системный вызов shmctl позволяет выполнять операции управления разделяемыми сегментами памяти. Операция определяется значением аргумента cmd, которое должно быть
одним из следующих:
- IPC_STAT
- Поместить текущие значения полей структуры данных,
ассоциированной с идентификатором разделяемого
сегмента shmid, в структуру, на которую указывает
аргумент buf. Содержимое структуры описано в
intro(2). {Требуется право на чтение.}
- IPC_SET
- Присвоить следующим полям структуры данных, ассоциированной с идентификатором shmid, соответствующие значения, находящиеся в структуре, на которую
указывает аргумент buf:
shm_perm.uid
shm_perm.gid
shm_perm.mode /* Только младшие 9 бит */
Эта команда может выполняться только процессом,
который имеет действующий идентификатор пользователя, равный либо идентификатору суперпользователя, либо значению поля shm_perm.cuid или
shm_perm.uid в структуре, ассоциированной с идентификатором shmid.
- IPC_RMID
- Удалить из системы идентификатор разделяемого сегмента, заданный аргументом shmid, ликвидировать
сегмент и ассоциированную с ним структуру данных.
Эта команда может выполняться только процессом,
который имеет действующий идентификатор пользователя, равный либо идентификатору суперпользователя, либо значению поля shm_perm.cuid или
shm_perm.uid в структуре данных, ассоциированной с
идентификатором shmid.
- SHM_LOCK
- Удержать в памяти разделяемый сегмент, специфицированный идентификатором shmid. Эта команда может
выполняться только процессом, который имеет действующий идентификатор пользователя, равный идентификатору суперпользователя.
- SHM_UNLOCK
- Освободить разделяемой сегмент памяти, специфицированный идентификатором shmid. Эта команда может
выполняться только процессом, который имеет действующий идентификатор пользователя, равный идентификатору суперпользователя.
Системный вызов shmctl завершается неудачей, если выполнено хотя бы одно из следующих условий:
- [EINVAL]
- Значение аргумента shmid не является корректным идентификатором разделяемого сегмента.
- [EINVAL]
- Некорректное значение аргумента cmd, определяющее команду.
- [EACCES]
- Значение аргумента cmd равно IPC_STAT, но у
вызывающего процесса нет прав на выполнение
операции чтения [см. intro(2)].
- [EPERM]
- Значение аргумента cmd равно IPC_RMID или
IPC_SET, а действующий идентификатор пользователя вызывающего процесса не равен ни
идентификатору суперпользователя, ни значению поля shm_perm.cuid или shm_perm.uid в
структуре данных, ассоциированной с идентификатором shmid.
- [EPERM]
- Значение аргумента cmd равно SHM_LOCK или
SHM_UNLOCK, а действующий идентификатор
пользователя вызывающего процесса не равен
идентификатору суперпользователя.
- [EFAULT]
- Аргумент buf указывает за пределы отведенного процессу адресного пространства.
- [ENOMEM]
- Значение аргумента cmd равно SHM_LOCK и нет
достаточного об ема памяти в системе.
СМ. ТАКЖЕ
shmget(2), shmop(2).
ДИАГНОСТИКА
При успешном завершении результат равен 0; в случае
ошибки возвращается -1, а переменной errno присваивается код ошибки.
ПРИМЕЧАНИЯ
Необходимо явно удалять разделяемый сегмент памяти после того, как удаляется последняя ссылка на него.
