Documentation/translations/zh_CN/vm/free_page_reporting.rst

   1 .. include:: ../disclaimer-zh_CN.rst
   2
   3 :Original: Documentation/vm/_free_page_reporting.rst
   4
   5 :翻译:
   6
   7  司延腾 Yanteng Si <siyanteng@loongson.cn>
   8
   9 :校译:
  10
  11 ==========
  12 空闲页报告
  13 ==========
  14
  15 空闲页报告是一个API，设备可以通过它来注册接收系统当前未使用的页面列表。这在虚拟
  16 化的情况下是很有用的，客户机能够使用这些数据来通知管理器它不再使用内存中的某些页
  17 面。
  18
  19 对于驱动，通常是气球驱动要使用这个功能，它将分配和初始化一个page_reporting_dev_info
  20 结构体。它要填充的结构体中的字段是用于处理散点列表的 "report" 函数指针。它还必
  21 须保证每次调用该函数时能处理至少相当于PAGE_REPORTING_CAPACITY的散点列表条目。
  22 假设没有其他页面报告设备已经注册， 对page_reporting_register的调用将向报告框
  23 架注册页面报告接口。
  24
  25 一旦注册，页面报告API将开始向驱动报告成批的页面。API将在接口被注册后2秒开始报告
  26 页面，并在任何足够高的页面被释放之后2秒继续报告。
  27
  28 报告的页面将被存储在传递给报告函数的散列表中，最后一个条目的结束位被设置在条目
  29 nent-1中。 当页面被报告函数处理时，分配器将无法访问它们。一旦报告函数完成，这些
  30 页将被返回到它们所获得的自由区域。
  31
  32 在移除使用空闲页报告的驱动之前，有必要调用page_reporting_unregister，以移除
  33 目前被空闲页报告使用的page_reporting_dev_info结构体。这样做将阻止进一步的报
  34 告通过该接口发出。如果另一个驱动或同一驱动被注册，它就有可能恢复前一个驱动在报告
  35 空闲页方面的工作。
  36
  37
  38 Alexander Duyck, 2019年12月04日