From patchwork Sun Oct 16 11:58:43 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Rui Li X-Patchwork-Id: 3006 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:4ac7:0:0:0:0:0 with SMTP id y7csp991098wrs; Sun, 16 Oct 2022 05:14:38 -0700 (PDT) X-Google-Smtp-Source: AMsMyM6Agm25rs+GOUF5eqaQaPv7aJKmWKY4Rkb7HRz9dCuv5SFnlDHFJAlcfxMrMo7Emr9pAdRM X-Received: by 2002:a05:6402:278f:b0:45d:5503:8acd with SMTP id b15-20020a056402278f00b0045d55038acdmr5477091ede.314.1665922478508; Sun, 16 Oct 2022 05:14:38 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1665922478; cv=none; d=google.com; s=arc-20160816; b=eZC9YMBMM9SlwBwLqSpeXV/NovnuB45Kh8DvV+NM0AGdLVkaE50o8ssriG7UtRyab9 KOYshfkWwEonnC/5scHxFzkCMKvoPajdPUk9gekVX7r+Nw8W15f/FXTwbc90Kp+p9VY4 PpnY0e0NzyIUq3q04ZJ0mMO9x8H0jXUiFIcA5G1wL2gPOqaEok39CZVfJJlX8B/6K+Hf Isxkcg3KpM6iaU+vBMCAfZ64s9w4rnmbX9cLVtUAbHnpVZMX0m+7fnzcGxXRNkBeYA3f Be55dEL+ofv4jtErsQD56TiU8/GUuvlabZ/mPNle3QdK7cU4iyJY0lF6hOrH1kbg1RSE 7Cug== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:references:message-id:to:from :content-transfer-encoding:mime-version:in-reply-to:date:subject :dkim-signature; bh=t1dQDWM4/VSnTQoKiY6vSDDALOOAIL8qqA0imL4WIO4=; b=btMfjV4lZjp9uXbwD5zFoMOQ1ZnFHPE9LMOtlFX5bSHJS7hztxoFJEP0JWGizImBzy 6XwHGFu3YfCKrvarSdJEOm6LZFgX+IPvGh0g/GkNF5Se4+r25XnLlyxizDNdwThLBH+O cNmoD+Q7iVMXmw3UKM8FA96Uq1C1S2Su3HYlW9c21vh5D+d26QEl9KY0UYrZdTrgHsVJ C4paCRiWCdRKOolGhxTZdkMwmWBdFUCkrX0H07+Qc16gxwrFCD9BlFT531Y+iruPrEkG VUhIsKe3PrFqQcrF52KPY4HWqOUG3VkyY7WFa4NzviVUYc1gG839dvYNlQdLo/Eoe/n8 LFrg== ARC-Authentication-Results: i=1; mx.google.com; dkim=fail header.i=@lirui.org header.s=dkim header.b=J8HDgkbi; 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=fail (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 s14-20020a056402520e00b0045d131b8db8si7563593edd.559.2022.10.16.05.14.10; Sun, 16 Oct 2022 05:14: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; dkim=fail header.i=@lirui.org header.s=dkim header.b=J8HDgkbi; 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=fail (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=lirui.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229712AbiJPMIr (ORCPT + 99 others); Sun, 16 Oct 2022 08:08:47 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:53616 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229696AbiJPMIj (ORCPT ); Sun, 16 Oct 2022 08:08:39 -0400 X-Greylist: delayed 576 seconds by postgrey-1.37 at lindbergh.monkeyblade.net; Sun, 16 Oct 2022 05:08:36 PDT Received: from mail-200163.simplelogin.co (mail-200163.simplelogin.co [176.119.200.163]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id BEA9A32068 for ; Sun, 16 Oct 2022 05:08:36 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lirui.org; s=dkim; t=1665921539; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=t1dQDWM4/VSnTQoKiY6vSDDALOOAIL8qqA0imL4WIO4=; b=J8HDgkbip7PRRUqe+DOlfFyGQuPkaLPIMJCZRYr6TMqJgb5EjlQ9Z69T32UvpUPBdZUQpg noCmTsLWa0bzDJbbC/tKfZCi6DXAl7Cfdmz/Icler/4497zzAAz9qqdmRs/AoEmAge+5xe ypfXOTrAOZ6RYadPo+Z4cQCrPSLHfi4= Subject: [PATCH 1/2] docs/zh_CN: Add userspace-api/ebpf Chinese translation Date: Sun, 16 Oct 2022 19:58:43 +0800 In-Reply-To: MIME-Version: 1.0 From: Rui Li To: Alex Shi , Yanteng Si , Jonathan Corbet , linux-doc@vger.kernel.org, LKML Message-ID: <166592153928.7.17506607549803320212.69288112@lirui.org> References: <166592153626.7.4500669936128595360.69288105@lirui.org> X-SimpleLogin-Type: Reply X-SimpleLogin-EmailLog-ID: 69288116 X-SimpleLogin-Want-Signing: yes X-Spam-Status: No, score=-0.7 required=5.0 tests=BAYES_05,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,SPF_HELO_PASS,SPF_PASS autolearn=unavailable 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?1746846328747249779?= X-GMAIL-MSGID: =?utf-8?q?1746846328747249779?= Translate the following documents into Chinese: - userspace-api/ebpf/index.rst - userspace-api/ebpf/syscall.rst Signed-off-by: Rui Li --- .../zh_CN/userspace-api/ebpf/index.rst | 22 +++++++++++++ .../zh_CN/userspace-api/ebpf/syscall.rst | 31 +++++++++++++++++++ 2 files changed, 53 insertions(+) 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..9f0af275eb69 --- /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..56bfa9bc7887 --- /dev/null +++ b/Documentation/translations/zh_CN/userspace-api/ebpf/syscall.rst @@ -0,0 +1,31 @@ +.. 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() subcommand reference +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. kernel-doc:: include/uapi/linux/bpf.h + :doc: eBPF Syscall Preamble + +.. kernel-doc:: include/uapi/linux/bpf.h + :doc: eBPF Syscall Commands + +.. Links: +.. _man-pages: https://www.kernel.org/doc/man-pages/ +.. _bpf(2): https://man7.org/linux/man-pages/man2/bpf.2.html From patchwork Sun Oct 16 11:58:44 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Rui Li X-Patchwork-Id: 3005 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:4ac7:0:0:0:0:0 with SMTP id y7csp989563wrs; Sun, 16 Oct 2022 05:10:01 -0700 (PDT) X-Google-Smtp-Source: AMsMyM5gGvP/wHTvS5dyBojWF44egRXtAeZlCq8+QjTrv6NqLHHTf7vKaljLoVT8O8BxtItWx6oF X-Received: by 2002:a17:906:9bf1:b0:78d:f2d7:efbe with SMTP id de49-20020a1709069bf100b0078df2d7efbemr5057705ejc.273.1665922201134; Sun, 16 Oct 2022 05:10:01 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1665922201; cv=none; d=google.com; s=arc-20160816; b=mMMCbAet7oRRCPcJeMNulNcEtpFHbT6vTokp8VON7A7jES2DXyt0fweVoOZ6CbKcBG h8jLAykPmpJCdvpBnL2R1prtoWPzOERH93IYaVqXd1GzOi2rdKL6My81U63HGJYEewNA dDF8aXGYJ85Oywx70IshNoPzCZRegVdAA/OB1Bba4lWX3awXvAZUlkJOcEGEGyvZxJz0 NPEaEOwZK17NNU51skOKgv2nMiLBRpv25wzhN/1OTr0TLowrxmRNWJGJGESeaE1sGgZh AH/D25p9CCKNSfJoXv+6PVkT/wo7IGljb5DtDVwDxf6wObvW2GYubNuy50vPpzLpG5kv waXQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:references:message-id:to:from :content-transfer-encoding:mime-version:in-reply-to:date:subject :dkim-signature; bh=XT97/4ianI21dvpEGBZUSrkd+v0AEJCqTHZ0j4rZrRE=; b=HtZi9CXoth4jJ64nGsBHaHf5qB+VA6m4W8lHDUCs63568oUVm4hC6Cd9jmLB4UC3dE MaZCX33V6OjKLoQfIPFG3w7XsuBXFqqUrrm8qN6YEAycWMlXj53OqwHgdY1ViBqZACXK TsV3/4d14hH3bQG4jp/G9e6pKsKVupV/Dt1YKG/z6E7Ny/ve33iGyzVDMRJc20EcpQ5z XlGPHb3GxCTqk6QOExicWDK93ZdmFKFGeklE7zPN00T1q0YwRE2gk5726hHFUqW6a4py /SaYYtRi6nrlFzlSOvD8hnAhd9wxDF4YYxKcDBfFrg09fhnaS8oFSu0K37X0rR0mlBYV fWdA== ARC-Authentication-Results: i=1; mx.google.com; dkim=fail header.i=@lirui.org header.s=dkim header.b=JNUEUrNd; 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=fail (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 y88-20020a50bb61000000b0045bdff8a884si6063574ede.268.2022.10.16.05.09.34; Sun, 16 Oct 2022 05:10:01 -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=fail header.i=@lirui.org header.s=dkim header.b=JNUEUrNd; 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=fail (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=lirui.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229671AbiJPMIh (ORCPT + 99 others); Sun, 16 Oct 2022 08:08:37 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:53560 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229562AbiJPMIg (ORCPT ); Sun, 16 Oct 2022 08:08:36 -0400 Received: from mail-200160.simplelogin.co (mail-200160.simplelogin.co [176.119.200.160]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 445B231EDE for ; Sun, 16 Oct 2022 05:08:35 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lirui.org; s=dkim; t=1665921541; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=XT97/4ianI21dvpEGBZUSrkd+v0AEJCqTHZ0j4rZrRE=; b=JNUEUrNdwsWxcdLSJ7c3RahxF2N+WOxt4aZprkTdRIVGm9yeqFlcG6Yg0ya/2uoE1Mwji5 5+sU+0nUy/BEh0A9Gvc6kPIR4BCNPG0Hulx8ajawfLBnDBLH8eDolxNGHVJj9fNOVCR3x5 zmOmUPRr928K9Qb25hrj9srpMBw/CjU= Subject: [PATCH 2/2] docs/zh_CN: Add userspace-api/index Chinese translation Date: Sun, 16 Oct 2022 19:58:44 +0800 In-Reply-To: MIME-Version: 1.0 From: Rui Li To: Alex Shi , Yanteng Si , Jonathan Corbet , linux-doc@vger.kernel.org, LKML Message-ID: <166592154155.8.13781703774239604072.69288121@lirui.org> References: <166592153626.7.4500669936128595360.69288105@lirui.org> X-SimpleLogin-Type: Reply X-SimpleLogin-EmailLog-ID: 69288123 X-SimpleLogin-Want-Signing: yes X-Spam-Status: No, score=0.6 required=5.0 tests=BAYES_50,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,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?1746846037993128229?= X-GMAIL-MSGID: =?utf-8?q?1746846037993128229?= Translate userspace-api/index.rst into Chinese, add it into zh_CN/index.rst. Signed-off-by: Rui Li --- Documentation/translations/zh_CN/index.rst | 2 +- .../zh_CN/userspace-api/index.rst | 50 +++++++++++++++++++ 2 files changed, 51 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..4f5bc5530ebd --- /dev/null +++ b/Documentation/translations/zh_CN/userspace-api/index.rst @@ -0,0 +1,50 @@ +.. 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 + + 目录 + +.. toctree:: + :maxdepth: 2 + + ebpf/index + +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` \ No newline at end of file