shishi_authenticator_clientrealm(3)
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@josefsson.org>.
COPYRIGHT
Copyright © 2002-2008 Simon Josefsson.
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
preserved on all copies.
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.