|MIGRATE_PAGES(2)||Linux Programmer's Manual||MIGRATE_PAGES(2)|
NAMEmigrate_pages - move all pages in a process to another set of nodes
long migrate_pages(int pid , unsigned long maxnode,
const unsigned long * old_nodes,
const unsigned long * new_nodes );
DESCRIPTIONmigrate_pages() attempts to move all pages of the process pid that are in memory nodes old_nodes to the memory nodes in new_nodes. Pages not located in any node in old_nodes will not be migrated. As far as possible, the kernel maintains the relative topology relationship inside old_nodes during the migration to new_nodes.
RETURN VALUEOn success migrate_pages() returns the number of pages that could not be moved (i.e., a return of zero means that all pages were successfully moved). On error, it returns -1, and sets errno to indicate the error.
- Insufficient privilege ( CAP_SYS_NICE) to move pages of the process specified by pid, or insufficient privilege ( CAP_SYS_NICE) to access the specified target nodes.
- No process matching pid could be found.
VERSIONSThe migrate_pages() system call first appeared on Linux in version 2.6.16.
CONFORMING TOThis system call is Linux-specific.
NOTESFor information on library support, see numa(7).
SEE ALSOget_mempolicy(2), mbind(2), set_mempolicy(2), numa(3), numa_maps(5), cpuset(7), numa(7), migratepages(8), numastat(8)
COLOPHONThis page is part of release 3.53 of the Linux man-pages project. A description of the project, and information about reporting bugs, can be found at http://www.kernel.org/doc/man-pages/.