Name

dced_keytab_delete - Deletes a key table file from a specific host

Synopsis

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

Parameters

Input

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

keytab_uuidSpecifies the UUID of the keytab entry and associated key table to be deleted. 

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_delete() routine deletes a key table (file) from a specific host and removes the associated entry from the keytab service of that host’s dced.  A key table is a file containing a list of server keys (passwords).  This routine is used by management applications to remotely delete a key table. 

To remove individual keys from a remote key table, use the dced_keytab_remove_key() routine.  If you only want to make the key table inaccessible remotely (via dced), but not to delete it, use the dced_entry_remove() routine.  This routine only removes the key table’s keytab entry from dced. 

Prior to calling the dced_keytab_delete() 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_del_failed

db_s_iter_not_allowed

db_s_key_not_found

dced_s_bad_binding

dced_s_cant_remove_storage_file

dced_s_need_privacy

rpc_s_binding_has_no_auth

rpc_s_invalid_binding

rpc_s_wrong_kind_of_binding

sec_acl_invalid_permission

Related Information

Functions: dced_binding_create(3dce), dced_binding_from_rpc_binding(3dce), dced_entry_remove(3dce), dced_keytab_remove_key(3dce). 

Books: OSF DCE Application Development Guide.