From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-oo1-f52.google.com (mail-oo1-f52.google.com [209.85.161.52]) (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 7A16435894; Tue, 3 Sep 2024 01:23:39 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.161.52 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1725326621; cv=none; b=HKbxAzIywBHh8hHRxmj6J6+nXI4U4n+3++w+eq64fkCHzbkUvujvDR1WODXyWFVw75T9ozyULH2z6tBZKH+GcqvmiFi3oUwS3keCOpHoVgAwmCVYnik04ueJYX1c5XQsZDFnFivVRKqlLHFMLcSTeyHinQlKFOzZegQRskGOCnI= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1725326621; c=relaxed/simple; bh=I5GaQDo+r8u110Mc5ORN+9NDO9oXaZzSO4wm7B4JsT0=; h=Message-ID:Date:MIME-Version:Subject:To:Cc:References:From: In-Reply-To:Content-Type; b=lqxzsW/KG+C9H1iHeMRa4cPGTgXcJ3BvrYxkH7Lr3TdyRPlWk+cVbxNtxD9O3hjmykejFC6LRJFzWmDPYxWrhOaO0Lh8r8Zc27kkQTHmz+tV3WwhS1gpcuPJCZJ0RdGQ1JRYl82coFCrRwkfebrukC2Nlhb8UCaDZezA1NJedAQ= 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=GhHf36R0; arc=none smtp.client-ip=209.85.161.52 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="GhHf36R0" Received: by mail-oo1-f52.google.com with SMTP id 006d021491bc7-5dd43ab0458so2799583eaf.0; Mon, 02 Sep 2024 18:23:39 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1725326618; x=1725931418; darn=vger.kernel.org; h=content-transfer-encoding:in-reply-to:from:content-language :references:cc:to:subject:user-agent:mime-version:date:message-id :from:to:cc:subject:date:message-id:reply-to; bh=RJfLSAGOYYqG4ZgajBQXh8F3yrAHFYIyXLB6XRiyLO4=; b=GhHf36R0Wx/0+hRygDM3l1ZJQkQx3sus2/kDxHG+MXQW5wQkMLaww9InjHQQnOvVg0 0viLxqOEdh5jzfVJ1ZrReTWKV5kWAhLF1vDSkLPUz7/h8GtpPqd42SavAKHFRoaOAQub 7GVCpdeJB1zIGjfkRvKMcn4qpj/XBbGe3iuB7Qu/EkuHppr+TCZVwCELDcqtR8VKTmSu h7i22ifzBV6jPzjsjD1PzvJyJcnMSHQEf6Fn/KpBG0ZNGnyaFobnMkMHTYhYYnwoki1w JYLWAACzQN+plpGGGxFB6Wh5auQxO82v56gizxxdd6+QI7xWSJ8TMttVaDXI5zJdTjWJ oiWw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1725326618; x=1725931418; h=content-transfer-encoding:in-reply-to:from:content-language :references:cc:to:subject:user-agent:mime-version:date:message-id :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=RJfLSAGOYYqG4ZgajBQXh8F3yrAHFYIyXLB6XRiyLO4=; b=sRFCTkhPPDRdL/VuNBfb9b/VcNkUbAtXc0ut3+Y3J5qjjSy503pES/CeOeLgOufoDU +KB2ZfzA/Pc2NHYVUnhz5vk7sLcnwh8eXW+jIRKBgfC8bE+1rS8tajXrfgdFedSNLO2T QbcuzvpWZb47fxWWJNM8SifQYJcaJkEK4bZM8bFuocMjOQrzNZwJlCGs8GSLkMGF+Hxi 0bfN0s1LRuj503CDaOeZ/16JtXs3dQ0EU4BWokkgXnXBa36HD+DZrSsgcoEMZSru+YdF 7wSO2ecg6WLM9NZF/zzte/3LBDH//1gtwpUQZMje7oKYhukt6E0srrh4w66Knk+3OkE6 M+EQ== X-Forwarded-Encrypted: i=1; AJvYcCU+xqWzYK7X+EjZXCNtg+pi3Bs+VMDS0o5+8s4O9Yp3qtTXBV2fuJNFDhi2OFEjGCnGI+oU1LsBj2sOMbc=@vger.kernel.org, AJvYcCVD5NuFh0D51baIs0vNwcwnXCRIUJYdgfbOkXLNi41ESwk2+kMThzpm09f8xiGttDKQwSMEHqX/ZmQx@vger.kernel.org, AJvYcCVOE6J4tvEYQBfaEpfjld7LWHzp1g8PFrCBpiJl8OrwasqokAnJLHIyhJ76BcIpPrF+BegUSx4QuwgM@vger.kernel.org, AJvYcCWrZ2iNmiz36RWcmsbKY9QAqMK4zji5+K/lY7J0zFPVWwOGYDlwTz6uwk69XFXvY3hbHfngc6XPggQptA==@vger.kernel.org, AJvYcCX3VBuUnQvcoXJQa410TU0ykU3LR+k78KDItAevK87g4XNSXvl/iiQijVG2r1V3QfcCG9l4bqp+ljDM@vger.kernel.org, AJvYcCXUEL/93g7xlaEaGyBT5O11klW8wve0/EcZdHC4fgmXimzphQNvD2zErVqiRy68F85tIKDGSbk+vJMtr0Kd@vger.kernel.org X-Gm-Message-State: AOJu0YzA1fJiF3HatRngwMMmSs/NdTouXQQhMESA7QEEBaoUuMxVkBc1 XNHjSFQAtFxij6nNDNbN7hsMUfDD7x2n5j5N6FH+zmbDQebYyONW X-Google-Smtp-Source: AGHT+IEEqIJI+4PA8pSOsfMxA3zSUc0eTm4f+qtSSo7zpsu62tBdkyVJEa4o7WCAreFvxF+8t0F2Vw== X-Received: by 2002:a05:6870:9692:b0:254:b337:eebc with SMTP id 586e51a60fabf-277d060434emr11214764fac.35.1725326618141; Mon, 02 Sep 2024 18:23:38 -0700 (PDT) Received: from [192.168.255.10] ([43.132.141.24]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-715e5576cd2sm7395379b3a.22.2024.09.02.18.23.28 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 02 Sep 2024 18:23:37 -0700 (PDT) Message-ID: <1f943f92-5e46-4c5d-8e21-0d597128c105@gmail.com> Date: Tue, 3 Sep 2024 09:23:26 +0800 Precedence: bulk X-Mailing-List: workflows@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH v2] docs: Move fault injection section to dev-tools To: Breno Leitao , Jonathan Corbet , Akinobu Mita , Federico Vaga , Akira Yokosawa , Carlos Bilbao , Avadhut Naik , Alex Shi , Yanteng Si , Hu Haowen <2023002089@link.tyut.edu.cn>, Jens Axboe , Kees Cook , Arnd Bergmann , Greg Kroah-Hartman , Alim Akhtar , Avri Altman , Bart Van Assche , "James E.J. Bottomley" , "Martin K. Petersen" , Andrew Morton Cc: leit@meta.com, "Paul E. McKenney" , Thomas Huth , "Borislav Petkov (AMD)" , Thomas Gleixner , Xiongwei Song , Ard Biesheuvel , John Moon , Vegard Nossum , Miguel Ojeda , Wolfram Sang , SeongJae Park , "Ran.Park" , Tiezhu Yang , Remington Brasga , Damien Le Moal , Hannes Reinecke , Chaitanya Kulkarni , Johannes Thumshirn , Zhu Yanjun , John Garry , Chengming Zhou , Yu Kuai , Shin'ichiro Kawasaki , Vlastimil Babka , "open list:DOCUMENTATION" , open list , "open list:DOCUMENTATION PROCESS" , "open list:BLOCK LAYER" , "open list:UNIVERSAL FLASH STORAGE HOST CONTROLLER DRIVER" , "open list:GENERIC INCLUDE/ASM HEADER FILES" References: <20240902125421.569668-1-leitao@debian.org> Content-Language: en-US From: Alex Shi In-Reply-To: <20240902125421.569668-1-leitao@debian.org> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit LGTM. Reviewed-by: Alex Shi On 9/2/24 8:53 PM, Breno Leitao wrote: > Fault injection is a development tool, and should be under dev-tools > section. > > Suggested-by: Jonathan Corbet > Signed-off-by: Breno Leitao > --- > Changelog: > > v2: > * Fixed a remaining file pointing to the wrong file, as reported by > kernel test robot: > * https://lore.kernel.org/all/202408312350.DEf53QzI-lkp@intel.com/ > > v1: > * https://lore.kernel.org/all/20240830174502.3732959-1-leitao@debian.org/ > > Documentation/admin-guide/kernel-parameters.txt | 2 +- > .../{ => dev-tools}/fault-injection/fault-injection.rst | 0 > Documentation/{ => dev-tools}/fault-injection/index.rst | 0 > .../fault-injection/notifier-error-inject.rst | 0 > .../{ => dev-tools}/fault-injection/nvme-fault-injection.rst | 0 > .../{ => dev-tools}/fault-injection/provoke-crashes.rst | 0 > Documentation/dev-tools/index.rst | 1 + > Documentation/index.rst | 1 - > Documentation/process/4.Coding.rst | 2 +- > Documentation/process/submit-checklist.rst | 2 +- > Documentation/translations/it_IT/process/4.Coding.rst | 2 +- > .../translations/it_IT/process/submit-checklist.rst | 2 +- > Documentation/translations/ja_JP/SubmitChecklist | 2 +- > .../translations/sp_SP/process/submit-checklist.rst | 2 +- > Documentation/translations/zh_CN/index.rst | 2 +- > Documentation/translations/zh_CN/process/4.Coding.rst | 2 +- > .../translations/zh_CN/process/submit-checklist.rst | 2 +- > Documentation/translations/zh_TW/index.rst | 2 +- > Documentation/translations/zh_TW/process/4.Coding.rst | 2 +- > .../translations/zh_TW/process/submit-checklist.rst | 2 +- > MAINTAINERS | 2 +- > drivers/block/null_blk/main.c | 2 +- > drivers/misc/lkdtm/core.c | 2 +- > drivers/ufs/core/ufs-fault-injection.c | 2 +- > include/asm-generic/error-injection.h | 5 +++-- > include/linux/fault-inject.h | 2 +- > lib/Kconfig.debug | 4 ++-- > tools/testing/fault-injection/failcmd.sh | 2 +- > 28 files changed, 25 insertions(+), 24 deletions(-) > rename Documentation/{ => dev-tools}/fault-injection/fault-injection.rst (100%) > rename Documentation/{ => dev-tools}/fault-injection/index.rst (100%) > rename Documentation/{ => dev-tools}/fault-injection/notifier-error-inject.rst (100%) > rename Documentation/{ => dev-tools}/fault-injection/nvme-fault-injection.rst (100%) > rename Documentation/{ => dev-tools}/fault-injection/provoke-crashes.rst (100%) > > diff --git a/Documentation/admin-guide/kernel-parameters.txt b/Documentation/admin-guide/kernel-parameters.txt > index 09126bb8cc9f..70d2077c9b3f 100644 > --- a/Documentation/admin-guide/kernel-parameters.txt > +++ b/Documentation/admin-guide/kernel-parameters.txt > @@ -1532,7 +1532,7 @@ > fail_make_request=[KNL] > General fault injection mechanism. > Format: ,,, > - See also Documentation/fault-injection/. > + See also Documentation/dev-tools/fault-injection/. > > fb_tunnels= [NET] > Format: { initns | none } > diff --git a/Documentation/fault-injection/fault-injection.rst b/Documentation/dev-tools/fault-injection/fault-injection.rst > similarity index 100% > rename from Documentation/fault-injection/fault-injection.rst > rename to Documentation/dev-tools/fault-injection/fault-injection.rst > diff --git a/Documentation/fault-injection/index.rst b/Documentation/dev-tools/fault-injection/index.rst > similarity index 100% > rename from Documentation/fault-injection/index.rst > rename to Documentation/dev-tools/fault-injection/index.rst > diff --git a/Documentation/fault-injection/notifier-error-inject.rst b/Documentation/dev-tools/fault-injection/notifier-error-inject.rst > similarity index 100% > rename from Documentation/fault-injection/notifier-error-inject.rst > rename to Documentation/dev-tools/fault-injection/notifier-error-inject.rst > diff --git a/Documentation/fault-injection/nvme-fault-injection.rst b/Documentation/dev-tools/fault-injection/nvme-fault-injection.rst > similarity index 100% > rename from Documentation/fault-injection/nvme-fault-injection.rst > rename to Documentation/dev-tools/fault-injection/nvme-fault-injection.rst > diff --git a/Documentation/fault-injection/provoke-crashes.rst b/Documentation/dev-tools/fault-injection/provoke-crashes.rst > similarity index 100% > rename from Documentation/fault-injection/provoke-crashes.rst > rename to Documentation/dev-tools/fault-injection/provoke-crashes.rst > diff --git a/Documentation/dev-tools/index.rst b/Documentation/dev-tools/index.rst > index 53d4d124f9c5..ade850c4b344 100644 > --- a/Documentation/dev-tools/index.rst > +++ b/Documentation/dev-tools/index.rst > @@ -34,6 +34,7 @@ Documentation/dev-tools/testing-overview.rst > ktap > checkuapi > gpio-sloppy-logic-analyzer > + Fault injection > > > .. only:: subproject and html > diff --git a/Documentation/index.rst b/Documentation/index.rst > index f9f525f4c0dd..9b57d6bc04f4 100644 > --- a/Documentation/index.rst > +++ b/Documentation/index.rst > @@ -57,7 +57,6 @@ Various other manuals with useful information for all kernel developers. > Testing guide > Hacking guide > Tracing > - Fault injection > Livepatching > Rust > > diff --git a/Documentation/process/4.Coding.rst b/Documentation/process/4.Coding.rst > index 80bcc1cabc23..1fc0a7fc2f43 100644 > --- a/Documentation/process/4.Coding.rst > +++ b/Documentation/process/4.Coding.rst > @@ -300,7 +300,7 @@ enabled, a configurable percentage of memory allocations will be made to > fail; these failures can be restricted to a specific range of code. > Running with fault injection enabled allows the programmer to see how the > code responds when things go badly. See > -Documentation/fault-injection/fault-injection.rst for more information on > +Documentation/dev-tools/fault-injection/fault-injection.rst for more information on > how to use this facility. > > Other kinds of errors can be found with the "sparse" static analysis tool. > diff --git a/Documentation/process/submit-checklist.rst b/Documentation/process/submit-checklist.rst > index e531dd504b6c..b513b3d05426 100644 > --- a/Documentation/process/submit-checklist.rst > +++ b/Documentation/process/submit-checklist.rst > @@ -124,7 +124,7 @@ Test your code > 3) All codepaths have been exercised with all lockdep features enabled. > > 4) Has been checked with injection of at least slab and page-allocation > - failures. See ``Documentation/fault-injection/``. > + failures. See ``Documentation/dev-tools/fault-injection/``. > If the new code is substantial, addition of subsystem-specific fault > injection might be appropriate. > > diff --git a/Documentation/translations/it_IT/process/4.Coding.rst b/Documentation/translations/it_IT/process/4.Coding.rst > index ec874a8dfb9d..b7b9ab6df103 100644 > --- a/Documentation/translations/it_IT/process/4.Coding.rst > +++ b/Documentation/translations/it_IT/process/4.Coding.rst > @@ -317,7 +317,7 @@ di allocazione di memoria sarà destinata al fallimento; questi fallimenti > possono essere ridotti ad uno specifico pezzo di codice. Procedere con > l'inserimento dei fallimenti attivo permette al programmatore di verificare > come il codice risponde quando le cose vanno male. Consultate: > -Documentation/fault-injection/fault-injection.rst per avere maggiori > +Documentation/dev-tools/fault-injection/fault-injection.rst per avere maggiori > informazioni su come utilizzare questo strumento. > > Altre tipologie di errori possono essere riscontrati con lo strumento di > diff --git a/Documentation/translations/it_IT/process/submit-checklist.rst b/Documentation/translations/it_IT/process/submit-checklist.rst > index 2fc09cc1f0be..60ec660702fa 100644 > --- a/Documentation/translations/it_IT/process/submit-checklist.rst > +++ b/Documentation/translations/it_IT/process/submit-checklist.rst > @@ -99,7 +99,7 @@ sottomissione delle patch, in particolare > essere inviate in copia anche a linux-api@vger.kernel.org. > > 20) La patch è stata verificata con l'iniezione di fallimenti in slab e > - nell'allocazione di pagine. Vedere ``Documentation/fault-injection/``. > + nell'allocazione di pagine. Vedere ``Documentation/dev-tools/fault-injection/``. > > Se il nuovo codice è corposo, potrebbe essere opportuno aggiungere > l'iniezione di fallimenti specifici per il sottosistema. > diff --git a/Documentation/translations/ja_JP/SubmitChecklist b/Documentation/translations/ja_JP/SubmitChecklist > index 1759c6b452d6..193641581e98 100644 > --- a/Documentation/translations/ja_JP/SubmitChecklist > +++ b/Documentation/translations/ja_JP/SubmitChecklist > @@ -90,7 +90,7 @@ Linux カーネルパッチ投稿者向けチェックリスト > > 19: 少なくともslabアロケーションとpageアロケーションに失敗した場合の > 挙動について、fault-injectionを利用して確認してください。 > - Documentation/fault-injection/ を参照してください。 > + Documentation/dev-tools/fault-injection/ を参照してください。 > > 追加したコードがかなりの量であったならば、サブシステム特有の > fault-injectionを追加したほうが良いかもしれません。 > diff --git a/Documentation/translations/sp_SP/process/submit-checklist.rst b/Documentation/translations/sp_SP/process/submit-checklist.rst > index 0d6651f9d871..d2b09a10c1fe 100644 > --- a/Documentation/translations/sp_SP/process/submit-checklist.rst > +++ b/Documentation/translations/sp_SP/process/submit-checklist.rst > @@ -102,7 +102,7 @@ y en otros lugares con respecto al envío de parches del kernel de Linux. > espacio de usuario deben ser CCed a linux-api@vger.kernel.org. > > 19) Se ha comprobado con la inyección de al menos errores de asignación > - de slab y página. Consulte ``Documentation/fault-injection/``. > + de slab y página. Consulte ``Documentation/dev-tools/fault-injection/``. > > Si el nuevo código es sustancial, la adición de la inyección de > errores específica del subsistema podría ser apropiada. > diff --git a/Documentation/translations/zh_CN/index.rst b/Documentation/translations/zh_CN/index.rst > index 20b9d4270d1f..e471f22a5473 100644 > --- a/Documentation/translations/zh_CN/index.rst > +++ b/Documentation/translations/zh_CN/index.rst > @@ -73,7 +73,7 @@ > TODOList: > > * trace/index > -* fault-injection/index > +* dev-tools/fault-injection/index > * livepatch/index > > 面向用户的文档 > diff --git a/Documentation/translations/zh_CN/process/4.Coding.rst b/Documentation/translations/zh_CN/process/4.Coding.rst > index 4cc35d410dbc..2794761a1cbe 100644 > --- a/Documentation/translations/zh_CN/process/4.Coding.rst > +++ b/Documentation/translations/zh_CN/process/4.Coding.rst > @@ -208,7 +208,7 @@ Linus对这个问题给出了最佳答案: > 启用故障注入后，内存分配的可配置失败的百分比；这些失败可以限定在特定的代码 > 范围内。在启用了故障注入的情况下运行，程序员可以看到当情况恶化时代码如何响 > 应。有关如何使用此工具的详细信息，请参阅 > -Documentation/fault-injection/fault-injection.rst。 > +Documentation/dev-tools/fault-injection/fault-injection.rst。 > > “sparse”静态分析工具可以发现其他类型的错误。sparse可以警告程序员用户空间 > 和内核空间地址之间的混淆、大端序与小端序的混淆、在需要一组位标志的地方传递 > diff --git a/Documentation/translations/zh_CN/process/submit-checklist.rst b/Documentation/translations/zh_CN/process/submit-checklist.rst > index 10536b74aeec..4f8d7480673d 100644 > --- a/Documentation/translations/zh_CN/process/submit-checklist.rst > +++ b/Documentation/translations/zh_CN/process/submit-checklist.rst > @@ -85,7 +85,7 @@ Linux内核补丁提交检查单 > 请参阅 ``Documentation/ABI/README`` 。更改用户空间接口的补丁应该抄送 > linux-api@vger.kernel.org。 > > -19) 已通过至少注入slab和page分配失败进行检查。请参阅 ``Documentation/fault-injection/`` 。 > +19) 已通过至少注入slab和page分配失败进行检查。请参阅 ``Documentation/dev-tools/fault-injection/`` 。 > 如果新代码是实质性的，那么添加子系统特定的故障注入可能是合适的。 > > 20) 新添加的代码已经用 ``gcc -W`` 编译（使用 ``make EXTRA-CFLAGS=-W`` ）。这 > diff --git a/Documentation/translations/zh_TW/index.rst b/Documentation/translations/zh_TW/index.rst > index 660a74d2023c..1932a5f28069 100644 > --- a/Documentation/translations/zh_TW/index.rst > +++ b/Documentation/translations/zh_TW/index.rst > @@ -64,7 +64,7 @@ TODOList: > * kernel-hacking/index > * rust/index > * trace/index > -* fault-injection/index > +* dev-tools/fault-injection/index > * livepatch/index > > 面向用戶的文檔 > diff --git a/Documentation/translations/zh_TW/process/4.Coding.rst b/Documentation/translations/zh_TW/process/4.Coding.rst > index e90a6b51fb98..3841da1e6729 100644 > --- a/Documentation/translations/zh_TW/process/4.Coding.rst > +++ b/Documentation/translations/zh_TW/process/4.Coding.rst > @@ -211,7 +211,7 @@ Linus對這個問題給出了最佳答案: > 啓用故障注入後，內存分配的可配置失敗的百分比；這些失敗可以限定在特定的代碼 > 範圍內。在啓用了故障注入的情況下運行，程序員可以看到當情況惡化時代碼如何響 > 應。有關如何使用此工具的詳細信息，請參閱 > -Documentation/fault-injection/fault-injection.rst。 > +Documentation/dev-tools/fault-injection/fault-injection.rst。 > > “sparse”靜態分析工具可以發現其他類型的錯誤。sparse可以警告程序員用戶空間 > 和內核空間地址之間的混淆、大端序與小端序的混淆、在需要一組位標誌的地方傳遞 > diff --git a/Documentation/translations/zh_TW/process/submit-checklist.rst b/Documentation/translations/zh_TW/process/submit-checklist.rst > index 0ecb187753e4..e7a6c3332017 100644 > --- a/Documentation/translations/zh_TW/process/submit-checklist.rst > +++ b/Documentation/translations/zh_TW/process/submit-checklist.rst > @@ -88,7 +88,7 @@ Linux內核補丁提交檢查單 > 請參閱 ``Documentation/ABI/README`` 。更改用戶空間接口的補丁應該抄送 > linux-api@vger.kernel.org。 > > -19) 已通過至少注入slab和page分配失敗進行檢查。請參閱 ``Documentation/fault-injection/`` 。 > +19) 已通過至少注入slab和page分配失敗進行檢查。請參閱 ``Documentation/dev-tools/fault-injection/`` 。 > 如果新代碼是實質性的，那麼添加子系統特定的故障注入可能是合適的。 > > 20) 新添加的代碼已經用 ``gcc -W`` 編譯（使用 ``make EXTRA-CFLAGS=-W`` ）。這 > diff --git a/MAINTAINERS b/MAINTAINERS > index e4fa9010fcb6..b5fd319b8786 100644 > --- a/MAINTAINERS > +++ b/MAINTAINERS > @@ -8537,7 +8537,7 @@ F: drivers/net/wan/farsync.* > FAULT INJECTION SUPPORT > M: Akinobu Mita > S: Supported > -F: Documentation/fault-injection/ > +F: Documentation/dev-tools/fault-injection/ > F: lib/fault-inject.c > > FBTFT Framebuffer drivers > diff --git a/drivers/block/null_blk/main.c b/drivers/block/null_blk/main.c > index 2f0431e42c49..2266c80649a2 100644 > --- a/drivers/block/null_blk/main.c > +++ b/drivers/block/null_blk/main.c > @@ -100,7 +100,7 @@ MODULE_PARM_DESC(home_node, "Home node for the device"); > #ifdef CONFIG_BLK_DEV_NULL_BLK_FAULT_INJECTION > /* > * For more details about fault injection, please refer to > - * Documentation/fault-injection/fault-injection.rst. > + * Documentation/dev-tools/fault-injection/fault-injection.rst. > */ > static char g_timeout_str[80]; > module_param_string(timeout, g_timeout_str, sizeof(g_timeout_str), 0444); > diff --git a/drivers/misc/lkdtm/core.c b/drivers/misc/lkdtm/core.c > index 5732fd59a227..029592f2d07e 100644 > --- a/drivers/misc/lkdtm/core.c > +++ b/drivers/misc/lkdtm/core.c > @@ -15,7 +15,7 @@ > * > * Debugfs support added by Simon Kagstrom > * > - * See Documentation/fault-injection/provoke-crashes.rst for instructions > + * See Documentation/dev-tools/fault-injection/provoke-crashes.rst for instructions > */ > #include "lkdtm.h" > #include > diff --git a/drivers/ufs/core/ufs-fault-injection.c b/drivers/ufs/core/ufs-fault-injection.c > index 169540417079..3afe1e7fb407 100644 > --- a/drivers/ufs/core/ufs-fault-injection.c > +++ b/drivers/ufs/core/ufs-fault-injection.c > @@ -19,7 +19,7 @@ enum { FAULT_INJ_STR_SIZE = 80 }; > > /* > * For more details about fault injection, please refer to > - * Documentation/fault-injection/fault-injection.rst. > + * Documentation/dev-tools/fault-injection/fault-injection.rst. > */ > static char g_trigger_eh_str[FAULT_INJ_STR_SIZE]; > module_param_cb(trigger_eh, &ufs_fault_ops, g_trigger_eh_str, 0644); > diff --git a/include/asm-generic/error-injection.h b/include/asm-generic/error-injection.h > index b05253f68eaa..26b80eec6d5f 100644 > --- a/include/asm-generic/error-injection.h > +++ b/include/asm-generic/error-injection.h > @@ -21,8 +21,9 @@ struct pt_regs; > /* > * Whitelist generating macro. Specify functions which can be error-injectable > * using this macro. If you unsure what is required for the error-injectable > - * functions, please read Documentation/fault-injection/fault-injection.rst > - * 'Error Injectable Functions' section. > + * functions, please read > + * Documentation/dev-tools/fault-injection/fault-injection.rst 'Error > + * Injectable Functions' section. > */ > #define ALLOW_ERROR_INJECTION(fname, _etype) \ > static struct error_injection_entry __used \ > diff --git a/include/linux/fault-inject.h b/include/linux/fault-inject.h > index 354413950d34..9b10e50155a6 100644 > --- a/include/linux/fault-inject.h > +++ b/include/linux/fault-inject.h > @@ -12,7 +12,7 @@ > > /* > * For explanation of the elements of this struct, see > - * Documentation/fault-injection/fault-injection.rst > + * Documentation/dev-tools/fault-injection/fault-injection.rst > */ > struct fault_attr { > unsigned long probability; > diff --git a/lib/Kconfig.debug b/lib/Kconfig.debug > index a30c03a66172..a0e66c01042e 100644 > --- a/lib/Kconfig.debug > +++ b/lib/Kconfig.debug > @@ -2019,7 +2019,7 @@ config FAULT_INJECTION > depends on DEBUG_KERNEL > help > Provide fault-injection framework. > - For more details, see Documentation/fault-injection/. > + For more details, see Documentation/dev-tools/fault-injection/. > > config FAILSLAB > bool "Fault-injection capability for kmalloc" > @@ -2225,7 +2225,7 @@ config LKDTM > called lkdtm. > > Documentation on how to use the module can be found in > - Documentation/fault-injection/provoke-crashes.rst > + Documentation/dev-tools/fault-injection/provoke-crashes.rst > > config CPUMASK_KUNIT_TEST > tristate "KUnit test for cpumask" if !KUNIT_ALL_TESTS > diff --git a/tools/testing/fault-injection/failcmd.sh b/tools/testing/fault-injection/failcmd.sh > index 78dac34264be..ea384c7cae68 100644 > --- a/tools/testing/fault-injection/failcmd.sh > +++ b/tools/testing/fault-injection/failcmd.sh > @@ -42,7 +42,7 @@ OPTIONS > --interval=value, --space=value, --verbose=value, --task-filter=value, > --stacktrace-depth=value, --require-start=value, --require-end=value, > --reject-start=value, --reject-end=value, --ignore-gfp-wait=value > - See Documentation/fault-injection/fault-injection.rst for more > + See Documentation/dev-tools/fault-injection/fault-injection.rst for more > information > > failslab options: