Re: [PATCH 5/5] ld.so.8: Describe the --list-diagnostics loader option

[Alejandro Colomar <alx@kernel.org>]

[-- Attachment #1: Type: text/plain, Size: 2937 bytes --]

Hi Adhemerval,

On Wed, Oct 18, 2023 at 02:21:04PM -0300, Adhemerval Zanella wrote:
> It was added on glibc 2.33 as a way to print system diagnostic
> information in a machine-readable format.
> 
> Signed-off-by: Adhemerval Zanella <adhemerval.zanella@linaro.org>

Patch applied.  Thanks!

I've amended with the following minor fixes:

diff --git a/man8/ld.so.8 b/man8/ld.so.8
index 6684b8418..d4eb27a70 100644
--- a/man8/ld.so.8
+++ b/man8/ld.so.8
@@ -238,13 +238,16 @@ .SH OPTIONS
 .B \-\-list
 List all dependencies and how they are resolved.
 .TP
-.BR \-\-list\-diagnostics " (since glibc 2.33)
-Print system diagnostic information in a machine-readable format, such as some
-internal loader variables, the auxiliary vector (see
+.BR \-\-list\-diagnostics " (since glibc 2.33)"
+Print system diagnostic information in a machine-readable format,
+such as some internal loader variables,
+the auxiliary vector
+(see
 .BR getauxval (3)),
-and the environment variables.  On some architecture, the command might print
-additional information (like the cpu features used in GNU indirect function
-selection on x86).
+and the environment variables.
+On some architectures,
+the command might print additional information
+(like the cpu features used in GNU indirect function selection on x86).
 .BR \-\-list\-tunables " (since glibc 2.33)"
 Print the names and values of all tunables,
 along with the minimum and maximum allowed values.



> ---
>  man8/ld.so.8 | 7 +++++++
>  1 file changed, 7 insertions(+)
> 
> diff --git a/man8/ld.so.8 b/man8/ld.so.8
> index 0e742cddd..66f14aef4 100644
> --- a/man8/ld.so.8
> +++ b/man8/ld.so.8
> @@ -246,6 +246,13 @@ are delimited by colons or spaces.
>  .B \-\-list
>  List all dependencies and how they are resolved.
>  .TP
> +.BR \-\-list\-diagnostics " (since glibc 2.33)

This triggered a warning:

$ make lint build check
LINT (mandoc)	.tmp/man/man8/ld.so.8.lint-man.mandoc.touch
mandoc: man8/ld.so.8:241:27: STYLE: unterminated quoted argument
make: *** [share/mk/lint/man/man.mk:32: .tmp/man/man8/ld.so.8.lint-man.mandoc.touch] Error 1

With the fix from above it vanished.

Here are the applied patches:
<https://www.alejandro-colomar.es/src/alx/linux/man-pages/man-pages.git/commit/?h=contrib&id=cce97466d5ed9e278120b7a49c7933e939742ef1>

Cheers,
Alex

> +Print system diagnostic information in a machine-readable format, such as some
> +internal loader variables, the auxiliary vector (see
> +.BR getauxval (3)),
> +and the environment variables.  On some architecture, the command might print
> +additional information (like the cpu features used in GNU indirect function
> +selection on x86).
>  .BR \-\-list\-tunables " (since glibc 2.33)"
>  Print the names and values of all tunables,
>  along with the minimum and maximum allowed values.
> -- 
> 2.34.1
> 

-- 
<https://www.alejandro-colomar.es/>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]