summaryrefslogtreecommitdiff
path: root/crypt_gensalt.3
diff options
context:
space:
mode:
authorDmitry V. Levin <ldv@altlinux.org>2018-06-26 22:45:01 +0000
committerBjörn Esser <besser82@fedoraproject.org>2018-07-13 11:35:21 +0200
commit59680ceac13f85a1506fca87255ea47304a8e493 (patch)
tree9e498061f0034aed2a4a631cc3e64978fe7d8ac6 /crypt_gensalt.3
parentb3ee64bf08082367ea2116ea1fb2007e1a2896cd (diff)
downloadlibxcrypt-59680ceac13f85a1506fca87255ea47304a8e493.tar.gz
libxcrypt-59680ceac13f85a1506fca87255ea47304a8e493.tar.bz2
libxcrypt-59680ceac13f85a1506fca87255ea47304a8e493.zip
crypt.h: introduce CRYPT_GENSALT_IMPLEMENTS_* feature test macros
Define CRYPT_GENSALT_IMPLEMENTS_DEFAULT_PREFIX and CRYPT_GENSALT_IMPLEMENTS_AUTO_ENTROPY feature test macros. These macros could be checked by portable users of crypt_gensalt* functions to find out whether null pointers could be specified as PREFIX and RBYTES arguments.
Diffstat (limited to 'crypt_gensalt.3')
-rw-r--r--crypt_gensalt.321
1 files changed, 21 insertions, 0 deletions
diff --git a/crypt_gensalt.3 b/crypt_gensalt.3
index 8759011..ebfff28 100644
--- a/crypt_gensalt.3
+++ b/crypt_gensalt.3
@@ -172,6 +172,19 @@ failed to allocate memory for the compiled
string.
.ad b
.hy 1
+.SH FEATURE TEST MACROS
+The following macros are defined by
+.BR crypt.h :
+.TP
+.B CRYPT_GENSALT_IMPLEMENTS_DEFAULT_PREFIX
+A null pointer can be specified as
+.I prefix
+argument.
+.TP
+.B CRYPT_GENSALT_IMPLEMENTS_AUTO_ENTROPY
+A null pointer can be specified as
+.I rbytes
+argument.
.SH PORTABILITY NOTES
The functions
.BR crypt_gensalt ", " crypt_gensalt_rn ", and " crypt_gensalt_ra
@@ -181,6 +194,14 @@ A function with the name
.B crypt_gensalt
also exists on Solaris 10 and newer, but its prototype and semantics differ.
.PP
+The default prefix and auto entropy features are available since libxcrypt
+version 4.0.0. Portable software can use feature test macros to find out
+whether null pointers could be specified as
+.I prefix
+and
+.I rbytes
+arguments.
+.PP
The set of supported hashing methods varies considerably from system
to system.
.SH ATTRIBUTES