Проект OpenNet: MAN crypt_gensalt_impl (3) Библиотечные вызовы (FreeBSD и Linux)

Интерактивная система просмотра системных руководств (man-ов)

crypt_gensalt_impl (3)

>> crypt_gensalt_impl (3) ( Solaris man: Библиотечные вызовы )

NAME

crypt_gensalt_impl - generate salt for password encryption

SYNOPSIS

#include <crypt.h>

char *crypt_gensalt_impl(char *gsbuffer, size_t gsbufflen,
    const char *oldsalt, const struct passwd *userinfo,
    const char **params);

DESCRIPTION

The crypt_gensalt_impl() function is called by crypt_gensalt(3C) to generate the salt for password encryption.

The gsbuffer argument is a pointer to an MT-safe buffer of size gsbufflen.

The oldsalt and userinfo arguments are passed unchanged from crypt_gensalt(3C).

The params argument is an argv-like null terminated vector of type char *. The first element of params represents the mechanism token name from crypt.conf(4). The remaining elements of params represent strings of the form <parameter>[=<value>] to allow passing in additional information from the crypt.conf entry, such as specifying rounds information "rounds=4096".

The value returned by crypt_gensalt_impl() points to a thread-specific buffer to be freed by the caller of crypt_gensalt(3C) after calling crypt(3C).

RETURN VALUES

Upon successful completion, crypt_gensalt_impl() returns a pointer to the new salt. Otherwise a null pointer is returned and errno is set to indicate the error.