next up previous contents
Next: kadm5_get_policies Up: Functions Previous: kadm5_modify_policy   Contents

kadm5_get_policy

In KADM5_API_VERSION_1:

kadm5_ret_t
kadm5_get_policy(void *server_handle, char *policy, kadm5_policy_ent_t *ent);

In KADM5_API_VERSION_2:

kadm5_ret_t
kadm5_get_policy(void *server_handle, char *policy, kadm5_policy_ent_t ent);

AUTHORIZATION REQUIRED: get, or the calling principal's policy being the same as the policy argument. If the request is authenticated to the kadmin/changepw service, the get privilege is disregarded.

In KADM5_API_VERSION_1, return the policy's attributes in allocated memory; if an error is returned entry is set to NULL. In KADM5_API_VERSION_2, fill in fields of the policy structure allocated by the caller. The caller must free the returned entry with kadm5_free_policy_ent

RETURN CODES:

KADM5_BAD_POLICY
The policy name contains illegal characters.
KADM5_UNK_POLICY
Policy not found.



Autobuild 2009-09-05