Received: by 10.223.185.116 with SMTP id b49csp1480630wrg; Fri, 16 Feb 2018 21:52:14 -0800 (PST) X-Google-Smtp-Source: AH8x225equlgrEUlMvtNRvi07LlQ9SXbaNylDoiCtQ3bismzNgIhuUQoog3cOSwjKaume7EE+CiQ X-Received: by 2002:a17:902:8b8a:: with SMTP id ay10-v6mr7866968plb.156.1518846734321; Fri, 16 Feb 2018 21:52:14 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1518846734; cv=none; d=google.com; s=arc-20160816; b=R1i4GzA0cDeYcM/OCX94qtC/VT3Ip2flMFXyneuUPu5CI2/kGB+E/8nqqicKHHwtLq 7/1BOvs8cgYKr73P7jv1XPFLdZMZPDs6Z3wOnZ4YDPjZZ6qz1m2HDVdb9rhpdcTKmB1g v8//bt53E+tJQxeKYqnZuWT05OgaNKLDS5EXUflBLM9v7WNa7Qo5Fxf9AnlMrbnzdlcS ncnFJKYIWJBRRd4dQ22nksnoQ6PdZgyxwfwgA3g+ry914mKBcq5sQM1YHgB8Yldlz05G knyLQOYS/bEbUAezDzZJquDbZ2uO+b0EjPNq/zUN4Ft+kOP5jWwRkvYx0/sqvu6k1kTO PxBQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:references:in-reply-to:message-id:date :subject:cc:to:from:arc-authentication-results; bh=TfhfqcWPoW2r1QL9bChoIWIoBdj0H+8A2Vigp2FC+Fo=; b=V2JInxhxHH2gycJUH59OqXkDw+drSjX/RnQmdSOeTCWdKO1a4HKBH8nZfVNf7Yy8qH O39pNt7W8T5GPTQnn5T0iiaAM7lK/yTUQIHAQNT7959NH92xdRpu9rVeKJFpJGgifl3n FWRgCmSHKLZSSmGZXh98/QFbElp+9ulW9aIwF1M+dpWWJ6i3FzFVeQYuEpisM2je877Q OHdw8ombKjy2FJ261i+TYVgtY4MuALdFp1w0QkHCD8S+4gweNvkS1zRCFAJ1rN021r7c qDe1hToQYPSjI0aWcTe8ER3ONHXXEph1yeL8L+OBPVN3wbYMjTFuHRHfq82Pv4p76vJr K1qg== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id v4-v6si820686plo.55.2018.02.16.21.51.17; Fri, 16 Feb 2018 21:52:14 -0800 (PST) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751298AbeBQFtz (ORCPT + 99 others); Sat, 17 Feb 2018 00:49:55 -0500 Received: from mga02.intel.com ([134.134.136.20]:59982 "EHLO mga02.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751240AbeBQFt3 (ORCPT ); Sat, 17 Feb 2018 00:49:29 -0500 X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga002.fm.intel.com ([10.253.24.26]) by orsmga101.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 16 Feb 2018 21:49:29 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.46,523,1511856000"; d="scan'208";a="20863425" Received: from gvt-dell.bj.intel.com (HELO gvt-dell-host.bj.intel.com) ([10.238.154.59]) by fmsmga002.fm.intel.com with ESMTP; 16 Feb 2018 21:49:28 -0800 From: changbin.du@intel.com To: corbet@lwn.net, rostedt@goodmis.org Cc: mingo@kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Changbin Du Subject: [PATCH 17/17] trace doc: convert trace/stm.txt to rst format Date: Sat, 17 Feb 2018 13:39:50 +0800 Message-Id: <1518845990-20733-18-git-send-email-changbin.du@intel.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1518845990-20733-1-git-send-email-changbin.du@intel.com> References: <1518845990-20733-1-git-send-email-changbin.du@intel.com> Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org From: Changbin Du This converts the plain text documentation to reStructuredText format and add it into Sphinx TOC tree. No essential content change. Cc: Steven Rostedt Signed-off-by: Changbin Du --- Documentation/trace/index.rst | 1 + Documentation/trace/{stm.txt => stm.rst} | 23 ++++++++++++----------- 2 files changed, 13 insertions(+), 11 deletions(-) rename Documentation/trace/{stm.txt => stm.rst} (91%) diff --git a/Documentation/trace/index.rst b/Documentation/trace/index.rst index 02cc56c..b58c10b 100644 --- a/Documentation/trace/index.rst +++ b/Documentation/trace/index.rst @@ -20,3 +20,4 @@ Linux Tracing Technologies mmiotrace hwlat_detector intel_th + stm diff --git a/Documentation/trace/stm.txt b/Documentation/trace/stm.rst similarity index 91% rename from Documentation/trace/stm.txt rename to Documentation/trace/stm.rst index 0376575..2c22ddb 100644 --- a/Documentation/trace/stm.txt +++ b/Documentation/trace/stm.rst @@ -1,3 +1,4 @@ +=================== System Trace Module =================== @@ -32,14 +33,14 @@ associated with it, located in "stp-policy" subsystem directory in configfs. The topmost directory's name (the policy) is formatted as the STM device name to which this policy applies and and arbitrary string identifier separated by a stop. From the examle above, a rule -may look like this: +may look like this:: -$ ls /config/stp-policy/dummy_stm.my-policy/user -channels masters -$ cat /config/stp-policy/dummy_stm.my-policy/user/masters -48 63 -$ cat /config/stp-policy/dummy_stm.my-policy/user/channels -0 127 + $ ls /config/stp-policy/dummy_stm.my-policy/user + channels masters + $ cat /config/stp-policy/dummy_stm.my-policy/user/masters + 48 63 + $ cat /config/stp-policy/dummy_stm.my-policy/user/channels + 0 127 which means that the master allocation pool for this rule consists of masters 48 through 63 and channel allocation pool has channels 0 @@ -78,9 +79,9 @@ stm_source For kernel-based trace sources, there is "stm_source" device class. Devices of this class can be connected and disconnected to/from stm devices at runtime via a sysfs attribute called "stm_source_link" -by writing the name of the desired stm device there, for example: +by writing the name of the desired stm device there, for example:: -$ echo dummy_stm.0 > /sys/class/stm_source/console/stm_source_link + $ echo dummy_stm.0 > /sys/class/stm_source/console/stm_source_link For examples on how to use stm_source interface in the kernel, refer to stm_console, stm_heartbeat or stm_ftrace drivers. @@ -118,5 +119,5 @@ the same time. Currently only Ftrace "function" tracer is supported. -[1] https://software.intel.com/sites/default/files/managed/d3/3c/intel-th-developer-manual.pdf -[2] http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.ddi0444b/index.html +* [1] https://software.intel.com/sites/default/files/managed/d3/3c/intel-th-developer-manual.pdf +* [2] http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc.ddi0444b/index.html -- 2.7.4