NAME

       shishi_pbkdf2_sha1 - API function

SYNOPSIS

       #include <shishi.h>

       int  shishi_pbkdf2_sha1(Shishi  *  handle,  const  char  * P, size_t Plen, const char * S,
       size_t Slen, unsigned int c, unsigned int dkLen, char * DK);

ARGUMENTS

       Shishi * handle
                   shishi handle as allocated by shishi_init().

       const char * P
                   input password, an octet string

       size_t Plen length of password, an octet string

       const char * S
                   input salt, an octet string

       size_t Slen length of salt, an octet string

       unsigned int c
                   iteration count, a positive integer

       unsigned int dkLen
                   intended length in octets of the derived key,  a  positive  integer,  at  most
                   (2^32 - 1) * hLen.  The DK array must have room for this many characters.

       char * DK   output derived key, a dkLen-octet string

DESCRIPTION

       Derive  key  using the PBKDF2 defined in PKCS5.  PBKDF2 applies a pseudorandom function to
       derive keys. The length of the derived key is essentially unbounded. (However, the maximum
       effective  search  space  for  the  derived  key  may  be  limited by the structure of the
       underlying pseudorandom function, which is this function is always SHA1.)

RETURN VALUE

       Returns SHISHI_OK iff successful.

REPORTING BUGS

       Report bugs to <bug-shishi@gnu.org>.

COPYRIGHT

       Copyright © 2002-2010 Simon Josefsson.
       Copying and distribution of this file, with or without modification, are permitted in  any
       medium without royalty provided the copyright notice and this notice are preserved.

SEE ALSO

       The  full  documentation  for  shishi  is maintained as a Texinfo manual.  If the info and
       shishi programs are properly installed at your site, the command

              info shishi

       should give you access to the complete manual.