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.