HP Open Source Security for OpenVMS Volume 3: Kerberos > Chapter 6 KRB5 (Kerberos V5) Application Programming Interface

krb5_425_conv_principal — Convert a Kerberos V4 principal name to V5 format

  Table of Contents



C Prototype

krb5_error_code krb5_425_conv_principal(
krb5_context context,
const char *name,
const char *instance,
const char *realm,
krb5_principal *princ );


context (input/output) 

The context structure.

name (input) 

Kerberos V4 name.

instance (input) 

Kerberos V4 instance.

realm (input) 

Kerberos V4 realm.

principal (output) 

Kerberos V5 principal name.


This routine builds a principal princ from a V4 specification made up of name.instance@realm. The routine is site customized to convert the V4 naming scheme to a V5 scheme. For instance, the V4 rcmd is changed to host.

The returned principal should be freed with krb5_free_principal.

Return Values

This routine returns the following KRB5 status code:


Successful completion.