.\" -*- coding: UTF-8 -*- .\" SPDX-License-Identifier: Linux-man-pages-copyleft-2-para .\" .\" Copyright 2009 Intel Corporation .\" Author: Andi Kleen .\" Based on the move_pages manpage which was .\" This manpage is Copyright (C) 2006 Silicon Graphics, Inc. .\" Christoph Lameter .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH migrate_pages 2 "15 июля 2023 г." "Linux man\-pages 6.05.01" .SH ИМЯ migrate_pages \- переносит все страницы процесса на другой набор узлов .SH LIBRARY NUMA (Non\-Uniform Memory Access) policy library (\fIlibnuma\fP, \fI\-lnuma\fP) .SH СИНТАКСИС .nf \fB#include \fP .PP \fBlong migrate_pages(int \fP\fIpid\fP\fB, unsigned long \fP\fImaxnode,\fP \fB const unsigned long *\fP\fIold_nodes,\fP \fB const unsigned long *\fP\fInew_nodes\fP\fB);\fP .fi .SH ОПИСАНИЕ Вызов \fBmigrate_pages\fP() пытается перенести все страницы процесса с идентификатором \fIpid\fP, находящиеся в памяти узлов \fIold_nodes\fP, в память узлов \fInew_nodes\fP. Страницы, не расположенные в узлах \fIold_nodes\fP, не переносятся. При переносе на \fInew_nodes\fP ядро в максимально возможной степени поддерживает относительную топологию связи внутри \fIold_nodes\fP. .PP Аргументы \fIold_nodes\fP и \fInew_nodes\fP представляют собой указатели на маски битов номеров узлов, до \fImaxnode\fP в каждой маске. Эти маски обрабатываются как массивы беззнаковых целых \fIlong\fP (в последнем целом \fIlong\fP биты, лежащие за пределом \fImaxnode\fP, игнорируются). Аргумент \fImaxnode\fP представляет собой максимальный номер узла в битовой маске плюс 1 (также как в \fBmbind\fP(2), но отличается от \fBselect\fP(2)). .PP В аргументе \fIpid\fP задаётся идентификатор процесса, чьи страницы будут перемещаться. Чтобы перемещать страницы не своего процесса, вызывающий должен быть привилегированным (\fBCAP_SYS_NICE\fP) или реальный или эффективный ID пользователя вызывающего процесса должен совпадать с реальным или сохранённым ID пользователя процесса назначения. Если \fIpid\fP равен 0, то \fBmigrate_pages\fP() перемещает страницы вызвавшего процесса. .PP Совместно используемые с другими процессами страницы будут перемещаться только, если первоначальный процесс имеет мандат \fBCAP_SYS_NICE\fP. .SH "ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ" При нормальном завершении работы \fBmigrate_pages\fP() возвращает количество неперемещённых страниц (то есть, ноль означает, что все страницы успешно перемещены). В случае ошибки возвращается \-1, а \fIerrno\fP устанавливается в соответствующее значение. .SH ОШИБКИ .TP \fBEFAULT\fP Часть или весь диапазон памяти, заданный в \fIold_nodes\fP/\fInew_nodes\fP и \fImaxnode\fP, указывает за пределы доступного адресного пространства. .TP \fBEINVAL\fP .\" As at 3.5, this limit is "a page worth of bits", e.g., .\" 8 * 4096 bits, assuming a 4kB page size. Значение \fImaxnode\fP превышает введённое ядром ограничение. В \fIold_nodes\fP или \fInew_nodes\fP задан один или более ID узлов, превышающих поддерживаемый максимальный ID узла. Или ни один из ID узлов, указанных в \fInew_nodes\fP, включен и доступен из контекста текущего набора процессоров процесса, или ни один из узлов не содержит память. .TP \fBEPERM\fP Недостаточно прав (\fBCAP_SYS_NICE\fP) для перемещения страниц процесса, заданного \fIpid\fP, или недостаточно прав (\fBCAP_SYS_NICE\fP) для доступа к указанным узлам назначения. .TP \fBESRCH\fP .\" FIXME Document the other errors that can occur for migrate_pages() Не найден процесс с указанным \fIpid\fP. .SH СТАНДАРТЫ Linux. .SH ИСТОРИЯ Linux 2.6.16. .SH ЗАМЕЧАНИЯ Информация о библиотеке доступна в \fBnuma\fP(7). .PP Используйте \fBget_mempolicy\fP(2) с флагом \fBMPOL_F_MEMS_ALLOWED\fP для получения набора узлов, которые доступны в наборе ЦП вызывающему процессу. Заметим, что эта информация может измениться в любое время вручную или при автоматической перенастройке набора ЦП. .PP Использование \fBmigrate_pages\fP() может привести к тому, что расположение страниц (на узле) нарушит политику памяти, установленную для заданных адресов (см. \fBmbind\fP(2)) и/или заданного процесса (см. \fBset_mempolicy\fP(2)). То есть политика памяти не ограничивает узлы назначения, используемые \fBmigrate_pages\fP(). .PP Заголовочный файл \fI\fP не включён в glibc, его можно найти в пакете с именем \fIlibnuma\-devel\fP или подобным названием. .SH "СМ. ТАКЖЕ" \fBget_mempolicy\fP(2), \fBmbind\fP(2), \fBset_mempolicy\fP(2), \fBnuma\fP(3), \fBnuma_maps\fP(5), \fBcpuset\fP(7), \fBnuma\fP(7), \fBmigratepages\fP(8), \fBnumastat\fP(8) .PP Файл \fIDocumentation/vm/page_migration.rst\fP в дереве исходного кода ядра Linux .PP .SH ПЕРЕВОД Русский перевод этой страницы руководства был сделан aereiae , Alexey , Azamat Hackimov , Dmitriy S. Seregin , Dmitry Bolkhovskikh , ITriskTI , Max Is , Yuri Kozlov , Иван Павлов и Малянов Евгений Викторович . .PP Этот перевод является бесплатной документацией; прочитайте .UR https://www.gnu.org/licenses/gpl-3.0.html Стандартную общественную лицензию GNU версии 3 .UE или более позднюю, чтобы узнать об условиях авторского права. Мы не несем НИКАКОЙ ОТВЕТСТВЕННОСТИ. .PP Если вы обнаружите ошибки в переводе этой страницы руководства, пожалуйста, отправьте электронное письмо на .MT man-pages-ru-talks@lists.sourceforge.net .ME .