dced_keytab_initialize_cursor(3dce)
Obtains a list of keys from a key table and sets a cursor at the beginning of the list
Synopsis
#include <dce/dced.h>
void dced_keytab_initialize_cursor(
dced_binding_handle_t dced_bh,
uuid_t *keytab_uuid,
dced_keytab_cursor_t *cursor,
error_status_t *status);
Parameters
Input
dced_bh
Specifies the dced binding handle for the keytab service on a specific host.
keytab_uuid
Specifies the keytab entry dced associates with a key table.
Output
cursor
Returns the cursor that is used to traverse the list of keys.
status
Returns the status code from this routine. This status code indicates whether the routine completed successfully or, if not, why not.
Description
The dced_keytab_initialize_cursor( ) routine obtains the complete list of keys from a remote key table and sets a cursor at the beginning of the cached list
keys. In order to minimize the security risks of keys exposed to the network, the entire set of keys are encrypted and transferred in one remote procedure call rather than individually or in chunks.
The cursor is then used in subsequent calls to dced_keytab_get_next_key( ) to obtain individual keys. When the application is finished traversing the key list, it should call
dced_keytab_release_cursor( ) to release the resources previously allocated.
Management applications use dced_keytab_initialize_cursor( ) and its associated routines to remotely access server keys. Servers use sec_key_mgmt_initialize_cursor(3sec) and its associated routines to manage their own keys locally.
Prior to calling the dced_keytab_initialize_cursor( ) 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
dced_s_bad_binding
dced_s_need_privacy
dced_s_no_memory
dced_s_no_support
sec_acl_invalid_permission
sec_key_mgmt_e_authn_invalid
sec_key_mgmt_e_unauthorized
Related Information
Routines: dced_keytab_get_next_key(3dce)
dced_keytab_release_cursor(3dce)
sec_key_mgmt_initialize_cursor(3sec)
dced_binding_from_rpc_binding(3dce)
Book: OSF DCE Application Development Guide - Core Components