From patchwork Tue Oct 18 11:54:52 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Rui Li X-Patchwork-Id: 4131 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:4ac7:0:0:0:0:0 with SMTP id y7csp1917987wrs; Tue, 18 Oct 2022 05:00:58 -0700 (PDT) X-Google-Smtp-Source: AMsMyM78FmZNvWbKr7JRrq6iienMoa9+yKWBDHaZzXke52inOb9xYdZLI0GnW1M5RbyPUzUtNYAm X-Received: by 2002:a05:6402:1e8e:b0:45c:af84:63dd with SMTP id f14-20020a0564021e8e00b0045caf8463ddmr2291843edf.190.1666094458115; Tue, 18 Oct 2022 05:00:58 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1666094458; cv=none; d=google.com; s=arc-20160816; b=jKlDzob8uSHwhv9yFxoZRfxJFWqHMXuLOVsz1/APzzgk7dvJgu4gkegSJfyeTTcrtL wdtSK29NjRLE83oqvu0wHkiZzY8BO9TjZfQOoyiOCz5VqUMji4Tx2ivYCF0dH11Yx9Sd b4D2ofPLV4JOrBIYK0MBiETAAH4QwtYgG9IorcBAF2jyiK97KMh2LE2eDoAzzFLROPDw oAGSespOC5dygq72QuN+lSSUqTeF+y/l+8xB4axQSaNK+JI2cfbrk/wr/JpyzwGykUEi EOsMTLwP+Uq1CnSAeaS+lr5XChyEqehVkJVdzpHllu3gQreKz5Ht04H2fi9FEoUGHyNC hk2Q== 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=hupgNoQdpyp2o8IVUE4hcgxanPErrHi/bqHICjKXEEs=; b=J5DxvRAvv6aw1aBEDHccI0X+dJ5z0mHEqgAGtY+zvIQdSSKz0n7XSnkSYdOIk19h4W hjnQUuabBgcpETSb9R+ZCgjAyZeUb+DuM8kqVPEH1WnfyfxV3to7EFC5X+QvbRvCHueB qKqUCcIZClETutpLSxvYE+e9NYdaMaBUoeJy0ee82nDnDBpZzoA1nIv3TqMv9BuX0tzF FkLGgHjoNRGfUkVNHKvJldI78RH1ATraZIchStDJVd+aThrktabtdQ61noFlskshOtzJ 6JWhecYc0g8W334RAtVam5o2V7CaU82+R0B6dohZZA+0TmpkoCncsRdQvHkrMyaDdsiB OOXA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@lirui.org header.s=key1 header.b=mrQkA5WV; 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 he18-20020a1709073d9200b0078ca7bbf616si12524530ejc.746.2022.10.18.05.00.30; Tue, 18 Oct 2022 05:00:58 -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=mrQkA5WV; 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 S230098AbiJRLz1 (ORCPT + 99 others); Tue, 18 Oct 2022 07:55:27 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:54016 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229760AbiJRLzZ (ORCPT ); Tue, 18 Oct 2022 07:55:25 -0400 Received: from out2.migadu.com (out2.migadu.com [IPv6:2001:41d0:2:aacc::]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 2200997EF3; Tue, 18 Oct 2022 04:55:24 -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=1666094122; 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=hupgNoQdpyp2o8IVUE4hcgxanPErrHi/bqHICjKXEEs=; b=mrQkA5WVTIf9mfixRtZIuewlQflouJg2JZZeYBeVsipJEW9MPIkF39gS+adsgBMR+cIHZD Ri1CLhr7Ok+dABjxHV00/Qkgw40ZEKGGcW1IrJfNqvlqdQJKfH/AZU+SAVQOG6A9Ft/Ye3 /XkzhfCRPquaROrrmV0KJZXqhVpGIg8AfPdz2S1A82Zwn9101Dut++3PTAozB69agaSNuP lzpyVjuGeJfgutbD09mbqkcqY+vi98zSksWC3oWNYmyGKTa60qw6ZlNIAeHfsWbUjdPLnS FmY/pNs890hOJa7RvROHcYQ8ALUxx1FsFiIJimh2XqpFycTjvB1McmxPRIOjpQ== From: Rui Li To: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Cc: Alex Shi , Yanteng Si , Jonathan Corbet , Wu XiangCheng , Rui Li Subject: [PATCH v2 1/2] docs/zh_CN: Add userspace-api/ebpf Chinese translation Date: Tue, 18 Oct 2022 19:54:52 +0800 Message-Id: <8d032bf9a69ac6703260ac91408562c562c03f2d.1666093699.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?1747026662485136738?= X-GMAIL-MSGID: =?utf-8?q?1747026662485136738?= Translate the following documents into Chinese: - userspace-api/ebpf/index.rst - userspace-api/ebpf/syscall.rst Signed-off-by: Rui Li --- 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 | 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..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..17515728f544 --- /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() 子命令参考 +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +.. 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 Tue Oct 18 11:54:53 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Rui Li X-Patchwork-Id: 4130 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:4ac7:0:0:0:0:0 with SMTP id y7csp1917904wrs; Tue, 18 Oct 2022 05:00:49 -0700 (PDT) X-Google-Smtp-Source: AMsMyM7Ma1J5JMMCQCNFTiJ7fcyBMbWcYujwnV1QOG1ga7DDB7N+eerPw0C9wG3//Nr4iyeam1JV X-Received: by 2002:a17:903:30d4:b0:184:fadd:ec27 with SMTP id s20-20020a17090330d400b00184faddec27mr2691438plc.44.1666094448302; Tue, 18 Oct 2022 05:00:48 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1666094448; cv=none; d=google.com; s=arc-20160816; b=WPC1YpR7G8Xa8p5fLBKPaAGeJsNcnB+7QkZsb9OSMefEfQHT9Dsxuv6fC1jVMp5PuV wskzFtoy1z6Jl79WaNgu0Mj7WKOvnJ7eZv0Y1r/+3/Wz1qc9w8TTUpDgNi3avQtIB6Q5 RntKFs6V6UQQg8w+qSkf/MayO5U8q9+eYvnjU3R3VtWmfJnyyukRcueUMlq3byDiq9pg 0ZqPIhW7A8ixKsIz1cb2KAaR2E6HPa17uS4RFrZI95jpclZPAp4Q2nIaMdcU3/tiG5uu 7FY4FbZKgvRYOUf3sNCnmYGm5Fnu9bL2ohT/kZqGKREGDRxznpnXVF89CS00gJ3SSayx CQxw== 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=cgQBXm1dv4ujn38yEqX7tGehxSC+vaQSz42cTrCDBX0=; b=FJXv81EB2Wa1ym4/cn+c+yFb8WgPvya1zdbD180WeIe9chiCcTOqRpf3YLFattnU4Z pPDqoMR07eGDk9J9/c7QD/rgv6g7JVLst35Y06UO1AZL0FKlo85RAQyQvgHI5mqQH4T6 462VBXjmPPJxoE3C8jQdDbsBEJo9R5W/sEuJb5vAQTZmbTJ/A+JLdF1UwCPYzlTjcmzA OjnD4O+49Tgr851OwTLz5TDSadUA0y0hVvev3SXNihF4Zwt8RBDy3RVtz72yhA6D7TLH wcUG+xHuf90iX2UORJXYHryMbVc0fxjo4CAThC1hQ6KQ6vLe7dcKUcExmGofM0gCWvZv 5zOg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@lirui.org header.s=key1 header.b=cmkJgAm9; 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 q17-20020a170902f35100b00174ea015ee8si12394321ple.592.2022.10.18.05.00.31; Tue, 18 Oct 2022 05:00:48 -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=cmkJgAm9; 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 S230108AbiJRLzc (ORCPT + 99 others); Tue, 18 Oct 2022 07:55:32 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:54098 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229556AbiJRLz1 (ORCPT ); Tue, 18 Oct 2022 07:55:27 -0400 Received: from out2.migadu.com (out2.migadu.com [188.165.223.204]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 254DE9AFB0; Tue, 18 Oct 2022 04:55:27 -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=1666094125; 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=cgQBXm1dv4ujn38yEqX7tGehxSC+vaQSz42cTrCDBX0=; b=cmkJgAm9Z/g95AzBIckx9+AySMDFOs09DIvHgoRMO0cwmSHUbHBWLut/zsjiJa0zLq/jRg 4QF0KlMvu3STax+6Pky0JWJ1Zf4R2XpahP7wnnlmMR2HBe0YZRTpO60drjYC6fFeJWpKyb IKRZWfOBl+KyB2ucsvAghI5zxhpvd9uWLaQ0if/zk1itWq9Nfhh0RfTkzvbdjYDfoiBooB GRRyUtrAfpb4fHh5OXgEbRfRYYOSmY56HLdXgGKKAorMQWM4L/eNDX5dXUDeutw80poyun gokBznO3ehIg2yCi1JgEOiXMVQQCBGsFUOaj4PQGM4zCl3HujVzysFqVPGpnlQ== From: Rui Li To: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Cc: Alex Shi , Yanteng Si , Jonathan Corbet , Wu XiangCheng , Rui Li Subject: [PATCH v2 2/2] docs/zh_CN: Add userspace-api/index Chinese translation Date: Tue, 18 Oct 2022 19:54:53 +0800 Message-Id: <88e6c1390068bff71e16ebd375e684d8e663dee2.1666093699.git.me@lirui.org> In-Reply-To: References: MIME-Version: 1.0 X-Migadu-Flow: FLOW_OUT X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,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?1747026652397468690?= X-GMAIL-MSGID: =?utf-8?q?1747026652397468690?= Translate userspace-api/index.rst into Chinese, add it into zh_CN/index.rst. Signed-off-by: Rui Li --- Changes since v1: - Align title - Change some translation --- Documentation/translations/zh_CN/index.rst | 2 +- .../zh_CN/userspace-api/index.rst | 51 +++++++++++++++++++ 2 files changed, 52 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..df1e1572e3f4 --- /dev/null +++ b/Documentation/translations/zh_CN/userspace-api/index.rst @@ -0,0 +1,51 @@ +.. 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`