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.