From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-pf1-f178.google.com (mail-pf1-f178.google.com [209.85.210.178]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 40DCF3890EE for ; Mon, 7 Sep 2026 05:49:30 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.178 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1788760172; cv=none; b=nUTPdM60NWnNrf/SQo90F3cLOOH7T9kfrVY2Q46tW0oViuckEIn0z1wHo/HZDJpfkuirXtY61jp2g9wKIDtuKNfHwPgBTqmkSvUEIaHPa8b8ePK1Qey8lXqgi+mh+HKXGIosfb3ln724aP8wJTrnx692G+SJXxzathUk4CPZpBc= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1788760172; c=relaxed/simple; bh=qkLLrYO1wm0V5K+u4TzItu4MYjDG4vaouixDH+rGCj4=; h=Message-ID:Date:MIME-Version:Subject:To:Cc:References:From: In-Reply-To:Content-Type; b=JJzXHL/jCZTh+aNz0trBrvnxcieQZNeaWObufQ4epjJx9Fjq6nnoHM0xn6MRVviuUeYTXmqOUksfnQT5KDWrgZ0oP9Jq9AQiOeFDzgYPwz1h42yhesHB5MvztB4zLAjtMnXLNgXr2oAJl+16aGyChN1YVzN8rj95djHnN2zWBPU= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=mUIazvvx; arc=none smtp.client-ip=209.85.210.178 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="mUIazvvx" Received: by mail-pf1-f178.google.com with SMTP id d2e1a72fcca58-84e84a6c4bfso2792878b3a.1 for ; Sun, 06 Sep 2026 22:49:30 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1788760170; x=1789364970; darn=vger.kernel.org; h=content-transfer-encoding:content-type:in-reply-to:content-language :from:references:cc:to:subject:user-agent:mime-version:date :message-id:from:to:cc:subject:date:message-id:reply-to:content-type; bh=z7EX7mOM/qiOwQlbURkZ/luFmBbIsDaxMuwCLWOzuHM=; b=mUIazvvxTU0+WyKTSxJ/11DP4Fceun/YsoWrbeZL8NKh9VKe2heZfOV4R71tQIlpme /+oE1nBBatg71h5L2TyjHdZDgzyxbg5wct5X43FfVBJIJQ7dVFk9L6jqoRLiQwzxLSgP 7ER3zgalm2Tipo1XqndcdN+sdDW/9em80FJ/V4gq1jOKOI5ujrsmLIo2axFRwgspSdFD TtpzwNBUW5biUEH07FgZ9h2R6/rptU46JtRL8XjphXTKBdTn630keu+cO0AwkUV16ug9 YJGS0nIDEoBxZ34+jU4JfK2eYHJ2urPsf25vxcjAtegtwSmnDJDSzSdER2V0EnbC5qcF b74g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1788760170; x=1789364970; h=content-transfer-encoding:content-type:in-reply-to:content-language :from:references:cc:to:subject:user-agent:mime-version:date :message-id:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to:content-type; bh=z7EX7mOM/qiOwQlbURkZ/luFmBbIsDaxMuwCLWOzuHM=; b=CPaZHjB6IKJGsj+jElQPpxNbyvXstAJw6gcTYqRgZaJP9oZAj5qCkatf5MgUPDz1Ju xulmnvaNSvgggRC1KKydUHlwv7SxVd616gAe/pKq/LKrzV3wkVqy/7eMk9jqqhQl06nu VjIxaqRtYaVEvT2ZyYm1qP3i827Kmg6DsooaAYvZzhEt3s/lj34syddg0hEIFLeG50sH Pw0No2IRMUBxORkapxiIPmSCt/M1BBs0qK7AeAMQbDe1hglmYKpWMyk7qGXttGr7LNZy lmyKjM7A5AsoKgK20S/6/ql3VrBBBdHKaJXaZ77gKWFrT15ZoC4DUfzYyniMtF+1UQqb OUZg== X-Forwarded-Encrypted: i=1; AKwUvBwcR3+lCwe2uZugKxjsT7IiS4NaYZ+6uSWiVR973iVe0I0XZ/hH5Vaspuqq/Mi99odOeFHGA6C6GZSgMqQ=@vger.kernel.org X-Gm-Message-State: AFuF++mI3tnOkX0IJy6vxEjYSw0eiAKv0UUdWOaO17gfZSIedCdrxcJv ut1jQskRt0Qld17OQeouLkAEnTa9hiSgvMkyT2vEyaYkAzP8fHBlE6KqYHL1gw4LVWEweA== X-Gm-Gg: AYBFou3N4CyoKwzT7EPBIsiMNZMsaU+0QIosFyEjDHn/IrTLaU6VWYdHN1yvm/DAQf8 +Bij1jxBhq4LtnukIIZU1xF6EUsIeR4t+J+wW84gtZ1HVdfFI96NlXqHqneVeEp2LIMjOnEBNsz qoJ6Bi5HClB1NqdOu6NfClzOVIOtYtrtGsrJobZbpnx9HWyK+cOHi22c5NC2nm/SjAaa0pZMvOU QfZDbDcMJePSJ7NOvvZL/YQdtOx2ys6AMeOehzUFlHfqjYXEx7O2X+K7taGxyP/2KtpU6lFx77N 1eR92GFdqvEVVrCIOCQMVwTfMJTkFUCZvVdUSg/qgZxMNNWKQIT9hwf9Rt+/YSx9oKWY1cslfbx MJCZIk4/0i+PFL71FD6+RJ9jd8cv+miaib/2hmUA7RNMCvPw/peRDaYhHlq0jziPBQX39HO7ppP la3gfD8g6U5VuZ5KPzNFzMSYIxT5v40g0Q4eI2kZE1VjqZAaMVOtUvbybfAAdEN82Jefia+9Tf+ 5boCdlbipDf8AM= X-Received: by 2002:a05:6a00:f94:b0:857:72f8:dca6 with SMTP id d2e1a72fcca58-8619c87fcb5mr15788416b3a.12.1788760170262; Sun, 06 Sep 2026 22:49:30 -0700 (PDT) Received: from [192.168.2.166] (104.194.78.75.16clouds.com. [104.194.78.75]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-8614f873cb6sm3783716b3a.1.2026.09.06.22.49.24 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Sun, 06 Sep 2026 22:49:28 -0700 (PDT) Message-ID: <6932a51e-0b88-4db6-8e01-a6472d8e0968@gmail.com> Date: Mon, 7 Sep 2026 13:49:21 +0800 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH v3] docs/zh_CN: Add configurable error injection translation To: cuishuang , alexs@kernel.org, si.yanteng@linux.dev Cc: dzm91@hust.edu.cn, corbet@lwn.net, skhan@linuxfoundation.org, wangyuli@aosc.io, kezijie@leap-io-kernel.com, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org References: <20260722123240.22979-1-imcusg@gmail.com> From: Alex Shi Content-Language: en-US In-Reply-To: <20260722123240.22979-1-imcusg@gmail.com> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit On 2026/7/22 20:32, cuishuang wrote: > From: Cui Shuang > > Translate Documentation/block/error-injection.rst into Chinese and add > it to the Chinese block documentation index. > > Update the translation through commit e8dcf2d142bd > ("block: add configurable error injection"). > > Assisted-by: Codex:gpt-5 > Signed-off-by: Cui Shuang > --- > v2->v3: > - Add the missing Assisted-by trailer to the commit message. > - Use "Cui Shuang" consistently as the contributor name. > > v1->v2: > - Resend via authenticated SMTP after the original message was only > partially delivered and did not reach the linux-doc archive. > > .../zh_CN/block/error-injection.rst | 63 +++++++++++++++++++ > .../translations/zh_CN/block/index.rst | 1 + > 2 files changed, 64 insertions(+) > create mode 100644 Documentation/translations/zh_CN/block/error-injection.rst > > diff --git a/Documentation/translations/zh_CN/block/error-injection.rst b/Documentation/translations/zh_CN/block/error-injection.rst > new file mode 100644 > index 000000000000..63aac2fb38f8 > --- /dev/null > +++ b/Documentation/translations/zh_CN/block/error-injection.rst > @@ -0,0 +1,63 @@ > +.. SPDX-License-Identifier: GPL-2.0 > +.. include:: ../disclaimer-zh_CN.rst > + > +:Original: Documentation/block/error-injection.rst > + > +:翻译: > + > + Cui Shuang > + > +============== > +可配置错误注入 > +============== > + > +概述 > +---- > + > +可配置错误注入允许针对块设备的扇区范围注入特定的块层状态码。错误可以无条件 > +注入，也可以按给定概率注入。 > + > +要使用可配置错误注入，必须启用 ``CONFIG_BLK_ERROR_INJECTION``。 > + > +唯一的接口是 ``error_injection`` debugfs 文件，每个已注册的 gendisk 都会 > +创建该文件。写入此文件用于创建或删除规则，读取则返回当前错误注入点的列表。 "读取则返回当前错误注入点的列表", could you polish this word? make it more nature in Chinese.> + > +选项 > +---- > + > +以下选项指定操作： > + > +=================== ======================================================= > +add 添加一条新规则 > +removeall 删除所有现有规则 > +=================== ======================================================= > + > +以下选项指定 ``add`` 操作的规则详情： > + > +=================== ======================================================= > +op= 此规则适用的块层操作。它使用每个 ``REQ_OP_XYZ`` > + 操作中的 ``XYZ``，例如 ``READ``、``WRITE`` 或 > + ``DISCARD``。必填。 > +status= 要返回的状态。它使用每个 ``BLK_STS_XYZ`` 状态码 Incorrect indent. take care the alignment. Thanks Alex > + 中的 ``XYZ``，例如 ``IOERR`` 或 ``MEDIUM``。必填。 > +start= 此规则适用的第一个块层扇区。可选，默认为 0。 > +nr_sectors= 此规则适用的扇区数。可选，默认覆盖设备的剩余部分。 > +chance= 仅以 ``1/chance`` 的概率返回失败。可选，默认为 1 > + （总是失败）。 > +=================== ======================================================= > + > +示例 > +---- > + > +对 ``/dev/nvme0n1`` 扇区 0 的读取，每 10 次中有一次返回 > +``BLK_STS_IOERR``： > + > + $ echo 'add,op=READ,start=0,status=IOERR,chance=10' > /sys/kernel/debug/block/nvme0n1/error_injection > + > +对 ``/dev/nvme0n1`` 的每次写入都返回 ``BLK_STS_MEDIUM``： > + > + $ echo 'add,op=WRITE,start=0,status=MEDIUM' > /sys/kernel/debug/block/nvme0n1/error_injection > + > +删除 ``/dev/nvme0n1`` 的所有规则： > + > + $ echo 'removeall' > /sys/kernel/debug/block/nvme0n1/error_injection > diff --git a/Documentation/translations/zh_CN/block/index.rst b/Documentation/translations/zh_CN/block/index.rst > index f2ae5096ed68..4877432cc4ff 100644 > --- a/Documentation/translations/zh_CN/block/index.rst > +++ b/Documentation/translations/zh_CN/block/index.rst > @@ -18,6 +18,7 @@ Block > > blk-mq > data-integrity > + error-injection > > TODOList: > * bfq-iosched > -- 2.50.1 (Apple Git-155) >