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

# shishi\_principal\_name\_realm(3)

API function

## NAME

shishi\_principal\_name\_realm - API function

## SYNOPSIS

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

**int shishi\_principal\_name\_realm(Shishi \*** *handle***, Shishi\_asn1** *namenode***, const char \*** *namefield***, Shishi\_asn1** *realmnode***, const char \*** *realmfield***, char \*\*** *out***, size\_t \*** *outlen***);**

## ARGUMENTS

- Shishi \* handle

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

- Shishi\_asn1 namenode

  ASN.1 structure with principal name in *namefield*.

- const char \* namefield

  name of field in *namenode* containing principal name.

- Shishi\_asn1 realmnode

  ASN.1 structure with principal realm in *realmfield*.

- const char \* realmfield

  name of field in *realmnode* containing principal realm.

- char \*\* out

  pointer to newly allocated null terminated string containing principal name.  May be **NULL** (to only populate *outlen*).

- size\_t \* outlen

  pointer to length of *out* on output, excluding terminating null.  May be **NULL** (to only populate *out*).

## DESCRIPTION

Represent principal name and realm in ASN.1 structure as null-terminated string.  The string is allocated by this function. It is the responsibility of the caller to deallocate it.  Note that the output length *outlen* does not include the terminating null character.

## RETURN VALUE

Returns SHISHI\_OK if 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.