CRYPT_PREFERRED_METHOD

Section: C Library Functions (3)
Page Index

BSD mandoc
libxcrypt

NAME

crypt_preferred_method - get the prefix of the preferred hash method

LIBRARY

Lb libcrypt

SYNOPSIS

In crypt.h Ft const char* Fo crypt_preferred_method Fa void Fc

DESCRIPTION

is a convenience function to get the prefix of the preferred hash method. If a preferred method is available, it is the same as the one also used by the crypt_gensalt functions if their given prefix parameter is NULL.

RETURN VALUES

The string returned equals the prefix of the preferred hash method. If no preferred hash method is available it is NULL. It is safe to pass the string returned by crypt_preferred_method directly to crypt_gensalt without prior string-sanitizing nor NULL-pointer checks.

FEATURE TEST MACROS

In crypt.h will define the macro CRYPT_PREFERRED_METHOD_AVAILABLE if is available in the current version of libxcrypt.

PORTABILITY NOTES

The function is not part of any standard. It was added to libxcrypt in version 4.4.0.

ATTRIBUTES

For an explanation of the terms used in this section, see attributes(7).

Interface	Attribute	Value
	Thread safety	MT-Safe