Index for Section 3

Alphabetical listing for D

Bottom of page

dispcrypt(3)
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

Index for Section 3

Alphabetical listing for D

Top of page