next up previous contents
Next: kadm5_create_principal Up: Functions Previous: kadm5_flush   Contents

kadm5_destroy

kadm5_ret_t kadm5_destroy(void *server_handle)

AUTHORIZATION REQUIRED: none

Close the connection to the Admin server and releases all related resources. This function behaves differently when called by local and remote clients.

For remote clients, the semantics are:

  1. Destroy the temporary credential cache created by kadm5_init.

  2. Tear down the GSS-API context negotiated with the server.

  3. Close the RPC connection.

  4. Free storage space associated with server_handle, after erasing its magic number so it won't be mistaken for a valid handle by the library later.

For local clients, this function just frees the storage space associated with server_handle after erasing its magic number.

RETURN CODES:



Autobuild 2006-06-16