€•3i      Œsphinx.addnodes”Œdocument”“”)”}”(Œ	rawsource”Œ ”Œchildren”]”(Œtranslations”ŒLanguagesNode”“”)”}”(hhh]”(h Œpending_xref”“”)”}”(hhh]”Œdocutils.nodes”ŒText”“”ŒChinese (Simplified)”…””}”Œparent”hsbaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”Œ	refdomain”Œstd”Œreftype”Œdoc”Œ	reftarget”Œ./translations/zh_CN/admin-guide/mm/damon/start”Œmodname”NŒ	classname”NŒrefexplicit”ˆuŒtagname”hhhubh)”}”(hhh]”hŒChinese (Traditional)”…””}”hh2sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/zh_TW/admin-guide/mm/damon/start”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒItalian”…””}”hhFsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/it_IT/admin-guide/mm/damon/start”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒJapanese”…””}”hhZsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/ja_JP/admin-guide/mm/damon/start”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒKorean”…””}”hhnsbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/ko_KR/admin-guide/mm/damon/start”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubh)”}”(hhh]”hŒSpanish”…””}”hh‚sbah}”(h]”h ]”h"]”h$]”h&]”Œ	refdomain”h)Œreftype”h+Œ	reftarget”Œ./translations/sp_SP/admin-guide/mm/damon/start”Œmodname”NŒ	classname”NŒrefexplicit”ˆuh1hhhubeh}”(h]”h ]”h"]”h$]”h&]”Œcurrent_language”ŒEnglish”uh1h
hhŒ	_document”hŒsource”NŒline”NubhŒcomment”“”)”}”(hŒ SPDX-License-Identifier: GPL-2.0”h]”hŒ SPDX-License-Identifier: GPL-2.0”…””}”hh£sbah}”(h]”h ]”h"]”h$]”h&]”Œ	xml:space”Œpreserve”uh1h¡hhhžhhŸŒH/var/lib/git/docbuild/linux/Documentation/admin-guide/mm/damon/start.rst”h KubhŒsection”“”)”}”(hhh]”(hŒtitle”“”)”}”(hŒGetting Started”h]”hŒGetting Started”…””}”(hh»hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hh¶hžhhŸh³h KubhŒ	paragraph”“”)”}”(hX-  This document briefly describes how you can use DAMON by demonstrating its
default user space tool.  Please note that this document describes only a part
of its features for brevity.  Please refer to the usage `doc
<https://github.com/damonitor/damo/blob/next/USAGE.md>`_ of the tool for more
details.”h]”(hŒÒThis document briefly describes how you can use DAMON by demonstrating its
default user space tool.  Please note that this document describes only a part
of its features for brevity.  Please refer to the usage ”…””}”(hhËhžhhŸNh NubhŒ	reference”“”)”}”(hŒ=`doc
<https://github.com/damonitor/damo/blob/next/USAGE.md>`_”h]”hŒdoc”…””}”(hhÕhžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œname”Œdoc”Œrefuri”Œ4https://github.com/damonitor/damo/blob/next/USAGE.md”uh1hÓhhËubhŒtarget”“”)”}”(hŒ7
<https://github.com/damonitor/damo/blob/next/USAGE.md>”h]”h}”(h]”Œdoc”ah ]”h"]”Œdoc”ah$]”h&]”Œrefuri”hæuh1hçŒ
referenced”KhhËubhŒ of the tool for more
details.”…””}”(hhËhžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khh¶hžhubhµ)”}”(hhh]”(hº)”}”(hŒPrerequisites”h]”hŒPrerequisites”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj  hžhhŸh³h Kubhµ)”}”(hhh]”(hº)”}”(hŒKernel”h]”hŒKernel”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj  hžhhŸh³h KubhÊ)”}”(hŒ[You should first ensure your system is running on a kernel built with
``CONFIG_DAMON_*=y``.”h]”(hŒFYou should first ensure your system is running on a kernel built with
”…””}”(hj#  hžhhŸNh NubhŒliteral”“”)”}”(hŒ``CONFIG_DAMON_*=y``”h]”hŒCONFIG_DAMON_*=y”…””}”(hj-  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j+  hj#  ubhŒ.”…””}”(hj#  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Khj  hžhubeh}”(h]”Œkernel”ah ]”h"]”Œkernel”ah$]”h&]”uh1h´hj  hžhhŸh³h Kubhµ)”}”(hhh]”(hº)”}”(hŒUser Space Tool”h]”hŒUser Space Tool”…””}”(hjP  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hjM  hžhhŸh³h KubhÊ)”}”(hŒúFor the demonstration, we will use the default user space tool for DAMON,
called DAMON Operator (DAMO).  It is available at
https://github.com/damonitor/damo.  The examples below assume that ``damo`` is on
your ``$PATH``.  It's not mandatory, though.”h]”(hŒ|For the demonstration, we will use the default user space tool for DAMON,
called DAMON Operator (DAMO).  It is available at
”…””}”(hj^  hžhhŸNh NubhÔ)”}”(hŒ!https://github.com/damonitor/damo”h]”hŒ!https://github.com/damonitor/damo”…””}”(hjf  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”Œrefuri”jh  uh1hÓhj^  ubhŒ".  The examples below assume that ”…””}”(hj^  hžhhŸNh Nubj,  )”}”(hŒ``damo``”h]”hŒdamo”…””}”(hjy  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j+  hj^  ubhŒ is on
your ”…””}”(hj^  hžhhŸNh Nubj,  )”}”(hŒ	``$PATH``”h]”hŒ$PATH”…””}”(hj‹  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j+  hj^  ubhŒ .  Itâ€™s not mandatory, though.”…””}”(hj^  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KhjM  hžhubhÊ)”}”(hŒšBecause DAMO is using the sysfs interface (refer to :doc:`usage` for the
detail) of DAMON, you should ensure :doc:`sysfs </filesystems/sysfs>` is
mounted.”h]”(hŒ4Because DAMO is using the sysfs interface (refer to ”…””}”(hj£  hžhhŸNh Nubh)”}”(hŒ:doc:`usage`”h]”hŒinline”“”)”}”(hj­  h]”hŒusage”…””}”(hj±  hžhhŸNh Nubah}”(h]”h ]”(Œxref”Œstd”Œstd-doc”eh"]”h$]”h&]”uh1j¯  hj«  ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”Œadmin-guide/mm/damon/start”Œ	refdomain”j¼  Œreftype”Œdoc”Œrefexplicit”‰Œrefwarn”ˆŒ	reftarget”Œusage”uh1hhŸh³h K hj£  ubhŒ- for the
detail) of DAMON, you should ensure ”…””}”(hj£  hžhhŸNh Nubh)”}”(hŒ!:doc:`sysfs </filesystems/sysfs>`”h]”j°  )”}”(hjÖ  h]”hŒsysfs”…””}”(hjØ  hžhhŸNh Nubah}”(h]”h ]”(j»  Œstd”Œstd-doc”eh"]”h$]”h&]”uh1j¯  hjÔ  ubah}”(h]”h ]”h"]”h$]”h&]”Œrefdoc”jÈ  Œ	refdomain”jâ  Œreftype”Œdoc”Œrefexplicit”ˆŒrefwarn”ˆjÎ  Œ/filesystems/sysfs”uh1hhŸh³h K hj£  ubhŒ is
mounted.”…””}”(hj£  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K hjM  hžhubeh}”(h]”Œuser-space-tool”ah ]”h"]”Œuser space tool”ah$]”h&]”uh1h´hj  hžhhŸh³h Kubeh}”(h]”Œprerequisites”ah ]”h"]”Œprerequisites”ah$]”h&]”uh1h´hh¶hžhhŸh³h Kubhµ)”}”(hhh]”(hº)”}”(hŒSnapshot Data Access Patterns”h]”hŒSnapshot Data Access Patterns”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj  hžhhŸh³h K&ubhÊ)”}”(hŒaThe commands below show the memory access pattern of a program at the moment of
the execution. ::”h]”hŒ^The commands below show the memory access pattern of a program at the moment of
the execution.”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K(hj  hžhubhŒliteral_block”“”)”}”(hX©  $ git clone https://github.com/sjp38/masim; cd masim; make
$ sudo damo start "./masim ./configs/stairs.cfg --quiet"
$ sudo damo report access
heatmap: 641111111000000000000000000000000000000000000000000000[...]33333333333333335557984444[...]7
# min/max temperatures: -1,840,000,000, 370,010,000, column size: 3.925 MiB
0   addr 86.182 TiB   size 8.000 KiB   access 0 %   age 14.900 s
1   addr 86.182 TiB   size 8.000 KiB   access 60 %  age 0 ns
2   addr 86.182 TiB   size 3.422 MiB   access 0 %   age 4.100 s
3   addr 86.182 TiB   size 2.004 MiB   access 95 %  age 2.200 s
4   addr 86.182 TiB   size 29.688 MiB  access 0 %   age 14.100 s
5   addr 86.182 TiB   size 29.516 MiB  access 0 %   age 16.700 s
6   addr 86.182 TiB   size 29.633 MiB  access 0 %   age 17.900 s
7   addr 86.182 TiB   size 117.652 MiB access 0 %   age 18.400 s
8   addr 126.990 TiB  size 62.332 MiB  access 0 %   age 9.500 s
9   addr 126.990 TiB  size 13.980 MiB  access 0 %   age 5.200 s
10  addr 126.990 TiB  size 9.539 MiB   access 100 % age 3.700 s
11  addr 126.990 TiB  size 16.098 MiB  access 0 %   age 6.400 s
12  addr 127.987 TiB  size 132.000 KiB access 0 %   age 2.900 s
total size: 314.008 MiB
$ sudo damo stop”h]”hX©  $ git clone https://github.com/sjp38/masim; cd masim; make
$ sudo damo start "./masim ./configs/stairs.cfg --quiet"
$ sudo damo report access
heatmap: 641111111000000000000000000000000000000000000000000000[...]33333333333333335557984444[...]7
# min/max temperatures: -1,840,000,000, 370,010,000, column size: 3.925 MiB
0   addr 86.182 TiB   size 8.000 KiB   access 0 %   age 14.900 s
1   addr 86.182 TiB   size 8.000 KiB   access 60 %  age 0 ns
2   addr 86.182 TiB   size 3.422 MiB   access 0 %   age 4.100 s
3   addr 86.182 TiB   size 2.004 MiB   access 95 %  age 2.200 s
4   addr 86.182 TiB   size 29.688 MiB  access 0 %   age 14.100 s
5   addr 86.182 TiB   size 29.516 MiB  access 0 %   age 16.700 s
6   addr 86.182 TiB   size 29.633 MiB  access 0 %   age 17.900 s
7   addr 86.182 TiB   size 117.652 MiB access 0 %   age 18.400 s
8   addr 126.990 TiB  size 62.332 MiB  access 0 %   age 9.500 s
9   addr 126.990 TiB  size 13.980 MiB  access 0 %   age 5.200 s
10  addr 126.990 TiB  size 9.539 MiB   access 100 % age 3.700 s
11  addr 126.990 TiB  size 16.098 MiB  access 0 %   age 6.400 s
12  addr 127.987 TiB  size 132.000 KiB access 0 %   age 2.900 s
total size: 314.008 MiB
$ sudo damo stop”…””}”hj/  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j-  hŸh³h K+hj  hžhubhÊ)”}”(hX•  The first command of the above example downloads and builds an artificial
memory access generator program called ``masim``.  The second command asks DAMO
to start the program via the given command and make DAMON monitors the newly
started process.  The third command retrieves the current snapshot of the
monitored access pattern of the process from DAMON and shows the pattern in a
human readable format.”h]”(hŒqThe first command of the above example downloads and builds an artificial
memory access generator program called ”…””}”(hj=  hžhhŸNh Nubj,  )”}”(hŒ	``masim``”h]”hŒmasim”…””}”(hjE  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j+  hj=  ubhX  .  The second command asks DAMO
to start the program via the given command and make DAMON monitors the newly
started process.  The third command retrieves the current snapshot of the
monitored access pattern of the process from DAMON and shows the pattern in a
human readable format.”…””}”(hj=  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K@hj  hžhubhÊ)”}”(hX  The first line of the output shows the relative access temperature (hotness) of
the regions in a single row hetmap format.  Each column on the heatmap
represents regions of same size on the monitored virtual address space.  The
position of the colun on the row and the number on the column represents the
relative location and access temperature of the region.  ``[...]`` means
unmapped huge regions on the virtual address spaces.  The second line shows
additional information for better understanding the heatmap.”h]”(hXj  The first line of the output shows the relative access temperature (hotness) of
the regions in a single row hetmap format.  Each column on the heatmap
represents regions of same size on the monitored virtual address space.  The
position of the colun on the row and the number on the column represents the
relative location and access temperature of the region.  ”…””}”(hj]  hžhhŸNh Nubj,  )”}”(hŒ	``[...]``”h]”hŒ[...]”…””}”(hje  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j+  hj]  ubhŒ means
unmapped huge regions on the virtual address spaces.  The second line shows
additional information for better understanding the heatmap.”…””}”(hj]  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KGhj  hžhubhÊ)”}”(hXT  Each line of the output from the third line shows which virtual address range
(``addr XX size XX``) of the process is how frequently (``access XX %``)
accessed for how long time (``age XX``).  For example, the evelenth region of
~9.5 MiB size is being most frequently accessed for last 3.7 seconds.  Finally,
the fourth command stops DAMON.”h]”(hŒOEach line of the output from the third line shows which virtual address range
(”…””}”(hj}  hžhhŸNh Nubj,  )”}”(hŒ``addr XX size XX``”h]”hŒaddr XX size XX”…””}”(hj…  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j+  hj}  ubhŒ$) of the process is how frequently (”…””}”(hj}  hžhhŸNh Nubj,  )”}”(hŒ``access XX %``”h]”hŒaccess XX %”…””}”(hj—  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j+  hj}  ubhŒ)
accessed for how long time (”…””}”(hj}  hžhhŸNh Nubj,  )”}”(hŒ
``age XX``”h]”hŒage XX”…””}”(hj©  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j+  hj}  ubhŒ—).  For example, the evelenth region of
~9.5 MiB size is being most frequently accessed for last 3.7 seconds.  Finally,
the fourth command stops DAMON.”…””}”(hj}  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KOhj  hžhubhÊ)”}”(hŒ†Note that DAMON can monitor not only virtual address spaces but multiple types
of address spaces including the physical address space.”h]”hŒ†Note that DAMON can monitor not only virtual address spaces but multiple types
of address spaces including the physical address space.”…””}”(hjÁ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h KUhj  hžhubeh}”(h]”Œsnapshot-data-access-patterns”ah ]”h"]”Œsnapshot data access patterns”ah$]”h&]”uh1h´hh¶hžhhŸh³h K&ubhµ)”}”(hhh]”(hº)”}”(hŒRecording Data Access Patterns”h]”hŒRecording Data Access Patterns”…””}”(hjÚ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj×  hžhhŸh³h KZubhÊ)”}”(hŒoThe commands below record the memory access patterns of a program and save the
monitoring results to a file. ::”h]”hŒlThe commands below record the memory access patterns of a program and save the
monitoring results to a file.”…””}”(hjè  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K\hj×  hžhubj.  )”}”(hŒP$ ./masim ./configs/zigzag.cfg &
$ sudo damo record -o damon.data $(pidof masim)”h]”hŒP$ ./masim ./configs/zigzag.cfg &
$ sudo damo record -o damon.data $(pidof masim)”…””}”hjö  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j-  hŸh³h K_hj×  hžhubhÊ)”}”(hX-  The line of the commands run the artificial memory access
generator program again.  The generator will repeatedly
access two 100 MiB sized memory regions one by one.  You can substitute this
with your real workload.  The last line asks ``damo`` to record the access
pattern in the ``damon.data`` file.”h]”(hŒìThe line of the commands run the artificial memory access
generator program again.  The generator will repeatedly
access two 100 MiB sized memory regions one by one.  You can substitute this
with your real workload.  The last line asks ”…””}”(hj  hžhhŸNh Nubj,  )”}”(hŒ``damo``”h]”hŒdamo”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j+  hj  ubhŒ% to record the access
pattern in the ”…””}”(hj  hžhhŸNh Nubj,  )”}”(hŒ``damon.data``”h]”hŒ
damon.data”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j+  hj  ubhŒ file.”…””}”(hj  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kbhj×  hžhubeh}”(h]”Œrecording-data-access-patterns”ah ]”h"]”Œrecording data access patterns”ah$]”h&]”uh1h´hh¶hžhhŸh³h KZubhµ)”}”(hhh]”(hº)”}”(hŒVisualizing Recorded Patterns”h]”hŒVisualizing Recorded Patterns”…””}”(hjA  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj>  hžhhŸh³h KjubhÊ)”}”(hŒŠYou can visualize the pattern in a heatmap, showing which memory region
(x-axis) got accessed when (y-axis) and how frequently (number).::”h]”hŒ‰You can visualize the pattern in a heatmap, showing which memory region
(x-axis) got accessed when (y-axis) and how frequently (number).:”…””}”(hjO  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Klhj>  hžhubj.  )”}”(hX*  $ sudo damo report heatmap
22222222222222222222222222222222222222211111111111111111111111111111111111111100
44444444444444444444444444444444444444434444444444444444444444444444444444443200
44444444444444444444444444444444444444433444444444444444444444444444444444444200
33333333333333333333333333333333333333344555555555555555555555555555555555555200
33333333333333333333333333333333333344444444444444444444444444444444444444444200
22222222222222222222222222222222222223355555555555555555555555555555555555555200
00000000000000000000000000000000000000288888888888888888888888888888888888888400
00000000000000000000000000000000000000288888888888888888888888888888888888888400
33333333333333333333333333333333333333355555555555555555555555555555555555555200
88888888888888888888888888888888888888600000000000000000000000000000000000000000
88888888888888888888888888888888888888600000000000000000000000000000000000000000
33333333333333333333333333333333333333444444444444444444444444444444444444443200
00000000000000000000000000000000000000288888888888888888888888888888888888888400
[...]
# access_frequency:  0  1  2  3  4  5  6  7  8  9
# x-axis: space (139728247021568-139728453431248: 196.848 MiB)
# y-axis: time (15256597248362-15326899978162: 1 m 10.303 s)
# resolution: 80x40 (2.461 MiB and 1.758 s for each character)”h]”hX*  $ sudo damo report heatmap
22222222222222222222222222222222222222211111111111111111111111111111111111111100
44444444444444444444444444444444444444434444444444444444444444444444444444443200
44444444444444444444444444444444444444433444444444444444444444444444444444444200
33333333333333333333333333333333333333344555555555555555555555555555555555555200
33333333333333333333333333333333333344444444444444444444444444444444444444444200
22222222222222222222222222222222222223355555555555555555555555555555555555555200
00000000000000000000000000000000000000288888888888888888888888888888888888888400
00000000000000000000000000000000000000288888888888888888888888888888888888888400
33333333333333333333333333333333333333355555555555555555555555555555555555555200
88888888888888888888888888888888888888600000000000000000000000000000000000000000
88888888888888888888888888888888888888600000000000000000000000000000000000000000
33333333333333333333333333333333333333444444444444444444444444444444444444443200
00000000000000000000000000000000000000288888888888888888888888888888888888888400
[...]
# access_frequency:  0  1  2  3  4  5  6  7  8  9
# x-axis: space (139728247021568-139728453431248: 196.848 MiB)
# y-axis: time (15256597248362-15326899978162: 1 m 10.303 s)
# resolution: 80x40 (2.461 MiB and 1.758 s for each character)”…””}”hj]  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j-  hŸh³h Kohj>  hžhubhÊ)”}”(hŒVYou can also visualize the distribution of the working set size, sorted by the
size.::”h]”hŒUYou can also visualize the distribution of the working set size, sorted by the
size.:”…””}”(hjk  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h Kƒhj>  hžhubj.  )”}”(hXû  $ sudo damo report wss --range 0 101 10
# <percentile> <wss>
# target_id     18446632103789443072
# avr:  107.708 MiB
  0             0 B |                                                           |
 10      95.328 MiB |****************************                               |
 20      95.332 MiB |****************************                               |
 30      95.340 MiB |****************************                               |
 40      95.387 MiB |****************************                               |
 50      95.387 MiB |****************************                               |
 60      95.398 MiB |****************************                               |
 70      95.398 MiB |****************************                               |
 80      95.504 MiB |****************************                               |
 90     190.703 MiB |*********************************************************  |
100     196.875 MiB |***********************************************************|”h]”hXû  $ sudo damo report wss --range 0 101 10
# <percentile> <wss>
# target_id     18446632103789443072
# avr:  107.708 MiB
  0             0 B |                                                           |
 10      95.328 MiB |****************************                               |
 20      95.332 MiB |****************************                               |
 30      95.340 MiB |****************************                               |
 40      95.387 MiB |****************************                               |
 50      95.387 MiB |****************************                               |
 60      95.398 MiB |****************************                               |
 70      95.398 MiB |****************************                               |
 80      95.504 MiB |****************************                               |
 90     190.703 MiB |*********************************************************  |
100     196.875 MiB |***********************************************************|”…””}”hjy  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j-  hŸh³h K†hj>  hžhubhÊ)”}”(hŒvUsing ``--sortby`` option with the above command, you can show how the working
set size has chronologically changed.::”h]”(hŒUsing ”…””}”(hj‡  hžhhŸNh Nubj,  )”}”(hŒ``--sortby``”h]”hŒ--sortby”…””}”(hj  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1j+  hj‡  ubhŒc option with the above command, you can show how the working
set size has chronologically changed.:”…””}”(hj‡  hžhhŸNh Nubeh}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K–hj>  hžhubj.  )”}”(hX	  $ sudo damo report wss --range 0 101 10 --sortby time
# <percentile> <wss>
# target_id     18446632103789443072
# avr:  107.708 MiB
  0       3.051 MiB |                                                           |
 10     190.703 MiB |***********************************************************|
 20      95.336 MiB |*****************************                              |
 30      95.328 MiB |*****************************                              |
 40      95.387 MiB |*****************************                              |
 50      95.332 MiB |*****************************                              |
 60      95.320 MiB |*****************************                              |
 70      95.398 MiB |*****************************                              |
 80      95.398 MiB |*****************************                              |
 90      95.340 MiB |*****************************                              |
100      95.398 MiB |*****************************                              |”h]”hX	  $ sudo damo report wss --range 0 101 10 --sortby time
# <percentile> <wss>
# target_id     18446632103789443072
# avr:  107.708 MiB
  0       3.051 MiB |                                                           |
 10     190.703 MiB |***********************************************************|
 20      95.336 MiB |*****************************                              |
 30      95.328 MiB |*****************************                              |
 40      95.387 MiB |*****************************                              |
 50      95.332 MiB |*****************************                              |
 60      95.320 MiB |*****************************                              |
 70      95.398 MiB |*****************************                              |
 80      95.398 MiB |*****************************                              |
 90      95.340 MiB |*****************************                              |
100      95.398 MiB |*****************************                              |”…””}”hj§  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j-  hŸh³h K™hj>  hžhubeh}”(h]”Œvisualizing-recorded-patterns”ah ]”h"]”Œvisualizing recorded patterns”ah$]”h&]”uh1h´hh¶hžhhŸh³h Kjubhµ)”}”(hhh]”(hº)”}”(hŒ+Data Access Pattern Aware Memory Management”h]”hŒ+Data Access Pattern Aware Memory Management”…””}”(hjÀ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1h¹hj½  hžhhŸh³h K«ubhÊ)”}”(hŒ‚Below command makes every memory region of size >=4K that has not accessed for
>=60 seconds in your workload to be swapped out. ::”h]”hŒBelow command makes every memory region of size >=4K that has not accessed for
>=60 seconds in your workload to be swapped out.”…””}”(hjÎ  hžhhŸNh Nubah}”(h]”h ]”h"]”h$]”h&]”uh1hÉhŸh³h K­hj½  hžhubj.  )”}”(hŒ¬$ sudo damo start --damos_access_rate 0 0 --damos_sz_region 4K max \
                  --damos_age 60s max --damos_action pageout \
                  <pid of your workload>”h]”hŒ¬$ sudo damo start --damos_access_rate 0 0 --damos_sz_region 4K max \
                  --damos_age 60s max --damos_action pageout \
                  <pid of your workload>”…””}”hjÜ  sbah}”(h]”h ]”h"]”h$]”h&]”h±h²uh1j-  hŸh³h K°hj½  hžhubeh}”(h]”Œ+data-access-pattern-aware-memory-management”ah ]”h"]”Œ+data access pattern aware memory management”ah$]”h&]”uh1h´hh¶hžhhŸh³h K«ubeh}”(h]”Œgetting-started”ah ]”h"]”Œgetting started”ah$]”h&]”uh1h´hhhžhhŸh³h Kubeh}”(h]”h ]”h"]”h$]”h&]”Œsource”h³uh1hŒcurrent_source”NŒcurrent_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)”}”(h¹NŒ	generator”NŒ	datestamp”NŒsource_link”NŒ
source_url”NŒtoc_backlinks”Œentry”Œfootnote_backlinks”KŒsectnum_xform”KŒstrip_comments”NŒstrip_elements_with_classes”NŒstrip_classes”NŒreport_level”KŒ
halt_level”KŒexit_status_level”KŒdebug”NŒwarning_stream”NŒ	traceback”ˆŒinput_encoding”Œ	utf-8-sig”Œinput_encoding_error_handler”Œstrict”Œoutput_encoding”Œutf-8”Œoutput_encoding_error_handler”j  Œerror_encoding”Œutf-8”Œerror_encoding_error_handler”Œbackslashreplace”Œlanguage_code”Œen”Œrecord_dependencies”NŒconfig”NŒ	id_prefix”hŒauto_id_prefix”Œid”Œdump_settings”NŒdump_internals”NŒdump_transforms”NŒdump_pseudo_xml”NŒexpose_internals”NŒstrict_visitor”NŒ_disable_config”NŒ_source”h³Œ_destination”NŒ_config_files”]”Œ7/var/lib/git/docbuild/linux/Documentation/docutils.conf”aŒfile_insertion_enabled”ˆŒraw_enabled”KŒline_length_limit”M'Œpep_references”NŒpep_base_url”Œhttps://peps.python.org/”Œpep_file_url_template”Œpep-%04d”Œrfc_references”NŒrfc_base_url”Œ&https://datatracker.ietf.org/doc/html/”Œ	tab_width”KŒtrim_footnote_reference_space”‰Œsyntax_highlight”Œlong”Œsmart_quotes”ˆŒsmartquotes_locales”]”Œcharacter_level_inline_markup”‰Œdoctitle_xform”‰Œdocinfo_xform”KŒsectsubtitle_xform”‰Œimage_loading”Œlink”Œembed_stylesheet”‰Œcloak_email_addresses”ˆŒsection_self_link”‰Œenv”NubŒreporter”NŒindirect_targets”]”Œsubstitution_defs”}”Œsubstitution_names”}”Œrefnames”}”Œrefids”}”Œnameids”}”(j÷  jô  hòhïj  j  jJ  jG  j  j   jÔ  jÑ  j;  j8  jº  j·  jï  jì  uŒ	nametypes”}”(j÷  ‰hòˆj  ‰jJ  ‰j  ‰jÔ  ‰j;  ‰jº  ‰jï  ‰uh}”(jô  h¶hïhéj  j  jG  j  j   jM  jÑ  j  j8  j×  j·  j>  jì  j½  uŒfootnote_refs”}”Œcitation_refs”}”Œautofootnotes”]”Œautofootnote_refs”]”Œsymbol_footnotes”]”Œsymbol_footnote_refs”]”Œ	footnotes”]”Œ	citations”]”Œautofootnote_start”KŒsymbol_footnote_start”K Œ
id_counter”Œcollections”ŒCounter”“”}”…”R”Œparse_messages”]”Œtransform_messages”]”Œtransformer”NŒinclude_log”]”Œ
decoration”Nhžhub.