aboutsummaryrefslogtreecommitdiffstats
path: root/man3/printf.3
diff options
context:
space:
mode:
authorAlejandro Colomar <alx.manpages@gmail.com>2021-12-22 19:00:20 +0100
committerAlejandro Colomar <alx.manpages@gmail.com>2021-12-22 19:05:20 +0100
commitf2d38227b35b6788294b90c07556a1bc85b00992 (patch)
tree06536d80f4081ce05ccc6dc37a325fc9d2879dea /man3/printf.3
parent7936bacb92bd2fb88290b1e3e03939cc4c3e0d64 (diff)
downloadman-pages-f2d38227b35b6788294b90c07556a1bc85b00992.tar.gz
printf.3: Document %#m as strerrorname_np(errno)
Reported-by: Adhemerval Zanella <adhemerval.zanella@linaro.org> Signed-off-by: Alejandro Colomar <alx.manpages@gmail.com> Cc: libc-alpha@sourceware.org Cc: Florian Weimer <fweimer@redhat.com> Cc: Michael Kerrisk <mtk.manpages@gmail.com>
Diffstat (limited to 'man3/printf.3')
-rw-r--r--man3/printf.323
1 files changed, 22 insertions, 1 deletions
diff --git a/man3/printf.3 b/man3/printf.3
index 4fa1f11f3c..1e2bac4dfa 100644
--- a/man3/printf.3
+++ b/man3/printf.3
@@ -301,6 +301,17 @@ and
.B G
conversions, trailing zeros are not removed from the result as they would
otherwise be.
+For
+.BR m ,
+if
+.I errno
+contains a valid error code,
+the output of
+.I strerrorname_np(errno)
+is printed;
+otherwise, the value stored in
+.I errno
+is printed as a decimal number.
For other conversions, the result is undefined.
.TP
.B \&0
@@ -853,7 +864,10 @@ any flags, a field width, or a precision.
.B m
(Glibc extension; supported by uClibc and musl.)
Print output of
-.IR strerror(errno) .
+.I strerror(errno)
+(or
+.I strerrorname_np(errno)
+in the alternate form).
No argument is required.
.TP
.B %
@@ -974,6 +988,13 @@ and conversion characters \fBa\fP and \fBA\fP.
.PP
glibc 2.2 adds the conversion character \fBF\fP with C99 semantics,
and the flag character \fBI\fP.
+.PP
+glibc 2.35 gives a meaning to the alternate form
+.RB ( # )
+of the
+.B m
+conversion specifier, that is
+.IR %#m .
.SH NOTES
Some programs imprudently rely on code such as the following
.PP