Re: [musl] Re: [PATCH v1] man/man3/crypt.3: These functions accept many algorithms, not only DES

[Alejandro Colomar <alx+linux-man@kernel.org>]

[-- Attachment #1: Type: text/plain, Size: 1390 bytes --]

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>

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]