krb5_auth_con_initvector()--Allocate and Zero the Initial Vector

 #include <krb5.h>

 krb5_error_code krb5_auth_con_initvector(
     krb5_context     context,
     krb5_auth_context      auth_context);  

The krb5_auth_con_initivector() function allocates and zeros the initial vector in the authentication context. The authentication context must already contain an encryption key defining the type of encryption that will be used. The initial vector is used to initialize the encryption sequence each time a message is encrypted. This serves to generate different encrypted results for the same message contents and encryption key.

Authorities

No authorities are required.

Parameters

context  (Input)

The Kerberos context.

auth_context  (Input)

The authentication context.

Return Value

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

Error Messages

Usage Notes

1. The application should not use both krb5_auth_con_initivector() and krb5_auth_con_setivector() for the same 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.

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