NAME

     crypt - password and data encryption


SYNOPSIS

     #define _XOPEN_SOURCE
     #include <unistd.h>

     char *crypt(const char *key, const char *salt));


DESCRIPTION

     crypt is the password encryption function.  It is  based  on
     the  Data  Encryption  Standard  algorithm  with  variations
     intended (among other things) to discourage use of  hardware
     implementations of a key search.

     key is a user's typed password.

     salt  is  a  two-character  string  chosen  from   the   set
     [azAZ09./].  This string is used to perturb the algorithm in
     one of 4096 different ways.

     By taking the lowest 7 bit of each character of the  key,  a
     56-bit  key is obtained.  This 56-bit key is used to encrypt
     repeatedly a constant string (usually a string consisting of
     all  zeros).   The  returned  value  points to the encrypted
     password, a series of 13  printable  ASCII  characters  (the
     first two characters represent the salt itself).  The return
     value points to static data whose content is overwritten  by
     each call.

     Warning: The key space consists of 2**56 equal 7.2e16 possi-
     ble  values.  Exhaustive searches of this key space are pos-
     sible using massively parallel computers.  Software, such as
     crack(1), is available which will search the portion of this
     key space that is generally used by  humans  for  passwords.
     Hence,  password  selection should, at minimum, avoid common
     words and names.  The use of a passwd(1) program that checks
     for  crackable  passwords  during  the  selection process is
     recommended.

     The DES algorithm itself has a few quirks which make the use
     of  the  crypt(3)  interface a very poor choice for anything
     other than password authentication.  If you are planning  on
     using  the  crypt(3)  interface  for a cryptography project,
     don't do it: get a good book on encryption and  one  of  the
     widely available DES libraries.


CONFORMING TO

     SVID, X/OPEN, BSD 4.3


SEE ALSO

     login(1), passwd(1), encrypt(3),