HP OpenVMS Systems Documentation
Content starts here
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

 » Glossary

 » Index

spacerspacerspacer
spacer
spacer
  		 
 

C Prototype

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

Arguments

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.

Description

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:

0

Successful completion.



Chapter 6 KRB5 (Kerberos V5) Application Programming Interface
  		 


krb5_524_conv_principal — Separate a Kerberos V5 principal into components