From patchwork Mon Jul 8 13:43:09 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Emil Velikov via B4 Relay X-Patchwork-Id: 13726631 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 518E8137C35 for ; Mon, 8 Jul 2024 13:43:32 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1720446212; cv=none; b=V2FTAMtk/RDbrZ3lHNHgsuMpSmHFiVWxJzOi7eVih9nFmMotZ58Ai34ZTe2iEEYfxQg/mWuT0FHBmIPi+V2m6rYdil80KnsVkFqfoqljh/xOQatetjFPrSLY/4bRiBXctGJ6lAMEcHn3eM2bW4IjFVtCouZ94FqT9qa4ic52y6o= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1720446212; c=relaxed/simple; bh=aRxNuNV6XKHDn0B+riyWkbQdkjvQaWzi5nLB7wzy1E0=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=BvzkFfYc5ST5I3UuF3rn4xWdtnrdnH9x/EPV5gdA1f8eXoEZDwPsmds1bK7L8xuGlJd5v8OanlstzU/jyFGUy9Qxe8O4LruGCPLgXMI6CDLpHouUudSXiEJAbOerP3sy/Y/Vdes75ab0Sl2y131/b/VxjpRNvAFH+51cO78YAFo= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=UeRbcYVe; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="UeRbcYVe" Received: by smtp.kernel.org (Postfix) with ESMTPS id 044DCC4AF0A; Mon, 8 Jul 2024 13:43:32 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1720446212; bh=aRxNuNV6XKHDn0B+riyWkbQdkjvQaWzi5nLB7wzy1E0=; h=From:Date:Subject:References:In-Reply-To:To:Cc:Reply-To:From; b=UeRbcYVefA2LYFcs4Z0kH+QBF5JVTLitff/kqmxqOIE/edRUfQoSk52hl5AMP26za 5yc3Krh45QWDFYghLzv+Yk0s2jAqpGqND1Y6O2eHYh61ABTFENTJKZdO8v/MrOqLND tnFAYEvee19Q6Xn6scLghfWuMG9iLrrZ39/pYUMpoCLKIv0SnK8oq+XWA/26AXCZ56 rMxp/XhEfoJ5bCcffxk3epKXKjDW878EIVhePsyP54IlkuFJjSbuNRlg6kGoF95QqX SNZFAv89ENJSjDCY1hNnBzi9txkMhoaTi6tGLIZxb9pfFeD3gUczNB3gftQ6mVlPYx NSJx82ZKv42jw== Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id E3A57C3DA44; Mon, 8 Jul 2024 13:43:31 +0000 (UTC) From: Emil Velikov via B4 Relay Date: Mon, 08 Jul 2024 14:43:09 +0100 Subject: [PATCH kmod v2 01/17] man: add some extra bold/italic annotations Precedence: bulk X-Mailing-List: linux-modules@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Message-Id: <20240708-man-v2-1-a23df6ef871e@gmail.com> References: <20240708-man-v2-0-a23df6ef871e@gmail.com> In-Reply-To: <20240708-man-v2-0-a23df6ef871e@gmail.com> To: linux-modules@vger.kernel.org Cc: Emil Velikov X-Mailer: b4 0.14.0 X-Developer-Signature: v=1; a=ed25519-sha256; t=1720446209; l=8950; i=emil.l.velikov@gmail.com; s=20230301; h=from:subject:message-id; bh=V5iPrI6QXNubI5vuHbIuBAg+o8si/J1j7rX5731ZxA0=; b=BIU03eObp9rxpZcrR+NOjvyiryl7siNbQG6YtPsbxMneqG/CdTyTlWhgNk2ZgcwMrzyi+CxFo UHUxj6XmfSDAWaXy+I6RBwLmlquMiS3J8GNnQ12fjKHKKmZNk7OcUTz X-Developer-Key: i=emil.l.velikov@gmail.com; a=ed25519; pk=qeUTVTNyI3rcR2CfNNWsloTihgzmtbZo98GdxwZKCkY= X-Endpoint-Received: by B4 Relay for emil.l.velikov@gmail.com/20230301 with auth_id=35 X-Original-From: Emil Velikov Reply-To: emil.l.velikov@gmail.com From: Emil Velikov Signed-off-by: Emil Velikov --- v2: add an extra depmod instance --- man/depmod.8.scd | 20 ++++++++++---------- man/kmod.8.scd | 2 +- man/modinfo.8.scd | 8 ++++---- man/modprobe.8.scd | 12 ++++++------ man/modules.dep.5.scd | 11 ++++++----- man/rmmod.8.scd | 2 +- 6 files changed, 28 insertions(+), 27 deletions(-) diff --git a/man/depmod.8.scd b/man/depmod.8.scd index 0fe9128..34c1313 100644 --- a/man/depmod.8.scd +++ b/man/depmod.8.scd @@ -21,7 +21,7 @@ dependencies can get quite complex. *depmod* creates a list of module dependencies by reading each module under @MODULE_DIRECTORY@/_version_ and determining what symbols it exports and what -symbols it needs. By default, this list is written to modules.dep, and a binary +symbols it needs. By default, this list is written to *modules.dep*, and a binary hashed version named modules.dep.bin, in the same directory. If filenames are given on the command line, only those modules are examined (which is rarely useful unless all modules are listed). * depmod* also creates a list of symbols @@ -41,20 +41,20 @@ rather than the current kernel version (as returned by *uname -r*). *-A*, *--quick* This option scans to see if any modules are newer than the - modules.dep file before any work is done: if not, it silently exits + *modules.dep* file before any work is done: if not, it silently exits rather than regenerating the files. *-b* _basedir_, *--basedir* _basedir_ If your modules are not currently in the (normal) directory @MODULE_DIRECTORY@/_version_, but in a staging area, you can specify a _basedir_ which is prepended to the directory name. This _basedir_ is - stripped from the resulting modules.dep file, so it is ready to be moved - into the normal location. Use this option if you are a distribution - vendor who needs to pre-generate the meta-data files rather than running - depmod again later. + stripped from the resulting *modules.dep* file, so it is ready to be + moved into the normal location. Use this option if you are a + distribution vendor who needs to pre-generate the meta-data files rather + than running *depmod* again later. *-o* _outdir_, *--outdir* _outdir_ - Set the output directory where depmod will store any generated file. + Set the output directory where *depmod* will store any generated file. _ outdir_ serves as a root to that location, similar to how _basedir_ is used. Also this setting takes precedence and if used together with _basedir_ it will result in the input being that directory, but the output @@ -75,11 +75,11 @@ rather than the current kernel version (as returned by *uname -r*). *-E*, *--symvers* When combined with the *-e* option, this reports any symbol versions supplied by modules that do not match with the symbol versions provided - by the kernel in its Module.symvers. This option is mutually + by the kernel in its _Module.symvers_. This option is mutually incompatible with *-F*. *-F*, *--filesyms* _System.map_ - Supplied with the System.map produced when the kernel was built, this + Supplied with the _System.map_ produced when the kernel was built, this allows the *-e* option to report unresolved symbols. This option is mutually incompatible with *-E*. @@ -87,7 +87,7 @@ rather than the current kernel version (as returned by *uname -r*). Print the help message and exit. *-n*, *--show*, *--dry-run* - This sends the resulting modules.dep and the various map files to + This sends the resulting *modules.dep* and the various map files to standard output rather than writing them into the module directory. *-P* diff --git a/man/kmod.8.scd b/man/kmod.8.scd index d292a13..7bef863 100644 --- a/man/kmod.8.scd +++ b/man/kmod.8.scd @@ -6,7 +6,7 @@ kmod - Program to manage Linux Kernel modules # SYNOPSIS -*kmod* [*OPTIONS*...] [_COMMAND_] [*COMMAND_OPTIONS*...] +*kmod* [*OPTIONS...*] [_COMMAND_] [*COMMAND_OPTIONS...*] # DESCRIPTION diff --git a/man/modinfo.8.scd b/man/modinfo.8.scd index fd945ce..75267bc 100644 --- a/man/modinfo.8.scd +++ b/man/modinfo.8.scd @@ -29,14 +29,14 @@ architecture. # OPTIONS *-V*, *--version* - Print the modinfo version. + Print the *modinfo* version. *-F*, *--field* Only print this field value, one per line. This is most useful for scripts. Field names are case-insensitive. Common fields (which may not be in every module) include author, description, license, parm, depends, and alias. There are often multiple parm, alias and depends fields. The - special field filename lists the filename of the module. + special _field_ filename lists the filename of the module. *-b* _basedir_, *--basedir* _basedir_ Root directory for modules, / by default. @@ -50,9 +50,9 @@ architecture. image prior to booting. *-0*, *--null* - Use the ASCII zero character to separate field values, instead of a new + Use the ASCII zero character to separate _field_ values, instead of a new line. This is useful for scripts, since a new line can theoretically - appear inside a field. + appear inside a _field_. *-a* *--author*, *-d* *--description*, *-l* *--license*, *-p* *--parameters*, *-n* *--filename* diff --git a/man/modprobe.8.scd b/man/modprobe.8.scd index f678654..653fbd9 100644 --- a/man/modprobe.8.scd +++ b/man/modprobe.8.scd @@ -9,11 +9,11 @@ modprobe - Add and remove modules from the Linux Kernel *modprobe* [*-v*] [*-V*] [*-C *_config-file_] [*-n*] [*-i*] [*-q*] [*-b*] [_modulename_] \ \ \ \ \ \ \ \ \ \[_module parameters_...] -*modprobe* [-r] [*-v*] [*-n*] [*-i*] [_modulename_...] +*modprobe* [*-r*] [*-v*] [*-n*] [*-i*] [_modulename_...] -*modprobe* [-c] +*modprobe* [*-c*] -*modprobe* [--dump-modversions] [_filename_] +*modprobe* [*--dump-modversions*] [_filename_] # DESCRIPTION @@ -42,7 +42,7 @@ If any arguments are given after the _modulename_, they are passed to the kernel When loading modules, _modulename_ can also be a path to the module. If the path is relative, it must explicitly start with "./". Note that this may fail when -using a path to a module with dependencies not matching the installed depmod +using a path to a module with dependencies not matching the installed *depmod* database. # OPTIONS @@ -78,7 +78,7 @@ database. module which is already present or to remove a module which isn't present. This is ideal for simple scripts; however, more complicated scripts often want to know whether *modprobe* really did something: this - option makes modprobe fail in the case that it actually didn't do + option makes *modprobe* fail in the case that it actually didn't do anything. *--force-vermagic* @@ -97,7 +97,7 @@ database. detailing the versions of every interfaced used by (or supplied by) the module is created. If a module fails to load and the kernel complains that the module disagrees about a version of some interface, you can use - "--force-modversion" to remove the version information altogether. + *--force-modversion* to remove the version information altogether. Naturally, this check is there for your protection, so using this option is dangerous unless you know what you're doing. diff --git a/man/modules.dep.5.scd b/man/modules.dep.5.scd index 34ffb83..c4e7653 100644 --- a/man/modules.dep.5.scd +++ b/man/modules.dep.5.scd @@ -12,13 +12,14 @@ modules.dep, modules.dep.bin - Module dependency information # DESCRIPTION -modules.dep.bin is a binary file generated by *depmod* listing the dependencies -for every module in the directories under @MODULE_DIRECTORY@/_version_. It is -used by kmod tools such as *modprobe* and libkmod. +*modules.dep.bin* is a binary file generated by *depmod* listing the +dependencies for every module in the directories under +@MODULE_DIRECTORY@/_version_. It is used by *kmod* tools such as *modprobe* and +libkmod. Its text counterpart is located in the same directory with the name -modules.dep. The text version is maintained only for easy of reading by humans -and is in no way used by any kmod tool. +*modules.dep*. The text version is maintained only for easy of reading by humans +and is in no way used by any *kmod* tool. These files are not intended for editing or use by any additional utilities as their format is subject to change in the future. You should use the *modinfo*(8) diff --git a/man/rmmod.8.scd b/man/rmmod.8.scd index 72947a6..7813448 100644 --- a/man/rmmod.8.scd +++ b/man/rmmod.8.scd @@ -29,7 +29,7 @@ is provided) from the kernel. Most users will want to use *modprobe*(8) with the *-s*, *--syslog* Send errors to syslog instead of standard error. -*-V --version* +*-V*, *--version* Show version of program and exit. # COPYRIGHT From patchwork Mon Jul 8 13:43:10 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Emil Velikov via B4 Relay X-Patchwork-Id: 13726632 Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 51928138490 for ; Mon, 8 Jul 2024 13:43:32 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1720446212; cv=none; b=lV0CPO7A1E8LEwu4yvJtsKDxjXKnVFHvtyVVMhN1DfbksLbpqjfV0u7iEbrYIA4eOfPTeFlgVDvSS2mQ5FgFkBIthZMyTeyFbxI1qAw1l+5DuhOvLthTl8E+PSO0FDq1xqL08IIO/OpCWbGjZcWq27GWYzDWgXz62zON+hCVU4Y= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1720446212; c=relaxed/simple; bh=Dcx2+Qk2wKMUUYbY/Sf26bruZ8ltBKwvtqILvDzkEcY=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=V2l1AH4iMCBaeTDx1SNZMpYW6OL28lEf65CqcGEFscNJwk52zJWetDMPWyDow99eQbMrLAYgi+ts8ri5wLQQZ1N/gVonhIMgpcq+wGez47hfjGIXX/COrbzfjZyckawbkuboAyqd0jfQX4PkCALSNfoIlgpPANayZsYplEcQ+L8= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=mYUcINXo; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="mYUcINXo" Received: by smtp.kernel.org (Postfix) with ESMTPS id 0C01AC32786; Mon, 8 Jul 2024 13:43:32 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1720446212; bh=Dcx2+Qk2wKMUUYbY/Sf26bruZ8ltBKwvtqILvDzkEcY=; h=From:Date:Subject:References:In-Reply-To:To:Cc:Reply-To:From; b=mYUcINXocvXHIh8ccLK+v+4sX+Tk0Rul1jvfEbKzTtjYwoASqw3DSfYu/314Qda7e oFu4aHYUlhieAdXLiV+t7VzAMTMEyJZwapRDLXoMEerBFj59KA1fdkhGRslSE/84Yr JfbHjDKlbHsoUoLBiV93zMEQSJx02C7wIl/QLfFcSBTC89gDCLgNAHpnp39zzroqLR 0k0i/KFHxgpYIyLj6lC5cAZQt8oTftYK81wzZFS8zcjq8F9FKN2ML2/TSaP56fJR8W JeiuMw2rogYrhy2tfXseE1aJ6+CkwPEzgUMKD/21WJcJ0TzrZr8sSA3jUfy0OZrrmn G8S0l2NGdWwXA== Received: from aws-us-west-2-korg-lkml-1.web.codeaurora.org (localhost.localdomain [127.0.0.1]) by smtp.lore.kernel.org (Postfix) with ESMTP id F0F4FC3271E; Mon, 8 Jul 2024 13:43:31 +0000 (UTC) From: Emil Velikov via B4 Relay Date: Mon, 08 Jul 2024 14:43:10 +0100 Subject: [PATCH kmod v2 02/17] man: white space fixes Precedence: bulk X-Mailing-List: linux-modules@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Message-Id: <20240708-man-v2-2-a23df6ef871e@gmail.com> References: <20240708-man-v2-0-a23df6ef871e@gmail.com> In-Reply-To: <20240708-man-v2-0-a23df6ef871e@gmail.com> To: linux-modules@vger.kernel.org Cc: Emil Velikov X-Mailer: b4 0.14.0 X-Developer-Signature: v=1; a=ed25519-sha256; t=1720446209; l=4925; i=emil.l.velikov@gmail.com; s=20230301; h=from:subject:message-id; bh=FIuRVlV349zm6qJg/6cU04JoJxGlyJsKYzKRe2M51/A=; b=djL+v17757sgOhLq0cewdBxqCgEBSWgfo3VBXNS3uEORfeDNfiYCUUtK5aQ3woTPXS69yVDlW UGfifsF0cHdB61RkY/DL7YOqXZ0rQGUsL9W6UNX5NrqA9UGOi23n/BA X-Developer-Key: i=emil.l.velikov@gmail.com; a=ed25519; pk=qeUTVTNyI3rcR2CfNNWsloTihgzmtbZo98GdxwZKCkY= X-Endpoint-Received: by B4 Relay for emil.l.velikov@gmail.com/20230301 with auth_id=35 X-Original-From: Emil Velikov Reply-To: emil.l.velikov@gmail.com From: Emil Velikov These were present in the original xml files and I opted to keep them separate fix to make the transition/comparison easier. Signed-off-by: Emil Velikov --- v2: drop unrelated bold annotation - move to previous patch --- man/depmod.8.scd | 2 +- man/depmod.d.5.scd | 2 +- man/modprobe.8.scd | 8 ++++---- man/modprobe.d.5.scd | 4 ++-- 4 files changed, 8 insertions(+), 8 deletions(-) diff --git a/man/depmod.8.scd b/man/depmod.8.scd index 34c1313..80cc48d 100644 --- a/man/depmod.8.scd +++ b/man/depmod.8.scd @@ -55,7 +55,7 @@ rather than the current kernel version (as returned by *uname -r*). *-o* _outdir_, *--outdir* _outdir_ Set the output directory where *depmod* will store any generated file. - _ outdir_ serves as a root to that location, similar to how _basedir_ is + _outdir_ serves as a root to that location, similar to how _basedir_ is used. Also this setting takes precedence and if used together with _basedir_ it will result in the input being that directory, but the output being the one set by _outdir_. diff --git a/man/depmod.d.5.scd b/man/depmod.d.5.scd index 9c42478..4e05b93 100644 --- a/man/depmod.d.5.scd +++ b/man/depmod.d.5.scd @@ -50,7 +50,7 @@ override _modulename_ _kernelversion_ _modulesubdirectory_ This command allows you to override which version of a specific module will be used when more than one module sharing the same name is processed by the *depmod* command. It is possible to specify one kernel - or all kernels using the \* wildcard. _ modulesubdirectory_ is the name + or all kernels using the \* wildcard. _modulesubdirectory_ is the name of the subdirectory under @MODULE_DIRECTORY@ (or other module location) where the target module is installed. diff --git a/man/modprobe.8.scd b/man/modprobe.8.scd index 653fbd9..aac3a74 100644 --- a/man/modprobe.8.scd +++ b/man/modprobe.8.scd @@ -6,7 +6,7 @@ modprobe - Add and remove modules from the Linux Kernel # SYNOPSIS -*modprobe* [*-v*] [*-V*] [*-C *_config-file_] [*-n*] [*-i*] [*-q*] [*-b*] [_modulename_] +*modprobe* [*-v*] [*-V*] [*-C* _config-file_] [*-n*] [*-i*] [*-q*] [*-b*] [_modulename_] \ \ \ \ \ \ \ \ \ \[_module parameters_...] *modprobe* [*-r*] [*-v*] [*-n*] [*-i*] [_modulename_...] @@ -19,10 +19,10 @@ modprobe - Add and remove modules from the Linux Kernel *modprobe* intelligently adds or removes a module from the Linux kernel: note that for convenience, there is no difference between \_ and - in module names -(automatic underscore conversion is performed). * modprobe* looks in the module +(automatic underscore conversion is performed). *modprobe* looks in the module directory @DISTCONFDIR@/`uname -r` for all the modules and other files, except for the optional configuration files in the /etc/modprobe.d directory (see -*modprobe.d*(5)). * modprobe* will also use module options specified on the +*modprobe.d*(5)). *modprobe* will also use module options specified on the kernel command line in the form of .