From patchwork Wed Mar 22 00:33:59 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jithu Joseph X-Patchwork-Id: 73121 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:604a:0:0:0:0:0 with SMTP id j10csp2090124wrt; Tue, 21 Mar 2023 17:44:24 -0700 (PDT) X-Google-Smtp-Source: AK7set8SBFdzcYFO2CXX8B7SO7GAOzJ1P/Q7l0QjwInApCjyg42/9THk5TJNoSdoaHHIvq3QKaQ7 X-Received: by 2002:a62:5250:0:b0:5cd:d766:8a2b with SMTP id g77-20020a625250000000b005cdd7668a2bmr1551070pfb.6.1679445863909; Tue, 21 Mar 2023 17:44:23 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1679445863; cv=none; d=google.com; s=arc-20160816; b=C26u6pSmO+ZR8/+ZswTBYLYifXNzub4NaVUrifbvUHQxPa6Em3BWeTPG6jtYDBVBsD o684yEJXdvt2tqnsRA53Gh6716mKg+yoQUhuRrR+kBzUA5tVBMPLrqUYmb8L/AJpxjRn e6cyUOaOz1dq2c1zHUMbAZZD4XDnGZutBmbXgUEpclvjZv19HqmzVKcToELzcBStRZzJ het25ognnAIX3jmCWqfUppqenBRgj8Otl+Ki2T7PbOLus22F2f3tbgrWQjoISNDCwQXE Ll2NzEEog6DyGjgMtUemCxfZzIY1mYeU5csAubnBxAji7EizhnPccj9/LhDTM2GL+JpY lpPA== 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=dk12XbYjnpfUjGMWor98ntFsXTfB+XtMMbyww5f72hc=; b=icl8IeH2xowNnJGyAu49UhTWypUtsfR9WyVrvPuC269pUWgIKvwsGkqA98NxnfHrbo hqO4oBggDgnwAReaV/reJPVx82kjKNTCNYpwfQ/JZznd8a7QfSMvfhd5w1f2Pr6+YQh+ p+DCEMg12GMm7Adb2KO5aYm6TYHuespIJZex+gSQU16G3kU4gkNPMb+5op6dOM3Y9g89 6SIOc3+vmT33QEtkSa3YbcNKUDeccXH4n4vjdTjuLoZAQw2XQ1Pr7tXl234rgmY/pt++ CcQwL2RIDWWKbY0+dBFGCUL88q/2y9Kcazp2uQlDUy1vwq3bXckZnR/FFhbnH6/lqIbS SPyw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@intel.com header.s=Intel header.b="mTg++/nj"; 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=NONE sp=NONE dis=NONE) header.from=intel.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id j185-20020a638bc2000000b0050fa8965a13si3569779pge.654.2023.03.21.17.44.10; Tue, 21 Mar 2023 17:44:23 -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=@intel.com header.s=Intel header.b="mTg++/nj"; 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=NONE sp=NONE dis=NONE) header.from=intel.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229939AbjCVAic (ORCPT + 99 others); Tue, 21 Mar 2023 20:38:32 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:57680 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229871AbjCVAiL (ORCPT ); Tue, 21 Mar 2023 20:38:11 -0400 Received: from mga18.intel.com (mga18.intel.com [134.134.136.126]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 38086E184; Tue, 21 Mar 2023 17:38:09 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1679445489; x=1710981489; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=nohiqToOsP6y6cJNQuVw0xtw2VknYjmA95yg6FTsWC8=; b=mTg++/nj4JlBxKrZ6LHm8z7U9Qg8MZTYW4nfrAZgFwP+SKK1YtG8fDg/ 6eb8rIhRYActqveiR5XcKY3vnVQ+CZWy1dk/+1X2WDbqcOOFeMTlW5w+H NQZo+o8DlWTmWFwx5umPHSQvtvaXjtMvU+0c5emgmE3plFEaTWGwskOaq GPC+tOM0Vvs6UVRs8tLiJmXn4nm+AIlLYPom6pfOUcHYsfhBpMFgPtReH wpGo1WsTem0FiMDPozzgipPs6opqyP7Euv1wDp1tBf7BldtvEpz+o00nB f1Dp0tdZZdt/hwxl7Ne9Q+e3Avts7nERtFnMl9HLzIyyXOxep5lk1jXKa A==; X-IronPort-AV: E=McAfee;i="6600,9927,10656"; a="322934967" X-IronPort-AV: E=Sophos;i="5.98,280,1673942400"; d="scan'208";a="322934967" Received: from orsmga007.jf.intel.com ([10.7.209.58]) by orsmga106.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 21 Mar 2023 17:38:08 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6600,9927,10656"; a="675076077" X-IronPort-AV: E=Sophos;i="5.98,280,1673942400"; d="scan'208";a="675076077" Received: from jithujos.sc.intel.com ([172.25.103.66]) by orsmga007-auth.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 21 Mar 2023 17:38:07 -0700 From: Jithu Joseph To: hdegoede@redhat.com, markgross@kernel.org Cc: tglx@linutronix.de, mingo@redhat.com, bp@alien8.de, dave.hansen@linux.intel.com, x86@kernel.org, hpa@zytor.com, gregkh@linuxfoundation.org, rostedt@goodmis.org, jithu.joseph@intel.com, ashok.raj@intel.com, tony.luck@intel.com, linux-kernel@vger.kernel.org, platform-driver-x86@vger.kernel.org, patches@lists.linux.dev, ravi.v.shankar@intel.com, thiago.macieira@intel.com, athenas.jimenez.gonzalez@intel.com, sohil.mehta@intel.com Subject: [PATCH v4 9/9] Documentation/ABI: Update IFS ABI doc Date: Tue, 21 Mar 2023 17:33:59 -0700 Message-Id: <20230322003359.213046-10-jithu.joseph@intel.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230322003359.213046-1-jithu.joseph@intel.com> References: <20230301015942.462799-1-jithu.joseph@intel.com> <20230322003359.213046-1-jithu.joseph@intel.com> MIME-Version: 1.0 X-Spam-Status: No, score=-0.2 required=5.0 tests=DKIMWL_WL_HIGH,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,SPF_HELO_NONE,SPF_NONE, URIBL_BLOCKED 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?1757852326240655079?= X-GMAIL-MSGID: =?utf-8?q?1761026626002629834?= Array BIST test doesn't need an IFS test image to operate unlike the SCAN test. Consequently current_batch and image_version files are not applicable for Array BIST IFS device instance, clarify this in the ABI doc. Also given that multiple tests are supported, take the opportunity to generalize descriptions wherever applicable. Signed-off-by: Jithu Joseph Reviewed-by: Tony Luck --- .../ABI/testing/sysfs-platform-intel-ifs | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) diff --git a/Documentation/ABI/testing/sysfs-platform-intel-ifs b/Documentation/ABI/testing/sysfs-platform-intel-ifs index 55991983d0d0..41b4d5b1e21c 100644 --- a/Documentation/ABI/testing/sysfs-platform-intel-ifs +++ b/Documentation/ABI/testing/sysfs-platform-intel-ifs @@ -1,3 +1,7 @@ +Device instance to test mapping +intel_ifs_0 -> Scan Test +intel_ifs_1 -> Array BIST test + What: /sys/devices/virtual/misc/intel_ifs_/run_test Date: Nov 16 2022 KernelVersion: 6.2 @@ -8,6 +12,7 @@ Description: Write to trigger IFS test for one online core. completes the test for the core containing that thread. Example: to test the core containing cpu5: echo 5 > /sys/devices/virtual/misc/intel_ifs_/run_test +Devices: all What: /sys/devices/virtual/misc/intel_ifs_/status Date: Nov 16 2022 @@ -15,21 +20,25 @@ KernelVersion: 6.2 Contact: "Jithu Joseph" Description: The status of the last test. It can be one of "pass", "fail" or "untested". +Devices: all What: /sys/devices/virtual/misc/intel_ifs_/details Date: Nov 16 2022 KernelVersion: 6.2 Contact: "Jithu Joseph" Description: Additional information regarding the last test. The details file reports - the hex value of the SCAN_STATUS MSR. Note that the error_code field + the hex value of the STATUS MSR for this test. Note that the error_code field may contain driver defined software code not defined in the Intel SDM. +Devices: all What: /sys/devices/virtual/misc/intel_ifs_/image_version Date: Nov 16 2022 KernelVersion: 6.2 Contact: "Jithu Joseph" -Description: Version (hexadecimal) of loaded IFS binary image. If no scan image - is loaded reports "none". +Description: Version (hexadecimal) of loaded IFS test image. If no test image + is loaded reports "none". Only present for device instances where a test image + is applicable. +Devices: intel_ifs_0 What: /sys/devices/virtual/misc/intel_ifs_/current_batch Date: Nov 16 2022 @@ -39,3 +48,5 @@ Description: Write a number less than or equal to 0xff to load an IFS test image The number written treated as the 2 digit suffix in the following file name: /lib/firmware/intel/ifs_/ff-mm-ss-02x.scan Reading the file will provide the suffix of the currently loaded IFS test image. + This file is present only for device instances where a test image is applicable. +Devices: intel_ifs_0