MIGRATE_PAGES(2) | Linux Programmer's Manual | MIGRATE_PAGES(2) |
NAME
migrate_pages - move all pages in a process to another set of nodesSYNOPSIS
#include<numaif.h>
long migrate_pages(int pid , unsigned long maxnode,
const unsigned long * old_nodes,
const unsigned long * new_nodes );
DESCRIPTION
migrate_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 VALUE
On 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.ERRORS
- EPERM
- 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.
- ESRCH
- No process matching pid could be found.
VERSIONS
The migrate_pages() system call first appeared on Linux in version 2.6.16.CONFORMING TO
This system call is Linux-specific.NOTES
For information on library support, see numa(7).SEE ALSO
get_mempolicy(2), mbind(2), set_mempolicy(2), numa(3), numa_maps(5), cpuset(7), numa(7), migratepages(8), numastat(8)COLOPHON
This 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/.2012-08-01 | Linux |