.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
.TH "shishi_authenticator_clientrealm" 3 "1.0.2" "shishi" "shishi"
.SH NAME
shishi_authenticator_clientrealm \- API function
.SH SYNOPSIS
.B #include <shishi.h>
.sp
.BI "int shishi_authenticator_clientrealm(Shishi * " handle ", Shishi_asn1 " authenticator ", char ** " client ", size_t * " clientlen ");"
.SH ARGUMENTS
.IP "Shishi * handle" 12
Shishi library handle create by \fBshishi_init()\fP.
.IP "Shishi_asn1 authenticator" 12
Authenticator variable to get client name and realm from.
.IP "char ** client" 12
pointer to newly allocated zero terminated string containing
principal name and realm.  May be \fBNULL\fP (to only populate \fIclientlen\fP).
.IP "size_t * clientlen" 12
pointer to length of \fIclient\fP on output, excluding terminating
zero.  May be \fBNULL\fP (to only populate \fIclient\fP).
.SH "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 \fIclientlen\fP does not include the terminating
zero.
.SH "RETURN VALUE"
Returns SHISHI_OK iff successful.
.SH "REPORTING BUGS"
Report bugs to <bug-shishi@gnu.org>.
.SH COPYRIGHT
Copyright \(co 2002-2010 Simon Josefsson.
.br
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.
.SH "SEE ALSO"
The full documentation for
.B shishi
is maintained as a Texinfo manual.  If the
.B info
and
.B shishi
programs are properly installed at your site, the command
.IP
.B info shishi
.PP
should give you access to the complete manual.