From patchwork Wed Oct 19 13:30:21 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Rui Li X-Patchwork-Id: 5499 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:4ac7:0:0:0:0:0 with SMTP id y7csp336117wrs; Wed, 19 Oct 2022 06:46:24 -0700 (PDT) X-Google-Smtp-Source: AMsMyM6wIZuZ3zfYR4pO0QiH1fJpgB6iYTKS7J4Sa5Atl2ksDPzu+t7v6WcAm7N6y25ZBnq9dowB X-Received: by 2002:a17:903:200a:b0:181:75fc:e0c6 with SMTP id s10-20020a170903200a00b0018175fce0c6mr8535854pla.93.1666187184242; Wed, 19 Oct 2022 06:46:24 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1666187184; cv=none; d=google.com; s=arc-20160816; b=S9zTUr+iutWLz7yDYVC240UEoRxIu3z5gL6hzedKuV/mT1ip4yY1UOd12r0RFn0PFt ohYDXGNS1Hb2Ilm7h0h2X0qRsKsHzvNkRAyR1rnrkCZvKug/VqwGXm9NNQzr4rxVmI52 mi3T0J8NUfWrEftXD8QUA//ZrtcFpPdd9NvrdoYdJaQc6s8sC6i/00V73xljEj3ITlrP zOs61WuqlAtl8zWoTL3UUVxHbGhdECq7W3enn89wH1kyNlTvvP59bJ7IYfPPTOviwGgh 8dsvQlHuJMsAyKZWkAO2cg4Z/OuezpiLl9UfvpnKZpHBAQ9qVqih7Oz2kDNEoD39mv2G RokQ== 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 :dkim-signature; bh=AjuWJVNhkBvpGyB36JX1wwbKTh+Ncxz/qy06/EtkAxA=; b=ZkNe5AYteWStoHfo8liEbGUaygwEvzuvdxc3e6lnPpd5Ac9GXiiH7gMBPVG82DAalI Xu6gsoF9WFunHsKQvfDySoPYTeDKWB+0URb6wIduuKV4d8XVfIkoqwLZs0QSi/o2uESh npzO3Ws2f6babT24iNFIgf81t1teZfOWZ1VP56cWo0M6u9DKDTG/xzUa5nvpHo9QQHM/ Fh4olSEFVinMtbGBnUacnclUg85elpBlIoNVjAmYGyXlL1PJhQgPAzRGDlpi5ww1VFHZ pygIP+Wd7pNc0bp9+yu1TWC+NJXMT75A54dfj5g5h+oP3pGCqhvjkxqNF+pUW6FbApiT nS/w== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@lirui.org header.s=key1 header.b=JjwMk2ka; 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; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=lirui.org Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id eb9-20020a056a004c8900b0054342bb20e2si16626079pfb.66.2022.10.19.06.46.11; Wed, 19 Oct 2022 06:46:24 -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; dkim=pass header.i=@lirui.org header.s=key1 header.b=JjwMk2ka; 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; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=lirui.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S233200AbiJSNpt (ORCPT + 99 others); Wed, 19 Oct 2022 09:45:49 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:60598 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233590AbiJSNob (ORCPT ); Wed, 19 Oct 2022 09:44:31 -0400 Received: from out2.migadu.com (out2.migadu.com [IPv6:2001:41d0:2:aacc::]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 432A0199886; Wed, 19 Oct 2022 06:31:41 -0700 (PDT) X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers. DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lirui.org; s=key1; t=1666186257; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=AjuWJVNhkBvpGyB36JX1wwbKTh+Ncxz/qy06/EtkAxA=; b=JjwMk2ka730u9Fk4Et1ZdFdXTU80c10Qs5qqtXUSf9fROQhlCbPRNA6cQfJqVhkPyzSCXe D4rxGmSexAj0R7lmY2RdqZchJzGMDJvOc8ehTrTSICiYLD5fUOU2bhIeP+d/Dp2vNT7vYL nTBrYUHDgumpRmFVeZBhbxHqoWoDa6xL3lgSBBImoXk7oRou1Bb/l8i1tzHcjY+1cNQ0zc oFvzfb75mK1S1PriJxpuX4pGPNTY4aBPVBpx7QVuks8i3pgmotEW9lOWBR76oFuje57/vH KcTsoBOjPleRsFMJL2W+Me4IcfegXjXQcPUvC4eFbQRAuygsgTz0I7WgFcqNvQ== From: Rui Li To: Alex Shi , Yanteng Si Cc: Jonathan Corbet , Wu XiangCheng , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Rui Li Subject: [PATCH v3 1/2] docs/zh_CN: Add userspace-api/index Chinese translation Date: Wed, 19 Oct 2022 21:30:21 +0800 Message-Id: <76b86e687034d5347e1e49c4acfc28e9c45abe47.1666185911.git.me@lirui.org> In-Reply-To: References: MIME-Version: 1.0 X-Migadu-Flow: FLOW_OUT X-Spam-Status: No, score=-2.8 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_LOW,SPF_HELO_PASS, SPF_PASS autolearn=ham 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 X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1747123893272317775?= X-GMAIL-MSGID: =?utf-8?q?1747123893272317775?= Translate userspace-api/index.rst into Chinese, add it into zh_CN/index.rst. Signed-off-by: Rui Li Reviewed-by: Yanteng Si --- Changes since v2: - Change patch set order Changes since v1: - Align title - Change some translation --- Documentation/translations/zh_CN/index.rst | 2 +- .../zh_CN/userspace-api/index.rst | 46 +++++++++++++++++++ 2 files changed, 47 insertions(+), 1 deletion(-) create mode 100644 Documentation/translations/zh_CN/userspace-api/index.rst diff --git a/Documentation/translations/zh_CN/index.rst b/Documentation/translations/zh_CN/index.rst index ec99ef5fe990..272414971ce9 100644 --- a/Documentation/translations/zh_CN/index.rst +++ b/Documentation/translations/zh_CN/index.rst @@ -90,12 +90,12 @@ TODOList: admin-guide/index admin-guide/reporting-issues.rst + userspace-api/index TODOList: * 内核构建系统 * 用户空间工具 -* userspace-api/index 也可参考独立于内核文档的 `Linux 手册页 `_ 。 diff --git a/Documentation/translations/zh_CN/userspace-api/index.rst b/Documentation/translations/zh_CN/userspace-api/index.rst new file mode 100644 index 000000000000..3b834fe7e33b --- /dev/null +++ b/Documentation/translations/zh_CN/userspace-api/index.rst @@ -0,0 +1,46 @@ +.. SPDX-License-Identifier: GPL-2.0 +.. include:: ../disclaimer-zh_CN.rst + +:Original: Documentation/userspace-api/index.rst + +:翻译: + + 李睿 Rui Li + +========================= +Linux 内核用户空间API指南 +========================= + +.. _man-pages: https://www.kernel.org/doc/man-pages/ + +尽管许多用户空间API的文档被记录在别处（特别是在 man-pages_ 项目中）， +在代码树中仍然可以找到有关用户空间的部分信息。这个手册意在成为这些信息 +聚集的地方。 + +.. class:: toc-title + + 目录 + +TODOList: + +* no_new_privs +* seccomp_filter +* landlock +* unshare +* spec_ctrl +* accelerators/ocxl +* ebpf/index +* ioctl/index +* iommu +* media/index +* netlink/index +* sysfs-platform_profile +* vduse +* futex2 + +.. only:: subproject and html + + Indices + ======= + + * :ref:`genindex` From patchwork Wed Oct 19 13:30:22 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Rui Li X-Patchwork-Id: 5501 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:4ac7:0:0:0:0:0 with SMTP id y7csp336221wrs; Wed, 19 Oct 2022 06:46:38 -0700 (PDT) X-Google-Smtp-Source: AMsMyM5psxCDaA/Xixsr5jzA3RseyCdkAmhOZ1wpub3nhWxW7Ccz/WCmR9++jmSqB9eZHx8Y3RU1 X-Received: by 2002:a63:234b:0:b0:46b:208f:1e72 with SMTP id u11-20020a63234b000000b0046b208f1e72mr7005214pgm.581.1666187197802; Wed, 19 Oct 2022 06:46:37 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1666187197; cv=none; d=google.com; s=arc-20160816; b=A+Wwz8XeI4RhqGo7qQD3tgFyTVh24Co+8/fem4V2Yqg3mYDU4GFc6q2hp+oymXiMpL oVox+6EWmQ/+pTORtFywLzvb/YINpQLwfdTDuO6s3Xhz6jR+pgN7FZQHevvGWMpsbhVl WSfhpmFCa1KzRmamZe9C32tL6HizSguWLPd8dz7+eDfkCLujEiAGKQgXHFK8ztP5K6w6 8veDPdcZjegcYpE72f33kg6exzVqEo/gqPLqpDy8pHzfiYHKadfbMe471tYyVV98PF/i SH2wHvbW33SdS9shymvhAkdxEvCnahNbNV8Ggvd8SY039LszG8oqlJrNdGI2acQQy++d mmSw== 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 :dkim-signature; bh=kLONnTrgE41xLuoR7aINxfaHvykieYVHakm2mQu46pE=; b=0WQ9GU8MoWOL4gvGYNZvMgj9uUjDDs/WqdD1UB/2njTEgwdOWgIgB6prvDxWqzDRjq 7SAvIG7GosI7JfFS/y2v+7z883B5S1EQSxmegqTePEE9MzZn05GSDr0Y/8Jfq2ezNl+1 pVN9UfGLBLH9BNWO2FZXAMPJP902o24C1Sd90NoMPwgSmkdwo2zWPaXyYwsTQfPX5D5o JFGd/1dPdZjrWsTGWD7N0CY1ACLzJ0EgwhzGzHISC7Gn+lYawIfjPsJn7PySjrQRcCMB SEAHxOE292mKTdNZPMl8NF/PgcWT78dXlovxn+JxPGwyXuc4xG6+ac2gGIWacbk5DNxo NisA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@lirui.org header.s=key1 header.b=KCZ3cXrx; 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; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=lirui.org Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id d4-20020a170902854400b0017dafc02313si18377203plo.92.2022.10.19.06.46.23; Wed, 19 Oct 2022 06:46:37 -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; dkim=pass header.i=@lirui.org header.s=key1 header.b=KCZ3cXrx; 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; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=lirui.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S232622AbiJSNqJ (ORCPT + 99 others); Wed, 19 Oct 2022 09:46:09 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:48842 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S232924AbiJSNpA (ORCPT ); Wed, 19 Oct 2022 09:45:00 -0400 Received: from out2.migadu.com (out2.migadu.com [IPv6:2001:41d0:2:aacc::]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id D910E11C38; Wed, 19 Oct 2022 06:31:48 -0700 (PDT) X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers. DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lirui.org; s=key1; t=1666186272; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=kLONnTrgE41xLuoR7aINxfaHvykieYVHakm2mQu46pE=; b=KCZ3cXrxe+PB+8Vud62pouWmnw8EOrEex984T5Iqz55u/3CuMNV+j9NEpU0qmBBqMQwwno 2kiDr8xHqGnAVtyDZjovRWv0xynLRDYgI2msDGiegwnTNuKz536SnCuyoLj24hxnyyAr2D /qnxY+I1brSoE4oqkqUtTBupqe+KRGPadrgYw+VEbMOQNWJZvtZr58lna8z8kSk38Cswmo Y+XyVQ3WoFbyprmYvjEfITuVJMZZfXmZslH86lkUfJfuxtzmwu1SLSIvwDoySbhb0+epnS BqCzGWNHZiEkOdizwMN6OBUqVj9xtYCxqOTZfMsuOqaTv/7kOdGXP7y9LVO9/A== From: Rui Li To: Alex Shi , Yanteng Si Cc: Jonathan Corbet , Wu XiangCheng , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Rui Li Subject: [PATCH v3 2/2] docs/zh_CN: Add userspace-api/ebpf Chinese translation Date: Wed, 19 Oct 2022 21:30:22 +0800 Message-Id: In-Reply-To: References: MIME-Version: 1.0 X-Migadu-Flow: FLOW_OUT X-Spam-Status: No, score=-2.8 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_LOW,SPF_HELO_PASS, SPF_PASS autolearn=ham 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 X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1747123907032189840?= X-GMAIL-MSGID: =?utf-8?q?1747123907032189840?= Translate the following documents into Chinese: - userspace-api/ebpf/index.rst - userspace-api/ebpf/syscall.rst Signed-off-by: Rui Li Reviewed-by: Yanteng Si --- Changes since v2: - Remove long English reference - Remove ebpf from TODO Changes since v1: - Translate bpf subcommand title - Align title - Add space after doc path --- .../zh_CN/userspace-api/ebpf/index.rst | 22 ++++++++++++++ .../zh_CN/userspace-api/ebpf/syscall.rst | 29 +++++++++++++++++++ .../zh_CN/userspace-api/index.rst | 6 +++- 3 files changed, 56 insertions(+), 1 deletion(-) create mode 100644 Documentation/translations/zh_CN/userspace-api/ebpf/index.rst create mode 100644 Documentation/translations/zh_CN/userspace-api/ebpf/syscall.rst diff --git a/Documentation/translations/zh_CN/userspace-api/ebpf/index.rst b/Documentation/translations/zh_CN/userspace-api/ebpf/index.rst new file mode 100644 index 000000000000..d52c7052f101 --- /dev/null +++ b/Documentation/translations/zh_CN/userspace-api/ebpf/index.rst @@ -0,0 +1,22 @@ +.. SPDX-License-Identifier: GPL-2.0 +.. include:: ../../disclaimer-zh_CN.rst + +:Original: Documentation/userspace-api/ebpf/index.rst + +:翻译: + + 李睿 Rui Li + +eBPF 用户空间API +================ + +eBPF是一种在Linux内核中提供沙箱化运行环境的机制，它可以在不改变内核源码或加载 +内核模块的情况下扩展运行时和编写工具。eBPF程序能够被附加到各种内核子系统中，包 +括网络，跟踪和Linux安全模块(LSM)等。 + +关于eBPF的内部内核文档，请查看 Documentation/bpf/index.rst 。 + +.. toctree:: + :maxdepth: 1 + + syscall diff --git a/Documentation/translations/zh_CN/userspace-api/ebpf/syscall.rst b/Documentation/translations/zh_CN/userspace-api/ebpf/syscall.rst new file mode 100644 index 000000000000..47e2a59ae45d --- /dev/null +++ b/Documentation/translations/zh_CN/userspace-api/ebpf/syscall.rst @@ -0,0 +1,29 @@ +.. SPDX-License-Identifier: GPL-2.0 +.. include:: ../../disclaimer-zh_CN.rst + +:Original: Documentation/userspace-api/ebpf/syscall.rst + +:翻译: + + 李睿 Rui Li + +eBPF Syscall +------------ + +:作者: + - Alexei Starovoitov + - Joe Stringer + - Michael Kerrisk + +bpf syscall的主要信息可以在 `man-pages`_ 中的 `bpf(2)`_ 找到。 + +bpf() 子命令参考 +~~~~~~~~~~~~~~~~ + +子命令在以下内核代码中： + +include/uapi/linux/bpf.h + +.. Links: +.. _man-pages: https://www.kernel.org/doc/man-pages/ +.. _bpf(2): https://man7.org/linux/man-pages/man2/bpf.2.html diff --git a/Documentation/translations/zh_CN/userspace-api/index.rst b/Documentation/translations/zh_CN/userspace-api/index.rst index 3b834fe7e33b..12c63d81c663 100644 --- a/Documentation/translations/zh_CN/userspace-api/index.rst +++ b/Documentation/translations/zh_CN/userspace-api/index.rst @@ -21,6 +21,11 @@ Linux 内核用户空间API指南 目录 +.. toctree:: + :maxdepth: 2 + + ebpf/index + TODOList: * no_new_privs @@ -29,7 +34,6 @@ TODOList: * unshare * spec_ctrl * accelerators/ocxl -* ebpf/index * ioctl/index * iommu * media/index