munmap_flags_peer()

Освободить ранее смапированную область памяти другого процесса, предоставляя больше контроля в сравнении с munmap_peer()

Прототип:

#include <sys/mman.h>
                                       
int munmap_flags_peer( pid_t pid,
                       void *addr,
                       size_t len,
                       unsigned flags );

Аргументы:

pid

Идентификатор процесса, чьему адресному пространству соответствует адрес addr. В качестве pid может быть задан 0, что соответствует текущему процессу.

addr

Адрес начала области памяти.

len

Длина ресурса в байтах.

flags

Флаги, уточняющие процедуру освобождения памяти:

• 0 — Соответствует поведению функции munmap_peer().
• UNMAP_INT_REQUIRED — Регламентированное POSIX зануление страниц требуется при следующем аллоцировании физической памяти, ассоциированной с данной областью памяти.
• UNMAP_INT_OPTIONAL — Зануление физической памяти, ассоциированной с данной областью памяти, при следующем аллоцировании опционально.

Библиотека:

libc

Описание:

Функция munmap_flags_peer() удаляет мапирование страниц памяти процесса pid, начиная с адреса addr и длиной len байт, с округлением вверх до конца страницы памяти. Последующие обращения к этим страницам памяти в целевом процессе будут приводить к отправке процессу сигнала SIGSEGV.

Если соответствующих параметрам запроса страниц памяти не обнаружено, вызов munmap_flags_peer() не будет иметь эффекта.

Имеются некоторые взаимодействия аргумента flags с флагом MAP_NOINIT функции mmap(), равно как и с procnto-*, в следующих аспектах:

• Функция mmap64_peer() имеет новый флаг MAP_NOINIT. Если флаг установлен, требование POSIX по занулению памяти игнорируется. Физическая память, которая будет использована при мапировании, должна быть предварительно освобождена с использованием UNMAP_INIT_OPTIONAL для того, чтобы флаг MAP_NOINIT имел силу.

• procnto-* имеет опцию -m memmgr_configuration. Строчный аргумент memmgr_configuration позволяет настраивать ряд параметров менеджера памяти (в случае, если ему предшествует ~ символ, то речь идет об отключении параметра). Следующие параметры могут быть настроены:

  i

  munmap_flags_peer() (при равенстве нулю flags) действует аналогично UNMAP_INIT_REQUIRED (используется по умолчанию).

  ~i

  munmap_flags_peer() (при равенстве нулю flags) действует аналогично UNMAP_INIT_OPTIONAL.

Возвращаемое значение:

0

Успешное завершение.

-1

Функция завершилась с ошибкой (устанавлено знаение errno).

Коды ошибок:

EINVAL

Адрес в пределах заданного диапазона выходит за границы разрешенного диапазона адресного пространства процесса.

ENOSYS

Функция munmap_flags_peer() не поддерживается в текущей реализации.

Классификация:

ЗОСРВ «Нейтрино»

Безопасность использования

Точка остановки потока

Нет

Обработчик прерываний

Нет

Обработчик сигналов

Да

В потоке

Да

Тематические ссылки:

mmap(), mmap64(), mmap64_peer(), munmap(), munmap_peer(), munmap_flags()

procnto-* в Справочнике по Утилитам

Предыдущий раздел: Описание API системной библиотеки