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

# shishi\_key\_from\_name(3)

API function

## NAME

shishi\_key\_from\_name - API function

## SYNOPSIS

**#include \<shishi.h\>**

**int shishi\_key\_from\_name(Shishi \*** *handle***, int32\_t** *type***, const char \*** *name***, const char \*** *password***, size\_t** *passwordlen***, const char \*** *parameter***, Shishi\_key \*\*** *outkey***);**

## ARGUMENTS

- Shishi \* handle

  Shishi library handle create by **shishi\_init()**.

- int32\_t type

  type of key.

- const char \* name

  principal name of user.

- const char \* password

  input array containing password.

- size\_t passwordlen

  length of input array containing password.

- const char \* parameter

  input array with opaque encryption type specific information.

- Shishi\_key \*\* outkey

  pointer to structure that will hold newly created key information

## DESCRIPTION

Create a new Key information structure, and derive the key from principal name and password using **shishi\_key\_from\_name()**.  The salt is derived from the principal name by concatenating the decoded realm and principal.

## 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.