Name

dced_hostdata_delete - Deletes a hostdata item from a specific host and removes the associated entry from dced

Synopsis

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

Parameters

Input

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

entry_uuidSpecifies the UUID of the hostdata entry (and associated data) to delete. 

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_hostdata_delete() routine deletes a hostdata item (a file) from a specific host, and removes the associated entry from the host data service of that host’s dced. 

If you want to only make the data inaccessible remotely but not delete it, use the dced_entry_remove() routine which only removes the data’s hostdata entry. 

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

Warnings

Do not delete the standard hostdata items such as cell_name, cell_aliases, host_name, post_processors, or dce_cf.db.  This will cause operational problems for the host. 

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_not_found

sec_acl_invalid_permission

Related Information

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

Books: OSF DCE Application Development Guide.