Received: by 2002:a05:6a10:6d10:0:0:0:0 with SMTP id gq16csp4923390pxb; Wed, 20 Apr 2022 13:09:39 -0700 (PDT) X-Google-Smtp-Source: ABdhPJxvHbjBeqeyavysIkKeVjo7D7MdwWnV2YVjWuv8ZmeDXkfpMLbq+lCYMbOx9Yb1MNVuX8IH X-Received: by 2002:a05:6a00:1584:b0:50a:b6a1:6579 with SMTP id u4-20020a056a00158400b0050ab6a16579mr7839069pfk.80.1650485378832; Wed, 20 Apr 2022 13:09:38 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1650485378; cv=none; d=google.com; s=arc-20160816; b=JZbO3qeDrcEkzd5Up45I5MwbAf/VbB+QD/wdhHkG7N5v64yyZ4qndFWbxUpyRPGikr 3CHX1GngZfRKKEQqKQ28s18iLYWx84lig1xtAGZOM3TFNAA+1ibrn/W2NqHcBZrRtqpD UhDf5UfJUsNJeTroWbz5fSgu1BKMfJ1pjPXqABiqNBJqC+1JAuPZVL4tH2LeyIgiIVKQ 7kt6vfkaceLNrBPhMRyJXq7eZpzeq49pQkVuAYZyOpacTA5vDqEBdIS0qNAOWutDAgXC iRk9J/F672EkOa+XiqL5Is/txpyYIYqn9LqnfZwS+2TQnA2b7EMoU7T1xmnSdQNhzS+I NMQw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from; bh=xPGVuBleG81LAX+ozVOfp1tX6fIVffM8M6GKEm2PEHM=; b=TZXIoDD6iL3bz5dwvkIea+Ivdnn54JSghAT+kTqqkTHvJsRDh/jutu8yLu/xSYkGur BqYIz77+AzILxq+aK8DFW+2FgqLPz7/PUPMWa2efYfhvmCHawBMDUd0YrRyh1ScFlJg6 /Nc41N+/AyFAiphH1ZA/fRUKdIwRCLQbhNgIq7If5CVLDrB5ic771iTq3WCkrsaHie/r tK8RYDNv+FvtqBdyqXZe/w2HpqtOL3jP0W8B6ViZ0EvbqEG1jxZaZ4DZi3vRLwsa4fpC Veang1/YNJdUihZjbXYU8rYIFXjH9xZBQPM/Q+CdNx6qn5Z9v/uqLaq7lDa6zDa8Pp9X Q1Fg== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id d14-20020a056a00244e00b00505b033e35fsi3136657pfj.71.2022.04.20.13.08.06; Wed, 20 Apr 2022 13:09:38 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1359237AbiDTDK3 (ORCPT + 99 others); Tue, 19 Apr 2022 23:10:29 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:40996 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1359176AbiDTDKN (ORCPT ); Tue, 19 Apr 2022 23:10:13 -0400 Received: from mail.meizu.com (edge05.meizu.com [157.122.146.251]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id B7A2D767C; Tue, 19 Apr 2022 20:07:20 -0700 (PDT) Received: from IT-EXMB-1-125.meizu.com (172.16.1.125) by mz-mail12.meizu.com (172.16.1.108) with Microsoft SMTP Server (TLS) id 14.3.487.0; Wed, 20 Apr 2022 11:07:20 +0800 Received: from meizu.meizu.com (172.16.137.70) by IT-EXMB-1-125.meizu.com (172.16.1.125) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2308.14; Wed, 20 Apr 2022 11:07:18 +0800 From: Haowen Bai To: CC: , , , , , , Subject: [PATCH 1/2] docs/zh_CN: sync with original text Documentation/vm/page_owner.rst Date: Wed, 20 Apr 2022 11:06:55 +0800 Message-ID: <1650424016-7225-2-git-send-email-baihaowen@meizu.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1650424016-7225-1-git-send-email-baihaowen@meizu.com> References: <1650424016-7225-1-git-send-email-baihaowen@meizu.com> MIME-Version: 1.0 Content-Type: text/plain; charset="N" Content-Transfer-Encoding: 8bit X-Originating-IP: [172.16.137.70] X-ClientProxiedBy: IT-EXMB-1-126.meizu.com (172.16.1.126) To IT-EXMB-1-125.meizu.com (172.16.1.125) X-Spam-Status: No, score=-1.2 required=5.0 tests=BAYES_00,KHOP_HELO_FCRDNS, SPF_HELO_NONE,SPF_SOFTFAIL,T_SCC_BODY_TEXT_LINE autolearn=no autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org As the tools/vm/page_owner_sort added some feature and original text updated, sync the translation of zh_CN as below. Commit 8bd16bc0a081 ("tools/vm/page_owner_sort.c: support sorting blocks by multiple keys") add sorting blocks by multiple keys usage description. Commit 78a0b94f3829 ("tools/vm/page_owner_sort.c: support for multi-value selection in single argument") add multi-value selection in single argument usage description. Commit c89b3ad2dea2 ("doc/vm/page_owner.rst: remove content related to -c option") remove -c option usage description. Commit 9c8a0a8e599f ("tools/vm/page_owner_sort.c: support for user-defined culling rules") add user-defined culling rules usage description. Commit 8ea8613a616a ("tools/vm/page_owner_sort.c: support for selecting by PID, TGID or task command name") add selecting by PID, TGID or task command name usage description. Commit 194d52d771b8 ("tools/vm/page_owner_sort: support for sorting by task command name") add sorting by task command name usage description. Signed-off-by: Haowen Bai --- Documentation/translations/zh_CN/vm/page_owner.rst | 61 +++++++++++++++++++++- 1 file changed, 60 insertions(+), 1 deletion(-) diff --git a/Documentation/translations/zh_CN/vm/page_owner.rst b/Documentation/translations/zh_CN/vm/page_owner.rst index 9e951fabba9d..c692e81c724e 100644 --- a/Documentation/translations/zh_CN/vm/page_owner.rst +++ b/Documentation/translations/zh_CN/vm/page_owner.rst @@ -103,14 +103,73 @@ page owner在默认情况下是禁用的。所以,如果你想使用它,你 -m 按总内存排序 -p 按pid排序。 -P 按tgid排序。 + -n 按任务名称排序。 -r 按内存释放时间排序。 -s 按堆栈跟踪排序。 -t 按时间排序(默认)。 + --sort 指定排序顺序。排序语法是 [+|-]key[,[+|-]key[,...]]. 从 + **标准格式说明符** 部分选择一个键。"+" 是可选的,因为默认方向是增加数字或字典顺序。 + 允许混合使用缩写键和全称键。 + + Examples: + ./page_owner_sort --sort=n,+pid,-tgid + ./page_owner_sort --sort=at 其它函数: Cull: - -c 通过比较堆栈跟踪而不是总块来进行剔除。 + --cull + 指定筛选规则。筛选语法是 key[,key[,...]]。在**标准格式说明符**部分选择一个多字母键 + + 是逗号分隔列表形式的单个参数,它提供了一种指定单个筛选规则的方法。下面的**标准格式说明 + 符**部分描述了可识别的关键字。 可以由键 k1,k2, ... 顺序指定,如下面的 + STANDARD SORT KEYS 部分所述。允许混合使用缩写形式和完整形式的键。 + Examples: + ./page_owner_sort --cull=stacktrace + ./page_owner_sort --cull=st,pid,name + ./page_owner_sort --cull=n,f Filter: -f 过滤掉内存已被释放的块的信息。 + + Select: + --pid 通过 pid 进行选择。这将选择进程 ID 号出现在 中的块。 + --tgid 通过 tgid 进行选择。这将选择线程组 ID 号出现在 中的块。 + --name 按任务名称选择。这将选择任务名称出现在 中的块。 + + 是逗号分隔列表形式的单参数,它提供了一种指定单个选择规则的方法。 + + + Examples: + ./page_owner_sort --pid=1 + ./page_owner_sort --tgid=1,2,3 + ./page_owner_sort --name name1,name2 + +标准格式说明符 +============== + +--sort 选项: + + ====== ========== =================== + 缩写键 全称键 描述 + ====== ========== =================== + p pid 进程 ID + tg tgid 线程组 ID + n name 任务名称 + st stacktrace 页面分配的调用栈 + T txt 块的全文 + ft free_ts 页面被释放的时间戳 + at alloc_ts 页面分配的时间戳 + ====== ========== =================== + +--curl 选项: + + ====== ========== ================== + 缩写键 全称键 描述 + ====== ========== ================== + p pid 进程 ID + tg tgid 线程组 ID + n name 任务名称 + f free 该页面是否已被释放 + st stacktrace 页面分配的调用栈 + ====== ========== ================== -- 2.7.4