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
- 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 ]