release/man7/numa.7

   1 .\" Copyright (c) 2008, Linux Foundation, written by Michael Kerrisk
   2 .\"     <mtk.manpages@gmail.com>
   3 .\" and Copyright 2003,2004 Andi Kleen, SuSE Labs.
   4 .\" numa_maps material Copyright (c) 2005 Silicon Graphics Incorporated.
   5 .\"     Christoph Lameter, <cl@linux-foundation.org>.
   6 .\"
   7 .\" Permission is granted to make and distribute verbatim copies of this
   8 .\" manual provided the copyright notice and this permission notice are
   9 .\" preserved on all copies.
  10 .\"
  11 .\" Permission is granted to copy and distribute modified versions of this
  12 .\" manual under the conditions for verbatim copying, provided that the
  13 .\" entire resulting derived work is distributed under the terms of a
  14 .\" permission notice identical to this one.
  15 .\"
  16 .\" Since the Linux kernel and libraries are constantly changing, this
  17 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  18 .\" responsibility for errors or omissions, or for damages resulting from
  19 .\" the use of the information contained herein.  The author(s) may not
  20 .\" have taken the same level of care in the production of this manual,
  21 .\" which is licensed free of charge, as they might when working
  22 .\" professionally.
  23 .\"
  24 .\" Formatted or processed versions of this manual, if unaccompanied by
  25 .\" the source, must acknowledge the copyright and authors of this work.
  26 .\"
  27 .\"*******************************************************************
  28 .\"
  29 .\" This file was generated with po4a. Translate the source file.
  30 .\"
  31 .\"*******************************************************************
  32 .TH NUMA 7 2008\-08\-15 Linux "Linux Programmer's Manual"
  33 .SH 名前
  34 numa \- overview of Non\-Uniform Memory Architecture
  35 .SH 説明
  36 Non\-Uniform Memory Access (NUMA) refers to multiprocessor systems whose
  37 memory is divided into multiple memory nodes.  The access time of a memory
  38 node depends on the relative locations of the accessing CPU and the accessed
  39 node.  (This contrasts with a symmetric multiprocessor system, where the
  40 access time for all of the memory is the same for all CPUs.)  Normally, each
  41 CPU on a NUMA system has a local memory node whose contents can be accessed
  42 faster than the memory in the node local to another CPU or the memory on a
  43 bus shared by all CPUs.
  44 .SS "NUMA system calls"
  45 The Linux kernel implements the following NUMA\-related system calls:
  46 \fBget_mempolicy\fP(2), \fBmbind\fP(2), \fBmigrate_pages\fP(2), \fBmove_pages\fP(2), and
  47 \fBset_mempolicy\fP(2).  However, applications should normally use the
  48 interface provided by \fIlibnuma\fP; see "Library Support" below.
  49 .SS "/proc/[number]/numa_maps  (since Linux 2.6.14)"
  50 .\" See also Changelog-2.6.14
  51 This file displays information about a process's NUMA memory policy and
  52 allocation.
  53
  54 Each line contains information about a memory range used by the process,
  55 displaying\(emamong other information\(emthe effective memory policy for
  56 that memory range and on which nodes the pages have been allocated.
  57
  58 \fInuma_maps\fP is a read\-only file.  When \fI/proc/<pid>/numa_maps\fP is
  59 read, the kernel will scan the virtual address space of the process and
  60 report how memory is used.  One line is displayed for each unique memory
  61 range of the process.
  62
  63 The first field of each line shows the starting address of the memory
  64 range.  This field allows a correlation with the contents of the
  65 \fI/proc/<pid>/maps\fP file, which contains the end address of the
  66 range and other information, such as the access permissions and sharing.
  67
  68 The second field shows the memory policy currently in effect for the memory
  69 range.  Note that the effective policy is not necessarily the policy
  70 installed by the process for that memory range.  Specifically, if the
  71 process installed a "default" policy for that range, the effective policy
  72 for that range will be the process policy, which may or may not be
  73 "default".
  74
  75 The rest of the line contains information about the pages allocated in the
  76 memory range, as follows:
  77 .TP
  78 \fIN<node>=<nr_pages>\fP
  79 The number of pages allocated on \fI<node>\fP.  \fI<nr_pages>\fP
  80 includes only pages currently mapped by the process.  Page migration and
  81 memory reclaim may have temporarily unmapped pages associated with this
  82 memory range.  These pages may only show up again after the process has
  83 attempted to reference them.  If the memory range represents a shared memory
  84 area or file mapping, other processes may currently have additional pages
  85 mapped in a corresponding memory range.
  86 .TP
  87 \fIfile=<filename>\fP
  88 The file backing the memory range.  If the file is mapped as private, write
  89 accesses may have generated COW (Copy\-On\-Write) pages in this memory range.
  90 These pages are displayed as anonymous pages.
  91 .TP
  92 \fIheap\fP
  93 Memory range is used for the heap.
  94 .TP
  95 \fIstack\fP
  96 Memory range is used for the stack.
  97 .TP
  98 \fIhuge\fP
  99 Huge memory range.  The page counts shown are huge pages and not regular
 100 sized pages.
 101 .TP
 102 \fIanon=<pages>\fP
 103 The number of anonymous page in the range.
 104 .TP
 105 \fIdirty=<pages>\fP
 106 Number of dirty pages.
 107 .TP
 108 \fImapped=<pages>\fP
 109 Total number of mapped pages, if different from \fIdirty\fP and \fIanon\fP pages.
 110 .TP
 111 \fImapmax=<count>\fP
 112 Maximum mapcount (number of processes mapping a single page) encountered
 113 during the scan.  This may be used as an indicator of the degree of sharing
 114 occurring in a given memory range.
 115 .TP
 116 \fIswapcache=<count>\fP
 117 Number of pages that have an associated entry on a swap device.
 118 .TP
 119 \fIactive=<pages>\fP
 120 The number of pages on the active list.  This field is only shown if
 121 different from the number of pages in this range.  This means that some
 122 inactive pages exist in the memory range that may be removed from memory by
 123 the swapper soon.
 124 .TP
 125 \fIwriteback=<pages>\fP
 126 Number of pages that are currently being written out to disk.
 127 .SH 注意
 128 The Linux NUMA system calls and \fI/proc\fP interface are only available if the
 129 kernel was configured and built with the \fBCONFIG_NUMA\fP option.
 130 .SS "Library Support"
 131 Link with \fI\-lnuma\fP to get the system call definitions.  \fIlibnuma\fP and the
 132 required \fI<numaif.h>\fP header are available in the \fInumactl\fP
 133 package.
 134
 135 However, applications should not use these system calls directly.  Instead,
 136 the higher level interface provided by the \fBnuma\fP(3)  functions in the
 137 \fInumactl\fP package is recommended.  The \fInumactl\fP package is available at
 138 \fIftp://oss.sgi.com/www/projects/libnuma/download/\fP.  The package is also
 139 included in some Linux distributions.  Some distributions include the
 140 development library and header in the separate \fInumactl\-devel\fP package.
 141 .SH 準拠
 142 No standards govern NUMA interfaces.
 143 .SH 関連項目
 144 \fBget_mempolicy\fP(2), \fBmbind\fP(2), \fBmove_pages\fP(2), \fBset_mempolicy\fP(2),
 145 \fBnuma\fP(3), \fBcpuset\fP(7), \fBnumactl\fP(8)