NAME

sec_key_mgmt_initialize_cursor — Repositions the cursor in the local key store

Synopsis

void sec_key_mgmt_initialize_cursor(
sec_key_mgmt_authn_service authn_service,
void ∗arg,
idl_char ∗principal_name,
void ∗keytype,
void ∗∗cursor,
error_status_t ∗status);

Parameters

Input

authn_service
Identifies the authentication protocol using this key.  The possible authentication protocols are as follows:

rpc_c_authn_dce_secret
DCE shared-secret key authentication.

rpc_c_authn_dce_public
DCE public key authentication (reserved for future use).

argThis parameter can specify either the local key file or an argument to the get_key_fn key acquisition routine of the rpc_server_register_auth_info routine. 

A value of NULL specifies that the default key file (/krb/v5srvtab) should be used.  A key filename specifies that file should be used as the key file.  You must prepend the file’s absolute filename 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
A pointer to a character string indicating the name of the principal whose key is to be accessed. To access all keys in the local key store, supply NULL for this parameter.

keytypeA pointer to the data encryption algorithm (for example, DES) being used for the key. 

Output

cursorThe returned cursor value.  The storage for the cursor information is allocated dynamically, so the returned pointer actually indicates a pointer to the cursor value.  The storage for this data may be freed with the sec_key_mgmt_release_cursor() routine. 

statusA pointer to the completion status.  On successful completion, the routine returns error_status_ok.  Otherwise, it returns an error. 

Description

The sec_key_mgmt_initialize_cursor() routine resets the cursor in the local key store. 

Use this routine to reposition the cursor before performing a scan of the local store via sec_key_mgmt_get_next_key().  The returned cursor value is supplied as input to sec_key_mgmt_get_next_key(). 

Files

/usr/include/dce/keymgmt.idl
The idl file from which dce/keymgmt.h was derived. 

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. 

sec_s_no_memory
Unable to allocate memory.

sec_key_mgmt_e_authn_invalid
The authentication protocol is not valid.

sec_key_mgmt_e_unauthorized
The caller is not authorized to perform the operation.

error_status_ok
The call was successful.

Related Information

Functions: sec_intro(3sec), sec_key_mgmt_get_next_key(3sec), sec_key_mgmt_release_cursor(3sec).