[musl] Re: [PATCH v1] man/man3/crypt.3: These functions accept many algorithms, not only DES
Alejandro Colomar
alx+linux-man@kernel.org
Thu Nov 12 12:27:13 GMT 2026
Hi Rich,
> Date: 2026-11-12 07:08:32-0500
> From: Rich Felker <dalias@libc.org>
>
[...]
> > +.SH VERSIONS
> > +While POSIX only specifies the DES algorithms for these functions,
> > +all systems implement several other algorithms.
>
> POSIX doesn't specify any algorithm. It specifies the input format for
> salt in a way that's aligned with the traditional DES password hashing
> algorithm but it doesn't assign any actual definition for the
> algorithm.
>
> DES hash provides the implementation-defined algorithm POSIX mandates
> exists but doesn't specify. The other hashes fill in the gaps where
> the specification leaves things undefined.
>
> For practical purposes POSIX is irrelevant to the way you choose salt
> strings for producing new password hashes; it only specifies how to
> call the function and validate a password against a hash.
How about something this (we can improve the wording)?
diff --git i/man/man3/crypt.3 w/man/man3/crypt.3
index 524781d3c2a0..d579bc5394fb 100644
--- i/man/man3/crypt.3
+++ w/man/man3/crypt.3
@@ -111,6 +111,9 @@ .SH ATTRIBUTES
.BR crypt_r ()
T} Thread safety MT-Safe
.TE
+.SH VERSIONS
+POSIX specifies a quite useless API,
+and all systems extend it significantly.
.SH STANDARDS
.TP
.BR crypt ()
Have a lovely day!
Alex
--
<https://www.alejandro-colomar.es>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: not available
URL: <https://sourceware.org/pipermail/libc-alpha/attachments/20261112/61c5c9b2/attachment.sig>
More information about the Libc-alpha
mailing list