NAME

shishi_authenticator_clientrealm - API function

SYNOPSIS

#include <shishi.h>

int shishi_authenticator_clientrealm(Shishi * handle, Shishi_asn1 authenticator, char ** client, size_t * clientlen);

ARGUMENTS

Shishi * handle: Shishi library handle create by shishi_init().
Shishi_asn1 authenticator: Authenticator variable to get client name and realm from.
char ** client: pointer to newly allocated zero terminated string containing principal name and realm. May be NULL (to only populate clientlen).
size_t * clientlen: pointer to length of client on output, excluding terminating zero. May be NULL (to only populate client).

DESCRIPTION

Convert cname and realm fields from Authenticator to printable principal name format. The string is allocate by this function, and it is the responsibility of the caller to deallocate it. Note that the output length clientlen does not include the terminating zero.

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.