LIRS caching algorithm

<h2 id="summary">Summary</h2>
<h3>Quantifying the locality</h3>
<p>While all page replacement algorithms rely on existence of <a href="/facts/Locality_of_reference/fYFKDv5q">reference locality</a> to function, a major difference among different replacement algorithms is on how this locality is quantified. LIRS uses reuse distance of a page, or the number of distinct pages accessed between two consecutive references of the page, to quantify locality. Specifically, LIRS uses last and second-to-last references (if any) for this purpose. If a page is accessed for the first time, its reuse distance is infinite. In contrast, LRU uses recency of a page, which is the number of distinctive pages accessed after the reference of the page, to quantify locality. To take into account of up-to-date access history, the implementation of LIRS actually uses the larger of reuse distance and recency of a page as the metric to quantify its locality, denoted as RD-R. Assuming the cache has a capacity of C pages, the LIRS algorithm is to rank recently accessed pages according to their RD-R values and retain the C most highly ranked pages in the cache.
</p><p>The concepts of reuse distance and recency can be visualized as below, in which T1 and T2 are page B’s second-to-last and last reference times, respectively, and T3 is the current time. 
</p>

. . . B . . . B . . . . . . . . . . B . . . . . 
               ^----Reuse Distance---^--Recency--^
               T1                    T2          T3

<h3>Selecting the replacement victim</h3>
<p>LIRS organizes metadata of cached pages and some uncached pages and conducts its replacement operations described as below, which are also illustrated with an example <a class="footnote-ref" id="fnref:3" href="#fn:3"><sup>3</sup></a> in the graph.
</p>

<ol><li>The cache is divided into a Low Inter-reference Recency (LIR) and a High Inter-reference Recency (HIR) partition. The LIR partition is to store the most highly ranked pages (LIR pages) and the HIR partition is to store some of the other pages (HIR pages).</li>
<li>The LIR partition holds the majority of the cache, and all LIR pages are resident in the cache.</li>
<li>All recently accessed pages are placed in a <a href="/facts/FIFO_(computing_and_electronics)/RctvBNgE">FIFO</a> queue called the LIRS stack (stack <i>S</i> in the graph), and all resident HIR pages are also placed in another FIFO queue (stack <i>Q</i> in the graph).</li>
<li>An accessed page is moved to the top of Stack <i>S</i> and any HIR pages at the stack's bottom are removed. For example, Graph (b) is produced after page <i>B</i> is accessed on Graph (a).</li>
<li>When a HIR page in Stack <i>S</i> is accessed, it turns into a LIR page and accordingly the LIR page currently at Stack S’s bottom turns into a HIR page and moves to the top of Stack Q. For example, Graph (c) is produced after page <i>E</i> is accessed on Graph (a).</li>
<li>When there is a miss and a resident page has to be replaced, the resident HIR page at the bottom of Stack <i>Q</i> is selected as the victim for replacement. For example, Graphs (d)  and (e) are produced after pages <i>D</i> and <i>C</i> are accessed on Graph (a), respectively.</li></ol>
<h2 id="deployment">Deployment</h2>
<p>LIRS has been deployed in <a href="/facts/MySQL/QEEDNBDP">MySQL</a> since version 5.1,<a class="footnote-ref" id="fnref:4" href="#fn:4"><sup>4</sup></a> and another reference by <a href="http://www.iskm.org/mysql56/pgman_8hpp_source.html">link</a>. It is also adopted in <a href="/facts/Infinispan/lAxEd3fG">Infinispan</a> data grid platform.<a class="footnote-ref" id="fnref:5" href="#fn:5"><sup>5</sup></a> An approximation of LIRS, CLOCK-Pro,<a class="footnote-ref" id="fnref:6" href="#fn:6"><sup>6</sup></a> is adopted in <a href="/facts/NetBSD/PTm5HWls">NetBSD</a>.<a class="footnote-ref" id="fnref:7" href="#fn:7"><sup>7</sup></a> LIRS is adopted in <a href="https://jackrabbit.apache.org/oak/docs/apidocs/org/apache/jackrabbit/oak/cache/CacheLIRS.html">Apache Jackrabbit</a>, a Content Repository. An in-memory LIRS cache is developed in the <a href="https://access.redhat.com/documentation/en-us/red_hat_jboss_data_virtualization/6.2/html/development_guide_volume_2_governance/sect-federation">Red Hat JBoss Data Virtualization System</a>. LIRS is used in the H2 Database Engine, which is called a <a href="https://github.com/h2database/h2database/blob/master/h2/src/tools/org/h2/dev/cache/CacheLIRS.java">Scan Resistant Cache</a>. Furthermore, LIRS is used in <a href="https://docs.cloudera.com/runtime/7.1.0/release-notes/rt-release-notes.pdf">Apache Impala</a>, a data processing with Hadoop.
</p>
<h2 id="see-also">See also</h2>
<ul><li><a href="/facts/Clock_with_Adaptive_Replacement/ApuSJLaq">Page replacement algorithm</a></li></ul>

<h2 id="external-links">External links</h2>
<ul><li><a href="http://www.surriel.com/system/files/riel2003_o1_vm.pdf">Towards an O(1) VM</a> by Rik van Riel about the possible use of LIRS for balancing cache and program memory in Linux.</li>
<li>A <a href="https://lwn.net/Articles/147879/?format=printable">report</a> on the implementation of the CLOCK-Pro page replacement.</li>
<li><a href="http://linux-mm.org/AdvancedPageReplacement">Advanced Page Replacement Projects</a> established by the Linux memory management development team.</li>
<li>CLOCK-Pro <a href="https://web.archive.org/web/20130704065810/http://www.surriel.com/patches/clockpro/2.6.12/">patch</a> developed by Rik van Riel.</li>
<li>CLOCK-Pro <a href="http://linux-mm.org/PeterZClockPro2">patch</a> developed by Peter Zijlstra.</li>
<li>CLOCK-Pro is referred as an example in the section of <a href="http://www.cse.ohio-state.edu/~zhang/professional-linux-2.pdf">Linux and Academia</a> in Book <a href="https://www.amazon.com/Professional-Linux-Kernel-Architecture-Programmer/dp/0470343435">Professional Linux Kernel Architecture</a> by Wolfgan Mauerer.</li>
<li>A <a href="http://people.cs.vt.edu/~butta/docs/sigmetrics05_kernelPrefetch.pdf">paper</a> detailing performance differences of LIRS and other algorithms “The Performance Impact of Kernel Prefetching on Buffer Cache Replacement Algorithms” by Ali R. Butt, Chris Gniady, and Y. Charlie Hu.</li></ul>

<h2 id="references">References</h2>

<ol>
<li id="fn:1"><p>Jiang, Song; Zhang, Xiaodong (June 2002). "LIRS: an efficient low inter-reference recency set replacement policy to improve buffer cache performance". ACM SIGMETRICS Performance Evaluation Review. 30 (1): 31–42. doi:10.1145/511399.511340. <a href="/wiki/Doi_(identifier)" target="_blank">/wiki/Doi_(identifier)</a> <a href="#fnref:1" class="footnote-back-ref">↩</a></p></li>
<li id="fn:2"><p>Mattson, R.L.; Gecsei, J.; Slutz, D. R.; Traiger, I. L. (1970). "Evaluation techniques for storage hierarchies". IBM Systems Journal. 9 (2): 78–117. doi:10.1147/sj.92.0078. <a href="https://ieeexplore.ieee.org/document/5388318" target="_blank">https://ieeexplore.ieee.org/document/5388318</a> <a href="#fnref:2" class="footnote-back-ref">↩</a></p></li>
<li id="fn:3"><p>Song Jiang; Xiaodong Zhang (2005). "Making LRU Friendly to Weak Locality Workloads: A Novel Replacement Algorithm to Improve Buffer Cache Performance". IEEE Transactions on Computers. 54 (8): 939–952. doi:10.1109/TC.2005.130. S2CID 11539061. <a href="https://ieeexplore.ieee.org/document/1453496" target="_blank">https://ieeexplore.ieee.org/document/1453496</a> <a href="#fnref:3" class="footnote-back-ref">↩</a></p></li>
<li id="fn:4"><p>svn commit - mysqldoc@docsrva: r6768 - trunk/ndbapi <a href="http://lists.mysql.com/commits/28601" target="_blank">http://lists.mysql.com/commits/28601</a> <a href="#fnref:4" class="footnote-back-ref">↩</a></p></li>
<li id="fn:5"><p>Infinispan eviction, batching updates and LIRS <a href="http://blog.infinispan.org/2010/03/infinispan-eviction-batching-updates.html" target="_blank">http://blog.infinispan.org/2010/03/infinispan-eviction-batching-updates.html</a> <a href="#fnref:5" class="footnote-back-ref">↩</a></p></li>
<li id="fn:6"><p>Song Jiang, Feng Chen, and Xiaodong Zhang, "CLOCK-Pro: An Effective Improvement of the CLOCK Replacement", in Proceedings of 2005 USENIX Annual Technical Conference (USENIX'05), Anaheim, CA, April, 2005.
 <a href="http://www.cse.ohio-state.edu/hpcs/WWW/HTML/publications/abs05-3.html" target="_blank">http://www.cse.ohio-state.edu/hpcs/WWW/HTML/publications/abs05-3.html</a> <a href="#fnref:6" class="footnote-back-ref">↩</a></p></li>
<li id="fn:7"><p>FreeBSD/Linux Kernel Cross Reference sys/uvm/uvm_pdpolicy_clockpro.c <a href="http://fxr.watson.org/fxr/source/uvm/uvm_pdpolicy_clockpro.c?v=NETBSD" target="_blank">http://fxr.watson.org/fxr/source/uvm/uvm_pdpolicy_clockpro.c?v=NETBSD</a> <a href="#fnref:7" class="footnote-back-ref">↩</a></p></li>
</ol>

LIRS caching algorithm open-in-new

LIRS caching algorithm