next up previous contents
Next: kadm5_create_policy Up: Functions Previous: kadm5_decyrpt_key   Contents

kadm5_get_principals

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 ``$\backslash$'' matches itself exactly, and a ``$\backslash$'' cannot be the last character in the string.



Autobuild 2006-06-16