krb5_kt_start_seq_get()--Start Sequentially Retrieving Entries from Key Table


  Syntax 
 #include <krb5.h>

 krb5_error_code krb5_kt_start_seq_get(  
     krb5_context       context,   
     krb5_keytab      ktid,
     krb5_kt_cursor *     cursor);
  Service Program Name: QSYS/QKRBGSS

  Default Public Authority: *USE

  Threadsafe: Yes

The krb5_kt_start_seq_get() function starts sequentially retrieving entries from the key table. The krb5_kt_next_entry() routine is called repeatedly to retrieve each successive table entry. The krb5_kt_end_seq_get() routine is called at the completion of the read operation.


Authorities

Object Referred to Data Authority Required
All directories in the path name *X
Keytab file *RW


Parameters

context  (Input)
The Kerberos context.

ktid  (Input)
The key table handle.

cursor  (Output)
The cursor. The krb5_kt_end_seq_get() routine should be called to release the cursor at the completion of the sequential read operation.

Return Value

If no errors occur, the return value is 0. Otherwise, a Kerberos error code is returned.


Error Messages

Message ID Error Message Text
CPE3418 E Possible APAR condition or hardware failure.


Usage Notes

  1. The key table is locked when the krb5_kt_start_seq_get() routine is called and remains locked until the krb5_kt_end_seq_get() routine is called. Write access to the key table by other processes and threads is blocked until the table is unlocked. After the krb5_kt_start_seq_get() routine has been called, the current thread may not call any other key table functions except krb5_kt_next_entry() and krb5_kt_end_seq_get() for the specified table.


API introduced: V5R1

[ Back to top | Security APIs | UNIX-Type APIs | APIs by category ]