shisa_enumerate_principals

Langue: en

Autres versions - même langue

Version: 0.0.37 (ubuntu - 08/07/09)

Section: 3 (Bibliothèques de fonctions)

Sommaire

NAME

shisa_enumerate_principals - API function

SYNOPSIS

#include <shisa.h>

int shisa_enumerate_principals(Shisa * dbh, const char * realm, char *** principals, size_t * nprincipals);

ARGUMENTS

Shisa * dbh
Shisa library handle created by shisa().
const char * realm
Name of realm, as zero-terminated UTF-8 string.
char *** principals
size_t * nprincipals
Pointer to number indicating number of allocated realm strings.

DESCRIPTION

Extract a list of all principal names in realm in backend, as zero-terminated UTF-8 strings. The caller must deallocate the strings.

RETURN VALUE

Returns SHISA_OK on success, SHISA_NO_REALM if the specified realm does not exist, or error code.

REPORTING BUGS

Report bugs to <bug-shishi@josefsson.org>. 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.