From nobody Tue Sep 16 01:10:19 2025 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 3578BC54EBE for ; Mon, 9 Jan 2023 09:53:24 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S234156AbjAIJxX (ORCPT ); Mon, 9 Jan 2023 04:53:23 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:43890 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S236703AbjAIJv5 (ORCPT ); Mon, 9 Jan 2023 04:51:57 -0500 Received: from mail-pj1-x102a.google.com (mail-pj1-x102a.google.com [IPv6:2607:f8b0:4864:20::102a]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id A300F13CC6; Mon, 9 Jan 2023 01:51:19 -0800 (PST) Received: by mail-pj1-x102a.google.com with SMTP id z4-20020a17090a170400b00226d331390cso8818623pjd.5; Mon, 09 Jan 2023 01:51:19 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.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=mqJCH7hX4dILUHJmf3hsUMhsDu5qPCEp+u1n+kr7rxg=; b=iMD9gaWVVnDR5njGukGNImhoF87Ln9pekRZVKBgCi5H+o9ebrLASJQ9Pb2xx540g1b siUcwH+wbT4a+l1Cue1bsgU7jsA5qiKM3BbgRhL5ZfTLVAK41WaTCzcm4nHFh8+9ID1M q5N6wFjtyeQGX9HwBqsaLerLhmCLyNbyaevr5R3zYeI4RXH2SCbwekTA/tVPQh6oqR8C 1SfKizOBJpvEPl8mcABpM3INLBv+CZNm2tbav7SVt4UHgaxDfIzzi0dFpHolD2Iw2h/S C68rkN+4SmXk1aDJz4WKFWrUuqkCMRK5AXGAXJ5GsukhBGcDJ30tdagtyaYAsPqsT4Xq CDfA== 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=mqJCH7hX4dILUHJmf3hsUMhsDu5qPCEp+u1n+kr7rxg=; b=Ww4AMHz0TNsRfApXpVgo9PVkpO7Ed2xqBs/BL2lgMXqFjPU4UMD5LN+TJo3b72sUmp WNRkI71NAbDYv7SuTlp6Q2B0G54dypJ7/Jv6CBsOsHbZW27Ee+fjB0sJn4yLMIkUT0Yq 73ogXPNs3OvxdClGlBMXWy1Zv6+6M/60spc1KUqFP9KTRNtUC+adVFdDq1ME+cTSNe+f yAnPeeTEv3lNhnEgWcWe62zv0rVOfflzEz8wSZrtczgZBrt5gZ1bGUfMYYaRJUpuOBrU ygSoG6oE1zMeLuZDoi5OVZgPRP0oFvJWBRwlPgrGUffWPOp0F3HwM3EOOvq0dCnyh/4s LsQA== X-Gm-Message-State: AFqh2kp+SrZExvseUC5PjxRtv858PRskyl530aPukN/K6pGgII5GZUwv EJ1/CltIv8pAMdctnfN1BoY= X-Google-Smtp-Source: AMrXdXvxLMwwO7210xShAwXu60VO5zSYBPq3TMErKmIAVFxoEaev7iZZcvNbLW0WxAqP8M+IDQWZew== X-Received: by 2002:a17:90b:485:b0:223:ffd0:b2a1 with SMTP id bh5-20020a17090b048500b00223ffd0b2a1mr68601087pjb.48.1673257879189; Mon, 09 Jan 2023 01:51:19 -0800 (PST) Received: from debian.me (subs03-180-214-233-26.three.co.id. [180.214.233.26]) by smtp.gmail.com with ESMTPSA id s88-20020a17090a69e100b002262ab43327sm3762001pjj.26.2023.01.09.01.51.18 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 09 Jan 2023 01:51:18 -0800 (PST) Received: by debian.me (Postfix, from userid 1000) id E2698105011; Mon, 9 Jan 2023 16:51:10 +0700 (WIB) From: Bagas Sanjaya To: Jonathan Corbet , Yann Sionneau Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Clement Leger , Guillaume Thouvenin , Bagas Sanjaya Subject: [PATCH 7/8] Documentation: kvx: Use literal code block for command-line inputs Date: Mon, 9 Jan 2023 16:51:07 +0700 Message-Id: <20230109095108.21229-8-bagasdotme@gmail.com> X-Mailer: git-send-email 2.39.0 In-Reply-To: <20230109095108.21229-1-bagasdotme@gmail.com> References: <874jt7fqxt.fsf@meer.lwn.net> <20230109095108.21229-1-bagasdotme@gmail.com> MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=2492; i=bagasdotme@gmail.com; h=from:subject; bh=bMSMm0rWOWzEGbRrqmQsw/YZ3fZ91pfy18WO8XnzGNg=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDMm7H3dnLJ1tKiSrLXZpuXq/3KPEJ6803loUWJ8qfWBnOMlo Bc+yjlIWBjEuBlkxRZZJiXxNp3cZiVxoX+sIM4eVCWQIAxenAExEfRYjw92Vex8wV3+XeqDu88xx6v 6dpV8rZAraTbIupz8VCpPdq8HwP0pphXxbdPhRxVXZjWs/1eirsU3+1XxYJa667qng7ad/2QA= X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Type: text/plain; charset="utf-8" Command-line, like codes, looks ugly when default paragraph block is used (since proportional font is used), where literal code blocks (which render as monospace) do the job better. Signed-off-by: Bagas Sanjaya --- Documentation/kvx/kvx-iommu.rst | 2 +- Documentation/kvx/kvx.rst | 10 +++++----- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/Documentation/kvx/kvx-iommu.rst b/Documentation/kvx/kvx-iommu.= rst index 5e84dc12adb437..c95d9231d5b665 100644 --- a/Documentation/kvx/kvx-iommu.rst +++ b/Documentation/kvx/kvx-iommu.rst @@ -144,7 +144,7 @@ Maintenance interface It is possible to have several "maintainers" for the same IOMMU. The drive= r is using two of them. One that writes the TLB and another interface reads TLB= . For debug purpose it is possible to display the content of the tlb by using the -following command in gdb: +following command in gdb:: =20 gdb> p kvx_iommu_dump_tlb( , 0) =20 diff --git a/Documentation/kvx/kvx.rst b/Documentation/kvx/kvx.rst index 4aac7fce4e3d01..5385e1e3d30187 100644 --- a/Documentation/kvx/kvx.rst +++ b/Documentation/kvx/kvx.rst @@ -122,7 +122,7 @@ To be able to set breakpoints when MMU is enabled we ad= ded a label called gdb_mmu_enabled. If you try to set a breakpoint on a function that is in virtual memory before the activation of the MMU this address as no signifi= cation for GDB. So, for example, if you want to break on the function start_kerne= l() -you will need to run: +you will need to run:: =20 kvx-gdb -silent path_to/vmlinux \ -ex 'tbreak gdb_mmu_enabled' -ex 'run' \ @@ -253,19 +253,19 @@ Building =3D=3D=3D=3D=3D=3D=3D=3D =20 In order to build the kernel, you will need a complete kvx toolchain. -First, setup the config using the following command line +First, setup the config using the following command line:: =20 $ make ARCH=3Dkvx O=3Dyour_directory default_defconfig =20 -Adjust any configuration option you may need and then, build the kernel: +Adjust any configuration option you may need and then, build the kernel:: =20 $ make ARCH=3Dkvx O=3Dyour_directory -j12 =20 -You will finally have a vmlinux image ready to be run. +You will finally have a vmlinux image ready to be run:: =20 $ kvx-mppa -- vmlinux =20 -Additionally, you may want to debug it. To do so, use kvx-gdb: +Additionally, you may want to debug it. To do so, use kvx-gdb:: =20 $ kvx-gdb vmlinux =20 --=20 An old man doll... just what I always wanted! - Clara