krb5_kt_read_service_key()--Get Service Key from Key Table

Syntax

 #include <krb5.h>

 krb5_error_code krb5_kt_read_service_key(  
     krb5_context       context,
     krb5_pointer     keytab_name,   
     krb5_principal     principal,
     krb5_kvno        vno,
     krb5_enctype     enctype,
     krb5_keyblock **     key);

  Service Program Name: QSYS/QKRBGSS

  Default Public Authority: *USE

  Threadsafe: Yes

The krb5_kt_read_service_key() function returns the service key from the key table.

Authorities

Object Referred to	Data Authority Required
All directories in path	*X
Keytab file	*R

Parameters

context (Input): The Kerberos context.
keytab_name (Input): The key table name. If a NULL address is specified, the default key table is used.
principal (Input): The service principal.
vno (Input): The key version number for the key to be retrieved. Specify a version number of zero to retrieve the key with the highest version number.
enctype (Input): The key encryption type. Specify an encryption type of zero if the encryption type does not matter.
key (Output): The retrieved key. The krb5_free_keyblock() routine should be called to release the key when it is no longer needed.

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.

API introduced: V5R1

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