---
name: "shishi_pbkdf2_sha1"
section: "3"
platform: "linux"
package: "shishi-doc"
version: "1.0.3-5"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/shishi_pbkdf2_sha1"
---

# shishi\_pbkdf2\_sha1(3)

API function

## 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\>. GNU Shishi home page: http://www.gnu.org/software/shishi/ General help using GNU software: http://www.gnu.org/gethelp/

## COPYRIGHT

Copyright © 2002-2022 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.