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

krb5_524_conv_principal — Separate a Kerberos V5 principal into components

  Table of Contents



C Prototype

krb5_error_code krb5_524_conv_principal (
krb5_context context,
krb5_const_principal princ,
char *name,
char *inst,
char *realm );


context (input/output) 

The context structure.

princ (input) 

The Kerberos V5 principal.

name (output) 

The principal name.

inst (output)  

The principal instance name.

realm (output) 

The principal realm name.


This routine separates a Kerberos V5 principal into name, instance, and realm.

Return Values

This routine returns the following KRB5 status codes:

0Successful completion.


Invalid principal name.


Can’t open/find Kerberos configuration file.