Content-type: text/html Man page of dispcrypt

dispcrypt

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

dispcrypt - encrypt a password, dispatching based on the associated algorithm (Enhanced Security)  

LIBRARY

Security Library (libsecurity.so)

In order to quickstart a program, the program must be linked as follows:

-lsecurity -ldb -laud -lm

See the shared library discussion in the Programmer's Guide for more information about using the quickstarting feature.  

SYNOPSIS

#include <prot.h>

char *discprypt(
       const char *plaintext,

       const char *salt,

       int algorithm_index);
 

PARAMETERS

plaintext
The unencrypted password to be encrypted.
salt
A string value which may be used as input to the selected encryption algorithm. This parameter should be at least two characters in length, and null-terminated. For password validation, it should be the encrypted password which is already in use.
algorithm_index
A value from 0 to (get_num_crypts()-1), indicating which encryption algorithm is to be used. For password validation, use the fd_oldcrypt field of an es_passwd structure. For password generation, use the fd_newcrypt field (and update the fd_oldcrypt field at the same time as the fd_encrypt field if the change is successful).
 

DESCRIPTION

The dispcrypt() function applies the specified encryption algorithm to the given password string and salt value, and returns the encrypted form of the password. The return value is static data which is overwritten on subsequent calls to this function or to the encryption algorithms which it calls, so callers should save a copy of the string unless the only use is an immediate comparison during password validation.  

RETURN VALUES

This routine returns NULL if there is an encryption failure. Otherwise, it returns a pointer to static data, which is the null-terminated encrypted password result.  

RELATED INFORMATION

passwd(1), getespwent(3), get_num_crypts(3)

Security delim off


 

Index

NAME
LIBRARY
SYNOPSIS
PARAMETERS
DESCRIPTION
RETURN VALUES
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:42:00 GMT, October 02, 2010