.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
.TH "shisa_enumerate_principals" 3 "1.0.1" "shishi" "shishi"
.SH NAME
shisa_enumerate_principals \- API function
.SH SYNOPSIS
.B #include <shisa.h>
.sp
.BI "int shisa_enumerate_principals(Shisa * " dbh ", const char * " realm ", char *** " principals ", size_t * " nprincipals ");"
.SH ARGUMENTS
.IP "Shisa * dbh" 12
Shisa library handle created by \fBshisa()\fP.
.IP "const char * realm" 12
Name of realm, as zero\-terminated UTF\-8 string.
.IP "char *** principals" 12
.IP "size_t * nprincipals" 12
Pointer to number indicating number of allocated
realm strings.
.SH "DESCRIPTION"
Extract a list of all principal names in realm in backend, as
zero\-terminated UTF\-8 strings.  The caller must deallocate the
strings.
.SH "RETURN VALUE"
Returns SHISA_OK on success, SHISA_NO_REALM if the
specified realm does not exist, or error code.
.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.