[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-ID: <avWwXGpq1OLtNDSV@devuan>
Date: Thu, 12 Nov 2026 13:27:13 +0100
From: Alejandro Colomar <alx+linux-man@...nel.org>
To: Rich Felker <dalias@...c.org>
Cc: Alejandro Colomar <alx@...nel.org>,
Vincent Lefevre <vincent@...c17.net>, linux-man@...r.kernel.org, libc-alpha@...rceware.org,
Walter Harms <wharms@....de>, ~hallyn/shadow@...ts.sr.ht, musl@...ts.openwall.com
Subject: Re: Re: [PATCH v1] man/man3/crypt.3: These functions accept
many algorithms, not only DES
Hi Rich,
> Date: 2026-11-12 07:08:32-0500
> From: Rich Felker <dalias@...c.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>
Download attachment "signature.asc" of type "application/pgp-signature" (834 bytes)
Powered by blists - more mailing lists
Confused about mailing lists and their use?
Read about mailing lists on Wikipedia
and check out these
guidelines on proper formatting of your messages.
