Name

dced_keytab_remove_key - Removes a key (server password) from a specified key table on a specific host

Synopsis

#include <dce/dced.h> void dced_keytab_remove_key(
dced_binding_handle_t dced_bh,
uuid_t ∗keytab_uuid,
dced_key_t ∗key,
error_status_t ∗status);

Parameters

Input

dced_bhSpecifies the dced binding handle for the keytab service on a specific host. 

keytab_uuidSpecifies the UUID dced maintains to identify the key table from which the key is to be removed. 

keySpecifies the key to be removed from the key table. 

Output

statusReturns the status code from this routine.  This status code indicates whether the routine completed successfully or, if not, why not. 

Description

The dced_keytab_remove_key() routine removes a key from a key table (file) on a specific host.  The key table is specified with a keytab entry UUID from the host’s dced.  Management applications use dced_keytab_remove_key()  to remotely remove server keys from key tables.  Typically, servers delete their own keys from their local key tables implicitly by calling sec_­key_­mgmt_­manage_­key(), or explicitly by calling sec_­key_­mgmt_­delete_­key().  Applications can delete an entire key table file using the dced_­keytab_­delete() routine. 

Prior to calling this routine, the application must have established a valid dced binding handle to the keytab service by calling either the dced_binding_create() or dced_binding_from_rpc_binding() routine. 

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. 

error_status_ok

db_s_bad_index_type

db_s_key_not_found

dced_s_bad_binding

dced_s_need_privacy

rpc_s_binding_has_no_auth

rpc_s_invalid_binding

rpc_s_wrong_kind_of_binding

sec_acl_invalid_permission

sec_key_mgmt_e_authn_invalid

sec_key_mgmt_e_key_unavailable

sec_key_mgmt_e_unauthorized

Related Information

Functions: dced_binding_create(3dce), dced_binding_from_rpc_binding(3dce), dced_keytab_delete(3dce), sec_key_mgmt_delete_key(3sec). 

Books: OSF DCE Application Development Guide.