Standard C Library Functions               cryptgenhashimpl(3C)



NAME
     cryptgenhashimpl - generate encrypted password

SYNOPSIS
     #include 

     char *cryptgenhashimpl(char *ctbuffer, sizet ctbufflen,
          const char *plaintext, const char *salt, const char **params);


DESCRIPTION
     The cryptgenhashimpl() function is called by crypt(3C)  to
     generate the encrypted password plaintext.


     The ctbuffer argument is a pointer to an MT-safe  buffer  of
     ctbufflen size that is used to return the result.


     The salt argument is the salt used in encoding.


     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  ele-
     ments    of   params   represent   strings   of   the   form
     [=] to allow passing in additional  infor-
     mation  from  the crypt.conf entry, such as specifing rounds
     information "rounds=4096".


     The cryptgenhashimpl() function must not  free(3C)  ctbuf-
     flen on error.

RETURN VALUES
     Upon successful completion, cryptgenhashimpl()  returns  a
     pointer  to  the  encoded  version of plaintext. Otherwise a
     null pointer is returned and errno is set  to  indicate  the
     error.

ERORS
     The cryptgenhashimpl() function will fail if:

     EINVAL     The configuration  file  crypt.conf  contains  an
                invalid entry.


     ELIBAC    The required shared library was not found.


     ENOMEM     There is insufficient memory to perform hashing.




SunOS 5.11          Last change: 10 Jun 2002                    1






Standard C Library Functions               cryptgenhashimpl(3C)



ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Interface Stability          Evolving                    
    
     MT-Level                     MT-Safe                     
    


SEE ALSO
     passwd(1),  crypt(3C),   cryptgensaltimpl(3C),   free(3C),
     getpassphrase(3C), crypt.conf(4), passwd(4), attributes(5)





































SunOS 5.11          Last change: 10 Jun 2002                    2