krb5_build_principal()--Build a Kerberos Principal

 #include <krb5.h>

 krb5_error_code krb5_build_principal(
     krb5_context     context,
     krb5_principal *     ret_principal,  
     int        realm_length,
     krb5_const char *      realm,
     char *       name1, name2, ...); 

The krb5_build_principal() function builds a Kerberos principal from its component strings.

Authorities

No authorities are required.

Parameters

context  (Input)

The Kerberos context.

ret_principal  (Output)

The Kerberos principal. The krb5_free_principal() routine should be called to release the principal when it is no longer needed.

realm_length  (Input)

The length of the realm name.

realm  (Input)

The realm name.

name1, name2, ...  (Input)

One or more name components. The end of the components is indicated by specifying NULL for the parameter.

Return Value

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

Error Messages

Example

See Code disclaimer information for information pertaining to code examples.

The following example creates the principal bambi/admin@forest:

            
#include <krb5.h>

retval = krb5_build_principal(context, &princ, 6, "forest", "bambi", "admin", NULL);