![]() ![]()
sec_key_mgmt_delete_key_type(3sec)Deletes a key version of a key type from the local key storage Synopsis
#include <dce/keymgmt.h> Parameters Input
authn_service
rpc_c_authn_dce_secret
rpc_c_authn_dce_public
arg A value of NULL specifies that the default key file (/krb/v5srvtab) should be used. A key file name specifies that file should be used as the key file. You must prepend the file's absolute file name with FILE: and the file must have been created with the rgy_edit ktadd command or the sec_key_mgmt_set_key routine. Any other value specifies an argument for the get_key_fn key acquisition routine. See the rpc_server_register_auth_info( ) reference page for more information.
principal_name
keytype
key_vno Output
status
Description This routine removes the key from the local key storage, which invalidates all extant tickets encoded with the key. If the key in question is the current one, the principal should change the key with sec_key_mgmt_change_key( ) before deleting it. It is not an error for a process to delete the current key (as long as it is done after the network context has been established), but it may seriously inconvenience legitimate clients of a service. Files
/usr/include/dce/keymgmt.idl Errors The following describes a partial list of errors that might be returned. Refer to the OSF DCE Problem Determination Guide for complete descriptions of all error messages. Any error condition will leave the key state unchanged.
sec_key_mgmt_e_key_unavailable
sec_key_mgmt_e_authn_invalid
sec_key_mgmt_e_unauthorized
error_status_ok
Related Information sec_key_mgmt_garbage_collect(3sec)
|