krb5_auth_con_getremoteseqnumber()--Get Remote Message Sequence Number


  Syntax 
 #include <krb5.h>

 krb5_error_code krb5_auth_con_getremoteseqnumber(    
     krb5_context   context,
     krb5_auth_context   auth_context,
     krb5_int32 *   seqnum);
  Service Program Name: QSYS/QKRBGSS

  Default Public Authority: *USE

  Threadsafe: Conditional. See Usage notes.

The krb5_auth_con_getremoteseqnumber() function retrieves the remote message sequence number from the authentication context.


Authorities

No authorities are required.


Parameters

context  (Input)
The Kerberos context.

auth_context  (Input)
Tthe authentication context.

seqnum  (Output)
The message sequence number.

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. Sequence numbers are used when generating messages if the KRB5_AUTH_CONTEXT_DO_SEQUENCE (x'00000004') flag has been set in the authentication context.

  2. The Kerberos protocol runtime provides no concurrency control for the authentication context. If the application wants to use the same authentication context in multiple threads, it is the responsibility of the application to serialize access to the authentication context so that only a single thread is accessing the authentication context at any time.

API introduced: V5R1

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