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

Alejandro Colomar
2023-10-18T19:56:52Z

[-- 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 --]