krb5_init_context(3)

KRB5_CONTEXT(3)            UNIX Programmer's Manual            KRB5_CONTEXT(3)

NAME

     krb5_init_context, krb5_free_context - create and delete krb5_context
     structures

LIBRARY

     Kerberos 5 Library (libkrb5, -lkrb5)

SYNOPSIS

     krb5_error_code
     krb5_init_context(krb5_context *context)

     void
     krb5_free_context(krb5_context context)

DESCRIPTION

     The krb5_init_context() function initializes the context structure and
     reads the configuration file /etc/krb5.conf.

     The structure should be freed by calling krb5_free_context() when it is
     no longer being used.

RETURN VALUES

     krb5_init_context() returns 0 to indicate success.  Otherwise an errno
     code is returned.  Failure means either that something bad happened dur-
     ing initialization (typically [ENOMEM]) or that Kerberos should not be
     used [ENXIO].

SEE ALSO

     errno(2),  krb5_context(3),  kerberos(8)

 HEIMDAL                       January 21, 2001                              1