On Thu, Jan 27, 2022 at 9:50 AM Yanteng Si <siyanteng01@xxxxxxxxx> wrote: > > Translate .../vm/free_page_reporting.rst into Chinese. > > Signed-off-by: Yanteng Si <siyanteng@xxxxxxxxxxx> Reviewed-by: Alex Shi <alexs@xxxxxxxxxx> > --- > .../zh_CN/vm/free_page_reporting.rst | 38 +++++++++++++++++++ > Documentation/translations/zh_CN/vm/index.rst | 5 ++- > 2 files changed, 41 insertions(+), 2 deletions(-) > create mode 100644 Documentation/translations/zh_CN/vm/free_page_reporting.rst > > diff --git a/Documentation/translations/zh_CN/vm/free_page_reporting.rst b/Documentation/translations/zh_CN/vm/free_page_reporting.rst > new file mode 100644 > index 000000000000..6894e26ce079 > --- /dev/null > +++ b/Documentation/translations/zh_CN/vm/free_page_reporting.rst > @@ -0,0 +1,38 @@ > +.. include:: ../disclaimer-zh_CN.rst > + > +:Original: Documentation/vm/_free_page_reporting.rst > + > +:翻译: > + > + 司延腾 Yanteng Si <siyanteng@xxxxxxxxxxx> > + > +:校译: > + > +========== > +空闲页报告 > +========== > + > +空闲页报告是一个API，设备可以通过它来注册接收系统当前未使用的页面列表。这在虚拟 > +化的情况下是很有用的，客户机能够使用这些数据来通知管理器它不再使用内存中的某些页 > +面。 > + > +对于驱动，通常是气球驱动要使用这个功能，它将分配和初始化一个page_reporting_dev_info > +结构体。它要填充的结构体中的字段是用于处理散点列表的 "report" 函数指针。它还必 > +须保证每次调用该函数时能处理至少相当于PAGE_REPORTING_CAPACITY的散点列表条目。 > +假设没有其他页面报告设备已经注册， 对page_reporting_register的调用将向报告框 > +架注册页面报告接口。 > + > +一旦注册，页面报告API将开始向驱动报告成批的页面。API将在接口被注册后2秒开始报告 > +页面，并在任何足够高的页面被释放之后2秒继续报告。 > + > +报告的页面将被存储在传递给报告函数的散列表中，最后一个条目的结束位被设置在条目 > +nent-1中。 当页面被报告函数处理时，分配器将无法访问它们。一旦报告函数完成，这些 > +页将被返回到它们所获得的自由区域。 > + > +在移除使用空闲页报告的驱动之前，有必要调用page_reporting_unregister，以移除 > +目前被空闲页报告使用的page_reporting_dev_info结构体。这样做将阻止进一步的报 > +告通过该接口发出。如果另一个驱动或同一驱动被注册，它就有可能恢复前一个驱动在报告 > +空闲页方面的工作。 > + > + > +Alexander Duyck, 2019年12月04日 > diff --git a/Documentation/translations/zh_CN/vm/index.rst b/Documentation/translations/zh_CN/vm/index.rst > index fc39f0d60318..9cdfde0364f0 100644 > --- a/Documentation/translations/zh_CN/vm/index.rst > +++ b/Documentation/translations/zh_CN/vm/index.rst > @@ -23,17 +23,18 @@ TODO:待引用文档集被翻译完毕后请及时修改此处） > > active_mm > balance > + damon/index > + free_page_reporting > + ksm > > TODOLIST: > * arch_pgtable_helpers > -* damon/index > * free_page_reporting > * frontswap > * highmem > * hmm > * hwpoison > * hugetlbfs_reserv > -* ksm > * memory-model > * mmu_notifier > * numa > -- > 2.27.0 >
