Skip to contentSkip to conversation

core.5: document the %f and %C core_pattern specifiers

PATCH In review Emanuele Rocca 4 participants 4 messages Mar 13 – Mar 16 Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore

Emanuele Rocca

author
#0 lore raw

PATCH 1/1 core.5: document the %f and %C core_pattern specifiers

Whilst going through the relevant kernel code in fs/coredump.c, I noticed that two core pattern specifiers supported by Linux are missing from man5/core.5. Document them now.

Signed-off-by Emanuele Rocca <[email protected]>
---
 man/man5/core.5 | 10 ++++++++++
 1 file changed, 10 insertions(+)
man/man5/core.5 +10 -0
index 8c26aa07e..4da5819b6 100644
@@ -154,6 +154,11 @@ A single % character.
 %c
 Core file size soft resource limit of crashing process (since Linux 2.6.24).
 .TP
+%C
+CPU the task ran on
+.\" commit 8603b6f58637ce196d68f7749633ea81af196d66
+(since Linux 6.2).
+.TP
 %d
 .\" Added in git commit 12a2b4b2241e318b4f6df31228e4272d2c2968a1
 Dump mode\[em]same as value returned by

@@ -179,6 +184,11 @@ Pathname of executable,
 with slashes (\[aq]/\[aq]) replaced by exclamation marks (\[aq]!\[aq])
 (since Linux 3.0).
 .TP
+%f
+Actual filename of executable, which may differ from %e
+.\" commit f38c85f1ba6902e4e2e2bf1b84edf065a904cdeb
+(since Linux 5.9).
+.TP
 %F
 PIDFD of dumped process
 .\" commit b5325b2a270fcaf7b2a9a0f23d422ca8a5a8bdea
Signature · 1 line
2.47.3
Acked-by on v1 1/1
#1 lore raw
Quoted 14 lines · středoevropský standardní čas Emanuele Rocca

Whilst going through the relevant kernel code in fs/coredump.c, I noticed that two core pattern specifiers supported by Linux are missing from man5/core.5. Document them now.

Signed-off-by Emanuele Rocca <[email protected]>
---
 man/man5/core.5 | 10 ++++++++++
 1 file changed, 10 insertions(+)
man/man5/core.5 +0 -0
index 8c26aa07e..4da5819b6 100644

man/man5/core.5 A single % character. · line 161

Quoted 8 lines
man/man5/core.5 +5 -0
@@ -154,6 +154,11 @@ A single % character.
 %c
 Core file size soft resource limit of crashing process (since Linux 2.6.24).
 .TP
+%C
+CPU the task ran on
+.\" commit 8603b6f58637ce196d68f7749633ea81af196d66
+(since Linux 6.2).
+.TP

For this part:

Acked-by Oleksandr Natalenko <[email protected]>

Thank you.

Quoted 16 lines
man/man5/core.5 +5 -0
 %d
 .\" Added in git commit 12a2b4b2241e318b4f6df31228e4272d2c2968a1
 Dump mode\[em]same as value returned by

@@ -179,6 +184,11 @@ Pathname of executable,
 with slashes (\[aq]/\[aq]) replaced by exclamation marks (\[aq]!\[aq])
 (since Linux 3.0).
 .TP
+%f
+Actual filename of executable, which may differ from %e
+.\" commit f38c85f1ba6902e4e2e2bf1b84edf065a904cdeb
+(since Linux 5.9).
+.TP
 %F
 PIDFD of dumped process
 .\" commit b5325b2a270fcaf7b2a9a0f23d422ca8a5a8bdea
Signature · 1 line
Oleksandr Natalenko, MSE
Acked-by
#2 lore raw
Quoted 31 lines · Oleksandr Natalenko
Quoted 14 lines · středoevropský standardní čas Emanuele Rocca

Whilst going through the relevant kernel code in fs/coredump.c, I noticed that two core pattern specifiers supported by Linux are missing from man5/core.5. Document them now.

Signed-off-by Emanuele Rocca <[email protected]>
---
 man/man5/core.5 | 10 ++++++++++
 1 file changed, 10 insertions(+)
man/man5/core.5 +0 -0
index 8c26aa07e..4da5819b6 100644

man/man5/core.5 A single % character. · line 161

Quoted 8 lines
man/man5/core.5 +5 -0
@@ -154,6 +154,11 @@ A single % character.
 %c
 Core file size soft resource limit of crashing process (since Linux 2.6.24).
 .TP
+%C
+CPU the task ran on
+.\" commit 8603b6f58637ce196d68f7749633ea81af196d66
+(since Linux 6.2).
+.TP

For this part:

Acked-by Oleksandr Natalenko <[email protected]>

Thank you.

Quoted 12 lines

man/man5/core.5 Pathname of executable, · line 191

Quoted 12 lines
man/man5/core.5 +5 -0
 %d
 .\" Added in git commit 12a2b4b2241e318b4f6df31228e4272d2c2968a1
 Dump mode\[em]same as value returned by

@@ -179,6 +184,11 @@ Pathname of executable,
 with slashes (\[aq]/\[aq]) replaced by exclamation marks (\[aq]!\[aq])
 (since Linux 3.0).
 .TP
+%f
+Actual filename of executable, which may differ from %e
+.\" commit f38c85f1ba6902e4e2e2bf1b84edf065a904cdeb
+(since Linux 5.9).
+.TP

For this part:

Acked-by Lepton Wu <[email protected]>

Thanks!

Quoted 8 lines

man/man5/core.5 Pathname of executable, · line 194

Quoted 4 lines
man/man5/core.5 +0 -0
 %F
 PIDFD of dumped process
 .\" commit b5325b2a270fcaf7b2a9a0f23d422ca8a5a8bdea

--
Oleksandr Natalenko, MSE

maintainer
#3 lore raw

Hi all,

Quoted 9 lines · lepton
Quoted 7 lines · Oleksandr Natalenko
Quoted 5 lines · středoevropský standardní čas Emanuele Rocca

Whilst going through the relevant kernel code in fs/coredump.c, I noticed that two core pattern specifiers supported by Linux are missing from man5/core.5. Document them now.

Signed-off-by Emanuele Rocca <[email protected]>

Thanks! I've applied the patch,

Quoted 1 line
Quoted 1 line
Quoted 1 line

---

[...]

Quoted 12 lines
Quoted 12 lines

man/man5/core.5 A single % character. · line 161

Quoted 5 lines

+%C

man/man5/core.5 +4 -0
+CPU the task ran on
+.\" commit 8603b6f58637ce196d68f7749633ea81af196d66
+(since Linux 6.2).
+.TP

For this part:

Acked-by Oleksandr Natalenko <[email protected]>

Thank you.

[...]

Quoted 8 lines
Quoted 5 lines

man/man5/core.5 Pathname of executable, · line 191

Quoted 5 lines

+%f

man/man5/core.5 +4 -0
+Actual filename of executable, which may differ from %e
+.\" commit f38c85f1ba6902e4e2e2bf1b84edf065a904cdeb
+(since Linux 5.9).
+.TP

For this part:

Acked-by Lepton Wu <[email protected]>

And both ACKs.

Have a lovely night!
Alex

Quoted 10 lines

Thanks!

Quoted 8 lines
Quoted 4 lines

%F
PIDFD of dumped process
.\" commit b5325b2a270fcaf7b2a9a0f23d422ca8a5a8bdea

--
Oleksandr Natalenko, MSE

Signature · 1 line
<https://www.alejandro-colomar.es>