.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
.TH "shishi_principal_name_realm" 3 "1.0.2" "shishi" "shishi"
.SH NAME
shishi_principal_name_realm \- API function
.SH SYNOPSIS
.B #include <shishi.h>
.sp
.BI "int shishi_principal_name_realm(Shishi * " handle ", Shishi_asn1 " namenode ", const char * " namefield ", Shishi_asn1 " realmnode ", const char * " realmfield ", char ** " out ", size_t * " outlen ");"
.SH ARGUMENTS
.IP "Shishi * handle" 12
Shishi library handle created by \fBshishi_init()\fP.
.IP "Shishi_asn1 namenode" 12
ASN.1 structure with principal name in \fInamefield\fP.
.IP "const char * namefield" 12
name of field in \fInamenode\fP containing principal name.
.IP "Shishi_asn1 realmnode" 12
ASN.1 structure with principal realm in \fIrealmfield\fP.
.IP "const char * realmfield" 12
name of field in \fIrealmnode\fP containing principal realm.
.IP "char ** out" 12
pointer to newly allocated null terminated string containing
principal name.  May be \fBNULL\fP (to only populate \fIoutlen\fP).
.IP "size_t * outlen" 12
pointer to length of \fIout\fP on output, excluding terminating
null.  May be \fBNULL\fP (to only populate \fIout\fP).
.SH "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 \fIoutlen\fP does not include the terminating
null character.
.SH "RETURN VALUE"
Returns SHISHI_OK if 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.