From patchwork Sat Jan 21 22:53:03 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Yoann Congal X-Patchwork-Id: 46894 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:eb09:0:0:0:0:0 with SMTP id s9csp910720wrn; Sat, 21 Jan 2023 15:03:27 -0800 (PST) X-Google-Smtp-Source: AMrXdXucIbgn3vHLaiQbkhEWOvHrLviIZi5Q5eakOgvEizhkiT4aEAvRsemb/OCmuaIyGnonSD27 X-Received: by 2002:a05:6402:b27:b0:493:966d:e986 with SMTP id bo7-20020a0564020b2700b00493966de986mr19009669edb.13.1674342207578; Sat, 21 Jan 2023 15:03:27 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1674342207; cv=none; d=google.com; s=arc-20160816; b=NmhbKVf7po+xDpbsklrWQCYNwSfdaOEn8qWBxV7fQ8U4VkBWYeCkMvVVy9OFM4Uxne ACXCwGheRMG/8Gp4m/wJR8PhnDcApmo45zBqXAnFuWzy/m+Iss6RUsYgUtC0O8Vw9eG+ Q0JNjeUl3BOvxW+wCXuENf7kwQSaRjZ33qM7rV3ENKiDbtHbmxa+PrBQ0Cr9cfYtskrH l33JT6Ju7JOSb5mIsGf/R7gj7lUD5p4RbboW6/4b38Ca4ZCXQCySpgo3YCuiUWZKCUU9 zPdbtOn8MturW5bwN51poQRMcZWeXBNsam4/t1VfZDv/+F4N/0AfZ5CsMCU14nDNwjb0 /eFg== 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=uQ0vKpXMevlkvELPWPprpptk067lWow9uoTw6yIP2k4=; b=BNCOUYj/EIk+b22N/WzEfmGsC+ALSHOVqquFfsIWDhcS5mKSnhWri7OTGLMp1EejO5 eUMaVJcRLG4hfv2nxc3uUZjUPDf/CTo3LAMmRu3B7ImTbAOdd0Ag7CoK5B0dozaQRAv8 MJj5gAf3agZ3q7r1XTUSUTuLOcNfUkSfuB9eeaH0SNVmQIu982lawOaS3UMO/Je/9XOL sua5NSJd1CJ/rd4wIzXKzNESjd7YM8mnCBuq376M61OG1P1vh2fZgLNw0/gcZ6G6kt/G AaDb0UDpMAEyVe/2mshcdA9EKvE5jmZfrQeqodZtSyDcjzg206up8Z1B+i7Ba+HTr1XT HqLQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@smile-fr.20210112.gappssmtp.com header.s=20210112 header.b=VRbMVxuE; 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 Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id b12-20020a056402350c00b0049e15ded603si3193025edd.279.2023.01.21.15.03.03; Sat, 21 Jan 2023 15:03:27 -0800 (PST) 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=@smile-fr.20210112.gappssmtp.com header.s=20210112 header.b=VRbMVxuE; 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 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229925AbjAUWx6 (ORCPT + 99 others); Sat, 21 Jan 2023 17:53:58 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50540 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229921AbjAUWx4 (ORCPT ); Sat, 21 Jan 2023 17:53:56 -0500 Received: from mail-wr1-x433.google.com (mail-wr1-x433.google.com [IPv6:2a00:1450:4864:20::433]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 7CBF02798F for ; Sat, 21 Jan 2023 14:53:55 -0800 (PST) Received: by mail-wr1-x433.google.com with SMTP id r9so7748199wrw.4 for ; Sat, 21 Jan 2023 14:53:55 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=smile-fr.20210112.gappssmtp.com; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=uQ0vKpXMevlkvELPWPprpptk067lWow9uoTw6yIP2k4=; b=VRbMVxuEfiVah3EHHwyAfjK75rQ60GkUS0LpmkDIUck051uzMK8IXhm6kwnjK/HxIg OJSTSEq1iGyX2P8wTVl8FJQZ6NDvWInUXeN73jRDhSd1zvNtjceQjwt4id1IId9knHX5 1/L6tG071mp1O7vdh1jqVtrt7DVBoDhZL2w+NDymQACbegbiNphSTonK7b6Yo+tZsJTs XGDpOqE49AInOaNIcJa6fNpuDTEFimeZ2eApm5AOo7BopO4/gGAppqarie4a4F+AhZK1 kDVuN/SHJTFHzGzjT0slIU/Vi32v8Ug8BfeUNDy6bG9xo6MfdihKiWArM0oD1gUituqX 3r6w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=uQ0vKpXMevlkvELPWPprpptk067lWow9uoTw6yIP2k4=; b=tifZztOABpY/Ab2fQMXWd3ERF2CMTJnhxxpdOXHT5YHAjWMBY8Qdo87seU/Toh2diN 5TcbXvFor5ju50glCcNOks4MDy+9/PdmRXgUCkg0M+0qOog7JVYMRj5SWZ9FjuzC3Hr1 84/MN/fgd/GgfbKMq0BS22CCTAEB5R53QtS6pZApJ1OCoJQkth98QQqqNsYtTFwDPLmZ K7yN0+qc2mRMPp+5IGfd2MGVQe5bfNXlma09WcvyX88HBImwJECo+wBM5oZLpaD6paVz lKxFxutn2AKFy1NJ8hPwZg7yjfqVFMOxBLkxURd4u1UhfLe4EI4peCezZJMXoyu7CHLD L7TA== X-Gm-Message-State: AFqh2kpjtTCnR5TJDBss99DrpBrqiBZk0vxXfroawWMPpf1tgKPaH80g rloYIcEcUSg/luOBe5mTDTe0zE64R1DIX6N7 X-Received: by 2002:a5d:6b12:0:b0:242:7409:bbf with SMTP id v18-20020a5d6b12000000b0024274090bbfmr12108735wrw.54.1674341633899; Sat, 21 Jan 2023 14:53:53 -0800 (PST) Received: from P-ASN-ECS-830T8C3.mpl.intranet (89-159-1-53.rev.numericable.fr. [89.159.1.53]) by smtp.gmail.com with ESMTPSA id q16-20020adff950000000b002bcaa47bf78sm29531001wrr.26.2023.01.21.14.53.53 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 21 Jan 2023 14:53:53 -0800 (PST) From: Yoann Congal To: linux-trace-kernel@vger.kernel.org Cc: Yoann Congal , Steven Rostedt , Masami Hiramatsu , Jonathan Corbet , linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org Subject: [PATCH v3 1/3] Documentation: kprobetrace: Fix some typos Date: Sat, 21 Jan 2023 23:53:03 +0100 Message-Id: <20230121225304.1711635-2-yoann.congal@smile.fr> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20230121225304.1711635-1-yoann.congal@smile.fr> References: <20230121225304.1711635-1-yoann.congal@smile.fr> MIME-Version: 1.0 X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,RCVD_IN_DNSWL_NONE,SPF_HELO_NONE,SPF_PASS 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?1755675054563445193?= X-GMAIL-MSGID: =?utf-8?q?1755675054563445193?= * Uncapitalise tracepoint * Hyphen in *-based * Plurals * fetch-args -> fetchargs * 2bytes hex -> 2-byte hex * .. -> . * arch -> architecture Signed-off-by: Yoann Congal TBR typo --- Documentation/trace/kprobetrace.rst | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/Documentation/trace/kprobetrace.rst b/Documentation/trace/kprobetrace.rst index 08a2a6a3782f0..5c49cdc8f8323 100644 --- a/Documentation/trace/kprobetrace.rst +++ b/Documentation/trace/kprobetrace.rst @@ -6,16 +6,16 @@ Kprobe-based Event Tracing Overview -------- -These events are similar to tracepoint based events. Instead of Tracepoint, +These events are similar to tracepoint-based events. Instead of tracepoints, this is based on kprobes (kprobe and kretprobe). So it can probe wherever kprobes can probe (this means, all functions except those with __kprobes/nokprobe_inline annotation and those marked NOKPROBE_SYMBOL). -Unlike the Tracepoint based event, this can be added and removed +Unlike the tracepoint-based event, this can be added and removed dynamically, on the fly. To enable this feature, build your kernel with CONFIG_KPROBE_EVENTS=y. -Similar to the events tracer, this doesn't need to be activated via +Similar to the event tracer, this doesn't need to be activated via current_tracer. Instead of that, add probe points via /sys/kernel/debug/tracing/kprobe_events, and enable it via /sys/kernel/debug/tracing/events/kprobes//enable. @@ -68,7 +68,7 @@ Synopsis of kprobe_events Types ----- -Several types are supported for fetch-args. Kprobe tracer will access memory +Several types are supported for fetchargs. Kprobe tracer will access memory by given type. Prefix 's' and 'u' means those types are signed and unsigned respectively. 'x' prefix implies it is unsigned. Traced arguments are shown in decimal ('s' and 'u') or hexadecimal ('x'). Without type casting, 'x32' @@ -76,14 +76,15 @@ or 'x64' is used depends on the architecture (e.g. x86-32 uses x32, and x86-64 uses x64). These value types can be an array. To record array data, you can add '[N]' (where N is a fixed number, less than 64) to the base type. -E.g. 'x16[4]' means an array of x16 (2bytes hex) with 4 elements. +E.g. 'x16[4]' means an array of x16 (2-byte hex) with 4 elements. Note that the array can be applied to memory type fetchargs, you can not apply it to registers/stack-entries etc. (for example, '$stack1:x8[8]' is wrong, but '+8($stack):x8[8]' is OK.) String type is a special type, which fetches a "null-terminated" string from kernel space. This means it will fail and store NULL if the string container has been paged out. "ustring" type is an alternative of string for user-space. -See :ref:`user_mem_access` for more info.. +See :ref:`user_mem_access` for more info. + The string array type is a bit different from other types. For other base types, [1] is equal to (e.g. +0(%di):x32[1] is same as +0(%di):x32.) But string[1] is not equal to string. The string type itself @@ -120,8 +121,8 @@ space. 'ustring' is a shortcut way of performing the same task. That is, Note that kprobe-event provides the user-memory access syntax but it doesn't use it transparently. This means if you use normal dereference or string type -for user memory, it might fail, and may always fail on some archs. The user -has to carefully check if the target data is in kernel or user space. +for user memory, it might fail, and may always fail on some architectures. The +user has to carefully check if the target data is in kernel or user space. Per-Probe Event Filtering ------------------------- From patchwork Sat Jan 21 22:53:04 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Yoann Congal X-Patchwork-Id: 46895 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:eb09:0:0:0:0:0 with SMTP id s9csp910863wrn; Sat, 21 Jan 2023 15:03:49 -0800 (PST) X-Google-Smtp-Source: AMrXdXscEBVb8YJjtRdp7N6bBMyO3B2aBgB3F/yWChE2A6GmLawa8siwIuIyKtLAwhwVQ8teQGs8 X-Received: by 2002:a05:6402:3898:b0:499:c343:30e5 with SMTP id fd24-20020a056402389800b00499c34330e5mr21400134edb.3.1674342229263; Sat, 21 Jan 2023 15:03:49 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1674342229; cv=none; d=google.com; s=arc-20160816; b=TkDOjtCCEZW20lYQ0k2JXu5ymIKkjKg/+xxUcEY2fxcHCGEJ19Fg6qLx6paKiX0hYm uCzsa9ICeYgzsON00Iy2CCv9qGmCVua61bPkMxd93B/Osw0ZEVipaH/9eq0+urXEpXKf ylrtwmPY0jPQOkuS14ZQDoR2SUKbj6dzMijWHHsiCzstrbgeX4X/mlxdXnQzFKRrhcFU 1eg9z7aKlpbAkN3YrmEqExdzdSZRA9JawPueCKTgEzT4DcvWliEtG9FcwTOYM4Jl1nxi vbPEKelO5uJzZmlncTuRZTLEoduu7/jWIzXBrUj2IxrN1PjQKITyLTrl6XpRNNuhXVp/ N2Cw== 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=aQcpnm+xegArshUikS17fvnxeK/s1SURloIYiePDHH8=; b=NBNebKj8vCvKOvF+/rKmcmdeJdw70uI+hroKszlpd+ENbOafDLmv2DcE4oDcOde7m/ cBBdgqSVSt51Pdmt5oBlRrMgqyNiziuvU2BQJyEDcDcrETZL3kzDoPE9o3gaW6ffZItX nhqMN0UKcWBRogEGS39WPggtZ5iINJmedgDAyDecq+FT0GrHf93NU5uw6LgiyqiU7b/o H2b6a4qRalw/J6JXTuesocGIr/akyue1jqDtkfh0Z5GpUBMUHGJh+Kl8y6kQkQJCxhCL KN4O4ZNsDrErqavQ7Tq+aRu0PZ4Jf7EhbXHvB6W6uuYpy9A6b/LyyCCw6CL8IbH8PHd+ YDGg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@smile-fr.20210112.gappssmtp.com header.s=20210112 header.b=pxWOq0gY; 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 Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id ef14-20020a05640228ce00b0048254d95382si24147965edb.342.2023.01.21.15.03.26; Sat, 21 Jan 2023 15:03:49 -0800 (PST) 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=@smile-fr.20210112.gappssmtp.com header.s=20210112 header.b=pxWOq0gY; 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 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229768AbjAUWyA (ORCPT + 99 others); Sat, 21 Jan 2023 17:54:00 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50590 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229936AbjAUWx6 (ORCPT ); Sat, 21 Jan 2023 17:53:58 -0500 Received: from mail-wr1-x42b.google.com (mail-wr1-x42b.google.com [IPv6:2a00:1450:4864:20::42b]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 350592798F for ; Sat, 21 Jan 2023 14:53:57 -0800 (PST) Received: by mail-wr1-x42b.google.com with SMTP id b7so7757124wrt.3 for ; Sat, 21 Jan 2023 14:53:57 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=smile-fr.20210112.gappssmtp.com; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=aQcpnm+xegArshUikS17fvnxeK/s1SURloIYiePDHH8=; b=pxWOq0gY0m6If8+BESkb18dLeXB30J0Rrv4c9mWOpPfKCYIx5ofswf59f0awHMdgzN p510juAtaCTTUmVYdK097MMHRQGRVxcjqCb9XmBnh8noYE3l1AhCLzyeM3HBsG0bnmyS Vn8cNKMD/AbjC6bZRHHG52Wg+z9z3iaE8wU0XYx55ZNeD6PyRkXCh3sfgVd5izNE+d7n UWg2LOSZz//MAy2SmZuzxVAFKuQTSO96da+5Yf2O298InzP4c2vffGLhwAKmTRFWqseW m7xGq4l06HP4n5YNGCuwfw/B2m4Lte1S51fp6Ml+e2sy4aBwhIZt3OV1vPO3wy7qK/mz Z8ZA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=aQcpnm+xegArshUikS17fvnxeK/s1SURloIYiePDHH8=; b=NxQi4J78eTZMEp7Je7SQ2PYHxE9tbUlU1nVXw2k0r0Jcz6nmgGGR6W6w0kxzHzLK4c aXd27E3hPpdYCPbEZMP4fkf1vnsQdQfMsBCgDVLKhH7OwbUqTYS8dt0mrF6S5XPAieN/ 261cGlRv9cDyBu+Y/GtC45kRVQLxDiSZwKq8hBDiRttBI+485xCXx/3fvsjvQR90TahU t98c4987QP6diDKYom2qfaqSdS9PfYCIGpSak9JWBfJf2gsRxNQaF83yGlHTw4LgIWbF /zZFdoRzQ1Wydr77WsTCTFt9tfgoP1YkrGr6u11TyU3QLERyenlIs1W3LH7fZcdRVmmT VWpQ== X-Gm-Message-State: AFqh2kqboFqlgBd99LaZ82vtYw6jpyt+knSR96xbOXD7rbiB22/ic59H yZtSVVf54cvRoADqEh3FIOCvmw== X-Received: by 2002:adf:cd83:0:b0:2bd:d839:9918 with SMTP id q3-20020adfcd83000000b002bdd8399918mr17399387wrj.64.1674341635599; Sat, 21 Jan 2023 14:53:55 -0800 (PST) Received: from P-ASN-ECS-830T8C3.mpl.intranet (89-159-1-53.rev.numericable.fr. [89.159.1.53]) by smtp.gmail.com with ESMTPSA id q16-20020adff950000000b002bcaa47bf78sm29531001wrr.26.2023.01.21.14.53.55 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 21 Jan 2023 14:53:55 -0800 (PST) From: Yoann Congal To: linux-trace-kernel@vger.kernel.org Cc: Yoann Congal , Steven Rostedt , Masami Hiramatsu , Jonathan Corbet , linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org Subject: [PATCH v3 2/3] Documentation: kprobetrace: Fix code block markup Date: Sat, 21 Jan 2023 23:53:04 +0100 Message-Id: <20230121225304.1711635-3-yoann.congal@smile.fr> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20230121225304.1711635-1-yoann.congal@smile.fr> References: <20230121225304.1711635-1-yoann.congal@smile.fr> MIME-Version: 1.0 X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,RCVD_IN_DNSWL_NONE,SPF_HELO_NONE,SPF_PASS 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?1755675077142134079?= X-GMAIL-MSGID: =?utf-8?q?1755675077142134079?= This display the following code extract as a code block instead of a normal paragraph. Signed-off-by: Yoann Congal --- Documentation/trace/kprobetrace.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/trace/kprobetrace.rst b/Documentation/trace/kprobetrace.rst index 5c49cdc8f8323..febfd3792854f 100644 --- a/Documentation/trace/kprobetrace.rst +++ b/Documentation/trace/kprobetrace.rst @@ -161,11 +161,11 @@ You can add and enable new kprobe events when booting up the kernel by "kprobe_event=" parameter. The parameter accepts a semicolon-delimited kprobe events, which format is similar to the kprobe_events. The difference is that the probe definition parameters are comma-delimited -instead of space. For example, adding myprobe event on do_sys_open like below +instead of space. For example, adding myprobe event on do_sys_open like below:: p:myprobe do_sys_open dfd=%ax filename=%dx flags=%cx mode=+4($stack) -should be below for kernel boot parameter (just replace spaces with comma) +should be below for kernel boot parameter (just replace spaces with comma):: p:myprobe,do_sys_open,dfd=%ax,filename=%dx,flags=%cx,mode=+4($stack) From patchwork Sat Jan 21 22:53:05 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Yoann Congal X-Patchwork-Id: 46896 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:adf:eb09:0:0:0:0:0 with SMTP id s9csp911144wrn; Sat, 21 Jan 2023 15:04:35 -0800 (PST) X-Google-Smtp-Source: AMrXdXu8ur9CrgR6z5DXje7tdcIvcH53rzh12Xp9WH8Fg3PVWHdY8wUYh/EWUPz2mTayeiqkZwbG X-Received: by 2002:a17:906:2dd6:b0:86b:119c:7ea8 with SMTP id h22-20020a1709062dd600b0086b119c7ea8mr20252560eji.49.1674342275459; Sat, 21 Jan 2023 15:04:35 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1674342275; cv=none; d=google.com; s=arc-20160816; b=UrasJq9QXoR+m4OS4falvsTXwe2KsSay41lFkwA6k6EtS47f0bAzKTiIaIzx2d0W/X rj6H8rFF7ai5sMNupC3sL2ZGfnB2G12tHJkIrGtYVWhmUoK6vNrhGQpKURqAhEGJjauG y72pjtzomZRP8GTGEgYPRju4E7iYJDLDMTXwuaHZDsVu8J5nB03jfuD0z/P6fN9fnE8m jSg2fnJoOjg/cmzc4KJiAeeEHuLvgxDl36GzjbzSbP0ktihZxw1HbIVzinlyKp8/oQp5 wZb9N03fWIj5vjmtQBu7mImRbZpxVmIMRzGYdwu1SKkcX0uC0dA4fHmegIqHXs5SLZnl Xszg== 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=6aLj/ODwGBPQt5M/SiFpK9bRbaBx3QXPkN8yFU/v4Uw=; b=LlHcyQ8w3ghK1QPUu+BsGPvToYEF/SJfWLo3Rwk/bshybnEwYcwXvasXuVSQ8dxFWM 0Sm1ffsEqVsviv9orY+BZRr0k7Ov8fOkJncaATW/rKVtuktar3yw8uAa6UBgZDoXoLW9 Hio4xYzrObV1kDpOrGcECelEEdJJe0buOisLtidvpnzGLP86aK+kP6w26rq0mMucXWvr s83lRTo8otvNoVbNqbCylcbpVcXn26wSsO5Rklm5Fm143HiBkcPssKays8yuXLwfgvmD yoCQHVO2aUIFNkQdSpVhH4KAI4dDMHTvwhFWNpWn7Lwpdn//e3itTmu+g/pQisPLzByE yBHQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@smile-fr.20210112.gappssmtp.com header.s=20210112 header.b="wLK+/TX2"; 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 Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id sd34-20020a1709076e2200b008705d5bb5d1si22624317ejc.951.2023.01.21.15.04.12; Sat, 21 Jan 2023 15:04:35 -0800 (PST) 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=@smile-fr.20210112.gappssmtp.com header.s=20210112 header.b="wLK+/TX2"; 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 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229967AbjAUWyE (ORCPT + 99 others); Sat, 21 Jan 2023 17:54:04 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:50672 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229950AbjAUWyA (ORCPT ); Sat, 21 Jan 2023 17:54:00 -0500 Received: from mail-wr1-x431.google.com (mail-wr1-x431.google.com [IPv6:2a00:1450:4864:20::431]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 95338279AA for ; Sat, 21 Jan 2023 14:53:58 -0800 (PST) Received: by mail-wr1-x431.google.com with SMTP id q5so3089733wrv.0 for ; Sat, 21 Jan 2023 14:53:58 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=smile-fr.20210112.gappssmtp.com; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=6aLj/ODwGBPQt5M/SiFpK9bRbaBx3QXPkN8yFU/v4Uw=; b=wLK+/TX2jqUkSLNGrOV33nztWjS0BVBKyxpAoiH+fxZ9SyYAAJN5PpcvQqP0oo/3wj xmTqZ8rRmAjdiMx9zPBeQtsGbLpbq5R+YAo+tOMWNR+ulOH9UOCZ4a9PXC9Lu242HtFE kabFGpVGVkVQs74hDFrjdscUS97M0D7gathV5kRWGIzNeLGH2o99FiyB+X9Wq2Em7aC0 1rFFnfr2MFMGPW9O+T1RTdedQNrDRnsYK1JJnuvEn3JEJ7p44TA7zWamazmZVWxVPkSj vO7zFgLzmqtK++FZVNNhOLU1tXC1+P4b8vfteMtBzXXBGpZ9W+gs37LshLeDKMc4yhRF ngIg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=6aLj/ODwGBPQt5M/SiFpK9bRbaBx3QXPkN8yFU/v4Uw=; b=Kj/78k431gUfdaq+K2z5n9cMhuFTLX3Djpc+q8Fi3I0ANiJx1uyPBgaV60A7rw3j0J pKHzaCB65IZEgkMG/WQhS6VdpzGQgvPg3Jh/gUMRsjw0y5xiP8GqVLgDK2n/gkBTGyVb 3/u2SrKZ64TkNFldXe0LnNfTeCybkh7mBKYBf8QZDqZFgQIS0Abw4YyHu3Nr2FoulKTJ XDhWKaPSba1DRWBLUxSYXq8cISuwxyBYo7kHGPu4MpQylvz9KG6lVQPQGgpSfoik7AlX HOhyA58w1/kwWsP2Nt12KYNs0bhS7Zlp8BOts6nCK4lfgl1htigm+ZZYqFrTjoTQ0/Ut EKsA== X-Gm-Message-State: AFqh2kryd3wlyE/kRX+ODLWTcyOgNkmOeXcY1qUUNBOM+iaVHF3kvxsX UvxPOPLuQTOQ0ms9khxOFZXnOQ== X-Received: by 2002:adf:b604:0:b0:242:1809:7e17 with SMTP id f4-20020adfb604000000b0024218097e17mr16696562wre.6.1674341636948; Sat, 21 Jan 2023 14:53:56 -0800 (PST) Received: from P-ASN-ECS-830T8C3.mpl.intranet (89-159-1-53.rev.numericable.fr. [89.159.1.53]) by smtp.gmail.com with ESMTPSA id q16-20020adff950000000b002bcaa47bf78sm29531001wrr.26.2023.01.21.14.53.56 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 21 Jan 2023 14:53:56 -0800 (PST) From: Yoann Congal To: linux-trace-kernel@vger.kernel.org Cc: Yoann Congal , Steven Rostedt , Masami Hiramatsu , Jonathan Corbet , linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org Subject: [PATCH v3 3/3] Documentation: kprobetrace: Split paragraphs Date: Sat, 21 Jan 2023 23:53:05 +0100 Message-Id: <20230121225304.1711635-4-yoann.congal@smile.fr> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20230121225304.1711635-1-yoann.congal@smile.fr> References: <20230121225304.1711635-1-yoann.congal@smile.fr> MIME-Version: 1.0 X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,RCVD_IN_DNSWL_NONE,SPF_HELO_NONE,SPF_PASS 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?1755675125669814116?= X-GMAIL-MSGID: =?utf-8?q?1755675125669814116?= Add an empty line to force the output to split paragraphs like it is splitin the REST source. Signed-off-by: Yoann Congal --- Documentation/trace/kprobetrace.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/Documentation/trace/kprobetrace.rst b/Documentation/trace/kprobetrace.rst index febfd3792854f..fda155237be7a 100644 --- a/Documentation/trace/kprobetrace.rst +++ b/Documentation/trace/kprobetrace.rst @@ -74,12 +74,14 @@ respectively. 'x' prefix implies it is unsigned. Traced arguments are shown in decimal ('s' and 'u') or hexadecimal ('x'). Without type casting, 'x32' or 'x64' is used depends on the architecture (e.g. x86-32 uses x32, and x86-64 uses x64). + These value types can be an array. To record array data, you can add '[N]' (where N is a fixed number, less than 64) to the base type. E.g. 'x16[4]' means an array of x16 (2-byte hex) with 4 elements. Note that the array can be applied to memory type fetchargs, you can not apply it to registers/stack-entries etc. (for example, '$stack1:x8[8]' is wrong, but '+8($stack):x8[8]' is OK.) + String type is a special type, which fetches a "null-terminated" string from kernel space. This means it will fail and store NULL if the string container has been paged out. "ustring" type is an alternative of string for user-space.