kadm5_ret_t kadm5_get_principals(void *server_handle, char *exp, char ***princs, int *count)
Retrieves the list of principal names.
AUTHORIZATION REQUIRED: list
If #1
is NULL, all principal names are retrieved; otherwise,
principal names that match the expression exp are retrieved.
#1
is filled in with a pointer to a NULL-terminated array of
strings, and #1
is filled in with the number of principal names
in the array. #1
must be freed with a call to
#1
.
All characters in the expression match themselves except ``?'' which
matches any single character, ``*'' which matches any number of
consecutive characters, and ``[chars]'' which matches any single
character of ``chars''. Any character which follows a ``''
matches itself exactly, and a ``
'' cannot be the last
character in the string.